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

package/dist/telemetry/metrics.d.ts

@@ -0,0 +1,47 @@
+/**
+ * GenAI client metrics, mirroring `tracing.ts`: instruments are obtained through the
+ * `@opentelemetry/api` proxy meter, so they no-op before the SDK initialises and resolve
+ * the real meter afterwards. Histograms are created lazily and cached on first use so they
+ * bind after SDK init (not at module load). Every record helper is fully guarded — metrics
+ * must never throw into a caller path.
+ *
+ * Names/units/attributes follow the GenAI semantic conventions:
+ *   - gen_ai.client.token.usage        Histogram {token}
+ *   - gen_ai.client.operation.duration Histogram s
+ *   - gen_ai.execute_tool.duration     Histogram s
+ *   - gen_ai.invoke_agent.duration     Histogram s
+ */
+import { type Meter } from "@opentelemetry/api";
+/** The single meter for our manual instruments. Resolves the no-op meter pre-init. */
+export declare function getMeter(): Meter;
+/** Reset cached instruments (tests only). */
+export declare function __resetMetricsForTest(): void;
+/** Elapsed seconds from a `Date.now()` start, clamped to non-negative. */
+export declare function elapsedSeconds(startMs: number | undefined): number | undefined;
+export interface GenAiOperationDims {
+    provider?: string;
+    model?: string;
+}
+/**
+ * Record token usage at chat finalize: one data point per token type present.
+ * Skips a dimension when its count is undefined.
+ */
+export declare function recordTokenUsage(dims: GenAiOperationDims, tokens: {
+    input?: number;
+    output?: number;
+}): void;
+/** Record the chat operation duration (seconds); stamps `error.type` when set. */
+export declare function recordOperationDuration(seconds: number | undefined, dims: GenAiOperationDims & {
+    errorType?: string;
+}): void;
+/** Record the tool execution duration (seconds); stamps `error.type` when set. */
+export declare function recordExecuteToolDuration(seconds: number | undefined, dims: {
+    toolName?: string;
+    errorType?: string;
+}): void;
+/** Record the sub-agent invocation duration (seconds); stamps `error.type` when set. */
+export declare function recordInvokeAgentDuration(seconds: number | undefined, dims: {
+    agentName?: string;
+    errorType?: string;
+}): void;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/telemetry/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/telemetry/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAA2B,KAAK,KAAK,EAAmB,MAAM,oBAAoB,CAAC;AAK1F,sFAAsF;AACtF,wBAAgB,QAAQ,IAAI,KAAK,CAEhC;AASD,6CAA6C;AAC7C,wBAAgB,qBAAqB,IAAI,IAAI,CAK5C;AAmDD,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAG9E;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1C,IAAI,CAiBN;AAED,kFAAkF;AAClF,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE,kBAAkB,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,IAAI,CAeN;AAED,kFAAkF;AAClF,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C,IAAI,CAcN;AAED,wFAAwF;AACxF,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C,IAAI,CAcN"}

package/dist/telemetry/metrics.js

