@senpi/runtime 3.0.6-dev.runtime-phase-2.20260630134327 → 3.0.6-dev.runtime-phase-2.20260630134410

package/dist/tracking/spans/otel/recording-span-transport.js

@@ -1,67 +0,0 @@
-/**
- * RecordingSpanTransport — ships agent spans to the OTEL v2 `/v1/traces` path.
- *
- * Implements the same `SpanTransport` seam as `BatchingSpanTransport`, but maps
- * each `TrackingSpan` to a HyperDX `TraceRow` and enqueues it on a dedicated
- * recording `TelemetryBatcher` (one per gateway — built at plugin register(),
- * not borrowed from a per-runtime batcher).
- *
- * Pipeline per span (fire-and-forget, never throws into the SpanTracker):
- *   truncate oversized data fields  →  redact PII  →  map to TraceRow  →  enqueueTrace
- *
- * Truncation + redaction mirror BatchingSpanTransport so the new path never
- * ships unredacted or oversized payloads. The recording batcher serializes at
- * enqueue, so (unlike the legacy transport) both run BEFORE the row is built.
- *
- * `flush`/`shutdown` first await any in-flight per-span processing, then the
- * batcher — so a flush is deterministic (no row stranded mid-pipeline).
- */
-import { truncateSpanData } from "../span-transport.js";
-import { getDefaultPiiRedactor, redactSpanData, } from "../redact-pii.js";
-import { trackingSpanToTraceRow } from "./map-span-to-trace-row.js";
-import { fitTraceRowToBudget } from "./fit-row-budget.js";
-import { createLogger } from "../../../utils/logger.js";
-const logger = createLogger("[senpi-core][recording-span-transport]");
-export class RecordingSpanTransport {
-    batcher;
-    redactorOverride;
-    pending = new Set();
-    constructor(options) {
-        this.batcher = options.batcher;
-        this.redactorOverride = options.redactor;
-    }
-    enqueue(span) {
-        const p = this.process(span).finally(() => this.pending.delete(p));
-        this.pending.add(p);
-    }
-    async flush() {
-        await this.drainPending();
-        await this.batcher.flush();
-    }
-    async shutdown() {
-        await this.drainPending();
-        await this.batcher.shutdown();
-    }
-    /** Truncate → redact → map → enqueue. Self-contained; never throws. */
-    async process(span) {
-        try {
-            const truncated = truncateSpanData(span);
-            const redactor = this.redactorOverride === undefined
-                ? getDefaultPiiRedactor()
-                : this.redactorOverride;
-            const cleaned = redactor ? await redactSpanData(truncated, redactor) : truncated;
-            // Fit to the OTEL per-row byte cap (256 KB server-side) — the legacy
-            // 2 MB/field truncation above doesn't bound the assembled row.
-            this.batcher.enqueueTrace(fitTraceRowToBudget(trackingSpanToTraceRow(cleaned)));
-        }
-        catch (err) {
-            logger.warn("span → trace-row pipeline failed; dropped", {
-                err: err instanceof Error ? err.message : String(err),
-            });
-        }
-    }
-    async drainPending() {
-        await Promise.allSettled([...this.pending]);
-    }
-}
-//# sourceMappingURL=recording-span-transport.js.map

package/dist/tracking/spans/otel/recording-span-transport.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"recording-span-transport.js","sourceRoot":"","sources":["../../../../src/tracking/spans/otel/recording-span-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAEL,qBAAqB,EACrB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,MAAM,MAAM,GAAG,YAAY,CAAC,wCAAwC,CAAC,CAAC;AAYtE,MAAM,OAAO,sBAAsB;IAChB,OAAO,CAAmB;IAC1B,gBAAgB,CAAiC;IACjD,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;IAEpD,YAAY,OAAsC;QAChD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC3C,CAAC;IAED,OAAO,CAAC,IAAkB;QACxB,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED,uEAAuE;IAC/D,KAAK,CAAC,OAAO,CAAC,IAAkB;QACtC,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,QAAQ,GACZ,IAAI,CAAC,gBAAgB,KAAK,SAAS;gBACjC,CAAC,CAAC,qBAAqB,EAAE;gBACzB,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;YAC5B,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACjF,qEAAqE;YACrE,+DAA+D;YAC/D,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,mBAAmB,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAClF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,2CAA2C,EAAE;gBACvD,GAAG,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACtD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,YAAY;QACxB,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9C,CAAC;CACF"}

