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

package/dist/tracking/spans/constants.js

@@ -1,28 +1,9 @@
 /**
- * Span telemetry constants: API path, batching thresholds, orphan-sweep timings.
+ * Span telemetry constants.
+ *
+ * Header names used to cross the runtime → OpenClaw HTTP boundary so the
+ * gateway-side hooks can stamp senpi identity onto the gen_ai spans.
  */
-export const SPANS_API_PATH = "/api/v1/tracking/spans";
-// Transport batching — mirrors the events transport defaults.
-export const FLUSH_INTERVAL_MS = 10_000;
-export const FLUSH_THRESHOLD = 50;
-export const MAX_BUFFER_SIZE = 500;
-// In-memory span lifecycle — sweep abandoned spans so they don't accumulate.
-export const STALE_TIMEOUT_MS = 5 * 60_000;
-export const SWEEP_INTERVAL_MS = 60_000;
-// Per-batch byte budget. We pack spans into a request until adding the next
-// one would push us over this, then flush. Sized to fit comfortably under the
-// ingest server's 10MB Fastify bodyLimit (set in senpi-agent-telemetry).
-export const MAX_BATCH_BYTES = 8_000_000;
-// Per-field byte cap for span.data top-level values. Acts as a safety net for
-// genuinely pathological outputs (e.g. an `exec` that printed a multi-MB log,
-// or a tool that returned a raw binary blob). Real chat-history payloads flow
-// through unchanged after sanitize-payload strips framework metadata.
-// Combined with the ingest server's 10MB body limit, only truly oversized
-// fields trip this.
-export const MAX_SPAN_FIELD_BYTES = 2_000_000;
-/** First N chars of each truncated value retained for debugging context. */
-export const TRUNCATED_PREVIEW_BYTES = 2_000;
-// Header names used to cross the runtime → OpenClaw HTTP boundary.
 export const HEADER_CORRELATION_ID = "x-senpi-correlation-id";
 export const HEADER_ADDRESS = "x-senpi-address";
 export const HEADER_RECIPE_NAME = "x-senpi-recipe-name";

package/dist/tracking/spans/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/tracking/spans/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,wBAAwB,CAAC;AAEvD,8DAA8D;AAC9D,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AACxC,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC;AAEnC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAG,MAAM,CAAC;AAC3C,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAExC,4EAA4E;AAC5E,8EAA8E;AAC9E,yEAAyE;AACzE,MAAM,CAAC,MAAM,eAAe,GAAG,SAAS,CAAC;AAEzC,8EAA8E;AAC9E,8EAA8E;AAC9E,8EAA8E;AAC9E,sEAAsE;AACtE,0EAA0E;AAC1E,oBAAoB;AACpB,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC;AAC9C,4EAA4E;AAC5E,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAE7C,mEAAmE;AACnE,MAAM,CAAC,MAAM,qBAAqB,GAAG,wBAAwB,CAAC;AAC9D,MAAM,CAAC,MAAM,cAAc,GAAG,iBAAiB,CAAC;AAChD,MAAM,CAAC,MAAM,kBAAkB,GAAG,qBAAqB,CAAC;AACxD,MAAM,CAAC,MAAM,iBAAiB,GAAG,oBAAoB,CAAC;AACtD,MAAM,CAAC,MAAM,sBAAsB,GAAG,yBAAyB,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/tracking/spans/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,wBAAwB,CAAC;AAC9D,MAAM,CAAC,MAAM,cAAc,GAAG,iBAAiB,CAAC;AAChD,MAAM,CAAC,MAAM,kBAAkB,GAAG,qBAAqB,CAAC;AACxD,MAAM,CAAC,MAAM,iBAAiB,GAAG,oBAAoB,CAAC;AACtD,MAAM,CAAC,MAAM,sBAAsB,GAAG,yBAAyB,CAAC"}

package/dist/tracking/spans/gen-ai.d.ts

