@vymalo/opencode-otel 0.12.0

package/dist/opencode.d.ts

@@ -0,0 +1,23 @@
+import type { Plugin } from "@opencode-ai/plugin";
+import { type EnvSource } from "./config.js";
+import { type Logger } from "./logging.js";
+import { type ExporterFactories } from "./providers.js";
+export interface OtelPluginFactoryOptions {
+    logger?: Logger;
+    /** Injected environment; defaults to `process.env`. */
+    env?: EnvSource;
+    /** Substitute exporters (tests use in-memory ones). */
+    exporters?: ExporterFactories;
+    /** Injectable clock; defaults to `Date.now`. */
+    now?: () => number;
+    /** Skip `beforeExit`/`SIGINT`/`SIGTERM` registration (tests). */
+    registerProcessHandlers?: boolean;
+    /** Override the resolved host metadata (hostname, version) for tests. */
+    hostInfo?: {
+        hostname?: string;
+        version?: string;
+    };
+}
+export declare function createOtelPlugin(factoryOptions?: OtelPluginFactoryOptions): Plugin;
+export declare const OpencodeOtelPlugin: Plugin;
+export default OpencodeOtelPlugin;

package/dist/opencode.js

@@ -0,0 +1,141 @@
+import { hostname } from "node:os";
+import { resolveOtelConfig } from "./config.js";
+import { createJsonConsoleLogger, DEFAULT_LOG_LEVEL, fromOpenCodeLogLevel, LOG_LEVEL_PRIORITY } from "./logging.js";
+import { installTracePropagation } from "./propagation.js";
+import { buildResource, createProviders, describeError } from "./providers.js";
+import { TelemetryRecorder } from "./recorder.js";
+const PLUGIN_SERVICE_NAME = "opencode-otel-plugin";
+/**
+ * Pipe plugin logs through OpenCode's `client.app.log` so they show up in the
+ * host's structured log stream, with the JSON console as a reliable fallback.
+ * Mirrors the rest of the suite.
+ *
+ * Note this is the plugin's *own* diagnostic logging — entirely separate from
+ * the OTLP logs signal it exports.
+ */
+function createOpenCodeLogger(client, getMinLevel) {
+    const fallback = createJsonConsoleLogger("debug");
+    const consoleAll = /^(1|true|yes|on)$/i.test(process.env.VYMALO_PLUGIN_CONSOLE_LOG ?? "");
+    const write = (level, event, fields) => {
+        if (LOG_LEVEL_PRIORITY[level] < LOG_LEVEL_PRIORITY[getMinLevel()]) {
+            return;
+        }
+        if (consoleAll || level === "warn" || level === "error") {
+            fallback[level](event, fields);
+        }
+        const hostLevel = level === "trace" ? "debug" : level;
+        void client.app
+            .log({
+            body: { service: PLUGIN_SERVICE_NAME, level: hostLevel, message: event, extra: fields }
+        })
+            .catch(() => {
+            /* best-effort */
+        });
+    };
+    return {
+        trace: (event, fields) => write("trace", event, fields),
+        debug: (event, fields) => write("debug", event, fields),
+        info: (event, fields) => write("info", event, fields),
+        warn: (event, fields) => write("warn", event, fields),
+        error: (event, fields) => write("error", event, fields)
+    };
+}
+/**
+ * Drain buffered telemetry on process exit. The plugin API has no dispose hook,
+ * so without this a short CLI invocation loses everything still in a batch
+ * processor. Handlers are registered once and never keep the loop alive.
+ */
+function registerExitHandlers(providers, logger) {
+    let done = false;
+    const drain = () => {
+        if (done) {
+            return;
+        }
+        done = true;
+        void providers.shutdown().catch((error) => {
+            logger.warn("otel_shutdown_failed", { error: describeError(error) });
+        });
+    };
+    process.once("beforeExit", drain);
+    process.once("SIGINT", drain);
+    process.once("SIGTERM", drain);
+}
+export function createOtelPlugin(factoryOptions = {}) {
+    return async (input, pluginOptions) => {
+        let currentLogLevel = DEFAULT_LOG_LEVEL;
+        const logger = factoryOptions.logger ?? createOpenCodeLogger(input.client, () => currentLogLevel);
+        const config = resolveOtelConfig(pluginOptions, factoryOptions.env ?? process.env);
+        if (!config.active) {
+            // No endpoint and no explicit exporter means the plugin was installed but
+            // never configured — cost nothing rather than half-initializing.
+            logger.info("otel_plugin_inactive", {
+                enabled: config.enabled,
+                reason: config.enabled ? "no_exporter_configured" : "disabled"
+            });
+            return {
+                config: async (hostConfig) => {
+                    currentLogLevel = fromOpenCodeLogLevel(hostConfig.logLevel) ?? DEFAULT_LOG_LEVEL;
+                }
+            };
+        }
+        const resource = buildResource(config, {
+            version: factoryOptions.hostInfo?.version,
+            hostname: factoryOptions.hostInfo?.hostname ?? safeHostname(),
+            projectName: input.project?.id,
+            directory: input.directory,
+            worktree: input.worktree
+        });
+        const providers = createProviders(config, resource, logger, factoryOptions.exporters);
+        const recorder = new TelemetryRecorder({
+            providers,
+            config,
+            logger,
+            now: factoryOptions.now
+        });
+        if (factoryOptions.registerProcessHandlers !== false) {
+            registerExitHandlers(providers, logger);
+        }
+        logger.info("otel_plugin_enabled", {
+            serviceName: config.serviceName,
+            exporters: config.exporters,
+            endpoint: config.endpoint,
+            includeSessionId: config.includeSessionId,
+            filteredTools: [...config.filteredTools]
+        });
+        return {
+            config: async (hostConfig) => {
+                currentLogLevel = fromOpenCodeLogLevel(hostConfig.logLevel) ?? DEFAULT_LOG_LEVEL;
+                if (config.propagateTraceContext) {
+                    const wrapped = installTracePropagation(hostConfig, {
+                        getContext: () => recorder.currentChatContext(),
+                        logger
+                    });
+                    logger.debug("otel_trace_propagation_ready", { providerCount: wrapped });
+                }
+            },
+            event: async ({ event }) => {
+                recorder.onEvent(event);
+            },
+            "chat.message": async (chatInput, chatOutput) => {
+                recorder.onChatMessage(chatInput, chatOutput);
+            },
+            "tool.execute.before": async (toolInput) => {
+                recorder.onToolBefore(toolInput);
+            },
+            "tool.execute.after": async (toolInput, toolOutput) => {
+                recorder.onToolAfter(toolInput, toolOutput);
+            }
+        };
+    };
+}
+function safeHostname() {
+    try {
+        return hostname() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export const OpencodeOtelPlugin = createOtelPlugin();
+export default OpencodeOtelPlugin;
+//# sourceMappingURL=opencode.js.map

package/dist/opencode.js.map

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

package/dist/propagation.d.ts

@@ -0,0 +1,22 @@
+import type { Context } from "@opentelemetry/api";
+import type { Logger } from "./logging.js";
+export interface ProviderConfigLike {
+    options?: Record<string, unknown>;
+}
+export interface PropagationConfigInput {
+    provider?: Record<string, ProviderConfigLike | undefined>;
+}
+/**
+ * Wrap every provider's `options.fetch` so outgoing model requests carry W3C
+ * trace context, joining an OpenCode session and its gateway-side spans into
+ * one trace.
+ *
+ * This is the same interception seam `@vymalo/opencode-ratelimit` uses — and it
+ * composes the same way: the existing fetch is captured at install time and
+ * delegated to, so stacking the two plugins in either order works.
+ */
+export declare function installTracePropagation(input: PropagationConfigInput, deps: {
+    getContext: () => Context | undefined;
+    logger: Logger;
+    fetchImpl?: typeof fetch;
+}): number;

package/dist/propagation.js

@@ -0,0 +1,55 @@
+import { defaultTextMapSetter } from "@opentelemetry/api";
+import { W3CTraceContextPropagator } from "@opentelemetry/core";
+const propagator = new W3CTraceContextPropagator();
+/**
+ * Wrap every provider's `options.fetch` so outgoing model requests carry W3C
+ * trace context, joining an OpenCode session and its gateway-side spans into
+ * one trace.
+ *
+ * This is the same interception seam `@vymalo/opencode-ratelimit` uses — and it
+ * composes the same way: the existing fetch is captured at install time and
+ * delegated to, so stacking the two plugins in either order works.
+ */
+export function installTracePropagation(input, deps) {
+    const providers = input.provider;
+    if (!providers) {
+        return 0;
+    }
+    let wrapped = 0;
+    for (const [providerId, providerConfig] of Object.entries(providers)) {
+        if (!providerConfig) {
+            continue;
+        }
+        const options = (providerConfig.options ??= {});
+        const delegate = typeof options.fetch === "function"
+            ? options.fetch
+            : (deps.fetchImpl ?? globalThis.fetch);
+        if (typeof delegate !== "function") {
+            continue;
+        }
+        options.fetch = async (input_, init) => {
+            const context = deps.getContext();
+            if (!context) {
+                return delegate(input_, init);
+            }
+            const carrier = {};
+            propagator.inject(context, carrier, defaultTextMapSetter);
+            if (Object.keys(carrier).length === 0) {
+                return delegate(input_, init);
+            }
+            const headers = new Headers(init?.headers ?? {});
+            // Never clobber an upstream traceparent — if something already set one,
+            // it knows more about the request than we do.
+            for (const [key, value] of Object.entries(carrier)) {
+                if (!headers.has(key)) {
+                    headers.set(key, value);
+                }
+            }
+            return delegate(input_, { ...init, headers });
+        };
+        wrapped += 1;
+        deps.logger.trace("otel_trace_propagation_installed", { providerId });
+    }
+    return wrapped;
+}
+//# sourceMappingURL=propagation.js.map

package/dist/propagation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"propagation.js","sourceRoot":"","sources":["../src/propagation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAYhE,MAAM,UAAU,GAAG,IAAI,yBAAyB,EAAE,CAAC;AAEnD;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAA6B,EAC7B,IAAyF;IAEzF,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC;IACjC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,CAAC,UAAU,EAAE,cAAc,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACrE,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,CAAC,cAAc,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC;QAChD,MAAM,QAAQ,GACZ,OAAO,OAAO,CAAC,KAAK,KAAK,UAAU;YACjC,CAAC,CAAE,OAAO,CAAC,KAAsB;YACjC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;YACnC,SAAS;QACX,CAAC;QAED,OAAO,CAAC,KAAK,GAAG,KAAK,EACnB,MAAmC,EACnC,IAAkC,EACf,EAAE;YACrB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAClC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAChC,CAAC;YACD,MAAM,OAAO,GAA2B,EAAE,CAAC;YAC3C,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,oBAAoB,CAAC,CAAC;YAC1D,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtC,OAAO,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAChC,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;YACjD,wEAAwE;YACxE,8CAA8C;YAC9C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBACtB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC;YACD,OAAO,QAAQ,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAChD,CAAC,CAAC;QACF,OAAO,IAAI,CAAC,CAAC;QACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/providers.d.ts

@@ -0,0 +1,55 @@
+import type { Logger as OtelLogger } from "@opentelemetry/api-logs";
+import { type Resource } from "@opentelemetry/resources";
+import { type LogRecordExporter } from "@opentelemetry/sdk-logs";
+import { type PushMetricExporter } from "@opentelemetry/sdk-metrics";
+import { type SpanExporter } from "@opentelemetry/sdk-trace";
+import type { Tracer } from "@opentelemetry/api";
+import type { Meter } from "@opentelemetry/api";
+import type { Logger } from "./logging.js";
+import type { ResolvedOtelConfig } from "./types.js";
+/**
+ * The three provider handles the recorder needs, plus lifecycle. `undefined`
+ * for a signal whose exporter is `none` — the recorder no-ops on it rather
+ * than branching on config everywhere.
+ */
+export interface TelemetryProviders {
+    tracer?: Tracer;
+    meter?: Meter;
+    otelLogger?: OtelLogger;
+    /** Push everything buffered. Called on `session.idle` and on process exit. */
+    forceFlush(): Promise<void>;
+    /** Flush and tear down. */
+    shutdown(): Promise<void>;
+}
+/**
+ * Exporter factories, injectable so tests can substitute in-memory exporters
+ * without reaching the network or constructing real OTLP clients.
+ */
+export interface ExporterFactories {
+    trace?: (config: ResolvedOtelConfig) => SpanExporter | undefined;
+    metric?: (config: ResolvedOtelConfig) => PushMetricExporter | undefined;
+    log?: (config: ResolvedOtelConfig) => LogRecordExporter | undefined;
+}
+/**
+ * Build the resource every signal is stamped with.
+ *
+ * Deliberately identifies the **machine and the project**, never the developer:
+ * no git author email, no account id. An operator who wants per-person
+ * attribution adds it explicitly via `resourceAttributes` /
+ * `OTEL_RESOURCE_ATTRIBUTES`, which keeps that choice visible in config.
+ */
+export declare function buildResource(config: ResolvedOtelConfig, context: {
+    version?: string;
+    hostname?: string;
+    projectName?: string;
+    directory?: string;
+    worktree?: string;
+    branch?: string;
+}): Resource;
+/**
+ * Construct the enabled providers. Each signal is independent: a failure to
+ * build one leaves the others running, because partial telemetry is strictly
+ * better than an exception escaping into the host's plugin loader.
+ */
+export declare function createProviders(config: ResolvedOtelConfig, resource: Resource, logger: Logger, factories?: ExporterFactories): TelemetryProviders;
+export declare function describeError(error: unknown): string;

package/dist/providers.js

@@ -0,0 +1,179 @@
+import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-proto";
+import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-proto";
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-proto";
+import { resourceFromAttributes } from "@opentelemetry/resources";
+import { BatchLogRecordProcessor, ConsoleLogRecordExporter, LoggerProvider } from "@opentelemetry/sdk-logs";
+import { AggregationTemporality, ConsoleMetricExporter, MeterProvider, PeriodicExportingMetricReader } from "@opentelemetry/sdk-metrics";
+import { BatchSpanProcessor, ConsoleSpanExporter, TracerProvider } from "@opentelemetry/sdk-trace";
+import { signalUrl } from "./config.js";
+const INSTRUMENTATION_SCOPE = "@vymalo/opencode-otel";
+function otlpArgs(config, signal) {
+    const url = signalUrl(config, signal);
+    return url ? { url, headers: config.headers } : undefined;
+}
+const defaultFactories = {
+    trace: (config) => {
+        if (config.exporters.traces === "console") {
+            return new ConsoleSpanExporter();
+        }
+        const args = otlpArgs(config, "traces");
+        return args ? new OTLPTraceExporter(args) : undefined;
+    },
+    metric: (config) => {
+        if (config.exporters.metrics === "console") {
+            return new ConsoleMetricExporter();
+        }
+        const args = otlpArgs(config, "metrics");
+        return args
+            ? new OTLPMetricExporter({
+                ...args,
+                temporalityPreference: config.metricTemporality === "cumulative"
+                    ? AggregationTemporality.CUMULATIVE
+                    : AggregationTemporality.DELTA
+            })
+            : undefined;
+    },
+    log: (config) => {
+        if (config.exporters.logs === "console") {
+            return new ConsoleLogRecordExporter();
+        }
+        const args = otlpArgs(config, "logs");
+        return args ? new OTLPLogExporter(args) : undefined;
+    }
+};
+/**
+ * Build the resource every signal is stamped with.
+ *
+ * Deliberately identifies the **machine and the project**, never the developer:
+ * no git author email, no account id. An operator who wants per-person
+ * attribution adds it explicitly via `resourceAttributes` /
+ * `OTEL_RESOURCE_ATTRIBUTES`, which keeps that choice visible in config.
+ */
+export function buildResource(config, context) {
+    const attributes = {
+        "service.name": config.serviceName,
+        "telemetry.sdk.language": "nodejs"
+    };
+    if (context.version) {
+        attributes["service.version"] = context.version;
+    }
+    if (config.environment) {
+        attributes["deployment.environment.name"] = config.environment;
+    }
+    if (context.hostname) {
+        attributes["host.name"] = context.hostname;
+    }
+    if (context.projectName) {
+        attributes["opencode.project.name"] = context.projectName;
+    }
+    if (context.directory) {
+        attributes["opencode.directory"] = context.directory;
+    }
+    if (context.worktree) {
+        attributes["opencode.worktree"] = context.worktree;
+    }
+    if (context.branch) {
+        attributes["vcs.repository.ref.name"] = context.branch;
+    }
+    // Operator-supplied attributes win — they are the escape hatch, and silently
+    // ignoring them would make the escape hatch useless.
+    return resourceFromAttributes({ ...attributes, ...config.resourceAttributes });
+}
+/**
+ * Construct the enabled providers. Each signal is independent: a failure to
+ * build one leaves the others running, because partial telemetry is strictly
+ * better than an exception escaping into the host's plugin loader.
+ */
+export function createProviders(config, resource, logger, factories = {}) {
+    const make = { ...defaultFactories, ...factories };
+    const flushers = [];
+    const shutdowns = [];
+    let tracer;
+    let meter;
+    let otelLogger;
+    if (config.exporters.traces !== "none") {
+        try {
+            const exporter = make.trace(config);
+            if (exporter) {
+                const provider = new TracerProvider({
+                    resource,
+                    spanProcessors: [
+                        new BatchSpanProcessor({
+                            exporter,
+                            scheduledDelayMillis: config.traceExportIntervalMs
+                        })
+                    ]
+                });
+                tracer = provider.getTracer(INSTRUMENTATION_SCOPE);
+                flushers.push(() => provider.forceFlush());
+                shutdowns.push(() => provider.shutdown());
+            }
+        }
+        catch (error) {
+            logger.warn("otel_traces_init_failed", { error: describeError(error) });
+        }
+    }
+    if (config.exporters.metrics !== "none") {
+        try {
+            const exporter = make.metric(config);
+            if (exporter) {
+                const provider = new MeterProvider({
+                    resource,
+                    readers: [
+                        new PeriodicExportingMetricReader({
+                            exporter,
+                            exportIntervalMillis: config.metricExportIntervalMs
+                        })
+                    ]
+                });
+                meter = provider.getMeter(INSTRUMENTATION_SCOPE);
+                flushers.push(() => provider.forceFlush());
+                shutdowns.push(() => provider.shutdown());
+            }
+        }
+        catch (error) {
+            logger.warn("otel_metrics_init_failed", { error: describeError(error) });
+        }
+    }
+    if (config.exporters.logs !== "none") {
+        try {
+            const exporter = make.log(config);
+            if (exporter) {
+                const provider = new LoggerProvider({
+                    resource,
+                    processors: [
+                        new BatchLogRecordProcessor({
+                            exporter,
+                            scheduledDelayMillis: config.logExportIntervalMs
+                        })
+                    ]
+                });
+                otelLogger = provider.getLogger(INSTRUMENTATION_SCOPE);
+                flushers.push(() => provider.forceFlush());
+                shutdowns.push(() => provider.shutdown());
+            }
+        }
+        catch (error) {
+            logger.warn("otel_logs_init_failed", { error: describeError(error) });
+        }
+    }
+    const runAll = async (tasks) => {
+        // `allSettled`, not `all`: one unreachable collector must not stop the
+        // other signals from draining.
+        await Promise.allSettled(tasks.map((task) => task()));
+    };
+    return {
+        tracer,
+        meter,
+        otelLogger,
+        forceFlush: () => runAll(flushers),
+        shutdown: () => runAll(shutdowns)
+    };
+}
+export function describeError(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+//# sourceMappingURL=providers.js.map

package/dist/providers.js.map

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

package/dist/recorder.d.ts

@@ -0,0 +1,85 @@
+import { type Context } from "@opentelemetry/api";
+import type { Hooks } from "@opencode-ai/plugin";
+import type { Logger } from "./logging.js";
+import type { TelemetryProviders } from "./providers.js";
+import type { ResolvedOtelConfig } from "./types.js";
+type OpencodeEvent = Parameters<NonNullable<Hooks["event"]>>[0]["event"];
+type ChatMessageInput = Parameters<NonNullable<Hooks["chat.message"]>>[0];
+type ChatMessageOutput = Parameters<NonNullable<Hooks["chat.message"]>>[1];
+type ToolBeforeInput = Parameters<NonNullable<Hooks["tool.execute.before"]>>[0];
+type ToolAfterInput = Parameters<NonNullable<Hooks["tool.execute.after"]>>[0];
+export interface RecorderDeps {
+    providers: TelemetryProviders;
+    config: ResolvedOtelConfig;
+    logger: Logger;
+    /** Injectable clock; defaults to `Date.now`. */
+    now?: () => number;
+}
+/**
+ * Translates the OpenCode event stream and hook callbacks into OTel signals.
+ *
+ * Deliberately holds no content: lengths, counts, durations and outcomes only.
+ * See `plans/otel.md` → "No content capture in v1".
+ */
+export declare class TelemetryRecorder {
+    private readonly deps;
+    private readonly instruments?;
+    private readonly now;
+    private readonly sessions;
+    private readonly chats;
+    private readonly tools;
+    /** Terminal tool outcomes already recorded, so the hook and the part update cannot double-count. */
+    private readonly finishedTools;
+    /** Assistant messages already finalized — `message.updated` fires repeatedly with cumulative totals. */
+    private readonly finalizedMessages;
+    /** Pending permission prompts, so `permission.replied` can name the tool it resolved. */
+    private readonly permissions;
+    /**
+     * Last-seen cumulative diff per `sessionID\0file`. `session.diff` reports the
+     * session's whole diff each time, so only the delta may be counted.
+     */
+    private readonly diffs;
+    constructor(deps: RecorderDeps);
+    /**
+     * Session id as a *metric* attribute — omitted unless `includeSessionId`,
+     * because it is unbounded cardinality and metric backends bill per series.
+     * Logs and spans always carry it.
+     */
+    private metricSession;
+    private emit;
+    private session;
+    onEvent(event: OpencodeEvent): void;
+    private dispatch;
+    private onSessionCreated;
+    private onSessionStatus;
+    private settleActiveTime;
+    private onSessionIdle;
+    private onCompacted;
+    private onSessionError;
+    private onSessionDiff;
+    private onMessageUpdated;
+    private finalizeMessage;
+    private onPartUpdated;
+    private onPermissionReplied;
+    private onCommandExecuted;
+    onChatMessage(input: ChatMessageInput, output: ChatMessageOutput): void;
+    onToolBefore(input: ToolBeforeInput): void;
+    onToolAfter(input: ToolAfterInput, output: {
+        output?: string;
+    }): void;
+    /**
+     * Record a tool's terminal outcome exactly once. Both `tool.execute.after`
+     * and the tool part reaching a terminal state report it, and which arrives
+     * depends on whether the tool succeeded — first writer wins, so a failing
+     * tool (no `after` hook) is still counted.
+     */
+    private finishTool;
+    /**
+     * The context of the single in-flight chat, or `undefined` when zero or more
+     * than one is running. Ambiguity yields no trace context rather than a wrong
+     * parent — a missing link is recoverable, a fabricated one is not.
+     */
+    currentChatContext(): Context | undefined;
+    shutdown(): Promise<void>;
+}
+export {};