@vymalo/opencode-core-otel 0.14.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vymalo contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,40 @@
+# @vymalo/opencode-core-otel
+
+Shared OpenTelemetry engine for the @vymalo OpenCode plugin suite. Holds the
+exporter wiring, resource building, the telemetry recorder, and the
+token-source seam in **one place** so [`@vymalo/opencode-otel`](../opencode-otel)
+(and any future OTEL-aware plugin) can share it instead of forking it.
+
+> Extracted from `@vymalo/opencode-otel`.
+
+## What it provides
+
+- `config.ts` — `resolveOtelConfig` and the env/command parsing it depends on.
+- `providers.ts` — `createProviders` / `buildResource`, the OTLP exporter and
+  SDK provider wiring for traces, metrics and logs.
+- `recorder.ts` — `TelemetryRecorder`, the OpenCode-hook-to-OTEL-signal mapper.
+- `instruments.ts` — the counters/histograms the recorder writes through.
+- `token-source.ts` — bearer-token injection for authenticated OTLP exporters.
+- `export-logging.ts` — failure-logging wrapper around exporters.
+- `propagation.ts` — W3C trace-context propagation into provider `fetch`.
+- `vcs.ts` — git remote/branch detection for resource attributes.
+- `deferred.ts` — bounded-wait resource attributes for late-arriving events.
+- `logging.ts` — structured logger with level filtering.
+- `types.ts` — the shared config/option types.
+
+## Usage
+
+```ts
+import { resolveOtelConfig, createProviders, TelemetryRecorder } from "@vymalo/opencode-core-otel";
+```
+
+For the full surface import from `@vymalo/opencode-core-otel/lib`.
+
+## Development
+
+```bash
+pnpm --filter @vymalo/opencode-core-otel build
+pnpm --filter @vymalo/opencode-core-otel typecheck
+pnpm --filter @vymalo/opencode-core-otel test
+pnpm --filter @vymalo/opencode-core-otel coverage
+```

package/dist/config.d.ts

@@ -0,0 +1,39 @@
+import type { ResolvedOtelConfig, SignalName } from "./types.js";
+export declare const SIGNALS: readonly SignalName[];
+/** Env source, injectable so tests never touch `process.env`. */
+export type EnvSource = Record<string, string | undefined>;
+/**
+* Parse the OTel `key=value,key2=value2` list format used by both
+* `OTEL_EXPORTER_OTLP_HEADERS` and `OTEL_RESOURCE_ATTRIBUTES`. Values are
+* percent-decoded per spec; an undecodable value is kept verbatim rather than
+* dropping the whole pair.
+*/
+export declare function parseKeyValueList(raw: string | undefined): Record<string, string>;
+/**
+* Normalise a command to argv. An array is taken verbatim — that is the form to
+* use when a path contains spaces. A string is split on whitespace, with **no
+* shell**: no quoting, no substitution, no injection surface.
+*
+* The split is decided by the type of the value actually supplied, not by the
+* type of some other candidate. Keying it on the wrong source silently produced
+* a single argv element like `"governance-auth token"` whenever an environment
+* override sat on top of an array in config — which `execFile` then failed to
+* spawn, so every export went out unauthenticated.
+*/
+export declare function parseCommand(raw: unknown): string[];
+/**
+* Resolve plugin options against the environment.
+*
+* **Precedence: environment overrides plugin options.** Options are the base
+* layer so a `.well-known/opencode` document can ship a working default for a
+* whole organization; `OTEL_*` variables override per machine so a developer
+* can point at a local collector without editing served config. See
+* `plans/otel.md`.
+*/
+export declare function resolveOtelConfig(raw: unknown, env?: EnvSource): ResolvedOtelConfig;
+/**
+* Resolve the OTLP URL for one signal. A per-signal endpoint is used verbatim
+* (spec: it already includes the path); the base endpoint gets the signal path
+* appended.
+*/
+export declare function signalUrl(config: ResolvedOtelConfig, signal: SignalName): string | undefined;

package/dist/config.js

