pi-otel 0.1.0

package/dist/index.js

@@ -0,0 +1,274 @@
+/**
+ * pi-otel — OpenTelemetry traces for pi-coding-agent.
+ *
+ * Wires pi lifecycle events into an OTel span tree:
+ *   pi.interaction (per user prompt)
+ *   ├─ pi.llm_request
+ *   └─ pi.tool.<name>
+ *
+ * See `_plans/SPEC.md` for the full design.
+ *
+ * The `/otel` command (Aspire launcher) is registered below via
+ * `registerOtelCommand`. We also expose `pi.events` channels
+ * (`pi-otel:status`, `pi-otel:trace-active`) for future consumers.
+ *
+ * ## pi-otel:log — extensibility API for other pi packages
+ *
+ * Any pi extension can route structured log records through pi-otel by emitting:
+ *
+ *   pi.events.emit("pi-otel:log", {
+ *     eventName: "my-package.something",   // lands as event.name attribute
+ *     severity: "info",                    // "debug" | "info" | "warn" | "error"
+ *     body: "human-readable message",
+ *     attributes: { "key": "value" },      // optional; string | number | boolean values
+ *   });
+ *
+ * No-op if signals.logs is disabled or the OTel SDK is not yet initialized.
+ * pi-otel uses this channel internally for its own lifecycle events.
+ */
+import { basename } from "node:path";
+import { trace } from "@opentelemetry/api";
+import { SeverityNumber } from "@opentelemetry/api-logs";
+import { ATTR_FINISH_REASONS, ATTR_HTTP_STATUS_CODE, ATTR_PI_CWD, ATTR_PI_SESSION_ID, ATTR_REQUEST_MODEL, ATTR_RESPONSE_ID, ATTR_RESPONSE_MODEL, ATTR_SYSTEM, applyUsageAttrs, GEN_AI_SYSTEM_PI, } from "./attrs.js";
+import { registerOtelCommand } from "./commands/otel.js";
+import { resolveConfig } from "./config.js";
+import { emitLifecycleLog } from "./otel/logs.js";
+import { initSdk, probeEndpoint, shutdownSdk } from "./otel/sdk.js";
+import { SpanTracker } from "./spans.js";
+const TRACER_NAME = "pi-otel";
+const TRACER_VERSION = "0.1.0";
+const SEVERITY_MAP = {
+    debug: SeverityNumber.DEBUG,
+    info: SeverityNumber.INFO,
+    warn: SeverityNumber.WARN,
+    error: SeverityNumber.ERROR,
+};
+export default function (pi) {
+    registerOtelCommand(pi, () => ctx0?.cwd);
+    // pi-otel:log — any pi extension can emit structured log records through
+    // pi-otel. No-op when signals.logs is disabled (LoggerProvider not registered).
+    pi.events.on("pi-otel:log", (data) => {
+        if (!data || typeof data !== "object")
+            return;
+        const { eventName = "pi-otel.log", severity = "info", body = "", attributes = {}, } = data;
+        emitLifecycleLog(eventName, SEVERITY_MAP[severity] ?? SeverityNumber.INFO, body, attributes);
+    });
+    let ctx0;
+    let tracker = null;
+    let sessionIdRef;
+    let sessionStartLogged = false;
+    const notify = (msg, severity = "info") => {
+        try {
+            ctx0?.ui?.notify?.(msg, severity);
+        }
+        catch {
+            // best-effort
+        }
+    };
+    function wireSdk(cfg, opts = {}) {
+        initSdk(cfg, notify, opts);
+        const tracer = trace.getTracer(TRACER_NAME, TRACER_VERSION);
+        tracker = new SpanTracker({
+            tracer,
+            captureContent: cfg.captureContent,
+            cwd: cfg.cwd,
+            sessionId: () => sessionIdRef,
+        });
+        pi.events.emit("pi-otel:status", {
+            state: "ready",
+            endpoint: cfg.endpoint,
+        });
+        // Fire once: wiring can happen at session_start OR later via dashboard-ready.
+        if (!sessionStartLogged) {
+            sessionStartLogged = true;
+            pi.events.emit("pi-otel:log", {
+                eventName: "pi.session.start",
+                severity: "info",
+                body: `pi session ${sessionIdRef ?? "(ephemeral)"} started`,
+                attributes: {
+                    [ATTR_SYSTEM]: GEN_AI_SYSTEM_PI,
+                    [ATTR_PI_CWD]: cfg.cwd,
+                    "service.name": cfg.serviceName,
+                    ...(sessionIdRef ? { [ATTR_PI_SESSION_ID]: sessionIdRef } : {}),
+                },
+            });
+        }
+    }
+    pi.on("session_start", async (_event, ctx) => {
+        ctx0 = ctx;
+        const cfg = resolveConfig(ctx.cwd);
+        if (!cfg.enabled) {
+            tracker = null;
+            return;
+        }
+        // Best-effort session id from the session manager.
+        try {
+            const file = ctx.sessionManager?.getSessionFile?.();
+            if (file)
+                sessionIdRef = basename(file, ".jsonl");
+        }
+        catch {
+            // ignore
+        }
+        // Defer SDK init until the endpoint is reachable — otherwise the metric
+        // reader / log processor begin retrying against a dead endpoint and the
+        // resulting errors get buffered and flushed once it comes online.
+        if (await probeEndpoint(cfg.endpoint)) {
+            wireSdk(cfg);
+        }
+        else {
+            notify(`pi-otel: OTLP endpoint ${cfg.endpoint} not reachable — run /otel start to launch a dashboard, or /otel connect <endpoint> to wire elsewhere.`);
+        }
+    });
+    const logError = (eventName, body, attrs = {}) => pi.events.emit("pi-otel:log", {
+        eventName,
+        severity: "error",
+        body,
+        attributes: attrs,
+    });
+    pi.on("before_agent_start", async (event, _ctx) => {
+        tracker?.startInteraction(event?.prompt);
+        const tid = tracker?.activeTraceId();
+        if (tid)
+            pi.events.emit("pi-otel:trace-active", { traceId: tid });
+    });
+    pi.on("turn_start", async (event, _ctx) => {
+        const idx = event?.turnIndex;
+        tracker?.startTurn(typeof idx === "number" ? idx : undefined);
+    });
+    pi.on("turn_end", async (_event, _ctx) => {
+        tracker?.endTurn();
+    });
+    pi.on("message_start", async (event, _ctx) => {
+        const msg = event?.message;
+        if (!msg)
+            return;
+        if (msg.role === "user") {
+            tracker?.noteUserMessage(msg.content);
+        }
+        else if (msg.role === "toolResult") {
+            tracker?.noteToolResultMessage({
+                toolCallId: msg.toolCallId,
+                toolName: msg.toolName,
+                content: msg.content,
+            });
+        }
+    });
+    pi.on("before_provider_request", async (event, _ctx) => {
+        // event.payload shape varies per provider; try to lift a model field.
+        const payload = event?.payload;
+        const model = payload?.model ?? payload?.modelId ?? payload?.modelName ?? undefined;
+        tracker?.startLlmRequest(typeof model === "string" ? model : undefined);
+        if (typeof model === "string") {
+            tracker?.setLlmAttrs({ [ATTR_REQUEST_MODEL]: model });
+        }
+    });
+    pi.on("after_provider_response", async (event, _ctx) => {
+        const status = event?.status;
+        const headers = event?.headers ?? {};
+        const attrs = {};
+        if (typeof status === "number")
+            attrs[ATTR_HTTP_STATUS_CODE] = status;
+        // Common response-id headers across providers.
+        const respId = headers["x-request-id"] ??
+            headers["request-id"] ??
+            headers["anthropic-request-id"] ??
+            headers["openai-response-id"];
+        if (typeof respId === "string")
+            attrs[ATTR_RESPONSE_ID] = respId;
+        tracker?.setLlmAttrs(attrs);
+        // Note: end is deferred to message_end so we can attach usage/cost.
+    });
+    pi.on("message_end", async (event, _ctx) => {
+        const msg = event?.message;
+        if (!msg || msg.role !== "assistant")
+            return;
+        const attrs = {};
+        if (typeof msg.model === "string")
+            attrs[ATTR_RESPONSE_MODEL] = msg.model;
+        const finish = msg.finishReason ?? msg.stopReason ?? msg.finish_reason;
+        if (typeof finish === "string")
+            attrs[ATTR_FINISH_REASONS] = [finish];
+        applyUsageAttrs(attrs, msg.usage);
+        tracker?.setLlmAttrs(attrs);
+        tracker?.noteAssistantMessage(msg);
+        tracker?.endLlmRequest();
+        if (finish === "error") {
+            logError("pi.llm_request.error", msg.errorMessage ?? `LLM request failed (${finish})`, {
+                ...(typeof msg.model === "string"
+                    ? { [ATTR_RESPONSE_MODEL]: msg.model }
+                    : {}),
+                [ATTR_FINISH_REASONS]: finish,
+            });
+        }
+    });
+    pi.on("tool_execution_start", async (event, _ctx) => {
+        const e = event;
+        if (!e?.toolCallId || !e?.toolName)
+            return;
+        tracker?.startTool(e.toolCallId, e.toolName, e.args);
+    });
+    pi.on("tool_execution_end", async (event, _ctx) => {
+        const e = event;
+        if (!e?.toolCallId)
+            return;
+        tracker?.endTool(e.toolCallId, { isError: !!e.isError, result: e.result });
+        if (e.isError) {
+            logError("pi.tool.error", `tool ${e.toolName} failed`, {
+                "gen_ai.tool.name": e.toolName,
+                "gen_ai.tool.call.id": e.toolCallId,
+            });
+        }
+    });
+    pi.on("agent_end", async (_event, _ctx) => {
+        tracker?.endInteraction();
+    });
+    pi.on("session_shutdown", async (_event, _ctx) => {
+        // Defensive: close any in-flight interaction before flushing.
+        tracker?.endInteraction();
+        pi.events.emit("pi-otel:log", {
+            eventName: "pi.session.end",
+            severity: "info",
+            body: `pi session ${sessionIdRef ?? "(ephemeral)"} ended`,
+            attributes: {
+                [ATTR_SYSTEM]: GEN_AI_SYSTEM_PI,
+                ...(sessionIdRef ? { [ATTR_PI_SESSION_ID]: sessionIdRef } : {}),
+            },
+        });
+        await shutdownSdk();
+        pi.events.emit("pi-otel:status", { state: "shutdown" });
+        tracker = null;
+    });
+    // Anchor exported for the launcher extension. The launcher can call
+    // `pi.events.emit("pi-otel:request-status", null)` and we reply with state.
+    pi.events.on("pi-otel:request-status", () => {
+        pi.events.emit("pi-otel:status", {
+            state: tracker ? "ready" : "disabled",
+        });
+    });
+    // Re-init the SDK when the dashboard becomes available mid-session, or when
+    // `/otel connect` rewires us to an external collector. Without this, the
+    // exporter keeps retrying against the dead endpoint it was wired to at
+    // session_start. Payload `endpoint`/`protocol` override resolved config.
+    pi.events.on("pi-otel:dashboard-ready", async (payload) => {
+        if (!ctx0)
+            return;
+        const cfg = resolveConfig(ctx0.cwd);
+        if (!cfg.enabled)
+            return;
+        const override = (payload ?? {});
+        if (typeof override.endpoint === "string" && override.endpoint) {
+            cfg.endpoint = override.endpoint;
+        }
+        if (typeof override.protocol === "string" && override.protocol) {
+            cfg.protocol = override.protocol;
+        }
+        await shutdownSdk();
+        // Caller (e.g. /otel start) already notified success; don't clobber it.
+        wireSdk(cfg, { silentSuccess: true });
+    });
+    // TODO(SPEC §9 q1): inject TRACEPARENT into bash subprocesses once pi
+    // exposes a subprocess-env hook for the bash tool.
+    // TODO(SPEC §7 P3): redaction + truncation for captureContent != "full".
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/otel/logs.d.ts

@@ -0,0 +1,14 @@
+/**
+ * LogRecord emission helpers + OTel diag→OTLP bridge.
+ *
+ * Pi-otel's OWN internal events do NOT use the global `diag` — they go
+ * through the `notify` callback wired from index.ts (ctx.ui.notify), because
+ * failing OTLP machinery cannot reliably report its own failures through
+ * itself.
+ */
+import type { DiagLogger } from "@opentelemetry/api";
+import { type LogAttributes, type Logger, SeverityNumber } from "@opentelemetry/api-logs";
+export declare function getLogger(): Logger;
+export declare function resetLogHandles(): void;
+export declare function emitLifecycleLog(eventName: string, severity: SeverityNumber, body: string, attrs?: LogAttributes): void;
+export declare function buildBridgeDiagLogger(): DiagLogger;

package/dist/otel/logs.js

@@ -0,0 +1,103 @@
+/**
+ * LogRecord emission helpers + OTel diag→OTLP bridge.
+ *
+ * Pi-otel's OWN internal events do NOT use the global `diag` — they go
+ * through the `notify` callback wired from index.ts (ctx.ui.notify), because
+ * failing OTLP machinery cannot reliably report its own failures through
+ * itself.
+ */
+import { logs, SeverityNumber, } from "@opentelemetry/api-logs";
+const LOGGER_NAME = "pi-otel";
+const LOGGER_VERSION = "0.1.0";
+const BRIDGE_LOGGER_NAME = "@opentelemetry/diag";
+let logger = null;
+let bridgeLogger = null;
+export function getLogger() {
+    if (!logger) {
+        logger = logs.getLogger(LOGGER_NAME, LOGGER_VERSION);
+    }
+    return logger;
+}
+function getBridgeLogger() {
+    if (!bridgeLogger) {
+        bridgeLogger = logs.getLogger(BRIDGE_LOGGER_NAME, LOGGER_VERSION);
+    }
+    return bridgeLogger;
+}
+export function resetLogHandles() {
+    logger = null;
+    bridgeLogger = null;
+}
+function emitLogRecord(log, severity, body, attributes) {
+    try {
+        log.emit({
+            severityNumber: severity,
+            severityText: SeverityNumber[severity],
+            body,
+            attributes,
+        });
+    }
+    catch {
+        // best-effort
+    }
+}
+export function emitLifecycleLog(eventName, severity, body, attrs = {}) {
+    emitLogRecord(getLogger(), severity, body, {
+        "event.name": eventName,
+        ...attrs,
+    });
+}
+function stringifyArg(a) {
+    if (typeof a === "string")
+        return a;
+    if (a instanceof Error)
+        return a.stack ?? `${a.name}: ${a.message}`;
+    // grpc-js callErrorFromStatus() uses Object.assign(new Error(), status), copying
+    // code/details/metadata as own properties. In some runtimes instanceof fails across
+    // module boundaries — fall back to duck-typing so we emit the stack, not JSON.
+    if (a &&
+        typeof a === "object" &&
+        typeof a.stack === "string") {
+        return a.stack;
+    }
+    try {
+        return JSON.stringify(a);
+    }
+    catch {
+        return String(a);
+    }
+}
+// Drop per-export ticks from the OTLP exporter delegate — they fire every
+// batch interval and drown signal in Aspire Structured Logs.
+const BRIDGE_DROP = /^(?:items to be sent|OTLPExportDelegate|Export\()/i;
+// Guards against re-entrant calls: logs.getLogger() itself calls diag.warn(),
+// which would recurse infinitely if bridgeLogger is not yet cached.
+let bridgeEmitting = false;
+function emitBridge(severity, message, args) {
+    if (bridgeEmitting)
+        return;
+    // OTel JS internals occasionally pass an Error as the first arg even though
+    // DiagLogger types it as string. Normalize so body is always a human-readable
+    // string (Aspire renders body as the Message column).
+    const text = typeof message === "string" ? message : stringifyArg(message);
+    if (BRIDGE_DROP.test(text))
+        return;
+    const attributes = args.length > 0 ? { "diag.args": args.map(stringifyArg) } : {};
+    bridgeEmitting = true;
+    try {
+        emitLogRecord(getBridgeLogger(), severity, text, attributes);
+    }
+    finally {
+        bridgeEmitting = false;
+    }
+}
+export function buildBridgeDiagLogger() {
+    return {
+        verbose: (message, ...args) => emitBridge(SeverityNumber.DEBUG, message, args),
+        debug: (message, ...args) => emitBridge(SeverityNumber.DEBUG, message, args),
+        info: (message, ...args) => emitBridge(SeverityNumber.INFO, message, args),
+        warn: (message, ...args) => emitBridge(SeverityNumber.WARN, message, args),
+        error: (message, ...args) => emitBridge(SeverityNumber.ERROR, message, args),
+    };
+}
+//# sourceMappingURL=logs.js.map

package/dist/otel/logs.js.map

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

package/dist/otel/metrics.d.ts

@@ -0,0 +1,11 @@
+/**
+ * GenAI client histograms — sigil-aligned per OTel semconv. Lazy so this
+ * module is safe to import when metrics are disabled (global MeterProvider
+ * is then no-op).
+ */
+import { type Counter, type Histogram } from "@opentelemetry/api";
+export declare const getDurationHistogram: () => Histogram<import("@opentelemetry/api").Attributes>;
+export declare const getTokenHistogram: () => Histogram<import("@opentelemetry/api").Attributes>;
+export declare const getToolCallsHistogram: () => Histogram<import("@opentelemetry/api").Attributes>;
+export declare const getToolCallsCounter: () => Counter<import("@opentelemetry/api").Attributes>;
+export declare function resetMetricHandles(): void;

package/dist/otel/metrics.js

@@ -0,0 +1,50 @@
+/**
+ * GenAI client histograms — sigil-aligned per OTel semconv. Lazy so this
+ * module is safe to import when metrics are disabled (global MeterProvider
+ * is then no-op).
+ */
+import { metrics, } from "@opentelemetry/api";
+const METER_NAME = "pi-otel";
+const METER_VERSION = "0.1.0";
+const cache = new Map();
+function getHistogram(name, opts) {
+    let h = cache.get(name);
+    if (!h) {
+        h = metrics.getMeter(METER_NAME, METER_VERSION).createHistogram(name, opts);
+        cache.set(name, h);
+    }
+    return h;
+}
+function getCounter(name, opts) {
+    let c = cache.get(name);
+    if (!c) {
+        c = metrics.getMeter(METER_NAME, METER_VERSION).createCounter(name, opts);
+        cache.set(name, c);
+    }
+    return c;
+}
+export const getDurationHistogram = () => getHistogram("gen_ai.client.operation.duration", {
+    description: "Duration of GenAI client operations",
+    unit: "s",
+});
+export const getTokenHistogram = () => getHistogram("gen_ai.client.token.usage", {
+    description: "Number of tokens used in GenAI client operations",
+    unit: "{token}",
+});
+// Step-1 integer buckets up to 32. Default OTel boundaries start at 5, so
+// per-op counts of 0/1/2 all land in the first bucket and percentile readers
+// (e.g. Aspire) report the bucket upper bound instead of the actual value.
+const TOOL_CALL_BUCKETS = Array.from({ length: 33 }, (_, i) => i);
+export const getToolCallsHistogram = () => getHistogram("gen_ai.client.tool_calls_per_operation", {
+    description: "Number of tool calls per GenAI client operation",
+    unit: "{call}",
+    advice: { explicitBucketBoundaries: TOOL_CALL_BUCKETS },
+});
+export const getToolCallsCounter = () => getCounter("gen_ai.client.tool.calls", {
+    description: "Total number of tool calls invoked by the agent",
+    unit: "{call}",
+});
+export function resetMetricHandles() {
+    cache.clear();
+}
+//# sourceMappingURL=metrics.js.map

package/dist/otel/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/otel/metrics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAIL,OAAO,GACR,MAAM,oBAAoB,CAAC;AAE5B,MAAM,UAAU,GAAG,SAAS,CAAC;AAC7B,MAAM,aAAa,GAAG,OAAO,CAAC;AAE9B,MAAM,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAC;AAErD,SAAS,YAAY,CAAC,IAAY,EAAE,IAAmB;IACrD,IAAI,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAA0B,CAAC;IACjD,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC5E,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,IAAmB;IACnD,IAAI,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAwB,CAAC;IAC/C,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1E,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,EAAE,CACvC,YAAY,CAAC,kCAAkC,EAAE;IAC/C,WAAW,EAAE,qCAAqC;IAClD,IAAI,EAAE,GAAG;CACV,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,EAAE,CACpC,YAAY,CAAC,2BAA2B,EAAE;IACxC,WAAW,EAAE,kDAAkD;IAC/D,IAAI,EAAE,SAAS;CAChB,CAAC,CAAC;AAEL,0EAA0E;AAC1E,6EAA6E;AAC7E,2EAA2E;AAC3E,MAAM,iBAAiB,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AAElE,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,EAAE,CACxC,YAAY,CAAC,wCAAwC,EAAE;IACrD,WAAW,EAAE,iDAAiD;IAC9D,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,EAAE,wBAAwB,EAAE,iBAAiB,EAAE;CACxD,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,EAAE,CACtC,UAAU,CAAC,0BAA0B,EAAE;IACrC,WAAW,EAAE,iDAAiD;IAC9D,IAAI,EAAE,QAAQ;CACf,CAAC,CAAC;AAEL,MAAM,UAAU,kBAAkB;IAChC,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC"}

package/dist/otel/sdk.d.ts

@@ -0,0 +1,14 @@
+/**
+ * OTel SDK bootstrap. One global SDK per process — pi loads us per session
+ * but the SDK is shared across sessions in the same process.
+ */
+import { NodeSDK } from "@opentelemetry/sdk-node";
+import type { OtelConfig } from "../config.js";
+export type NotifySeverity = "info" | "warning" | "error";
+export type Notify = (msg: string, severity?: NotifySeverity) => void;
+export declare function probeTcp(host: string, port: number, timeoutMs?: number): Promise<boolean>;
+export declare function probeEndpoint(endpoint: string, timeoutMs?: number): Promise<boolean>;
+export declare function initSdk(cfg: OtelConfig, notify?: Notify, opts?: {
+    silentSuccess?: boolean;
+}): NodeSDK | null;
+export declare function shutdownSdk(): Promise<void>;

package/dist/otel/sdk.js

@@ -0,0 +1,162 @@
+/**
+ * OTel SDK bootstrap. One global SDK per process — pi loads us per session
+ * but the SDK is shared across sessions in the same process.
+ */
+import { randomBytes } from "node:crypto";
+import { createConnection } from "node:net";
+import { diag, metrics, trace } from "@opentelemetry/api";
+import { logs } from "@opentelemetry/api-logs";
+import { OTLPLogExporter as LogGrpcExporter } from "@opentelemetry/exporter-logs-otlp-grpc";
+import { OTLPLogExporter as LogHttpExporter } from "@opentelemetry/exporter-logs-otlp-http";
+import { OTLPLogExporter as LogProtoExporter } from "@opentelemetry/exporter-logs-otlp-proto";
+import { OTLPMetricExporter as MetricGrpcExporter } from "@opentelemetry/exporter-metrics-otlp-grpc";
+import { OTLPMetricExporter as MetricHttpExporter } from "@opentelemetry/exporter-metrics-otlp-http";
+import { OTLPMetricExporter as MetricProtoExporter } from "@opentelemetry/exporter-metrics-otlp-proto";
+import { OTLPTraceExporter as GrpcExporter } from "@opentelemetry/exporter-trace-otlp-grpc";
+import { OTLPTraceExporter as HttpExporter } from "@opentelemetry/exporter-trace-otlp-http";
+import { OTLPTraceExporter as ProtoExporter } from "@opentelemetry/exporter-trace-otlp-proto";
+import { Resource } from "@opentelemetry/resources";
+import { BatchLogRecordProcessor } from "@opentelemetry/sdk-logs";
+import { PeriodicExportingMetricReader } from "@opentelemetry/sdk-metrics";
+import { NodeSDK } from "@opentelemetry/sdk-node";
+import { BatchSpanProcessor, ParentBasedSampler, TraceIdRatioBasedSampler, } from "@opentelemetry/sdk-trace-base";
+import { ATTR_SERVICE_INSTANCE_ID, ATTR_SERVICE_NAME, } from "@opentelemetry/semantic-conventions/incubating";
+import { ATTR_PI_CWD } from "../attrs.js";
+import { buildBridgeDiagLogger, resetLogHandles } from "./logs.js";
+import { resetMetricHandles } from "./metrics.js";
+let sdk = null;
+let initOnce = false;
+export function probeTcp(host, port, timeoutMs = 300) {
+    return new Promise((resolve) => {
+        const sock = createConnection({ port, host });
+        const done = (ok) => {
+            sock.destroy();
+            resolve(ok);
+        };
+        sock.setTimeout(timeoutMs);
+        sock.once("connect", () => done(true));
+        sock.once("timeout", () => done(false));
+        sock.once("error", () => done(false));
+    });
+}
+// Used at session_start to avoid wiring exporters at a dead endpoint —
+// otherwise the metric reader / log processor begin retrying immediately and
+// those failures get buffered and flushed once the endpoint comes online.
+export function probeEndpoint(endpoint, timeoutMs = 300) {
+    let u;
+    try {
+        u = new URL(endpoint);
+    }
+    catch {
+        return Promise.resolve(false);
+    }
+    // OTLP endpoints always carry an explicit port; refuse to fall back to
+    // 80/443, which could silently green-light an unrelated service.
+    if (!u.port)
+        return Promise.resolve(false);
+    return probeTcp(u.hostname || "127.0.0.1", Number(u.port), timeoutMs);
+}
+function pickByProtocol(cfg, ctors) {
+    const opts = { url: cfg.endpoint, headers: cfg.headers };
+    if (cfg.protocol === "http/protobuf")
+        return new ctors.proto(opts);
+    if (cfg.protocol === "http/json")
+        return new ctors.http(opts);
+    return new ctors.grpc(opts);
+}
+export function initSdk(cfg, notify, opts = {}) {
+    if (!cfg.enabled || !cfg.signals.traces)
+        return null;
+    if (initOnce)
+        return sdk;
+    initOnce = true;
+    const instanceId = `${process.pid}-${randomBytes(4).toString("hex")}`;
+    const resource = new Resource({
+        ...cfg.resourceAttributes,
+        [ATTR_SERVICE_NAME]: cfg.serviceName,
+        [ATTR_SERVICE_INSTANCE_ID]: instanceId,
+        [ATTR_PI_CWD]: cfg.cwd,
+    });
+    const traceExporter = pickByProtocol(cfg, {
+        grpc: GrpcExporter,
+        proto: ProtoExporter,
+        http: HttpExporter,
+    });
+    const spanProcessor = new BatchSpanProcessor(traceExporter);
+    const sampler = cfg.sampleRatio < 1.0
+        ? new ParentBasedSampler({
+            root: new TraceIdRatioBasedSampler(cfg.sampleRatio),
+        })
+        : undefined;
+    const sdkOpts = {
+        resource,
+        spanProcessor,
+        ...(sampler ? { sampler } : {}),
+    };
+    if (cfg.signals.metrics) {
+        const metricExporter = pickByProtocol(cfg, {
+            grpc: MetricGrpcExporter,
+            proto: MetricProtoExporter,
+            http: MetricHttpExporter,
+        });
+        sdkOpts.metricReader = new PeriodicExportingMetricReader({
+            exporter: metricExporter,
+            exportIntervalMillis: 10_000,
+        });
+    }
+    if (cfg.signals.logs) {
+        const logExporter = pickByProtocol(cfg, {
+            grpc: LogGrpcExporter,
+            proto: LogProtoExporter,
+            http: LogHttpExporter,
+        });
+        sdkOpts.logRecordProcessors = [new BatchLogRecordProcessor(logExporter)];
+    }
+    sdk = new NodeSDK(sdkOpts);
+    try {
+        sdk.start();
+    }
+    catch (err) {
+        const e = err;
+        notify?.(`pi-otel: SDK start failed — ${e.message}`, "error");
+        sdk = null;
+        initOnce = false;
+        return null;
+    }
+    // Install bridge AFTER sdk.start() — LoggerProvider must exist first.
+    if (cfg.signals.logs) {
+        diag.setLogger(buildBridgeDiagLogger(), {
+            logLevel: cfg.logLevel,
+            suppressOverrideMessage: true,
+        });
+    }
+    if (!opts.silentSuccess) {
+        notify?.(`pi-otel: OTLP wired to ${cfg.endpoint} (${cfg.protocol})`, "info");
+    }
+    return sdk;
+}
+export async function shutdownSdk() {
+    if (!sdk)
+        return;
+    try {
+        await sdk.shutdown();
+    }
+    catch {
+        // swallow — silent-drop policy (SPEC §7)
+    }
+    finally {
+        // Reset state first so a subsequent initSdk() can proceed even if the
+        // cleanup calls below throw. The global Tracer/Logger/Meter APIs refuse
+        // to replace an already-registered provider — without disabling all
+        // three, a re-init silently keeps the dead providers.
+        sdk = null;
+        initOnce = false;
+        trace.disable();
+        metrics.disable();
+        logs.disable();
+        diag.disable();
+        resetMetricHandles();
+        resetLogHandles();
+    }
+}
+//# sourceMappingURL=sdk.js.map