@@ -0,0 +1,70 @@
+/**
+ * gen_ai / MCP span mapping — the one place that turns extracted hook content (or on-site
+ * MCP call data) into OpenTelemetry GenAI/MCP semantic-convention span attributes (the
+ * `GEN_AI` keys below). Standard keys only — no OpenClaw `openclaw.content.*` mirror, no
+ * OpenInference `input.value`/`output.value` aliases; `gen_ai.system_instructions` is the
+ * spec's underscore form.
+ *
+ * Content (messages, system instructions, tool args/result) is the highest-PII surface, so
+ * it is always redacted *before* stamping and capped *after* (sanitize → redact → cap) so a
+ * truncated value can't re-expose a partial secret. If the redactor fails to load, content is
+ * dropped rather than emitted unredacted.
+ */
+import type { Attributes, Span } from "@opentelemetry/api";
+/**
+ * Max chars per content attribute value, applied after redaction. A transport-safety
+ * cap that sits far under the OTLP/HTTP request-body limit (~20 MiB), not a backend
+ * storage limit — content this size is rare and we'd rather truncate than risk a
+ * rejected export.
+ */
+export declare const MAX_OTEL_CONTENT_ATTRIBUTE_CHARS: number;
+/** Max items per message / tool-definition array, applied after redaction. */
+export declare const MAX_OTEL_CONTENT_ARRAY_ITEMS = 200;
+export declare const GEN_AI: {
+    readonly OPERATION_NAME: "gen_ai.operation.name";
+    readonly PROVIDER_NAME: "gen_ai.provider.name";
+    readonly REQUEST_MODEL: "gen_ai.request.model";
+    readonly REQUEST_TEMPERATURE: "gen_ai.request.temperature";
+    readonly REQUEST_MAX_TOKENS: "gen_ai.request.max_tokens";
+    readonly RESPONSE_MODEL: "gen_ai.response.model";
+    readonly RESPONSE_FINISH_REASONS: "gen_ai.response.finish_reasons";
+    readonly USAGE_INPUT_TOKENS: "gen_ai.usage.input_tokens";
+    readonly USAGE_OUTPUT_TOKENS: "gen_ai.usage.output_tokens";
+    readonly SYSTEM_INSTRUCTIONS: "gen_ai.system_instructions";
+    readonly INPUT_MESSAGES: "gen_ai.input.messages";
+    readonly OUTPUT_MESSAGES: "gen_ai.output.messages";
+    readonly TOOL_DEFINITIONS: "gen_ai.tool.definitions";
+    readonly AGENT_NAME: "gen_ai.agent.name";
+    readonly TOOL_NAME: "gen_ai.tool.name";
+    readonly TOOL_CALL_ID: "gen_ai.tool.call.id";
+    readonly TOOL_CALL_ARGUMENTS: "gen_ai.tool.call.arguments";
+    readonly TOOL_CALL_RESULT: "gen_ai.tool.call.result";
+};
+/** Reset the cached redactor (tests only). */
+export declare function __resetContentRedactorForTest(): void;
+/**
+ * Turn a content value into a capped JSON string with PII redacted: sanitize framework
+ * metadata, redact (when a redactor is available), then serialize within the caps.
+ * Array content keeps the newest items (dropping oldest with a visible elision marker,
+ * so the result stays valid JSON); non-array content is tail-truncated with a suffix.
+ * Returns `undefined` when the value is empty. Never throws — a failure drops the value.
+ */
+export declare function redactAndCapContent(value: unknown): Promise<string | undefined>;
+/** Redact + cap a content value and stamp it onto the span (when capture is on and non-empty). */
+export declare function setGenAiContentAttribute(span: Span, key: string, value: unknown): Promise<void>;
+/** Set every defined value in `attrs` on the span, skipping undefined/null. Never throws. */
+export declare function setDefinedAttributes(span: Span, attrs: Attributes): void;
+/** Low-cardinality `error.type` for the spec: error.name, the string itself, else "_OTHER". */
+export declare function errorTypeOf(error: unknown): string;
+/**
+ * Mark a span as failed: record the exception, set ERROR status, and stamp the spec's
+ * low-cardinality `error.type`. Never throws.
+ */
+export declare function recordSpanError(span: Span, error: unknown): void;
+/** First finite number among the candidates, else undefined. */
+export declare function firstNumber(...values: unknown[]): number | undefined;
+/** Normalize a finish-reason value to a string array (gen_ai.response.finish_reasons is an array). */
+export declare function toFinishReasons(value: unknown): string[] | undefined;
+/** Normalize a list of raw provider messages into spec `{ role, parts }` objects. */
+export declare function normalizeGenAiMessages(value: unknown, fallbackRole: "user" | "assistant"): Array<Record<string, unknown>> | undefined;
+//# sourceMappingURL=gen-ai.d.ts.map