@@ -0,0 +1,237 @@
+import { DEFAULT_REFRESH_MS } from "./token-source.js";
+export const SIGNALS = [
+	"traces",
+	"metrics",
+	"logs"
+];
+const DEFAULTS = {
+	serviceName: "opencode",
+	metricExportIntervalMs: 6e4,
+	logExportIntervalMs: 5e3,
+	traceExportIntervalMs: 5e3,
+	metricTemporality: "delta"
+};
+/**
+* The `OTEL_*` variable names read per signal. The first entry of each tuple is
+* the OTel-spec name; the second (where present) is the Claude-Code-compatible
+* alias, accepted so an operator can move a working env block across tools.
+*/
+const SIGNAL_ENV = {
+	traces: {
+		exporter: "OTEL_TRACES_EXPORTER",
+		endpoint: "OTEL_EXPORTER_OTLP_TRACES_ENDPOINT",
+		interval: ["OTEL_BSP_SCHEDULE_DELAY", "OTEL_TRACES_EXPORT_INTERVAL"]
+	},
+	metrics: {
+		exporter: "OTEL_METRICS_EXPORTER",
+		endpoint: "OTEL_EXPORTER_OTLP_METRICS_ENDPOINT",
+		interval: ["OTEL_METRIC_EXPORT_INTERVAL"]
+	},
+	logs: {
+		exporter: "OTEL_LOGS_EXPORTER",
+		endpoint: "OTEL_EXPORTER_OTLP_LOGS_ENDPOINT",
+		interval: ["OTEL_BLRP_SCHEDULE_DELAY", "OTEL_LOGS_EXPORT_INTERVAL"]
+	}
+};
+function parseBool(value) {
+	if (value === undefined) {
+		return undefined;
+	}
+	if (/^(1|true|yes|on)$/i.test(value)) {
+		return true;
+	}
+	if (/^(0|false|no|off)$/i.test(value)) {
+		return false;
+	}
+	return undefined;
+}
+function parsePositiveInt(value) {
+	if (value === undefined) {
+		return undefined;
+	}
+	const n = Number.parseInt(value.trim(), 10);
+	return Number.isFinite(n) && n > 0 ? n : undefined;
+}
+/**
+* Parse the OTel `key=value,key2=value2` list format used by both
+* `OTEL_EXPORTER_OTLP_HEADERS` and `OTEL_RESOURCE_ATTRIBUTES`. Values are
+* percent-decoded per spec; an undecodable value is kept verbatim rather than
+* dropping the whole pair.
+*/
+export function parseKeyValueList(raw) {
+	if (!raw) {
+		return {};
+	}
+	const out = {};
+	for (const pair of raw.split(",")) {
+		const eq = pair.indexOf("=");
+		if (eq <= 0) {
+			continue;
+		}
+		const key = pair.slice(0, eq).trim();
+		const rawValue = pair.slice(eq + 1).trim();
+		if (!key) {
+			continue;
+		}
+		try {
+			out[key] = decodeURIComponent(rawValue);
+		} catch {
+			out[key] = rawValue;
+		}
+	}
+	return out;
+}
+function parseExporter(value) {
+	if (value === undefined) {
+		return undefined;
+	}
+	// The spec allows a comma-separated list; we honour the first recognised
+	// entry rather than fanning out to multiple exporters.
+	for (const candidate of value.split(",").map((v) => v.trim().toLowerCase())) {
+		if (candidate === "otlp" || candidate === "console" || candidate === "none") {
+			return candidate;
+		}
+	}
+	return undefined;
+}
+function firstDefined(env, keys) {
+	for (const key of keys) {
+		const value = env[key];
+		if (value !== undefined && value !== "") {
+			return value;
+		}
+	}
+	return undefined;
+}
+function stringRecord(raw) {
+	if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+		return {};
+	}
+	const out = {};
+	for (const [key, value] of Object.entries(raw)) {
+		if (typeof value === "string") {
+			out[key] = value;
+		} else if (typeof value === "number" || typeof value === "boolean") {
+			out[key] = String(value);
+		}
+	}
+	return out;
+}
+function stringList(raw) {
+	if (Array.isArray(raw)) {
+		return raw.filter((v) => typeof v === "string" && v.trim() !== "");
+	}
+	if (typeof raw === "string") {
+		return raw.split(",").map((v) => v.trim()).filter((v) => v !== "");
+	}
+	return [];
+}
+/**
+* Normalise a command to argv. An array is taken verbatim — that is the form to
+* use when a path contains spaces. A string is split on whitespace, with **no
+* shell**: no quoting, no substitution, no injection surface.
+*
+* The split is decided by the type of the value actually supplied, not by the
+* type of some other candidate. Keying it on the wrong source silently produced
+* a single argv element like `"governance-auth token"` whenever an environment
+* override sat on top of an array in config — which `execFile` then failed to
+* spawn, so every export went out unauthenticated.
+*/
+export function parseCommand(raw) {
+	if (Array.isArray(raw)) {
+		return raw.filter((part) => typeof part === "string" && part.trim() !== "");
+	}
+	if (typeof raw === "string") {
+		return raw.split(/\s+/).filter((part) => part !== "");
+	}
+	return [];
+}
+/**
+* Resolve plugin options against the environment.
+*
+* **Precedence: environment overrides plugin options.** Options are the base
+* layer so a `.well-known/opencode` document can ship a working default for a
+* whole organization; `OTEL_*` variables override per machine so a developer
+* can point at a local collector without editing served config. See
+* `plans/otel.md`.
+*/
+export function resolveOtelConfig(raw, env = process.env) {
+	const opts = raw ?? {};
+	const enabled = parseBool(env.OPENCODE_OTEL_ENABLED) ?? opts.enabled !== false;
+	const endpoint = env.OTEL_EXPORTER_OTLP_ENDPOINT || opts.endpoint || undefined;
+	const endpoints = {};
+	for (const signal of SIGNALS) {
+		const value = env[SIGNAL_ENV[signal].endpoint] || opts.endpoints?.[signal];
+		if (value) {
+			endpoints[signal] = value;
+		}
+	}
+	// Env headers merge over option headers key-by-key rather than replacing the
+	// map, so a machine can override just its auth token without restating the
+	// whole set the served config provided.
+	const headers = {
+		...stringRecord(opts.headers),
+		...parseKeyValueList(env.OTEL_EXPORTER_OTLP_HEADERS)
+	};
+	// An endpoint anywhere is what makes OTLP the implicit default; with none
+	// configured the plugin stays completely inert.
+	const hasEndpoint = Boolean(endpoint) || SIGNALS.some((s) => Boolean(endpoints[s]));
+	const fallback = hasEndpoint ? "otlp" : "none";
+	const exporters = {};
+	for (const signal of SIGNALS) {
+		exporters[signal] = parseExporter(env[SIGNAL_ENV[signal].exporter]) ?? opts.exporters?.[signal] ?? fallback;
+	}
+	const resourceAttributes = {
+		...stringRecord(opts.resourceAttributes),
+		...parseKeyValueList(env.OTEL_RESOURCE_ATTRIBUTES)
+	};
+	const temporality = env.OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE?.trim().toLowerCase() === "cumulative" ? "cumulative" : env.OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE?.trim().toLowerCase() === "delta" ? "delta" : opts.metricTemporality ?? DEFAULTS.metricTemporality;
+	const filteredTools = new Set(env.OTEL_OPENCODE_FILTERED_TOOLS !== undefined ? stringList(env.OTEL_OPENCODE_FILTERED_TOOLS) : stringList(opts.filteredTools));
+	// Resolve the source first, then normalise based on *its* own type — see
+	// `parseCommand` for why keying the split on anything else is a trap.
+	const tokenCommand = parseCommand(env.OPENCODE_OTEL_TOKEN_COMMAND ?? opts.tokenCommand);
+	const enabledSignals = SIGNALS.filter((s) => exporters[s] !== "none");
+	return {
+		enabled,
+		active: enabled && enabledSignals.length > 0,
+		endpoint,
+		endpoints,
+		headers,
+		tokenCommand,
+		tokenHeader: env.OPENCODE_OTEL_TOKEN_HEADER || opts.tokenHeader || "Authorization",
+		tokenPrefix: env.OPENCODE_OTEL_TOKEN_PREFIX ?? opts.tokenPrefix ?? "Bearer ",
+		tokenRefreshMs: parsePositiveInt(env.OPENCODE_OTEL_TOKEN_REFRESH_MS) ?? (opts.tokenRefreshMs && opts.tokenRefreshMs > 0 ? opts.tokenRefreshMs : DEFAULT_REFRESH_MS),
+		tokenTimeoutMs: parsePositiveInt(env.OPENCODE_OTEL_TOKEN_TIMEOUT_MS) ?? (opts.tokenTimeoutMs && opts.tokenTimeoutMs > 0 ? opts.tokenTimeoutMs : 1e4),
+		exporters,
+		serviceName: env.OTEL_SERVICE_NAME || opts.serviceName || DEFAULTS.serviceName,
+		environment: env.OPENCODE_OTEL_ENVIRONMENT || opts.environment || undefined,
+		resourceAttributes,
+		collectVcs: parseBool(env.OPENCODE_OTEL_COLLECT_VCS) ?? opts.collectVcs !== false,
+		metricExportIntervalMs: parsePositiveInt(firstDefined(env, SIGNAL_ENV.metrics.interval)) ?? (opts.metricExportIntervalMs && opts.metricExportIntervalMs > 0 ? opts.metricExportIntervalMs : DEFAULTS.metricExportIntervalMs),
+		logExportIntervalMs: parsePositiveInt(firstDefined(env, SIGNAL_ENV.logs.interval)) ?? (opts.logExportIntervalMs && opts.logExportIntervalMs > 0 ? opts.logExportIntervalMs : DEFAULTS.logExportIntervalMs),
+		traceExportIntervalMs: parsePositiveInt(firstDefined(env, SIGNAL_ENV.traces.interval)) ?? (opts.traceExportIntervalMs && opts.traceExportIntervalMs > 0 ? opts.traceExportIntervalMs : DEFAULTS.traceExportIntervalMs),
+		metricTemporality: temporality,
+		includeSessionId: parseBool(env.OTEL_METRICS_INCLUDE_SESSION_ID) ?? opts.includeSessionId === true,
+		filteredTools,
+		propagateTraceContext: parseBool(env.OPENCODE_OTEL_PROPAGATE_TRACE_CONTEXT) ?? (opts.propagateTraceContext !== false && exporters.traces !== "none")
+	};
+}
+/**
+* Resolve the OTLP URL for one signal. A per-signal endpoint is used verbatim
+* (spec: it already includes the path); the base endpoint gets the signal path
+* appended.
+*/
+export function signalUrl(config, signal) {
+	const explicit = config.endpoints[signal];
+	if (explicit) {
+		return explicit;
+	}
+	if (!config.endpoint) {
+		return undefined;
+	}
+	const base = config.endpoint.replace(/\/+$/, "");
+	const path = signal === "traces" ? "v1/traces" : signal === "metrics" ? "v1/metrics" : "v1/logs";
+	return `${base}/${path}`;
+}
+
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/deferred.d.ts

