@senpi/runtime 1.1.0-dev.runtime-phase-2.20260610130051 → 1.1.0-dev.runtime-phase-2.20260611115723

package/dist/tracking/position-id-registry.js

@@ -0,0 +1,133 @@
+/**
+ * PositionIdRegistry: cross-flow position.id state machine.
+ *
+ * Sibling of the intra-flow correlation_id in src/tracking/context.ts. Keyed on
+ * (wallet, dex, asset).
+ *
+ * **Mint-at-intent.** A stable position.id is minted the moment the runtime decides to
+ * open ({@link mintOnIntent}), so it is already on the `action.open` emit — the open
+ * trace correlates by position.id directly, and even a sub-minute open+close (which the
+ * tracker poll never observes) still has a lifecycle.
+ *
+ * Two internal phases:
+ *  - `pending` — minted at intent, awaiting a confirmed open. In-memory only: the id is
+ *    a best-effort realtime grouping hint, not durable truth (post-hoc correlation
+ *    anchors on order ids against the venue ledger). A stale pending (order submitted
+ *    but never observed filling within {@link PENDING_OPEN_STALE_MS}) is lazily
+ *    discarded at the next read, so an abandoned intent never chains onto an unrelated
+ *    lifecycle hours later.
+ *  - `entries` — confirmed open. Reused for INCREASED/DECREASED/FLIPPED and DSL reads;
+ *    cleared on POSITION_CLOSED. Never staled.
+ *
+ * {@link mintOnOpened} promotes a pending intent-mint to a confirmed entry (reusing the
+ * id), or mints fresh for an externally-opened position with no prior intent.
+ *
+ * **Restart behavior.** Confirmed entries are rehydrated at boot from persisted DSL
+ * states ({@link rehydrate}). Pendings are not persisted: a restart inside the
+ * submit→observe window (~one tracker poll) loses the intent-mint and the tracker mints
+ * fresh on observation — a rare, accepted lifecycle split that downstream ledger
+ * reconciliation can heal via order ids.
+ */
+import { randomUUID } from "node:crypto";
+import { createLogger } from "../utils/logger.js";
+const logger = createLogger("[tracking][position-id]");
+/** Age beyond which an unconfirmed intent-mint is considered abandoned (order never filled). */
+export const PENDING_OPEN_STALE_MS = 30 * 60 * 1000;
+/**
+ * Build the registry key for a position. Normalizes dex the same way the
+ * position-tracker scanner's buildPositionKey does (empty/whitespace → "main"),
+ * scoped by wallet so the map is correct under multi-wallet deployment.
+ */
+export function positionRegistryKey(wallet, dex, asset) {
+    const normalizedDex = dex.trim() || "main";
+    return `${wallet}|${normalizedDex}:${asset}`;
+}
+export class PositionIdRegistry {
+    entries = new Map();
+    /** Positions minted at intent, awaiting a confirmed open. */
+    pending = new Map();
+    now;
+    staleMs;
+    constructor(opts = {}) {
+        this.now = opts.now ?? Date.now;
+        this.staleMs = opts.staleMs ?? PENDING_OPEN_STALE_MS;
+    }
+    /**
+     * Mint a position.id at the moment the runtime decides to open, before the position
+     * is confirmed open. The id is returned immediately so callers can stamp it on the
+     * `action.open` emit. Idempotent: a re-submit (or an already-confirmed entry) reuses
+     * the existing id rather than minting a new one.
+     */
+    mintOnIntent(key) {
+        const confirmed = this.entries.get(key);
+        if (confirmed)
+            return confirmed;
+        const existing = this.livePending(key);
+        if (existing)
+            return { positionId: existing.positionId };
+        const positionId = randomUUID();
+        this.pending.set(key, { positionId, ts: this.now() });
+        return { positionId };
+    }
+    /**
+     * Confirm the open. Idempotent: if a confirmed entry already exists it is returned.
+     * If the position was minted at intent (and the intent is not stale), that id is
+     * promoted (reused, never re-minted) and the pending record dropped. Otherwise — an
+     * externally-opened position with no prior runtime intent — a fresh id is minted.
+     */
+    mintOnOpened(key) {
+        const existing = this.entries.get(key);
+        if (existing)
+            return existing;
+        const pending = this.livePending(key);
+        const entry = pending
+            ? { positionId: pending.positionId }
+            : { positionId: randomUUID() };
+        this.entries.set(key, entry);
+        this.pending.delete(key);
+        return entry;
+    }
+    /**
+     * Read the current entry for a key (INCREASED/DECREASED/FLIPPED, DSL start, recording
+     * reads). Surfaces an intent-mint that has not yet been confirmed open, so reads in
+     * the open window still resolve the position.id.
+     */
+    get(key) {
+        const confirmed = this.entries.get(key);
+        if (confirmed)
+            return confirmed;
+        const pending = this.livePending(key);
+        return pending ? { positionId: pending.positionId } : undefined;
+    }
+    /** Clear on confirmed close. The next open on this key mints a fresh id. */
+    clearOnClosed(key) {
+        this.entries.delete(key);
+        this.pending.delete(key);
+    }
+    /** Repopulate confirmed entries at boot from persisted DSL states. */
+    rehydrate(items) {
+        for (const item of items) {
+            this.entries.set(item.key, item.entry);
+        }
+    }
+    /**
+     * The pending record for a key, unless it has gone stale — an intent whose order
+     * never filled within the stale window is discarded on read (and a fresh mint
+     * follows), so an abandoned submit's id never attaches to a later, unrelated open.
+     */
+    livePending(key) {
+        const pending = this.pending.get(key);
+        if (!pending)
+            return undefined;
+        if (this.now() - pending.ts > this.staleMs) {
+            this.pending.delete(key);
+            logger.warn("discarding stale pending position.id (order never confirmed filling); minting fresh", {
+                key,
+                ageMs: this.now() - pending.ts,
+            });
+            return undefined;
+        }
+        return pending;
+    }
+}
+//# sourceMappingURL=position-id-registry.js.map