package/dist/tracking/spans/gen-ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gen-ai.d.ts","sourceRoot":"","sources":["../../../src/tracking/spans/gen-ai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAc3D;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,QAAa,CAAC;AAC3D,8EAA8E;AAC9E,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAMhD,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;CAmBT,CAAC;AAyBX,8CAA8C;AAC9C,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD;AA+CD;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAyBrF;AAED,kGAAkG;AAClG,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,IAAI,CAAC,CASf;AAID,6FAA6F;AAC7F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAQxE;AAED,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIlD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAWhE;AAID,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,GAAG,SAAS,CAKpE;AAED,sGAAsG;AACtG,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAQpE;AAgGD,qFAAqF;AACrF,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,MAAM,GAAG,WAAW,GACjC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAQ5C"}

package/dist/tracking/spans/gen-ai.js

@@ -0,0 +1,330 @@
+/**
+ * gen_ai / MCP span mapping — the one place that turns extracted hook content (or on-site
+ * MCP call data) into OpenTelemetry GenAI/MCP semantic-convention span attributes (the
+ * `GEN_AI` keys below). Standard keys only — no OpenClaw `openclaw.content.*` mirror, no
+ * OpenInference `input.value`/`output.value` aliases; `gen_ai.system_instructions` is the
+ * spec's underscore form.
+ *
+ * Content (messages, system instructions, tool args/result) is the highest-PII surface, so
+ * it is always redacted *before* stamping and capped *after* (sanitize → redact → cap) so a
+ * truncated value can't re-expose a partial secret. If the redactor fails to load, content is
+ * dropped rather than emitted unredacted.
+ */
+import { SpanStatusCode } from "@opentelemetry/api";
+import { createLogger } from "../../utils/logger.js";
+import { createOpenRedactionAdapter, redactStringsDeep, } from "./redact-pii.js";
+import { sanitizePayloadValue } from "./sanitize-payload.js";
+const logger = createLogger("[senpi-core][gen-ai]");
+// ─── Caps ─────────────────────────────────────────────────────────────────────
+/**
+ * Max chars per content attribute value, applied after redaction. A transport-safety
+ * cap that sits far under the OTLP/HTTP request-body limit (~20 MiB), not a backend
+ * storage limit — content this size is rare and we'd rather truncate than risk a
+ * rejected export.
+ */
+export const MAX_OTEL_CONTENT_ATTRIBUTE_CHARS = 256 * 1024;
+/** Max items per message / tool-definition array, applied after redaction. */
+export const MAX_OTEL_CONTENT_ARRAY_ITEMS = 200;
+/** Suffix appended when a non-array (string/object) value is tail-truncated to fit the cap. */
+const TRUNCATION_SUFFIX = "…[truncated]";
+// ─── GenAI semantic-convention attribute keys ────────────────────────────────
+export const GEN_AI = {
+    OPERATION_NAME: "gen_ai.operation.name",
+    PROVIDER_NAME: "gen_ai.provider.name",
+    REQUEST_MODEL: "gen_ai.request.model",
+    REQUEST_TEMPERATURE: "gen_ai.request.temperature",
+    REQUEST_MAX_TOKENS: "gen_ai.request.max_tokens",
+    RESPONSE_MODEL: "gen_ai.response.model",
+    RESPONSE_FINISH_REASONS: "gen_ai.response.finish_reasons",
+    USAGE_INPUT_TOKENS: "gen_ai.usage.input_tokens",
+    USAGE_OUTPUT_TOKENS: "gen_ai.usage.output_tokens",
+    SYSTEM_INSTRUCTIONS: "gen_ai.system_instructions",
+    INPUT_MESSAGES: "gen_ai.input.messages",
+    OUTPUT_MESSAGES: "gen_ai.output.messages",
+    TOOL_DEFINITIONS: "gen_ai.tool.definitions",
+    AGENT_NAME: "gen_ai.agent.name",
+    TOOL_NAME: "gen_ai.tool.name",
+    TOOL_CALL_ID: "gen_ai.tool.call.id",
+    TOOL_CALL_ARGUMENTS: "gen_ai.tool.call.arguments",
+    TOOL_CALL_RESULT: "gen_ai.tool.call.result",
+};
+// ─── Content redactor (always on) ────────────────────────────────────────────
+let redactorPromise = null;
+/**
+ * Lazily build (once) the shared content redactor. Cached after first call so the
+ * OpenRedaction `enableCache` amortises multi-turn runs. Returns null only if the
+ * adapter fails to load (logged once) — callers then drop the content rather than
+ * emit it unredacted.
+ */
+async function getContentRedactor() {
+    if (redactorPromise === null) {
+        redactorPromise = createOpenRedactionAdapter().catch((err) => {
+            logger.warn("content redactor init failed; gen_ai content will be dropped until restart", err instanceof Error ? err : new Error(String(err)));
+            return null;
+        });
+    }
+    return redactorPromise;
+}
+/** Reset the cached redactor (tests only). */
+export function __resetContentRedactorForTest() {
+    redactorPromise = null;
+}
+// ─── Redact → cap → serialize ────────────────────────────────────────────────
+/** Build the elision marker prepended when older array elements are dropped. */
+function elisionMarker(droppedCount) {
+    return {
+        role: "system",
+        parts: [{ type: "text", content: `[${droppedCount} earlier messages elided]` }],
+    };
+}
+/**
+ * Cap an array (e.g. message history) keeping the NEWEST content. Trims the item count
+ * to the last {@link MAX_OTEL_CONTENT_ARRAY_ITEMS}, then — when the serialized JSON still
+ * exceeds the char cap — drops whole elements from the front (oldest) until it fits,
+ * prepending a single elision marker so the gap is visible. Returns the serialized string.
+ */
+function serializeArrayWithCap(value) {
+    let items = value.length > MAX_OTEL_CONTENT_ARRAY_ITEMS
+        ? value.slice(value.length - MAX_OTEL_CONTENT_ARRAY_ITEMS)
+        : value.slice();
+    const itemsTrimmed = value.length - items.length;
+    let dropped = 0;
+    let serialized = JSON.stringify(items);
+    while (serialized.length > MAX_OTEL_CONTENT_ATTRIBUTE_CHARS && items.length > 0) {
+        items.shift();
+        dropped += 1;
+        serialized = JSON.stringify([elisionMarker(itemsTrimmed + dropped), ...items]);
+    }
+    if (dropped > 0)
+        return serialized;
+    if (itemsTrimmed > 0)
+        return JSON.stringify([elisionMarker(itemsTrimmed), ...items]);
+    return serialized;
+}
+/**
+ * Tail-truncate a non-array serialized string to the char cap and append a compact
+ * suffix. Acceptable for non-cumulative values (system instructions, tool args/result)
+ * where the attribute is a plain string, not history we need to keep parseable.
+ */
+function capString(serialized) {
+    if (serialized.length <= MAX_OTEL_CONTENT_ATTRIBUTE_CHARS)
+        return serialized;
+    const keep = MAX_OTEL_CONTENT_ATTRIBUTE_CHARS - TRUNCATION_SUFFIX.length;
+    return serialized.slice(0, Math.max(0, keep)) + TRUNCATION_SUFFIX;
+}
+/**
+ * Turn a content value into a capped JSON string with PII redacted: sanitize framework
+ * metadata, redact (when a redactor is available), then serialize within the caps.
+ * Array content keeps the newest items (dropping oldest with a visible elision marker,
+ * so the result stays valid JSON); non-array content is tail-truncated with a suffix.
+ * Returns `undefined` when the value is empty. Never throws — a failure drops the value.
+ */
+export async function redactAndCapContent(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    try {
+        const sanitized = sanitizePayloadValue(value);
+        const redactor = await getContentRedactor();
+        // Fail closed: if the redactor didn't load, drop the content rather than emit it
+        // unredacted — it is the highest-PII surface.
+        if (!redactor)
+            return undefined;
+        const redacted = await redactStringsDeep(sanitized, redactor);
+        if (typeof redacted === "string") {
+            return redacted.length === 0 ? undefined : capString(redacted);
+        }
+        if (Array.isArray(redacted)) {
+            const serialized = serializeArrayWithCap(redacted);
+            return serialized.length === 0 ? undefined : serialized;
+        }
+        const serialized = JSON.stringify(redacted);
+        if (serialized === undefined || serialized.length === 0)
+            return undefined;
+        return capString(serialized);
+    }
+    catch (err) {
+        logger.warn("failed to redact/serialize gen_ai content; dropping value", {
+            err: err instanceof Error ? err.message : String(err),
+        });
+        return undefined;
+    }
+}
+/** Redact + cap a content value and stamp it onto the span (when capture is on and non-empty). */
+export async function setGenAiContentAttribute(span, key, value) {
+    const out = await redactAndCapContent(value);
+    if (out !== undefined) {
+        try {
+            span.setAttribute(key, out);
+        }
+        catch {
+            // Tracing must never break the caller.
+        }
+    }
+}
+// ─── Metadata helpers ────────────────────────────────────────────────────────
+/** Set every defined value in `attrs` on the span, skipping undefined/null. Never throws. */
+export function setDefinedAttributes(span, attrs) {
+    try {
+        for (const [k, v] of Object.entries(attrs)) {
+            if (v !== undefined && v !== null)
+                span.setAttribute(k, v);
+        }
+    }
+    catch {
+        // Tracing must never break the caller.
+    }
+}
+/** Low-cardinality `error.type` for the spec: error.name, the string itself, else "_OTHER". */
+export function errorTypeOf(error) {
+    if (error instanceof Error)
+        return error.name;
+    if (typeof error === "string")
+        return error;
+    return "_OTHER";
+}
+/**
+ * Mark a span as failed: record the exception, set ERROR status, and stamp the spec's
+ * low-cardinality `error.type`. Never throws.
+ */
+export function recordSpanError(span, error) {
+    try {
+        span.recordException(error instanceof Error ? error : { message: String(error) });
+        span.setStatus({
+            code: SpanStatusCode.ERROR,
+            message: error instanceof Error ? error.message : String(error),
+        });
+        span.setAttribute("error.type", errorTypeOf(error));
+    }
+    catch {
+        // Tracing must never break the caller.
+    }
+}
+// ─── Value coercion ──────────────────────────────────────────────────────────
+/** First finite number among the candidates, else undefined. */
+export function firstNumber(...values) {
+    for (const v of values) {
+        if (typeof v === "number" && Number.isFinite(v))
+            return v;
+    }
+    return undefined;
+}
+/** Normalize a finish-reason value to a string array (gen_ai.response.finish_reasons is an array). */
+export function toFinishReasons(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (Array.isArray(value)) {
+        const out = value.filter((v) => typeof v === "string");
+        return out.length > 0 ? out : undefined;
+    }
+    if (typeof value === "string" && value.length > 0)
+        return [value];
+    return undefined;
+}
+// ─── gen_ai message normalization ─────────────────────────────────────────────
+// Shape input/output messages into the spec's `{ role, parts: [...] }` structure
+// (parts are typed: text / tool_call / tool_call_response), matching the native
+// gateway mapping so the gen_ai views render identically. Unknown content is kept
+// as a native nested object (not stringified) rather than dropped, so the single
+// outer serialize escapes it exactly once.
+function isRecord(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function textPart(content) {
+    return { type: "text", content };
+}
+function toolCallResponsePart(part) {
+    return {
+        type: "tool_call_response",
+        ...(typeof part.id === "string" ? { id: part.id } : {}),
+        result: part.result ?? part.response ?? part.content ?? "",
+    };
+}
+/** Turn a message's `content` (string, array of blocks, or object) into typed parts. */
+function contentParts(value) {
+    if (typeof value === "string")
+        return value.length > 0 ? [textPart(value)] : [];
+    if (!Array.isArray(value)) {
+        if (value === undefined || value === null)
+            return [];
+        // Keep an unknown object as a native nested part — the single outer
+        // JSON.stringify in redactAndCapContent serializes it exactly once
+        // (pre-stringifying here would double-escape its sub-structures).
+        if (isRecord(value))
+            return [value];
+        return [textPart(String(value))];
+    }
+    const parts = [];
+    for (const part of value) {
+        if (typeof part === "string") {
+            if (part.length > 0)
+                parts.push(textPart(part));
+            continue;
+        }
+        if (!isRecord(part))
+            continue;
+        if (typeof part.text === "string") {
+            parts.push(textPart(part.text));
+        }
+        else if (part.type === "text" && typeof part.content === "string") {
+            parts.push(textPart(part.content));
+        }
+        else if ((part.type === "tool_call" || part.type === "toolCall") && typeof part.name === "string") {
+            parts.push({
+                type: "tool_call",
+                name: part.name,
+                ...(typeof part.id === "string" ? { id: part.id } : {}),
+                ...(part.arguments !== undefined ? { arguments: part.arguments } : {}),
+            });
+        }
+        else if (part.type === "tool_call_response") {
+            parts.push(toolCallResponsePart(part));
+        }
+        else {
+            // Unknown part kept as a native nested object (not stringified) so the
+            // single outer JSON.stringify serializes it once — preserving its real
+            // fields rather than escaping them into a text blob.
+            parts.push(part);
+        }
+    }
+    return parts;
+}
+function normalizeGenAiMessage(value, fallbackRole) {
+    if (typeof value === "string") {
+        return value.length > 0 ? { role: fallbackRole, parts: [textPart(value)] } : undefined;
+    }
+    if (!isRecord(value))
+        return undefined;
+    const rawRole = typeof value.role === "string" ? value.role : fallbackRole;
+    const role = rawRole === "toolResult" ? "tool" : rawRole;
+    let parts;
+    if (role === "tool") {
+        const explicit = contentParts(value.parts);
+        parts =
+            explicit.length > 0
+                ? explicit
+                : [toolCallResponsePart({ id: value.toolCallId, result: value.content ?? "" })];
+    }
+    else {
+        parts = contentParts(value.parts ?? value.content);
+    }
+    if (parts.length === 0)
+        return undefined;
+    const finish = typeof value.finish_reason === "string"
+        ? value.finish_reason
+        : typeof value.stopReason === "string"
+            ? value.stopReason
+            : undefined;
+    return { role, parts, ...(finish ? { finish_reason: finish } : {}) };
+}
+/** Normalize a list of raw provider messages into spec `{ role, parts }` objects. */
+export function normalizeGenAiMessages(value, fallbackRole) {
+    const source = Array.isArray(value) ? value : value === undefined || value === null ? [] : [value];
+    const out = [];
+    for (const item of source) {
+        const msg = normalizeGenAiMessage(item, fallbackRole);
+        if (msg)
+            out.push(msg);
+    }
+    return out.length > 0 ? out : undefined;
+}
+//# sourceMappingURL=gen-ai.js.map

package/dist/tracking/spans/gen-ai.js.map

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

package/dist/tracking/spans/index.d.ts

@@ -1,13 +1,11 @@
 /**
  * Span telemetry — barrel export.
+ *
+ * Agent telemetry (LLM / tool / subagent / MCP) is emitted as real OTel gen_ai spans
+ * through the shared tracer: the gateway hooks via {@link registerSpanHooks}, on-site
+ * MCP calls via `SenpiClient.callTool` (both using the {@link module:gen-ai} mapping).
  */
-export type { EmissionSource, OpenSpan, OpenSubagentSpan, SpanTransport, SpanType, TrackingSpan, } from "./types.js";
-export { SPANS_API_PATH, HEADER_CORRELATION_ID, HEADER_ADDRESS, HEADER_RECIPE_NAME, HEADER_RUNTIME_ID, HEADER_RUNTIME_VERSION, } from "./constants.js";
-export { BatchingSpanTransport, NoOpSpanTransport, type BatchingSpanTransportOptions, } from "./span-transport.js";
-export { SpanTracker, type AgentEndInput, type DirectLlmSpanInput, type DirectToolSpanInput, type FinalizeLlmSpanInput, type FinalizeSubagentInput, type FinalizeToolSpanInput, type MergeSubagentInput, type OpenLlmSpanInput, type OpenSubagentInput, type OpenToolSpanInput, type SpanContextFields, type SpanTrackerOptions, } from "./span-tracker.js";
+export { HEADER_CORRELATION_ID, HEADER_ADDRESS, HEADER_RECIPE_NAME, HEADER_RUNTIME_ID, HEADER_RUNTIME_VERSION, } from "./constants.js";
 export { registerSpanHooks, type RegisterSpanHooksOptions, type SpanHooksPluginApi, } from "./span-hooks.js";
-export { createPluginSpanTracker } from "./plugin-span-tracker.js";
-import type { SpanTracker as _SpanTracker } from "./span-tracker.js";
-export declare function setDefaultSpanTracker(tracker: _SpanTracker | null): void;
-export declare function getDefaultSpanTracker(): _SpanTracker | null;
+export { GEN_AI, setGenAiContentAttribute, redactAndCapContent, } from "./gen-ai.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/tracking/spans/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tracking/spans/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,cAAc,EACd,QAAQ,EACR,gBAAgB,EAChB,aAAa,EACb,QAAQ,EACR,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,KAAK,4BAA4B,GAClC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAMnE,OAAO,KAAK,EAAE,WAAW,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAErE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAExE;AACD,wBAAgB,qBAAqB,IAAI,YAAY,GAAG,IAAI,CAE3D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tracking/spans/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,MAAM,EACN,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,aAAa,CAAC"}