package/dist/tracking/spans/otel/span-ids.d.ts

@@ -1,22 +0,0 @@
-/**
- * Deterministic OTEL id derivation for agent spans.
- *
- * Unlike scanner spans (each its own trace, random ids via `cryptoIdGenerator`),
- * agent spans must group by run and preserve their parent/child tree. So ids are
- * *derived* — a hash of the stable source key — rather than random:
- *
- *   - `TraceId`      = hash(runId)        → every span in one agent run shares it
- *   - `SpanId`       = hash(span.id)
- *   - `ParentSpanId` = hash(span.parentSpanId)  ("" stays "" for roots)
- *
- * A child's `parentSpanId` holds the parent span's raw id, so
- * `deriveParentSpanId(child.parentSpanId)` equals `deriveSpanId(parent.id)` —
- * the link reconstructs in HyperDX.
- */
-/** 32 lowercase-hex chars (16 bytes) derived from the agent run id. */
-export declare function deriveTraceId(runId: string): string;
-/** 16 lowercase-hex chars (8 bytes) derived from the span's raw id. */
-export declare function deriveSpanId(id: string): string;
-/** Derived parent SpanId; empty string (root) passes through unchanged. */
-export declare function deriveParentSpanId(parentSpanId: string): string;
-//# sourceMappingURL=span-ids.d.ts.map

package/dist/tracking/spans/otel/span-ids.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"span-ids.d.ts","sourceRoot":"","sources":["../../../../src/tracking/spans/otel/span-ids.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE/D"}

package/dist/tracking/spans/otel/span-ids.js

@@ -1,32 +0,0 @@
-/**
- * Deterministic OTEL id derivation for agent spans.
- *
- * Unlike scanner spans (each its own trace, random ids via `cryptoIdGenerator`),
- * agent spans must group by run and preserve their parent/child tree. So ids are
- * *derived* — a hash of the stable source key — rather than random:
- *
- *   - `TraceId`      = hash(runId)        → every span in one agent run shares it
- *   - `SpanId`       = hash(span.id)
- *   - `ParentSpanId` = hash(span.parentSpanId)  ("" stays "" for roots)
- *
- * A child's `parentSpanId` holds the parent span's raw id, so
- * `deriveParentSpanId(child.parentSpanId)` equals `deriveSpanId(parent.id)` —
- * the link reconstructs in HyperDX.
- */
-import { createHash } from "node:crypto";
-function hashHex(input, bytes) {
-    return createHash("sha256").update(input).digest("hex").slice(0, bytes * 2);
-}
-/** 32 lowercase-hex chars (16 bytes) derived from the agent run id. */
-export function deriveTraceId(runId) {
-    return hashHex(runId, 16);
-}
-/** 16 lowercase-hex chars (8 bytes) derived from the span's raw id. */
-export function deriveSpanId(id) {
-    return hashHex(id, 8);
-}
-/** Derived parent SpanId; empty string (root) passes through unchanged. */
-export function deriveParentSpanId(parentSpanId) {
-    return parentSpanId === "" ? "" : deriveSpanId(parentSpanId);
-}
-//# sourceMappingURL=span-ids.js.map

package/dist/tracking/spans/otel/span-ids.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"span-ids.js","sourceRoot":"","sources":["../../../../src/tracking/spans/otel/span-ids.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,SAAS,OAAO,CAAC,KAAa,EAAE,KAAa;IAC3C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAC5B,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,OAAO,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AACxB,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,kBAAkB,CAAC,YAAoB;IACrD,OAAO,YAAY,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;AAC/D,CAAC"}

package/dist/tracking/spans/plugin-span-tracker.d.ts