package/dist/tracking/position-id-registry.js.map

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

package/dist/tracking/spans/fan-out-span-transport.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Fan-out span transport — ships every span to N child transports.
+ *
+ * Used during the dual-write phase of the OTEL v2 cutover: the legacy
+ * `BatchingSpanTransport` (→ /api/v1/tracking/spans) and the new
+ * `RecordingSpanTransport` (→ /v1/traces) both receive every span.
+ *
+ * Isolation is load-bearing: a throw/rejection in one child must never starve
+ * the other, and `enqueue` must never throw back into the SpanTracker (which
+ * runs on the hook path). `flush`/`shutdown` await all children and never
+ * reject — a failing child is logged and swallowed.
+ */
+import type { SpanTransport, TrackingSpan } from "./types.js";
+export declare class FanOutSpanTransport implements SpanTransport {
+    private readonly children;
+    constructor(children: SpanTransport[]);
+    enqueue(span: TrackingSpan): void;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+    private allSettled;
+}
+//# sourceMappingURL=fan-out-span-transport.d.ts.map

package/dist/tracking/spans/fan-out-span-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fan-out-span-transport.d.ts","sourceRoot":"","sources":["../../../src/tracking/spans/fan-out-span-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK9D,qBAAa,mBAAoB,YAAW,aAAa;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,aAAa,EAAE;IAEtD,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAY3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAIjB,UAAU;CAazB"}

package/dist/tracking/spans/fan-out-span-transport.js