package/dist/tracking/spans/index.js

@@ -1,16 +1,11 @@
 /**
  * Span telemetry — barrel export.
+ *
+ * Agent telemetry (LLM / tool / subagent / MCP) is emitted as real OTel gen_ai spans
+ * through the shared tracer: the gateway hooks via {@link registerSpanHooks}, on-site
+ * MCP calls via `SenpiClient.callTool` (both using the {@link module:gen-ai} mapping).
  */
-export { SPANS_API_PATH, HEADER_CORRELATION_ID, HEADER_ADDRESS, HEADER_RECIPE_NAME, HEADER_RUNTIME_ID, HEADER_RUNTIME_VERSION, } from "./constants.js";
-export { BatchingSpanTransport, NoOpSpanTransport, } from "./span-transport.js";
-export { SpanTracker, } from "./span-tracker.js";
+export { HEADER_CORRELATION_ID, HEADER_ADDRESS, HEADER_RECIPE_NAME, HEADER_RUNTIME_ID, HEADER_RUNTIME_VERSION, } from "./constants.js";
 export { registerSpanHooks, } from "./span-hooks.js";
-export { createPluginSpanTracker } from "./plugin-span-tracker.js";
-let defaultSpanTracker = null;
-export function setDefaultSpanTracker(tracker) {
-    defaultSpanTracker = tracker;
-}
-export function getDefaultSpanTracker() {
-    return defaultSpanTracker;
-}
+export { GEN_AI, setGenAiContentAttribute, redactAndCapContent, } from "./gen-ai.js";
 //# sourceMappingURL=index.js.map