@@ -0,0 +1,22 @@
+/**
+* A resource attribute whose value only becomes known after the plugin has
+* already started — OpenCode reports the host version and the git branch as
+* *events*, not as plugin input, but an OTel `Resource` is fixed at provider
+* construction.
+*
+* The OTel resource API accepts promise-valued attributes and exporters await
+* them before the first export, so a deferred value is the supported way to
+* bridge that gap. The timeout is not optional: a promise that never settles
+* would block every export forever, so an attribute that has not arrived in
+* time resolves to `undefined` and is dropped from the resource.
+*/
+export interface DeferredAttribute {
+	/** Hand this to `resourceFromAttributes`. */
+	readonly value: Promise<string | undefined>;
+	/** Settle it with the real value. Later calls are ignored. */
+	settle(value: string | undefined): void;
+	/** Give up and settle as absent. Idempotent. */
+	abandon(): void;
+}
+export declare const DEFAULT_DEFERRED_TIMEOUT_MS = 2e3;
+export declare function deferredAttribute(timeoutMs?: number, schedule?: typeof setTimeout): DeferredAttribute;

package/dist/deferred.js

@@ -0,0 +1,29 @@
+export const DEFAULT_DEFERRED_TIMEOUT_MS = 2e3;
+export function deferredAttribute(timeoutMs = DEFAULT_DEFERRED_TIMEOUT_MS, schedule = setTimeout) {
+	let resolve = () => {};
+	let settled = false;
+	const value = new Promise((r) => {
+		resolve = r;
+	});
+	const finish = (next) => {
+		if (settled) {
+			return;
+		}
+		settled = true;
+		resolve(next);
+	};
+	const timer = schedule(() => finish(undefined), timeoutMs);
+	// Never hold a short CLI invocation open just to wait for an attribute.
+	timer.unref?.();
+	return {
+		value,
+		settle: (next) => {
+			if (next !== undefined && next !== "") {
+				finish(next);
+			}
+		},
+		abandon: () => finish(undefined)
+	};
+}
+
+//# sourceMappingURL=deferred.js.map