@@ -1,9 +0,0 @@
-import { SpanTracker } from "./span-tracker.js";
-import type { SpanTransport } from "./types.js";
-export type SpanSinkMode = "legacy" | "dual" | "otel";
-/** Parse `SENPI_SPANS_SINK`; unknown/unset → `dual` (the validation default). */
-export declare function resolveSpanSinkMode(value: string | undefined): SpanSinkMode;
-/** Compose the active transport from the two children per the sink mode. */
-export declare function composeSpanTransport(mode: SpanSinkMode, legacy: SpanTransport, recording: SpanTransport): SpanTransport;
-export declare function createPluginSpanTracker(apiKey: string | undefined): SpanTracker;
-//# sourceMappingURL=plugin-span-tracker.d.ts.map

package/dist/tracking/spans/plugin-span-tracker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin-span-tracker.d.ts","sourceRoot":"","sources":["../../../src/tracking/spans/plugin-span-tracker.ts"],"names":[],"mappings":"AA2BA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAQhD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtD,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAI3E;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,aAAa,GACvB,aAAa,CASf;AA8BD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,WAAW,CAsDb"}

package/dist/tracking/spans/plugin-span-tracker.js

@@ -1,115 +0,0 @@
-/**
- * Plugin-scoped SpanTracker factory.
- *
- * One SpanTracker is built at plugin register() and shared across all runtime
- * instances and OpenClaw hooks running inside this gateway. The transport is
- * authenticated with the gateway's single SENPI_API_KEY (one-gateway-per-user
- * deployment assumption).
- *
- * Span sink (OTEL v2 cutover): `SENPI_SPANS_SINK` selects where spans go —
- *   - `legacy` → POST /api/v1/tracking/spans (BatchingSpanTransport)
- *   - `dual`   → both, via FanOutSpanTransport (default; validation phase)
- *   - `otel`   → POST /v1/traces (RecordingSpanTransport → recording batcher)
- * Every transition is config-only (set the env var + restart); see the design
- * doc's cutover plan.
- */
-import { createLogger } from "../../utils/logger.js";
-import { TRACKING_API_BASE_URL } from "../constants.js";
-import { createBatcher, createTelemetryClient, resolveTransportConfig, } from "../../recording/transport/index.js";
-import { TRACES_PATH } from "../../recording/transport/config.js";
-import { BatchingSpanTransport, NoOpSpanTransport } from "./span-transport.js";
-import { FanOutSpanTransport } from "./fan-out-span-transport.js";
-import { RecordingSpanTransport } from "./otel/recording-span-transport.js";
-import { SpanTracker } from "./span-tracker.js";
-import { createOpenRedactionAdapter, setDefaultPiiRedactor, } from "./redact-pii.js";
-const logger = createLogger("[senpi-core][plugin-span-tracker]");
-/** Parse `SENPI_SPANS_SINK`; unknown/unset → `dual` (the validation default). */
-export function resolveSpanSinkMode(value) {
-    const v = value?.trim().toLowerCase();
-    if (v === "legacy" || v === "dual" || v === "otel")
-        return v;
-    return "dual";
-}
-/** Compose the active transport from the two children per the sink mode. */
-export function composeSpanTransport(mode, legacy, recording) {
-    switch (mode) {
-        case "legacy":
-            return legacy;
-        case "otel":
-            return recording;
-        case "dual":
-            return new FanOutSpanTransport([legacy, recording]);
-    }
-}
-/**
- * Register the process-wide default PII redactor at boot. Always on, no env gate:
- * `logger.event()` redact fields (free-text LLM reasoning, venue errors, raw signals)
- * are scrubbed on the live path. The same default redactor also covers the span path —
- * for spans this only ADDS scrubbing, never removes it.
- *
- * Fire-and-forget and never awaited, so it adds no boot latency and can't introduce a
- * boot failure mode. The OpenRedaction + bip39 imports are dynamic, so they cold-start
- * here; until the promise resolves `getDefaultPiiRedactor()` is null and the event path
- * fails safe (drops the fields rather than emitting them raw). On install failure the
- * redactor stays null — the fields keep being dropped, never leaked.
- */
-function initPiiRedactor() {
-    createOpenRedactionAdapter()
-        .then((redactor) => {
-        setDefaultPiiRedactor(redactor);
-        logger.info("PII redaction ready — event redact fields and spans scrubbed for emails, international phones (US/IN/CN/KR/JP/UK/BR/+intl), vendor API keys, EVM private keys, and BIP39 mnemonics before transport");
-    })
-        .catch((err) => {
-        logger.warn("PII redaction init failed — event evidence will be DROPPED (never emitted raw); check openredaction install", { err: err instanceof Error ? err.message : String(err) });
-    });
-}
-export function createPluginSpanTracker(apiKey) {
-    initPiiRedactor();
-    if (!apiKey) {
-        logger.warn("span telemetry disabled: set SENPI_API_KEY (or pass apiKey) so spans reach senpi-agent-telemetry; NoOpSpanTransport drops spans");
-        return new SpanTracker({ transport: new NoOpSpanTransport() });
-    }
-    const mode = resolveSpanSinkMode(process.env.SENPI_SPANS_SINK);
-    const trackingBaseUrl = process.env.SENPI_TRACKING_URL ?? TRACKING_API_BASE_URL;
-    // Build only the children the mode needs; the unused side is a cheap NoOp.
-    const legacy = mode === "otel"
-        ? new NoOpSpanTransport()
-        : new BatchingSpanTransport({ baseUrl: trackingBaseUrl, apiKey });
-    let recording;
-    if (mode === "legacy") {
-        recording = new NoOpSpanTransport();
-    }
-    else {
-        const otelConfig = resolveTransportConfig({ getToken: () => apiKey });
-        // DIAGNOSTIC: confirm exactly where the span batcher posts and with what.
-        logger.info("span otel transport target", {
-            baseUrl: otelConfig.baseUrl,
-            tracesPath: TRACES_PATH,
-            tokenPresent: Boolean(apiKey),
-            flushIntervalMs: otelConfig.flushIntervalMs,
-        });
-        const baseClient = createTelemetryClient(otelConfig);
-        // DIAGNOSTIC: log every trace send outcome (does it arrive? accepted? rejected? why?).
-        const loggingClient = {
-            sendTraces: async (rowsJson) => {
-                const res = await baseClient.sendTraces(rowsJson);
-                logger.info("span otel sendTraces result", {
-                    rows: rowsJson.length,
-                    outcome: res.outcome,
-                    status: res.status,
-                    accepted: res.accepted,
-                    rejected: res.rejected,
-                    errors: res.errors?.slice(0, 3),
-                });
-                return res;
-            },
-            sendLogs: (rowsJson) => baseClient.sendLogs(rowsJson),
-        };
-        recording = new RecordingSpanTransport({
-            batcher: createBatcher(otelConfig, loggingClient),
-        });
-    }
-    logger.info("span sink mode", { mode });
-    return new SpanTracker({ transport: composeSpanTransport(mode, legacy, recording) });
-}
-//# sourceMappingURL=plugin-span-tracker.js.map

