@vymalo/opencode-otel 0.12.0

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,91 @@
+# `@vymalo/opencode-otel`
+
+[![npm](https://img.shields.io/npm/v/@vymalo/opencode-otel?label=npm&color=CB3837&logo=npm)](https://www.npmjs.com/package/@vymalo/opencode-otel)
+
+**OpenTelemetry export for OpenCode.** Ships what actually happens in a session — cost, tokens, tool
+calls, permission decisions, errors, lines of code — as standard OTLP **traces, metrics and logs**,
+to any OpenTelemetry backend. The OpenCode counterpart to
+[Claude Code's monitoring](https://code.claude.com/docs/en/monitoring-usage) and
+[Codex's `[otel]` block](https://learn.chatgpt.com/docs/config-file/config-advanced).
+
+Part of the [OpenCode Toolbelt](https://github.com/ADORSYS-GIS/lightbridge-opencode-toolbeit).
+
+## Install
+
+```sh
+npm install @vymalo/opencode-otel
+```
+
+```jsonc
+// opencode.json
+{
+  "plugin": [
+    ["@vymalo/opencode-otel", { "endpoint": "http://localhost:4318" }]
+  ]
+}
+```
+
+Or configure it entirely from the environment:
+
+```sh
+export OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:4318"
+```
+
+With **neither** configured the plugin is completely inert — no providers, no sockets, no hooks.
+
+## Why another one
+
+[`opencode-otel-plugin`](https://github.com/felixti/opencode-otel-plugin) already covers traces and
+metrics well, and this package deliberately reuses its GenAI-semconv vocabulary so both land on the
+same dashboards. What it adds:
+
+- **The logs signal** — `user_prompt`, `assistant_response`, `tool_result`, `tool_decision`,
+  `api_error` and friends. This is the developer-interaction stream; Claude Code ships 17 log event
+  types against 8 metrics, and it is where the interesting data lives.
+- **Real USD cost.** OpenCode's host computes `AssistantMessage.cost`; this exports it directly, so
+  there is no price table to maintain and nothing to drift when a provider changes rates.
+- **All five token types** — `input`, `output`, `reasoning`, `cache_read`, `cache_write`. On a
+  cached agentic session cache-read is routinely the majority of tokens, so summing input+output
+  alone measures a different quantity.
+- **Permission decisions**, mapped from OpenCode's `permission.*` events.
+- **`opencode.json` configuration**, not just environment variables — required for
+  `.well-known/opencode` distribution.
+
+Run one or the other, not both: they would double-count.
+
+## At a glance
+
+| Signal | What you get |
+| --- | --- |
+| **Metrics** | `opencode.cost.usage` (USD), `gen_ai.client.token.usage` (5 token types), `gen_ai.client.operation.duration`, session/request/compaction counts, active time, lines of code, tool invocations, permission decisions |
+| **Logs** | `opencode.session_start` / `_idle`, `user_prompt`, `assistant_response`, `tool_result`, `tool_decision`, `api_error`, `file_edited`, `compaction`, `command_executed` |
+| **Traces** | `invoke_agent opencode` → `chat {model}` → `execute_tool {name}`, with W3C `traceparent` propagated into provider requests |
+
+## Privacy
+
+**No content is captured** — not prompts, responses, tool arguments or API bodies. Log records carry
+shape only: lengths, counts, durations, sizes, outcomes, error classes.
+
+Resource attributes identify the **machine and project, never the developer**. The git author email
+is not collected; add `OTEL_RESOURCE_ATTRIBUTES="enduser.id=…"` if you want per-person attribution.
+
+Session id is attached to logs and spans always, but to **metrics only** when `includeSessionId` is
+enabled — it is unbounded cardinality and metric backends bill per series.
+
+## Transport
+
+OTLP over **HTTP with a protobuf payload**, only. gRPC is deliberately absent: OpenCode plugins run
+under Bun as well as Node, and `@grpc/grpc-js` is unreliable there. Put a collector in front if your
+backend needs gRPC. See
+[ADR-0009](https://github.com/ADORSYS-GIS/lightbridge-opencode-toolbeit/blob/main/docs/adr/0009-otel-otlp-http-not-grpc.md).
+
+## Full reference
+
+- [`docs/otel.md`](https://github.com/ADORSYS-GIS/lightbridge-opencode-toolbeit/blob/main/docs/otel.md)
+  — every option, metric, log event and attribute; backend recipes; troubleshooting.
+- [`plans/otel.md`](https://github.com/ADORSYS-GIS/lightbridge-opencode-toolbeit/blob/main/plans/otel.md)
+  — design rationale, the prior-art sweep, and the OpenCode-event → OTel-signal mapping table.
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,27 @@
+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>;
+/**
+ * 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,224 @@
+export const SIGNALS = ["traces", "metrics", "logs"];
+const DEFAULTS = {
+    serviceName: "opencode",
+    metricExportIntervalMs: 60_000,
+    logExportIntervalMs: 5_000,
+    traceExportIntervalMs: 5_000,
+    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 [];
+}
+/**
+ * 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));
+    const enabledSignals = SIGNALS.filter((s) => exporters[s] !== "none");
+    return {
+        enabled,
+        active: enabled && enabledSignals.length > 0,
+        endpoint,
+        endpoints,
+        headers,
+        exporters,
+        serviceName: env.OTEL_SERVICE_NAME || opts.serviceName || DEFAULTS.serviceName,
+        environment: env.OPENCODE_OTEL_ENVIRONMENT || opts.environment || undefined,
+        resourceAttributes,
+        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 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { default } from "./opencode.js";

package/dist/index.js

@@ -0,0 +1,6 @@
+// Intentionally tiny. OpenCode iterates every named export of the main entry
+// and rejects anything that isn't a `Plugin` function, so the only thing this
+// module exposes is the default plugin. Library/utility exports live in
+// `./lib` (see lib.ts), which OpenCode never inspects.
+export { default } from "./opencode.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,8EAA8E;AAC9E,wEAAwE;AACxE,uDAAuD;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC"}

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

package/dist/lib.d.ts

@@ -0,0 +1,8 @@
+export { createOtelPlugin, OpencodeOtelPlugin, type OtelPluginFactoryOptions } from "./opencode.js";
+export { type EnvSource, parseKeyValueList, resolveOtelConfig, signalUrl, SIGNALS } from "./config.js";
+export { buildResource, createProviders, type ExporterFactories, type TelemetryProviders } from "./providers.js";
+export { createInstruments, detectLanguage, type Instruments } from "./instruments.js";
+export { type RecorderDeps, TelemetryRecorder } from "./recorder.js";
+export { installTracePropagation, type PropagationConfigInput, type ProviderConfigLike } from "./propagation.js";
+export { createJsonConsoleLogger, DEFAULT_LOG_LEVEL, fromOpenCodeLogLevel, type LogFields, type Logger, type LogLevel } from "./logging.js";
+export type { ExporterKind, MetricTemporality, OtelPluginOptions, ResolvedOtelConfig, SignalName } from "./types.js";

package/dist/lib.js

@@ -0,0 +1,8 @@
+export { createOtelPlugin, OpencodeOtelPlugin } from "./opencode.js";
+export { parseKeyValueList, resolveOtelConfig, signalUrl, SIGNALS } from "./config.js";
+export { buildResource, createProviders } from "./providers.js";
+export { createInstruments, detectLanguage } from "./instruments.js";
+export { TelemetryRecorder } from "./recorder.js";
+export { installTracePropagation } from "./propagation.js";
+export { createJsonConsoleLogger, DEFAULT_LOG_LEVEL, fromOpenCodeLogLevel } from "./logging.js";
+//# sourceMappingURL=lib.js.map

package/dist/lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAEnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAEL,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,OAAO,EACR,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,aAAa,EACb,eAAe,EAGhB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAoB,MAAM,kBAAkB,CAAC;AAEvF,OAAO,EAAqB,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAErE,OAAO,EACL,uBAAuB,EAGxB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EAIrB,MAAM,cAAc,CAAC"}

package/dist/logging.d.ts

@@ -0,0 +1,16 @@
+import type { LogLevel } from "./types.js";
+export type { LogLevel } from "./types.js";
+export declare const LOG_LEVEL_PRIORITY: Record<LogLevel, number>;
+export declare const DEFAULT_LOG_LEVEL: LogLevel;
+export interface LogFields {
+    [key: string]: unknown;
+}
+export interface Logger {
+    trace(event: string, fields?: LogFields): void;
+    debug(event: string, fields?: LogFields): void;
+    info(event: string, fields?: LogFields): void;
+    warn(event: string, fields?: LogFields): void;
+    error(event: string, fields?: LogFields): void;
+}
+export declare function createJsonConsoleLogger(minLevel?: LogLevel): Logger;
+export declare function fromOpenCodeLogLevel(value: unknown): LogLevel | undefined;

package/dist/logging.js

@@ -0,0 +1,72 @@
+export const LOG_LEVEL_PRIORITY = {
+    trace: 5,
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40
+};
+export const DEFAULT_LOG_LEVEL = "info";
+function redactFields(fields) {
+    if (!fields) {
+        return undefined;
+    }
+    const redacted = {};
+    for (const [key, value] of Object.entries(fields)) {
+        if (/token|secret|password|authorization/i.test(key)) {
+            redacted[key] = "[redacted]";
+            continue;
+        }
+        redacted[key] = value;
+    }
+    return redacted;
+}
+export function createJsonConsoleLogger(minLevel = DEFAULT_LOG_LEVEL) {
+    const minPriority = LOG_LEVEL_PRIORITY[minLevel];
+    const write = (level, event, fields) => {
+        if (LOG_LEVEL_PRIORITY[level] < minPriority) {
+            return;
+        }
+        const payload = {
+            ts: new Date().toISOString(),
+            level,
+            event,
+            ...(redactFields(fields) ?? {})
+        };
+        const line = JSON.stringify(payload);
+        if (level === "error") {
+            console.error(line);
+            return;
+        }
+        if (level === "warn") {
+            console.warn(line);
+            return;
+        }
+        console.log(line);
+    };
+    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)
+    };
+}
+export function fromOpenCodeLogLevel(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    switch (value.toUpperCase()) {
+        case "DEBUG":
+            // Host DEBUG unlocks our most-verbose internal tier (trace).
+            return "trace";
+        case "INFO":
+            return "info";
+        case "WARN":
+            return "warn";
+        case "ERROR":
+            return "error";
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=logging.js.map

package/dist/logging.js.map

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