package/dist/deferred.js.map

@@ -0,0 +1 @@
+{"mappings":"AAqBA,OAAO,MAAM,8BAA8B;AAE3C,OAAO,SAAS,kBACd,YAAoB,6BACpB,WAA8B,YACX;CACnB,IAAI,gBAAqD,CAAC;CAC1D,IAAI,UAAU;CACd,MAAM,QAAQ,IAAI,SAA6B,MAAM;EACnD,UAAU;CACZ,CAAC;CAED,MAAM,UAAU,SAAmC;EACjD,IAAI,SAAS;GACX;EACF;EACA,UAAU;EACV,QAAQ,IAAI;CACd;CAEA,MAAM,QAAQ,eAAe,OAAO,SAAS,GAAG,SAAS;;CAEzD,AAAC,MAAiC,QAAQ;CAE1C,OAAO;EACL;EACA,SAAS,SAAS;GAChB,IAAI,SAAS,aAAa,SAAS,IAAI;IACrC,OAAO,IAAI;GACb;EACF;EACA,eAAe,OAAO,SAAS;CACjC;AACF","names":[],"sources":["../src/deferred.ts"],"version":3,"file":"deferred.js","sourceRoot":""}

package/dist/export-logging.d.ts

@@ -0,0 +1,28 @@
+import { type ExportResult } from "@opentelemetry/core";
+import type { Logger } from "./logging.js";
+import type { SignalName } from "./types.js";
+/**
+* The shape all three OTel exporters share: `export(items, resultCallback)`.
+* Typed structurally rather than against `SpanExporter | PushMetricExporter |
+* LogRecordExporter`, whose item types are unrelated.
+*/
+export interface ExporterLike {
+	export(items: never, resultCallback: (result: ExportResult) => void): void;
+	shutdown(): Promise<void>;
+	forceFlush?(): Promise<void>;
+}
+/**
+* Wrap an exporter so a failed export reaches the host log stream.
+*
+* Without this, a rejected OTLP request — an expired credential, a wrong
+* audience, an unreachable collector — is reported only through the OTel SDK's
+* own `diag` channel, which nothing here subscribes to. The visible symptom is
+* that telemetry silently stops while the session looks entirely healthy.
+*
+* Deliberately not `diag.setLogger`: that is process-global and would hijack
+* the channel for the host and every other plugin. Decorating our own exporters
+* observes exactly the failures we caused and nothing else.
+*/
+export declare function withFailureLogging<T extends ExporterLike>(exporter: T, signal: SignalName, logger: Logger, options?: {
+	onFailure?: () => void;
+}): T;