@@ -0,0 +1,49 @@
+/**
+ * Fan-out span transport — ships every span to N child transports.
+ *
+ * Used during the dual-write phase of the OTEL v2 cutover: the legacy
+ * `BatchingSpanTransport` (→ /api/v1/tracking/spans) and the new
+ * `RecordingSpanTransport` (→ /v1/traces) both receive every span.
+ *
+ * Isolation is load-bearing: a throw/rejection in one child must never starve
+ * the other, and `enqueue` must never throw back into the SpanTracker (which
+ * runs on the hook path). `flush`/`shutdown` await all children and never
+ * reject — a failing child is logged and swallowed.
+ */
+import { createLogger } from "../../utils/logger.js";
+const logger = createLogger("[senpi-core][fan-out-span-transport]");
+export class FanOutSpanTransport {
+    children;
+    constructor(children) {
+        this.children = children;
+    }
+    enqueue(span) {
+        for (const child of this.children) {
+            try {
+                child.enqueue(span);
+            }
+            catch (err) {
+                logger.warn("child transport enqueue threw; swallowed", {
+                    err: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+    }
+    async flush() {
+        await this.allSettled((c) => c.flush(), "flush");
+    }
+    async shutdown() {
+        await this.allSettled((c) => c.shutdown(), "shutdown");
+    }
+    async allSettled(op, label) {
+        const results = await Promise.allSettled(this.children.map((c) => op(c)));
+        for (const r of results) {
+            if (r.status === "rejected") {
+                logger.warn(`child transport ${label} rejected; swallowed`, {
+                    err: r.reason instanceof Error ? r.reason.message : String(r.reason),
+                });
+            }
+        }
+    }
+}
+//# sourceMappingURL=fan-out-span-transport.js.map

package/dist/tracking/spans/fan-out-span-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fan-out-span-transport.js","sourceRoot":"","sources":["../../../src/tracking/spans/fan-out-span-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,MAAM,GAAG,YAAY,CAAC,sCAAsC,CAAC,CAAC;AAEpE,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,QAAyB;QAAzB,aAAQ,GAAR,QAAQ,CAAiB;IAAG,CAAC;IAE1D,OAAO,CAAC,IAAkB;QACxB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE;oBACtD,GAAG,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBACtD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,UAAU,CAAC,CAAC;IACzD,CAAC;IAEO,KAAK,CAAC,UAAU,CACtB,EAA2C,EAC3C,KAAa;QAEb,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1E,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBAC5B,MAAM,CAAC,IAAI,CAAC,mBAAmB,KAAK,sBAAsB,EAAE;oBAC1D,GAAG,EAAE,CAAC,CAAC,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;iBACrE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/tracking/spans/otel/map-span-to-trace-row.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Pure `TrackingSpan → TraceRow` mapper.
+ *
+ * Maps the agent-span envelope onto the OTEL v2 HyperDX-row shape so agent spans
+ * land in `otel_traces` alongside scanner/runtime traces. The caller is expected
+ * to have already redacted + truncated `span.data` (see RecordingSpanTransport);
+ * this function performs no redaction and no I/O.
+ *
+ * Bounding: per-field size is the caller's responsibility (truncateSpanData,
+ * 2 MB/field) and the batcher's 8 MB body cap — so this does NOT impose the
+ * small AttrBuilder caps (4 KB/value), which would gut large LLM payloads.
+ */
+import type { TraceRow } from "../../../recording/transport/rows.js";
+import type { TrackingSpan } from "../types.js";
+export declare function trackingSpanToTraceRow(span: TrackingSpan): TraceRow;
+//# sourceMappingURL=map-span-to-trace-row.d.ts.map

package/dist/tracking/spans/otel/map-span-to-trace-row.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-span-to-trace-row.d.ts","sourceRoot":"","sources":["../../../../src/tracking/spans/otel/map-span-to-trace-row.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAwB,MAAM,sCAAsC,CAAC;AAE3F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA4EhD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,CA8DnE"}

package/dist/tracking/spans/otel/map-span-to-trace-row.js

@@ -0,0 +1,137 @@
+/**
+ * Pure `TrackingSpan → TraceRow` mapper.
+ *
+ * Maps the agent-span envelope onto the OTEL v2 HyperDX-row shape so agent spans
+ * land in `otel_traces` alongside scanner/runtime traces. The caller is expected
+ * to have already redacted + truncated `span.data` (see RecordingSpanTransport);
+ * this function performs no redaction and no I/O.
+ *
+ * Bounding: per-field size is the caller's responsibility (truncateSpanData,
+ * 2 MB/field) and the batcher's 8 MB body cap — so this does NOT impose the
+ * small AttrBuilder caps (4 KB/value), which would gut large LLM payloads.
+ */
+import { msToNs, durationNs } from "../../../recording/otel/attributes.js";
+import { deriveTraceId, deriveSpanId, deriveParentSpanId } from "./span-ids.js";
+const SERVICE_NAME = "senpi-trading-runtime";
+const SCOPE_NAME = "senpi.otel";
+const SCOPE_VERSION = "2.0.0";
+function asRecord(v) {
+    return v && typeof v === "object" && !Array.isArray(v)
+        ? v
+        : undefined;
+}
+function nonEmpty(v) {
+    return typeof v === "string" && v.length > 0 ? v : undefined;
+}
+/** Set a string attribute, omitting null/undefined/empty. `0` survives (meaningful). */
+function putStr(map, key, value) {
+    if (value === null || value === undefined || value === "")
+        return;
+    map[key] = String(value);
+}
+/** Set one attribute per top-level `data` key: scalars as String, objects/arrays as JSON. */
+function putDataValue(map, key, value) {
+    if (value === undefined)
+        return;
+    if (value === null)
+        return;
+    if (typeof value === "object") {
+        try {
+            const s = JSON.stringify(value);
+            if (s !== undefined)
+                map[key] = s;
+        }
+        catch {
+            /* unserializable — drop the one key, not the row */
+        }
+        return;
+    }
+    map[key] = String(value);
+}
+function spanName(span) {
+    const data = asRecord(span.data);
+    switch (span.spanType) {
+        case "llm":
+            return nonEmpty(span.model) ? `llm ${span.model}` : "llm";
+        case "tool": {
+            const name = nonEmpty(data?.tool_name) ?? nonEmpty(data?.toolName);
+            return name ? `tool ${name}` : "tool";
+        }
+        case "subagent": {
+            const agentId = nonEmpty(asRecord(data?.input)?.agentId) ?? nonEmpty(data?.agentId);
+            return agentId ? `subagent ${agentId}` : "subagent";
+        }
+        case "agent_end":
+            return "agent.end";
+        default:
+            return span.spanType;
+    }
+}
+function spanKind(spanType) {
+    return spanType === "llm" || spanType === "tool" ? "Client" : "Internal";
+}
+/** Child run id rides in the delivery patch (subagent_delivery_target) or the spawned patch. */
+function childRunId(data) {
+    return (nonEmpty(asRecord(data?.delivery)?.childRunId) ??
+        nonEmpty(data?.childRunId) ??
+        nonEmpty(data?.runId));
+}
+export function trackingSpanToTraceRow(span) {
+    const data = asRecord(span.data);
+    const error = nonEmpty(data?.error);
+    const address = span.address.toLowerCase();
+    const status = error !== undefined ? "Error" : "Ok";
+    const resourceAttributes = { "service.name": SERVICE_NAME };
+    putStr(resourceAttributes, "strategy.address", address);
+    putStr(resourceAttributes, "recipe.name", span.recipeName);
+    putStr(resourceAttributes, "runtime.id", span.runtimeId);
+    putStr(resourceAttributes, "runtime.version", span.runtimeVersion);
+    // user.id is intentionally NOT set — the /v1/traces route server-stamps it.
+    const spanAttributes = {};
+    putStr(spanAttributes, "span.type", span.spanType);
+    putStr(spanAttributes, "emission.source", span.emissionSource);
+    putStr(spanAttributes, "session.key", span.sessionKey);
+    putStr(spanAttributes, "run.id", span.runId);
+    putStr(spanAttributes, "correlation.id", span.correlationId);
+    putStr(spanAttributes, "child.session.key", span.childSessionKey);
+    putStr(spanAttributes, "tool.call_id", span.toolCallId);
+    putStr(spanAttributes, "tool.name", nonEmpty(data?.tool_name) ?? nonEmpty(data?.toolName));
+    putStr(spanAttributes, "gen_ai.request.model", span.model);
+    putStr(spanAttributes, "gen_ai.usage.input_tokens", span.tokensIn);
+    putStr(spanAttributes, "gen_ai.usage.output_tokens", span.tokensOut);
+    putStr(spanAttributes, "cost.usd", span.costUsd);
+    // Mega-trace breadcrumb: lets a downstream view stitch the subagent's own
+    // (separate) trace back onto the host. child.session.key is always present;
+    // child.run_id depends on the spawned/delivery hooks having fired.
+    if (span.spanType === "subagent") {
+        putStr(spanAttributes, "subagent.child_session_key", span.childSessionKey);
+        putStr(spanAttributes, "subagent.child_run_id", childRunId(data));
+    }
+    // Flatten the payload bag one level: each top-level data key → one attribute.
+    if (data) {
+        for (const [k, v] of Object.entries(data)) {
+            putDataValue(spanAttributes, `data.${k}`, v);
+        }
+    }
+    return {
+        Timestamp: msToNs(span.startedAt),
+        TraceId: deriveTraceId(span.runId),
+        SpanId: deriveSpanId(span.id),
+        ParentSpanId: deriveParentSpanId(span.parentSpanId),
+        TraceState: "",
+        SpanName: spanName(span),
+        SpanKind: spanKind(span.spanType),
+        ServiceName: SERVICE_NAME,
+        Duration: durationNs(span.startedAt, span.endedAt),
+        StatusCode: status,
+        StatusMessage: error ?? "",
+        SpanAttributes: spanAttributes,
+        ResourceAttributes: resourceAttributes,
+        Events: [],
+        ScopeName: SCOPE_NAME,
+        ScopeVersion: SCOPE_VERSION,
+        TraceFlags: 1,
+        address,
+    };
+}
+//# sourceMappingURL=map-span-to-trace-row.js.map

package/dist/tracking/spans/otel/map-span-to-trace-row.js.map

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

package/dist/tracking/spans/otel/recording-span-transport.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 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 type { SpanTransport, TrackingSpan } from "../types.js";
+import type { TelemetryBatcher } from "../../../recording/transport/index.js";
+import { type PiiRedactor } from "../redact-pii.js";
+export interface RecordingSpanTransportOptions {
+    batcher: TelemetryBatcher;
+    /**
+     * PII redactor. Omit (`undefined`) to look up the process-wide default at use
+     * time (handles async redactor init); pass `null` to disable redaction
+     * explicitly (tests/local dev).
+     */
+    redactor?: PiiRedactor | null;
+}
+export declare class RecordingSpanTransport implements SpanTransport {
+    private readonly batcher;
+    private readonly redactorOverride;
+    private readonly pending;
+    constructor(options: RecordingSpanTransportOptions);
+    enqueue(span: TrackingSpan): void;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+    /** Truncate → redact → map → enqueue. Self-contained; never throws. */
+    private process;
+    private drainPending;
+}
+//# sourceMappingURL=recording-span-transport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recording-span-transport.d.ts","sourceRoot":"","sources":["../../../../src/tracking/spans/otel/recording-span-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,OAAO,EACL,KAAK,WAAW,EAGjB,MAAM,kBAAkB,CAAC;AAM1B,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,gBAAgB,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CAC/B;AAED,qBAAa,sBAAuB,YAAW,aAAa;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAiC;IAClE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;gBAExC,OAAO,EAAE,6BAA6B;IAKlD,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAK3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/B,uEAAuE;YACzD,OAAO;YAgBP,YAAY;CAG3B"}

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

@@ -0,0 +1,64 @@
+/**
+ * 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 { 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;
+            this.batcher.enqueueTrace(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

@@ -0,0 +1 @@
+{"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,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,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC;QAC7D,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

@@ -0,0 +1,22 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,32 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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,3 +1,9 @@
 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 +1 @@
-{"version":3,"file":"plugin-span-tracker.d.ts","sourceRoot":"","sources":["../../../src/tracking/spans/plugin-span-tracker.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAuChD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,WAAW,CAYb"}
+{"version":3,"file":"plugin-span-tracker.d.ts","sourceRoot":"","sources":["../../../src/tracking/spans/plugin-span-tracker.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAShD,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;AAgCD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,WAAW,CA2Bb"}