package/dist/tracking/spans/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tracking/spans/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,GAElB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,WAAW,GAaZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,iBAAiB,GAGlB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAOnE,IAAI,kBAAkB,GAAwB,IAAI,CAAC;AACnD,MAAM,UAAU,qBAAqB,CAAC,OAA4B;IAChE,kBAAkB,GAAG,OAAO,CAAC;AAC/B,CAAC;AACD,MAAM,UAAU,qBAAqB;IACnC,OAAO,kBAAkB,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tracking/spans/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,iBAAiB,GAGlB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,MAAM,EACN,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,aAAa,CAAC"}

package/dist/tracking/spans/redact-pii.d.ts

@@ -1,26 +1,19 @@
 /**
- * PII + secret redaction for span payloads.
+ * PII + secret redaction for span content.
  *
- * Walks the `data` field of each span and replaces matches in string values
- * before the batch hits the wire. Runs at flush time (async) — the underlying
- * redactor is async, and the producer is fire-and-forget, so we pay the
- * latency on the network-bound path rather than on the caller's enqueue call.
+ * Walks a JSON-shaped value and replaces matches in string values. Reused by the
+ * gen_ai content path (`gen-ai.ts`), which redacts conversation/tool content inline
+ * before stamping it onto a span (awaited per call).
  *
  * Scope (see createOpenRedactionAdapter): emails, phones (US, international,
  * India, China, South Korea, Japan, UK mobile, Brazil), ~28 vendor API keys
  * / tokens (AWS, GitHub, Stripe, OpenAI, etc.), EVM private keys, Anthropic
  * `sk-ant-*` keys, generic `sk-*` keys, and BIP39 mnemonic phrases.
  *
- * Integration point: BatchingSpanTransport.flush() applies this to every
- * span in the batch before JSON.stringify. Only `span.data` is walked;
- * top-level columns (`address`, `correlationId`, etc.) are non-PII identifiers
- * and stay as-is.
- *
  * The process-wide default redactor is registered unconditionally at plugin
- * boot (see plugin-span-tracker), so both the event-log redact-field path and
- * the span path are scrubbed without an env gate.
+ * boot (see initDefaultPiiRedactor), so the event-log redact-field path
+ * (`logger.event()`) is scrubbed without an env gate.
  */