@@ -0,0 +1,154 @@
+/**
+ * GenAI client metrics, mirroring `tracing.ts`: instruments are obtained through the
+ * `@opentelemetry/api` proxy meter, so they no-op before the SDK initialises and resolve
+ * the real meter afterwards. Histograms are created lazily and cached on first use so they
+ * bind after SDK init (not at module load). Every record helper is fully guarded — metrics
+ * must never throw into a caller path.
+ *
+ * Names/units/attributes follow the GenAI semantic conventions:
+ *   - gen_ai.client.token.usage        Histogram {token}
+ *   - gen_ai.client.operation.duration Histogram s
+ *   - gen_ai.execute_tool.duration     Histogram s
+ *   - gen_ai.invoke_agent.duration     Histogram s
+ */
+import { metrics } from "@opentelemetry/api";
+/** Instrumentation scope; matches the tracer/logger scope. */
+const METER_NAME = "senpi-trading-runtime";
+/** The single meter for our manual instruments. Resolves the no-op meter pre-init. */
+export function getMeter() {
+    return metrics.getMeter(METER_NAME);
+}
+// Lazily created + cached histograms — built on first record so they bind to the real
+// meter after SDK init rather than to the no-op meter at module load.
+let tokenUsage;
+let operationDuration;
+let executeToolDuration;
+let invokeAgentDuration;
+/** Reset cached instruments (tests only). */
+export function __resetMetricsForTest() {
+    tokenUsage = undefined;
+    operationDuration = undefined;
+    executeToolDuration = undefined;
+    invokeAgentDuration = undefined;
+}
+function tokenUsageInstrument() {
+    if (!tokenUsage) {
+        tokenUsage = getMeter().createHistogram("gen_ai.client.token.usage", {
+            description: "Number of input/output tokens used by a GenAI request",
+            unit: "{token}",
+        });
+    }
+    return tokenUsage;
+}
+function operationDurationInstrument() {
+    if (!operationDuration) {
+        operationDuration = getMeter().createHistogram("gen_ai.client.operation.duration", {
+            description: "Duration of a GenAI client operation",
+            unit: "s",
+        });
+    }
+    return operationDuration;
+}
+function executeToolDurationInstrument() {
+    if (!executeToolDuration) {
+        executeToolDuration = getMeter().createHistogram("gen_ai.execute_tool.duration", {
+            description: "Duration of a GenAI tool execution",
+            unit: "s",
+        });
+    }
+    return executeToolDuration;
+}
+function invokeAgentDurationInstrument() {
+    if (!invokeAgentDuration) {
+        invokeAgentDuration = getMeter().createHistogram("gen_ai.invoke_agent.duration", {
+            description: "Duration of a GenAI sub-agent invocation",
+            unit: "s",
+        });
+    }
+    return invokeAgentDuration;
+}
+/** Drop undefined/null attributes so we never stamp hollow dimensions. */
+function defined(attrs) {
+    const out = {};
+    for (const [k, v] of Object.entries(attrs)) {
+        if (v !== undefined && v !== null)
+            out[k] = v;
+    }
+    return out;
+}
+/** Elapsed seconds from a `Date.now()` start, clamped to non-negative. */
+export function elapsedSeconds(startMs) {
+    if (typeof startMs !== "number" || !Number.isFinite(startMs))
+        return undefined;
+    return Math.max(0, (Date.now() - startMs) / 1000);
+}
+/**
+ * Record token usage at chat finalize: one data point per token type present.
+ * Skips a dimension when its count is undefined.
+ */
+export function recordTokenUsage(dims, tokens) {
+    try {
+        const base = {
+            "gen_ai.operation.name": "chat",
+            "gen_ai.provider.name": dims.provider,
+            "gen_ai.request.model": dims.model,
+        };
+        const inst = tokenUsageInstrument();
+        if (typeof tokens.input === "number" && Number.isFinite(tokens.input)) {
+            inst.record(tokens.input, defined({ ...base, "gen_ai.token.type": "input" }));
+        }
+        if (typeof tokens.output === "number" && Number.isFinite(tokens.output)) {
+            inst.record(tokens.output, defined({ ...base, "gen_ai.token.type": "output" }));
+        }
+    }
+    catch {
+        // Metrics must never break the caller.
+    }
+}
+/** Record the chat operation duration (seconds); stamps `error.type` when set. */
+export function recordOperationDuration(seconds, dims) {
+    if (seconds === undefined)
+        return;
+    try {
+        operationDurationInstrument().record(seconds, defined({
+            "gen_ai.operation.name": "chat",
+            "gen_ai.provider.name": dims.provider,
+            "gen_ai.request.model": dims.model,
+            "error.type": dims.errorType,
+        }));
+    }
+    catch {
+        // Metrics must never break the caller.
+    }
+}
+/** Record the tool execution duration (seconds); stamps `error.type` when set. */
+export function recordExecuteToolDuration(seconds, dims) {
+    if (seconds === undefined)
+        return;
+    try {
+        executeToolDurationInstrument().record(seconds, defined({
+            "gen_ai.operation.name": "execute_tool",
+            "gen_ai.tool.name": dims.toolName,
+            "error.type": dims.errorType,
+        }));
+    }
+    catch {
+        // Metrics must never break the caller.
+    }
+}
+/** Record the sub-agent invocation duration (seconds); stamps `error.type` when set. */
+export function recordInvokeAgentDuration(seconds, dims) {
+    if (seconds === undefined)
+        return;
+    try {
+        invokeAgentDurationInstrument().record(seconds, defined({
+            "gen_ai.operation.name": "invoke_agent",
+            "gen_ai.agent.name": dims.agentName,
+            "error.type": dims.errorType,
+        }));
+    }
+    catch {
+        // Metrics must never break the caller.
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/telemetry/metrics.js.map

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

package/dist/telemetry/otel-sdk.d.ts

@@ -1,32 +1,25 @@
 /**
- * OpenTelemetry SDK stand-up: initialises HyperDX's OTel distribution
- * (`@hyperdx/node-opentelemetry`) — auto-instrumentation, console-capture logs,
- * uncaught-exception capture — against a self-hosted OTLP collector, with a
- * standardised resource-attribute set.
+ * OpenTelemetry SDK stand-up: HyperDX's OTel distribution (`@hyperdx/node-opentelemetry`)
+ * — auto-instrumentation + uncaught-exception capture — against a self-hosted OTLP collector,
+ * with a process-stable resource-attribute set.
  *
- * Init runs from `Runtime.start()`, not at process entry: resource attributes
- * are immutable after `init()` and are built from the recipe/strategy identity
- * and the `telemetry.enabled` gate, none of which exist before a runtime starts.
- * On Node >= 22 the diagnostics_channel HTTP instrumentation hooks lazily, so
- * deferring init still instruments outbound HTTP.
+ * Init runs from plugin `register()` (process scope): the agent hooks register there, before
+ * any runtime, and emit through this SDK's tracer. Only process-stable values ride the resource
+ * (`service.*`, `deployment.environment`, `user.id`), so init need not wait for a runtime.
  *
- * The package is imported dynamically (not at top level) because it captures the
- * OTLP transport config from the `OTEL_EXPORTER_OTLP_*` env vars at module-load time
- * and exposes no endpoint/header option on `init()` — so those vars must be set before
- * it loads.
+ * Gated by OTLP-config presence: inits iff an OTLP endpoint env is set (no enable flag, no
+ * localhost default). No endpoint ⇒ no SDK and the global tracer/logger no-op. If a non-noop
+ * global `TracerProvider` already exists (the gateway's `diagnostics-otel` owns it), we stand
+ * down and emit through the global API — one SDK per process, first writer wins.
  *
- * Under openclaw the operator must set ALL of these in the container env (the SDK does
- * not derive them; this module only defaults the base endpoint below, for standalone runs):
- *   OTEL_EXPORTER_OTLP_ENDPOINT          (base, e.g. http://host.docker.internal:4318)
- *   OTEL_EXPORTER_OTLP_TRACES_ENDPOINT   (.../v1/traces)
- *   OTEL_EXPORTER_OTLP_LOGS_ENDPOINT     (.../v1/logs)
- *   OTEL_EXPORTER_OTLP_METRICS_ENDPOINT  (.../v1/metrics)
- *   OTEL_EXPORTER_OTLP_HEADERS           (e.g. Authorization=<collector-token>)
- * See docs/runtime-docs/runtime-api.md (Tracing) for why each is required.
+ * The package is imported dynamically: it reads `OTEL_EXPORTER_OTLP_*` at module-load and
+ * exposes no init() option for them, so the env must be set first. Under openclaw the operator
+ * sets all of these (the SDK derives none):
+ *   OTEL_EXPORTER_OTLP_ENDPOINT / _TRACES_ENDPOINT / _LOGS_ENDPOINT / _METRICS_ENDPOINT / _HEADERS
+ * See docs/runtime-docs/runtime-api.md (Tracing).
  */
-import type { IdentityEnvelope } from "../recording/identity.js";
-/** Base OTLP endpoint defaulted for standalone Node runs only; ignored under openclaw (see module header). */
-export declare const DEFAULT_OTLP_ENDPOINT = "http://localhost:4318";
+/** True when any OTLP endpoint env is set — the gate for standing up the plugin's SDK. */
+export declare function isOtlpEndpointConfigured(): boolean;
 /**
  * Whether {@link initOtelSdk} has completed. Code that loads `@hyperdx/node-opentelemetry`
  * lazily (e.g. per-trace attribute stamping) gates on this so the package — which captures
@@ -72,22 +65,17 @@ export interface OtelResourceExtras {
  * emit-time identity stamp (both reading the same per-runtime identity context).
  */
 export declare function buildOtelResourceAttributes(serviceName: string, extras: OtelResourceExtras): string;
-/**
- * Resolve the OTLP endpoint: `OTEL_EXPORTER_OTLP_ENDPOINT` env >
- * {@link DEFAULT_OTLP_ENDPOINT}.
- */
-export declare function resolveOtlpEndpoint(): string;
 export interface InitOtelSdkParams {
-    readonly enabled: boolean;
-    /** Built only on the live path to preserve laziness. */
-    readonly identity: () => IdentityEnvelope;
     /** SENPI_API_KEY JWT (the MCP bearer) — decoded locally for `user.id`. */
     readonly userToken?: string;
+    /** Plugin version → `service.version`. */
     readonly serviceVersion: string;
 }
 /**
  * Initialise the OTel SDK. Idempotent, side-effecting, and never crashes boot:
- * no-ops when disabled, already initialised, or under test.
+ * no-ops when no OTLP endpoint is configured, when a real global TracerProvider
+ * already exists (the gateway owns it — we emit through the global API instead),
+ * when already initialised, or under test.
  */
 export declare function initOtelSdk(params: InitOtelSdkParams): Promise<void>;
 /**

package/dist/telemetry/otel-sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"otel-sdk.d.ts","sourceRoot":"","sources":["../../src/telemetry/otel-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAKjE,8GAA8G;AAC9G,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AA0E7D;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAkB/E;AAED,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,2BAA2B;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,kCAAkC;IAClC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,kBAAkB,GACzB,MAAM,CAaR;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAI5C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,gBAAgB,CAAC;IAC1C,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmF1E;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAcrD"}
+{"version":3,"file":"otel-sdk.d.ts","sourceRoot":"","sources":["../../src/telemetry/otel-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAgBH,0FAA0F;AAC1F,wBAAgB,wBAAwB,IAAI,OAAO,CAKlD;AAoGD;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAkB/E;AAED,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,2BAA2B;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,kCAAkC;IAClC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,kBAAkB,GACzB,MAAM,CAaR;AAED,MAAM,WAAW,iBAAiB;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAKD;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuF1E;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAcrD"}

package/dist/telemetry/otel-sdk.js

@@ -1,34 +1,66 @@
 /**
- * OpenTelemetry SDK stand-up: initialises HyperDX's OTel distribution
- * (`@hyperdx/node-opentelemetry`) — auto-instrumentation, console-capture logs,
- * uncaught-exception capture — against a self-hosted OTLP collector, with a
- * standardised resource-attribute set.
+ * OpenTelemetry SDK stand-up: HyperDX's OTel distribution (`@hyperdx/node-opentelemetry`)
+ * — auto-instrumentation + uncaught-exception capture — against a self-hosted OTLP collector,
+ * with a process-stable resource-attribute set.
  *
- * Init runs from `Runtime.start()`, not at process entry: resource attributes
- * are immutable after `init()` and are built from the recipe/strategy identity
- * and the `telemetry.enabled` gate, none of which exist before a runtime starts.
- * On Node >= 22 the diagnostics_channel HTTP instrumentation hooks lazily, so
- * deferring init still instruments outbound HTTP.
+ * Init runs from plugin `register()` (process scope): the agent hooks register there, before
+ * any runtime, and emit through this SDK's tracer. Only process-stable values ride the resource
+ * (`service.*`, `deployment.environment`, `user.id`), so init need not wait for a runtime.
  *
- * The package is imported dynamically (not at top level) because it captures the
- * OTLP transport config from the `OTEL_EXPORTER_OTLP_*` env vars at module-load time
- * and exposes no endpoint/header option on `init()` — so those vars must be set before
- * it loads.
+ * Gated by OTLP-config presence: inits iff an OTLP endpoint env is set (no enable flag, no
+ * localhost default). No endpoint ⇒ no SDK and the global tracer/logger no-op. If a non-noop
+ * global `TracerProvider` already exists (the gateway's `diagnostics-otel` owns it), we stand
+ * down and emit through the global API — one SDK per process, first writer wins.
  *
- * Under openclaw the operator must set ALL of these in the container env (the SDK does
- * not derive them; this module only defaults the base endpoint below, for standalone runs):
- *   OTEL_EXPORTER_OTLP_ENDPOINT          (base, e.g. http://host.docker.internal:4318)
- *   OTEL_EXPORTER_OTLP_TRACES_ENDPOINT   (.../v1/traces)
- *   OTEL_EXPORTER_OTLP_LOGS_ENDPOINT     (.../v1/logs)
- *   OTEL_EXPORTER_OTLP_METRICS_ENDPOINT  (.../v1/metrics)
- *   OTEL_EXPORTER_OTLP_HEADERS           (e.g. Authorization=<collector-token>)
- * See docs/runtime-docs/runtime-api.md (Tracing) for why each is required.
+ * The package is imported dynamically: it reads `OTEL_EXPORTER_OTLP_*` at module-load and
+ * exposes no init() option for them, so the env must be set first. Under openclaw the operator
+ * sets all of these (the SDK derives none):
+ *   OTEL_EXPORTER_OTLP_ENDPOINT / _TRACES_ENDPOINT / _LOGS_ENDPOINT / _METRICS_ENDPOINT / _HEADERS
+ * See docs/runtime-docs/runtime-api.md (Tracing).
  */
 import { randomUUID } from "node:crypto";
+import { trace } from "@opentelemetry/api";
 import { createLogger } from "../utils/logger.js";
 const logger = createLogger("telemetry/otel-sdk");
-/** Base OTLP endpoint defaulted for standalone Node runs only; ignored under openclaw (see module header). */
-export const DEFAULT_OTLP_ENDPOINT = "http://localhost:4318";
+/** Per-signal OTLP endpoint env vars; presence of any (or the base) is the on-switch. */
+const OTLP_ENDPOINT_ENV_VARS = [
+    "OTEL_EXPORTER_OTLP_ENDPOINT",
+    "OTEL_EXPORTER_OTLP_TRACES_ENDPOINT",
+    "OTEL_EXPORTER_OTLP_LOGS_ENDPOINT",
+    "OTEL_EXPORTER_OTLP_METRICS_ENDPOINT",
+];
+/** True when any OTLP endpoint env is set — the gate for standing up the plugin's SDK. */
+export function isOtlpEndpointConfigured() {
+    return OTLP_ENDPOINT_ENV_VARS.some((name) => {
+        const value = process.env[name];
+        return typeof value === "string" && value.trim().length > 0;
+    });
+}
+/**
+ * True when a real (non-noop) global `TracerProvider` is already registered — i.e.
+ * another SDK (the gateway's `diagnostics-otel`) owns the slot. The global API hands
+ * back a `ProxyTracerProvider` until `setGlobalTracerProvider` runs; before that its
+ * delegate is the no-op provider. We detect "real" by checking whether a delegate
+ * provider has been set: `getDelegate()` exists on the proxy and differs from the
+ * no-op. Best-effort — on any uncertainty we treat it as "not owned" and init our own.
+ */
+function globalTracerProviderIsReal() {
+    try {
+        const provider = trace.getTracerProvider();
+        if (typeof provider?.getDelegate !== "function") {
+            // Not a ProxyTracerProvider — a concrete provider is registered directly.
+            return true;
+        }
+        const delegate = provider.getDelegate();
+        if (delegate == null)
+            return false;
+        // The proxy's default delegate is the NoopTracerProvider; anything else is real.
+        return delegate.constructor?.name !== "NoopTracerProvider";
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * Process-level instance id for `service.instance.id`. Distinct from the
  * per-runtime `IdentityEnvelope.bootId`: resource attributes are process-global,
@@ -50,7 +82,7 @@ const PROCESS_INSTANCE_ID = randomUUID();
  * Fix: enable our own `UndiciInstrumentation`; with no provider set it resolves the
  * global one `init()` registered, and HyperDX's instance stays disabled (no double
  * instrumentation). Best-effort — a failure must not fail boot. Also a prerequisite
- * for the manual `mcp.*`/`dsl.*` spans (Task 9b), which assume outbound `fetch` calls
+ * for the manual `mcp.*`/`dsl.*` spans, which assume outbound `fetch` calls
  * auto-nest as HTTP children.
  *
  * Seen with `@hyperdx/node-opentelemetry` 0.11 / `instrumentation-undici` 0.28, Node 24
@@ -147,38 +179,37 @@ export function buildOtelResourceAttributes(serviceName, extras) {
         .map(([key, value]) => `${key}=${encodeURIComponent(String(value))}`)
         .join(",");
 }
-/**
- * Resolve the OTLP endpoint: `OTEL_EXPORTER_OTLP_ENDPOINT` env >
- * {@link DEFAULT_OTLP_ENDPOINT}.
- */
-export function resolveOtlpEndpoint() {
-    const envOverride = process.env.OTEL_EXPORTER_OTLP_ENDPOINT?.trim();
-    if (envOverride)
-        return envOverride;
-    return DEFAULT_OTLP_ENDPOINT;
-}
+/** `service.name` for the plugin-owned resource; matches the tracer/logger scope. */
+const SERVICE_NAME = "senpi-trading-runtime";
 /**
  * Initialise the OTel SDK. Idempotent, side-effecting, and never crashes boot:
- * no-ops when disabled, already initialised, or under test.
+ * no-ops when no OTLP endpoint is configured, when a real global TracerProvider
+ * already exists (the gateway owns it — we emit through the global API instead),
+ * when already initialised, or under test.
  */
 export async function initOtelSdk(params) {
     if (initialized)
         return;
-    if (!params.enabled) {
-        logger.debug("OTel SDK init skipped: telemetry disabled");
+    // Presence of OTLP config is the on-switch — no endpoint means telemetry off.
+    if (!isOtlpEndpointConfigured()) {
+        logger.debug("OTel SDK init skipped: no OTLP endpoint configured");
         return;
     }
-    // Skip under test: the enable gate defaults to true, so without this the SDK
-    // would init (start exporters, patch core modules) during the vitest run.
+    // Stand down if another SDK (the gateway's diagnostics-otel) already owns the
+    // global provider — a second registration drops spans and splits resource identity.
+    if (globalTracerProviderIsReal()) {
+        logger.info("OTel SDK init skipped: a global TracerProvider already exists; emitting through the global API");
+        initialized = true;
+        return;
+    }
+    // Skip under test: the SDK would start exporters and patch core modules during vitest.
     if (process.env.VITEST || process.env.NODE_ENV === "test") {
         logger.debug("OTel SDK init skipped: running under test");
         return;
     }
     try {
-        const identity = params.identity();
         // Commit the guard before any fallible work: a failed init must not let a
-        // later Runtime.start() re-enter and double-append OTEL_RESOURCE_ATTRIBUTES.
-        // identity() above threw before this, so env is still untouched on that path.
+        // later caller re-enter and double-append OTEL_RESOURCE_ATTRIBUTES.
         initialized = true;
         // Source the environment label from NODE_ENV (Node-standard). Pass the value
         // through verbatim (so `staging`/custom envs are faithful), defaulting to
@@ -188,7 +219,7 @@ export async function initOtelSdk(params) {
         const deploymentEnvironment = nodeEnv && nodeEnv.length > 0 ? nodeEnv : "development";
         const userId = decodeSenpiUserId(params.userToken);
         // Append to any host-set value rather than clobber operator attrs.
-        const ourAttrs = buildOtelResourceAttributes(identity.service, {
+        const ourAttrs = buildOtelResourceAttributes(SERVICE_NAME, {
             serviceInstanceId: PROCESS_INSTANCE_ID,
             serviceVersion: params.serviceVersion,
             deploymentEnvironment,
@@ -198,18 +229,14 @@ export async function initOtelSdk(params) {
         process.env.OTEL_RESOURCE_ATTRIBUTES = existingAttrs
             ? `${existingAttrs},${ourAttrs}`
             : ourAttrs;
-        // Must be set before the import below — HyperDX reads it at module-load.
-        if (!process.env.OTEL_EXPORTER_OTLP_ENDPOINT) {
-            process.env.OTEL_EXPORTER_OTLP_ENDPOINT = resolveOtlpEndpoint();
-        }
-        // Dynamic import: loads only now, after the env var above is set.
+        // Dynamic import: loads only now, after the endpoint env is confirmed set.
         const hyperdx = (await import("@hyperdx/node-opentelemetry"));
         hyperdxModule = hyperdx;
         hyperdx.init({
             // No apiKey on init(): the exporter authenticates to the collector via the
             // Authorization header in OTEL_EXPORTER_OTLP_HEADERS (read from env at
             // module-load), not through the SDK's HyperDX apiKey field.
-            service: identity.service,
+            service: SERVICE_NAME,
             // Off: createLogger() emits structured LogRecords through the OTel Logs API directly,
             // so capturing console.* would duplicate every log (flattened, lossy) into the collector.
             // stdout is untouched — the local human line still prints.
@@ -228,7 +255,7 @@ export async function initOtelSdk(params) {
         });
         await reinstrumentUndici();
         logger.info("OTel SDK initialised", {
-            service: identity.service,
+            service: SERVICE_NAME,
             endpoint: process.env.OTEL_EXPORTER_OTLP_ENDPOINT,
             deploymentEnvironment,
         });

package/dist/telemetry/otel-sdk.js.map

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

package/dist/telemetry/tracing.d.ts

@@ -5,7 +5,7 @@
  * is not initialised (telemetry off, or under test) the API resolves a no-op tracer,
  * so `withSpan` runs the callback with near-zero overhead — no `enabled` gate needed.
  */
-import { type Span, type Attributes, type Tracer } from "@opentelemetry/api";
+import { type Span, type SpanKind, type Attributes, type Tracer } from "@opentelemetry/api";
 /** The single tracer for our manual spans. Resolves the no-op tracer pre-init. */
 export declare function getTracer(): Tracer;
 /**
@@ -28,5 +28,6 @@ export declare function getTracer(): Tracer;
  */
 export declare function withSpan<T>(name: string, attributes: Attributes, fn: (span: Span) => Promise<T>, options?: {
     expected?: (err: unknown) => boolean;
+    kind?: SpanKind;
 }): Promise<T>;
 //# sourceMappingURL=tracing.d.ts.map

package/dist/telemetry/tracing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../src/telemetry/tracing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAGL,KAAK,IAAI,EACT,KAAK,UAAU,EACf,KAAK,MAAM,EACZ,MAAM,oBAAoB,CAAC;AAK5B,kFAAkF;AAClF,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,EACtB,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAA;CAAE,GACjD,OAAO,CAAC,CAAC,CAAC,CA8BZ"}
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../src/telemetry/tracing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAGL,KAAK,IAAI,EACT,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,MAAM,EACZ,MAAM,oBAAoB,CAAC;AAK5B,kFAAkF;AAClF,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,EACtB,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;CAAE,GAClE,OAAO,CAAC,CAAC,CAAC,CA8BZ"}

package/dist/telemetry/tracing.js

@@ -31,7 +31,7 @@ export function getTracer() {
  * error nor corrupt its result.
  */
 export function withSpan(name, attributes, fn, options) {
-    return getTracer().startActiveSpan(name, { attributes }, async (span) => {
+    return getTracer().startActiveSpan(name, { attributes, kind: options?.kind }, async (span) => {
         try {
             return await fn(span);
         }

package/dist/telemetry/tracing.js.map

@@ -1 +1 @@
-{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../src/telemetry/tracing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,KAAK,EACL,cAAc,GAIf,MAAM,oBAAoB,CAAC;AAE5B,iEAAiE;AACjE,MAAM,WAAW,GAAG,uBAAuB,CAAC;AAE5C,kFAAkF;AAClF,MAAM,UAAU,SAAS;IACvB,OAAO,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,QAAQ,CACtB,IAAY,EACZ,UAAsB,EACtB,EAA8B,EAC9B,OAAkD;IAElD,OAAO,SAAS,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtE,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,IAAI,CAAC;gBACH,QAAQ,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC;YAC/C,CAAC;YAAC,MAAM,CAAC;gBACP,4EAA4E;YAC9E,CAAC;YACD,IAAI,QAAQ;gBAAE,MAAM,GAAG,CAAC;YACxB,IAAI,CAAC;gBACH,IAAI,CAAC,eAAe,CAAC,GAAY,CAAC,CAAC;gBACnC,IAAI,CAAC,SAAS,CAAC;oBACb,IAAI,EAAE,cAAc,CAAC,KAAK;oBAC1B,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBAC1D,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,wEAAwE;YAC1E,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC;gBACH,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,CAAC;YAAC,MAAM,CAAC;gBACP,+DAA+D;YACjE,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../src/telemetry/tracing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,KAAK,EACL,cAAc,GAKf,MAAM,oBAAoB,CAAC;AAE5B,iEAAiE;AACjE,MAAM,WAAW,GAAG,uBAAuB,CAAC;AAE5C,kFAAkF;AAClF,MAAM,UAAU,SAAS;IACvB,OAAO,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,QAAQ,CACtB,IAAY,EACZ,UAAsB,EACtB,EAA8B,EAC9B,OAAmE;IAEnE,OAAO,SAAS,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC3F,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,IAAI,CAAC;gBACH,QAAQ,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC;YAC/C,CAAC;YAAC,MAAM,CAAC;gBACP,4EAA4E;YAC9E,CAAC;YACD,IAAI,QAAQ;gBAAE,MAAM,GAAG,CAAC;YACxB,IAAI,CAAC;gBACH,IAAI,CAAC,eAAe,CAAC,GAAY,CAAC,CAAC;gBACnC,IAAI,CAAC,SAAS,CAAC;oBACb,IAAI,EAAE,cAAc,CAAC,KAAK;oBAC1B,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBAC1D,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,wEAAwE;YAC1E,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC;gBACH,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,CAAC;YAAC,MAAM,CAAC;gBACP,+DAA+D;YACjE,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -1,16 +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 declare const SPANS_API_PATH = "/api/v1/tracking/spans";
-export declare const FLUSH_INTERVAL_MS = 10000;
-export declare const FLUSH_THRESHOLD = 50;
-export declare const MAX_BUFFER_SIZE = 500;
-export declare const STALE_TIMEOUT_MS: number;
-export declare const SWEEP_INTERVAL_MS = 60000;
-export declare const MAX_BATCH_BYTES = 8000000;
-export declare const MAX_SPAN_FIELD_BYTES = 2000000;
-/** First N chars of each truncated value retained for debugging context. */
-export declare const TRUNCATED_PREVIEW_BYTES = 2000;
 export declare const HEADER_CORRELATION_ID = "x-senpi-correlation-id";
 export declare const HEADER_ADDRESS = "x-senpi-address";
 export declare const HEADER_RECIPE_NAME = "x-senpi-recipe-name";

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tracking/spans/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,cAAc,2BAA2B,CAAC;AAGvD,eAAO,MAAM,iBAAiB,QAAS,CAAC;AACxC,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,eAAe,MAAM,CAAC;AAGnC,eAAO,MAAM,gBAAgB,QAAa,CAAC;AAC3C,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAKxC,eAAO,MAAM,eAAe,UAAY,CAAC;AAQzC,eAAO,MAAM,oBAAoB,UAAY,CAAC;AAC9C,4EAA4E;AAC5E,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAG7C,eAAO,MAAM,qBAAqB,2BAA2B,CAAC;AAC9D,eAAO,MAAM,cAAc,oBAAoB,CAAC;AAChD,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AACxD,eAAO,MAAM,iBAAiB,uBAAuB,CAAC;AACtD,eAAO,MAAM,sBAAsB,4BAA4B,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tracking/spans/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,qBAAqB,2BAA2B,CAAC;AAC9D,eAAO,MAAM,cAAc,oBAAoB,CAAC;AAChD,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AACxD,eAAO,MAAM,iBAAiB,uBAAuB,CAAC;AACtD,eAAO,MAAM,sBAAsB,4BAA4B,CAAC"}