package/dist/export-logging.js

@@ -0,0 +1,74 @@
+import { ExportResultCode } from "@opentelemetry/core";
+/**
+* Wrap an exporter so a failed export reaches the host log stream.
+*
+* Without this, a rejected OTLP request — an expired credential, a wrong
+* audience, an unreachable collector — is reported only through the OTel SDK's
+* own `diag` channel, which nothing here subscribes to. The visible symptom is
+* that telemetry silently stops while the session looks entirely healthy.
+*
+* Deliberately not `diag.setLogger`: that is process-global and would hijack
+* the channel for the host and every other plugin. Decorating our own exporters
+* observes exactly the failures we caused and nothing else.
+*/
+export function withFailureLogging(exporter, signal, logger, options = {}) {
+	let consecutiveFailures = 0;
+	const wrapped = {
+		export(items, resultCallback) {
+			exporter.export(items, (result) => {
+				if (result.code === ExportResultCode.SUCCESS) {
+					if (consecutiveFailures > 0) {
+						logger.info("otel_export_recovered", {
+							signal,
+							afterFailures: consecutiveFailures
+						});
+						consecutiveFailures = 0;
+					}
+				} else {
+					consecutiveFailures += 1;
+					logger.warn("otel_export_failed", {
+						signal,
+						consecutiveFailures,
+						// `error` may carry an HTTP status; the message is the actionable
+						// part (e.g. "authentication didn't succeed" from an OIDC gate).
+						error: describeExportError(result.error),
+						status: readStatus(result.error)
+					});
+					options.onFailure?.();
+				}
+				resultCallback(result);
+			});
+		},
+		shutdown: () => exporter.shutdown(),
+		...exporter.forceFlush ? { forceFlush: () => exporter.forceFlush?.() } : {}
+	};
+	// Preserve the prototype and any extra members the concrete exporter exposes.
+	return Object.assign(Object.create(Object.getPrototypeOf(exporter)), exporter, wrapped);
+}
+function describeExportError(error) {
+	if (!error) {
+		return "unknown";
+	}
+	if (error instanceof Error) {
+		return error.message;
+	}
+	return String(error);
+}
+/** OTLP exporter errors carry the HTTP status as `code` or `statusCode`. */
+function readStatus(error) {
+	if (!error || typeof error !== "object") {
+		return undefined;
+	}
+	const candidate = error;
+	for (const value of [candidate.statusCode, candidate.code]) {
+		if (typeof value === "number") {
+			return value;
+		}
+		if (typeof value === "string" && /^\d{3}$/.test(value)) {
+			return Number(value);
+		}
+	}
+	return undefined;
+}
+
+//# sourceMappingURL=export-logging.js.map