-import type { TrackingSpan } from "./types.js";
 /** Minimal interface so tests can inject a synchronous stub. */
 export interface PiiRedactor {
     redact(text: string): Promise<string>;
@@ -32,16 +25,21 @@ export interface PiiRedactor {
  * when nothing changes — useful for short-circuit downstream comparisons.
  */
 export declare function redactStringsDeep(value: unknown, redactor: PiiRedactor): Promise<unknown>;
+export declare function setDefaultPiiRedactor(r: PiiRedactor | null): void;
+export declare function getDefaultPiiRedactor(): PiiRedactor | null;
 /**
- * Redact PII inside `span.data` only. Top-level structural fields (address,
- * correlationId, runId, etc.) are non-PII identifiers and skipped.
+ * Register the process-wide default PII redactor at plugin boot. Always on, no
+ * env gate: `logger.event()` redact fields (free-text LLM reasoning, venue
+ * errors, raw signals) are scrubbed on the live path.
  *
- * Returns the same span if nothing changed (avoids object allocation when no
- * PII was found).
+ * 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.
  */
-export declare function redactSpanData(span: TrackingSpan, redactor: PiiRedactor): Promise<TrackingSpan>;
-export declare function setDefaultPiiRedactor(r: PiiRedactor | null): void;
-export declare function getDefaultPiiRedactor(): PiiRedactor | null;
+export declare function initDefaultPiiRedactor(): void;
 /**
  * Find BIP39-mnemonic spans in `text` using a true sliding window — not
  * a greedy regex with a post-hoc validator.

package/dist/tracking/spans/redact-pii.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redact-pii.d.ts","sourceRoot":"","sources":["../../../src/tracking/spans/redact-pii.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK/C,gEAAgE;AAChE,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACvC;AAQD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,WAAW,GACpB,OAAO,CAAC,OAAO,CAAC,CAgClB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,WAAW,GACpB,OAAO,CAAC,YAAY,CAAC,CAKvB;AAUD,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAEjE;AAED,wBAAgB,qBAAqB,IAAI,WAAW,GAAG,IAAI,CAE1D;AAqOD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GACjB,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CA0CvC;AAsBD;;;;GAIG;AACH,wBAAsB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI/E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,WAAW,CAAC,CAkCvE"}
+{"version":3,"file":"redact-pii.d.ts","sourceRoot":"","sources":["../../../src/tracking/spans/redact-pii.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,gEAAgE;AAChE,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACvC;AAQD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,WAAW,GACpB,OAAO,CAAC,OAAO,CAAC,CAgClB;AAUD,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAEjE;AAED,wBAAgB,qBAAqB,IAAI,WAAW,GAAG,IAAI,CAE1D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAc7C;AAqOD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GACjB,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CA0CvC;AAsBD;;;;GAIG;AACH,wBAAsB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI/E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,WAAW,CAAC,CAkCvE"}