package/dist/tracking/spans/plugin-span-tracker.js.map

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

package/dist/tracking/spans/span-tracker.d.ts

@@ -1,133 +0,0 @@
-import type { EmissionSource, SpanTransport } from "./types.js";
-export interface SpanContextFields {
-    correlationId?: string | null;
-    address?: string | null;
-    recipeName?: string | null;
-    runtimeId?: string | null;
-    runtimeVersion?: string | null;
-}
-export interface OpenLlmSpanInput extends SpanContextFields {
-    sessionKey: string;
-    runId: string;
-    emissionSource: EmissionSource;
-    startedAt?: number;
-    input: Record<string, unknown>;
-}
-export interface FinalizeLlmSpanInput extends SpanContextFields {
-    sessionKey: string;
-    runId: string;
-    output?: Record<string, unknown>;
-    error?: unknown;
-    model?: string | null;
-    tokensIn?: number | null;
-    tokensOut?: number | null;
-    costUsd?: number | null;
-}
-export interface OpenToolSpanInput extends SpanContextFields {
-    sessionKey: string;
-    runId: string;
-    emissionSource: EmissionSource;
-    toolCallId: string | null;
-    toolName: string;
-    toolInput?: Record<string, unknown>;
-    startedAt?: number;
-}
-export interface FinalizeToolSpanInput extends SpanContextFields {
-    sessionKey: string;
-    runId: string;
-    toolCallId: string | null;
-    toolName: string;
-    output?: unknown;
-    error?: unknown;
-    durationMs?: number;
-}
-export interface DirectLlmSpanInput extends SpanContextFields {
-    sessionKey: string;
-    runId: string;
-    startedAt: number;
-    endedAt: number;
-    model?: string | null;
-    tokensIn?: number | null;
-    tokensOut?: number | null;
-    costUsd?: number | null;
-    input: Record<string, unknown>;
-    output?: Record<string, unknown>;
-    error?: unknown;
-    parentSpanId?: string | null;
-}
-export interface DirectToolSpanInput extends SpanContextFields {
-    sessionKey: string;
-    runId: string;
-    toolCallId?: string | null;
-    toolName: string;
-    startedAt: number;
-    endedAt: number;
-    input?: Record<string, unknown>;
-    output?: unknown;
-    error?: unknown;
-    parentSpanId?: string | null;
-}
-export interface OpenSubagentInput extends SpanContextFields {
-    hostSessionKey: string;
-    hostRunId: string;
-    childSessionKey: string;
-    parentSpanId: string | null;
-    input: Record<string, unknown>;
-    startedAt?: number;
-}
-export interface MergeSubagentInput {
-    childSessionKey: string;
-    /** Status to record (e.g., "spawned", "delivery_target"). */
-    status: string;
-    /** Additional fields to merge into `data` (e.g., delivery metadata). */
-    patch?: Record<string, unknown>;
-}
-export interface FinalizeSubagentInput {
-    childSessionKey: string;
-    status: string;
-    output?: Record<string, unknown>;
-    error?: unknown;
-}
-export interface AgentEndInput extends SpanContextFields {
-    sessionKey: string;
-    runId: string;
-    outcome?: unknown;
-    error?: unknown;
-}
-export interface SpanTrackerOptions {
-    transport: SpanTransport;
-    /** Override Date.now for tests. */
-    now?: () => number;
-    staleTimeoutMs?: number;
-    sweepIntervalMs?: number;
-    /** Start the periodic stale sweeper. Set false in tests for determinism. */
-    enableSweeper?: boolean;
-}
-export declare class SpanTracker {
-    private readonly transport;
-    private readonly now;
-    private readonly staleTimeoutMs;
-    private readonly openSpans;
-    private readonly openSubagents;
-    private toolSeq;
-    private sweepTimer;
-    constructor(options: SpanTrackerOptions);
-    openLlmSpan(input: OpenLlmSpanInput): string;
-    finalizeLlmSpan(input: FinalizeLlmSpanInput): void;
-    /** Returns the id of the currently-open LLM span for (session, run), or null. */
-    getActiveLlmSpanId(sessionKey: string, runId: string): string | null;
-    openToolSpan(input: OpenToolSpanInput): string;
-    finalizeToolSpan(input: FinalizeToolSpanInput): void;
-    openSubagentSpan(input: OpenSubagentInput): string;
-    /** Merge fields into an existing subagent (e.g., on _spawned, _delivery_target). Lazy-creates if missing. */
-    mergeSubagentSpan(input: MergeSubagentInput, context?: SpanContextFields): void;
-    finalizeSubagentSpan(input: FinalizeSubagentInput, context?: SpanContextFields): void;
-    captureAgentEnd(input: AgentEndInput): void;
-    captureLlmSpan(input: DirectLlmSpanInput): void;
-    captureToolSpan(input: DirectToolSpanInput): void;
-    sweepStale(): void;
-    shutdown(): Promise<void>;
-    private enqueueOrphan;
-    private enqueueSubagentOrphan;
-}
-//# sourceMappingURL=span-tracker.d.ts.map

package/dist/tracking/spans/span-tracker.d.ts.map

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