package/dist/export-logging.js.map

@@ -0,0 +1 @@
+{"mappings":"AAAA,SAA4B,wBAAwB;;;;;;;;;;;;;AA4BpD,OAAO,SAAS,mBACd,UACA,QACA,QACA,UAAsC,CAAC,GACpC;CACH,IAAI,sBAAsB;CAE1B,MAAM,UAAwB;EAC5B,OAAO,OAAO,gBAAgB;GAC5B,SAAS,OAAO,QAAQ,WAAW;IACjC,IAAI,OAAO,SAAS,iBAAiB,SAAS;KAC5C,IAAI,sBAAsB,GAAG;MAC3B,OAAO,KAAK,yBAAyB;OAAE;OAAQ,eAAe;MAAoB,CAAC;MACnF,sBAAsB;KACxB;IACF,OAAO;KACL,uBAAuB;KACvB,OAAO,KAAK,sBAAsB;MAChC;MACA;;;MAGA,OAAO,oBAAoB,OAAO,KAAK;MACvC,QAAQ,WAAW,OAAO,KAAK;KACjC,CAAC;KACD,QAAQ,YAAY;IACtB;IACA,eAAe,MAAM;GACvB,CAAC;EACH;EACA,gBAAgB,SAAS,SAAS;EAClC,GAAI,SAAS,aAAa,EAAE,kBAAkB,SAAS,aAAa,EAAmB,IAAI,CAAC;CAC9F;;CAGA,OAAO,OAAO,OAAO,OAAO,OAAO,OAAO,eAAe,QAAQ,CAAC,GAAG,UAAU,OAAO;AACxF;AAEA,SAAS,oBAAoB,OAAwB;CACnD,IAAI,CAAC,OAAO;EACV,OAAO;CACT;CACA,IAAI,iBAAiB,OAAO;EAC1B,OAAO,MAAM;CACf;CACA,OAAO,OAAO,KAAK;AACrB;;AAGA,SAAS,WAAW,OAAoC;CACtD,IAAI,CAAC,SAAS,OAAO,UAAU,UAAU;EACvC,OAAO;CACT;CACA,MAAM,YAAY;CAClB,KAAK,MAAM,SAAS,CAAC,UAAU,YAAY,UAAU,IAAI,GAAG;EAC1D,IAAI,OAAO,UAAU,UAAU;GAC7B,OAAO;EACT;EACA,IAAI,OAAO,UAAU,YAAY,UAAU,KAAK,KAAK,GAAG;GACtD,OAAO,OAAO,KAAK;EACrB;CACF;CACA,OAAO;AACT","names":[],"sources":["../src/export-logging.ts"],"version":3,"file":"export-logging.js","sourceRoot":""}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from "./lib.js";

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from "./lib.js";
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"mappings":"AAAA,cAAc","names":[],"sources":["../src/index.ts"],"version":3,"file":"index.js","sourceRoot":""}

package/dist/instruments.d.ts

@@ -0,0 +1,29 @@
+import type { Counter, Histogram, Meter } from "@opentelemetry/api";
+/**
+* Every metric this plugin emits, created once per plugin instance.
+*
+* Naming follows the GenAI semantic conventions where one exists
+* (`gen_ai.client.*`) and `opencode.*` otherwise — deliberately matching the
+* vocabulary `opencode-otel-plugin` already established, so both plugins' data
+* lands on the same dashboards. See `plans/otel.md`.
+*/
+export interface Instruments {
+	/** Real USD, straight from `AssistantMessage.cost` — no price table involved. */
+	cost: Counter;
+	/** All five token types, discriminated by `gen_ai.token.type`. */
+	tokens: Histogram;
+	/** Assistant-message wall time, seconds. */
+	duration: Histogram;
+	sessions: Counter;
+	requests: Counter;
+	compactions: Counter;
+	/** Wall time a session spent `busy`, seconds. */
+	activeTime: Counter;
+	linesOfCode: Counter;
+	toolInvocations: Counter;
+	permissionDecisions: Counter;
+	commands: Counter;
+}
+export declare function createInstruments(meter: Meter): Instruments;
+/** Best-effort language for a path, by extension. `undefined` when unknown. */
+export declare function detectLanguage(file: string): string | undefined;

package/dist/instruments.js

@@ -0,0 +1,103 @@
+export function createInstruments(meter) {
+	return {
+		cost: meter.createCounter("opencode.cost.usage", {
+			description: "Cost of model usage, as reported by the OpenCode host",
+			unit: "USD"
+		}),
+		tokens: meter.createHistogram("gen_ai.client.token.usage", {
+			description: "Tokens consumed per assistant message, by token type",
+			unit: "{token}"
+		}),
+		duration: meter.createHistogram("gen_ai.client.operation.duration", {
+			description: "Duration of a model operation",
+			unit: "s"
+		}),
+		sessions: meter.createCounter("opencode.session.count", {
+			description: "Sessions started",
+			unit: "{session}"
+		}),
+		requests: meter.createCounter("opencode.session.request.count", {
+			description: "Assistant messages completed",
+			unit: "{request}"
+		}),
+		compactions: meter.createCounter("opencode.session.compaction.count", {
+			description: "Context compactions performed",
+			unit: "{compaction}"
+		}),
+		activeTime: meter.createCounter("opencode.active_time.total", {
+			description: "Wall time sessions spent busy",
+			unit: "s"
+		}),
+		linesOfCode: meter.createCounter("opencode.lines_of_code.count", {
+			description: "Lines added or removed across session diffs",
+			unit: "{line}"
+		}),
+		toolInvocations: meter.createCounter("opencode.tool.invocations", {
+			description: "Tool executions",
+			unit: "{invocation}"
+		}),
+		permissionDecisions: meter.createCounter("opencode.permission.decision.count", {
+			description: "Permission prompts resolved",
+			unit: "{decision}"
+		}),
+		commands: meter.createCounter("opencode.command.executed.count", {
+			description: "Slash commands executed",
+			unit: "{command}"
+		})
+	};
+}
+const EXTENSION_LANGUAGES = {
+	ts: "typescript",
+	tsx: "typescript",
+	mts: "typescript",
+	cts: "typescript",
+	js: "javascript",
+	jsx: "javascript",
+	mjs: "javascript",
+	cjs: "javascript",
+	py: "python",
+	rs: "rust",
+	go: "go",
+	java: "java",
+	kt: "kotlin",
+	kts: "kotlin",
+	swift: "swift",
+	dart: "dart",
+	rb: "ruby",
+	php: "php",
+	cs: "csharp",
+	c: "c",
+	h: "c",
+	cc: "cpp",
+	cpp: "cpp",
+	hpp: "cpp",
+	m: "objective-c",
+	mm: "objective-c",
+	scala: "scala",
+	ex: "elixir",
+	exs: "elixir",
+	sh: "shell",
+	bash: "shell",
+	zsh: "shell",
+	sql: "sql",
+	html: "html",
+	css: "css",
+	scss: "scss",
+	json: "json",
+	yaml: "yaml",
+	yml: "yaml",
+	toml: "toml",
+	md: "markdown",
+	tf: "terraform"
+};
+/** Best-effort language for a path, by extension. `undefined` when unknown. */
+export function detectLanguage(file) {
+	const base = file.slice(file.lastIndexOf("/") + 1);
+	const dot = base.lastIndexOf(".");
+	if (dot <= 0) {
+		return undefined;
+	}
+	return EXTENSION_LANGUAGES[base.slice(dot + 1).toLowerCase()];
+}
+
+//# sourceMappingURL=instruments.js.map

package/dist/instruments.js.map

@@ -0,0 +1 @@
+{"mappings":"AA4BA,OAAO,SAAS,kBAAkB,OAA2B;CAC3D,OAAO;EACL,MAAM,MAAM,cAAc,uBAAuB;GAC/C,aAAa;GACb,MAAM;EACR,CAAC;EACD,QAAQ,MAAM,gBAAgB,6BAA6B;GACzD,aAAa;GACb,MAAM;EACR,CAAC;EACD,UAAU,MAAM,gBAAgB,oCAAoC;GAClE,aAAa;GACb,MAAM;EACR,CAAC;EACD,UAAU,MAAM,cAAc,0BAA0B;GACtD,aAAa;GACb,MAAM;EACR,CAAC;EACD,UAAU,MAAM,cAAc,kCAAkC;GAC9D,aAAa;GACb,MAAM;EACR,CAAC;EACD,aAAa,MAAM,cAAc,qCAAqC;GACpE,aAAa;GACb,MAAM;EACR,CAAC;EACD,YAAY,MAAM,cAAc,8BAA8B;GAC5D,aAAa;GACb,MAAM;EACR,CAAC;EACD,aAAa,MAAM,cAAc,gCAAgC;GAC/D,aAAa;GACb,MAAM;EACR,CAAC;EACD,iBAAiB,MAAM,cAAc,6BAA6B;GAChE,aAAa;GACb,MAAM;EACR,CAAC;EACD,qBAAqB,MAAM,cAAc,sCAAsC;GAC7E,aAAa;GACb,MAAM;EACR,CAAC;EACD,UAAU,MAAM,cAAc,mCAAmC;GAC/D,aAAa;GACb,MAAM;EACR,CAAC;CACH;AACF;AAEA,MAAM,sBAA8C;CAClD,IAAI;CACJ,KAAK;CACL,KAAK;CACL,KAAK;CACL,IAAI;CACJ,KAAK;CACL,KAAK;CACL,KAAK;CACL,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,MAAM;CACN,IAAI;CACJ,KAAK;CACL,OAAO;CACP,MAAM;CACN,IAAI;CACJ,KAAK;CACL,IAAI;CACJ,GAAG;CACH,GAAG;CACH,IAAI;CACJ,KAAK;CACL,KAAK;CACL,GAAG;CACH,IAAI;CACJ,OAAO;CACP,IAAI;CACJ,KAAK;CACL,IAAI;CACJ,MAAM;CACN,KAAK;CACL,KAAK;CACL,MAAM;CACN,KAAK;CACL,MAAM;CACN,MAAM;CACN,MAAM;CACN,KAAK;CACL,MAAM;CACN,IAAI;CACJ,IAAI;AACN;;AAGA,OAAO,SAAS,eAAe,MAAkC;CAC/D,MAAM,OAAO,KAAK,MAAM,KAAK,YAAY,GAAG,IAAI,CAAC;CACjD,MAAM,MAAM,KAAK,YAAY,GAAG;CAChC,IAAI,OAAO,GAAG;EACZ,OAAO;CACT;CACA,OAAO,oBAAoB,KAAK,MAAM,MAAM,CAAC,CAAC,CAAC,YAAY;AAC7D","names":[],"sources":["../src/instruments.ts"],"version":3,"file":"instruments.js","sourceRoot":""}