@smthrs/observability 0.35.0 → 1.0.0-rc.12

package/src/SmithersLogFormat.ts

@@ -1 +0,0 @@
-export type SmithersLogFormat = "json" | "pretty" | "string" | "logfmt";

package/src/SmithersMetricDefinition.ts

@@ -1,15 +0,0 @@
-import type { MetricLabels } from "./_corePrometheusShape.ts";
-import type { SmithersMetricType } from "./SmithersMetricType.ts";
-import type { SmithersMetricUnit } from "./SmithersMetricUnit.ts";
-
-export type SmithersMetricDefinition = {
-  readonly key: string;
-  readonly name: string;
-  readonly prometheusName: string;
-  readonly type: SmithersMetricType;
-  readonly label: string;
-  readonly unit?: SmithersMetricUnit;
-  readonly labels?: readonly string[];
-  readonly defaultLabels?: readonly MetricLabels[];
-  readonly boundaries?: readonly number[];
-};

package/src/SmithersMetricType.ts

@@ -1 +0,0 @@
-export type SmithersMetricType = "counter" | "gauge" | "histogram";

package/src/SmithersMetricUnit.ts

@@ -1 +0,0 @@
-export type SmithersMetricUnit = "count" | "milliseconds" | "seconds" | "bytes" | "tokens" | "ratio" | "depth";

package/src/SmithersObservability.js

@@ -1,15 +0,0 @@
-import { Context } from "effect";
-/** @typedef {import("./SmithersObservabilityService.ts").SmithersObservabilityService} SmithersObservabilityService */
-
-/** @typedef {Context.ServiceClass.Shape<"SmithersObservability", SmithersObservabilityService>} SmithersObservability */
-const SmithersObservabilityTag =
-  /** @type {Context.ServiceClass<SmithersObservability, "SmithersObservability", SmithersObservabilityService>} */ (
-    Context.Service()("SmithersObservability")
-  );
-export const SmithersObservability = /** @type {Context.ServiceClass<SmithersObservability, "SmithersObservability", SmithersObservabilityService>} */ (
-  class SmithersObservability extends SmithersObservabilityTag {
-    constructor(...args) {
-      super(...args);
-    }
-  }
-);

package/src/SmithersObservabilityOptions.ts

@@ -1,12 +0,0 @@
-import type { LogLevel } from "effect";
-import type { SmithersLogFormat } from "./SmithersLogFormat";
-
-export type SmithersObservabilityOptions = {
-  readonly enabled?: boolean;
-  readonly endpoint?: string;
-  readonly headers?: Record<string, string>;
-  readonly serviceName?: string;
-  readonly logFormat?: SmithersLogFormat;
-  readonly logLevel?: LogLevel.LogLevel | string;
-  readonly installLogger?: boolean;
-};

package/src/SmithersObservabilityService.ts

@@ -1,13 +0,0 @@
-import type { Effect } from "effect";
-import type * as Tracer from "effect/Tracer";
-import type { ResolvedSmithersObservabilityOptions } from "./ResolvedSmithersObservabilityOptions";
-
-export type SmithersObservabilityService = {
-  readonly options: ResolvedSmithersObservabilityOptions;
-  readonly annotate: (attributes: Readonly<Record<string, unknown>>) => Effect.Effect<void>;
-  readonly withSpan: <A, E, R>(
-    name: string,
-    effect: Effect.Effect<A, E, R>,
-    attributes?: Readonly<Record<string, unknown>>,
-  ) => Effect.Effect<A, E, Exclude<R, Tracer.ParentSpan>>;
-};

package/src/_coreCorrelation/CorrelationContext.ts

@@ -1,10 +0,0 @@
-export type CorrelationContext = {
-  runId: string;
-  nodeId?: string;
-  iteration?: number;
-  attempt?: number;
-  workflowName?: string;
-  parentRunId?: string;
-  traceId?: string;
-  spanId?: string;
-};

package/src/_coreCorrelation/CorrelationContextLive.js

@@ -1,11 +0,0 @@
-import { Layer } from "effect";
-import { CorrelationContextService } from "./CorrelationContextService.js";
-import { correlationContextToLogAnnotations } from "./correlationContextToLogAnnotations.js";
-import { getCurrentCorrelationContextEffect } from "./getCurrentCorrelationContextEffect.js";
-import { withCorrelationContext } from "./withCorrelationContext.js";
-/** @type {Layer.Layer<CorrelationContextService, never, never>} */
-export const CorrelationContextLive = Layer.succeed(CorrelationContextService, {
-  current: () => getCurrentCorrelationContextEffect(),
-  withCorrelation: (patch, effect) => withCorrelationContext(effect, patch),
-  toLogAnnotations: correlationContextToLogAnnotations,
-});

package/src/_coreCorrelation/CorrelationContextService.js

@@ -1,15 +0,0 @@
-import { Context } from "effect";
-/** @typedef {import("./CorrelationContextServiceShape.ts").CorrelationContextServiceShape} CorrelationContextServiceShape */
-
-/** @typedef {Context.ServiceClass.Shape<"CorrelationContextService", CorrelationContextServiceShape>} CorrelationContextService */
-const CorrelationContextServiceTag =
-  /** @type {Context.ServiceClass<CorrelationContextService, "CorrelationContextService", CorrelationContextServiceShape>} */ (
-    Context.Service()("CorrelationContextService")
-  );
-export const CorrelationContextService = /** @type {Context.ServiceClass<CorrelationContextService, "CorrelationContextService", CorrelationContextServiceShape>} */ (
-  class CorrelationContextService extends CorrelationContextServiceTag {
-    constructor(...args) {
-      super(...args);
-    }
-  }
-);

package/src/_coreCorrelation/CorrelationContextServiceShape.ts

@@ -1,12 +0,0 @@
-import type { Effect } from "effect";
-import type { CorrelationContext } from "./CorrelationContext.ts";
-import type { CorrelationPatch } from "./CorrelationPatch.ts";
-
-export type CorrelationContextServiceShape = {
-  readonly current: () => Effect.Effect<CorrelationContext | undefined>;
-  readonly withCorrelation: <A, E, R>(
-    patch: CorrelationPatch,
-    effect: Effect.Effect<A, E, R>,
-  ) => Effect.Effect<A, E, R>;
-  readonly toLogAnnotations: (context?: CorrelationContext | null) => Record<string, unknown> | undefined;
-};

package/src/_coreCorrelation/CorrelationPatch.ts

@@ -1,3 +0,0 @@
-import type { CorrelationContext } from "./CorrelationContext.ts";
-
-export type CorrelationPatch = Partial<CorrelationContext> | undefined | null;

package/src/_coreCorrelation/README.md

@@ -1,20 +0,0 @@
-# _coreCorrelation/
-
-The correlation-context core: a per-run/node/attempt context (`{ runId,
-nodeId, iteration, attempt, workflowName, parentRunId, traceId, spanId }`)
-tracked on TWO stores at once — an AsyncLocalStorage
-(`_correlationStorage.js`) for synchronous, non-Effect readers (the imperative
-logger) and a FiberRef (`correlationContextFiberRef.js`) for Effect code.
-
-How the pieces fit: `mergeCorrelationContext.js` normalizes patches and
-requires a `runId` for a context to exist; `withCorrelationContext.js` bridges
-a patch onto BOTH stores; `getCurrentCorrelationContextEffect.js` prefers the
-FiberRef and falls back to the ALS; `CorrelationContextLive.js` packages the
-whole thing as an Effect service; `index.js` is the barrel that
-`../correlation.js` re-exports from.
-
-Gotcha: run effects wrapped by `withCorrelationContext` with `runPromise` or
-`runFork`, never `runSync` — its acquire step calls
-`AsyncLocalStorage.enterWith()`, which under `runSync` leaks the context into
-the caller's synchronous async-context (documented in
-`withCorrelationContext.js`).

package/src/_coreCorrelation/_correlationStorage.js

@@ -1,4 +0,0 @@
-import { AsyncLocalStorage } from "node:async_hooks";
-/** @typedef {import("./CorrelationContext.ts").CorrelationContext} CorrelationContext */
-/** @type {AsyncLocalStorage<CorrelationContext>} */
-export const correlationStorage = new AsyncLocalStorage();

package/src/_coreCorrelation/correlationContextFiberRef.js

@@ -1,5 +0,0 @@
-import { Context } from "effect";
-
-export const correlationContextFiberRef = Context.Reference("smithers/observability/correlation-context", {
-  defaultValue: () => undefined,
-});

package/src/_coreCorrelation/correlationContextToLogAnnotations.js

@@ -1,18 +0,0 @@
-/** @typedef {import("./CorrelationContext.ts").CorrelationContext} CorrelationContext */
-/**
- * @param {CorrelationContext | null} [context]
- * @returns {Record<string, unknown> | undefined}
- */
-export function correlationContextToLogAnnotations(context) {
-  if (!context) return undefined;
-  const annotations = {};
-  if (context.runId) annotations.runId = context.runId;
-  if (context.nodeId) annotations.nodeId = context.nodeId;
-  if (context.workflowName) annotations.workflowName = context.workflowName;
-  if (context.parentRunId) annotations.parentRunId = context.parentRunId;
-  if (context.traceId) annotations.traceId = context.traceId;
-  if (context.spanId) annotations.spanId = context.spanId;
-  if (typeof context.iteration === "number") annotations.iteration = context.iteration;
-  if (typeof context.attempt === "number") annotations.attempt = context.attempt;
-  return Object.keys(annotations).length > 0 ? annotations : undefined;
-}

package/src/_coreCorrelation/getCurrentCorrelationContext.js

@@ -1,9 +0,0 @@
-import { correlationStorage } from "./_correlationStorage.js";
-/** @typedef {import("./CorrelationContext.ts").CorrelationContext} CorrelationContext */
-
-/**
- * @returns {CorrelationContext | undefined}
- */
-export function getCurrentCorrelationContext() {
-  return correlationStorage.getStore();
-}

package/src/_coreCorrelation/getCurrentCorrelationContextEffect.js

@@ -1,11 +0,0 @@
-import { Effect } from "effect";
-import { correlationContextFiberRef } from "./correlationContextFiberRef.js";
-import { correlationStorage } from "./_correlationStorage.js";
-/** @typedef {import("./CorrelationContext.ts").CorrelationContext} CorrelationContext */
-
-/**
- * @returns {Effect.Effect< CorrelationContext | undefined >}
- */
-export function getCurrentCorrelationContextEffect() {
-  return correlationContextFiberRef.pipe(Effect.map((fiberContext) => fiberContext ?? correlationStorage.getStore()));
-}

package/src/_coreCorrelation/index.js

@@ -1,14 +0,0 @@
-/** @typedef {import("./CorrelationContext.ts").CorrelationContext} CorrelationContext */
-/** @typedef {import("./CorrelationPatch.ts").CorrelationPatch} CorrelationPatch */
-
-export { correlationContextFiberRef } from "./correlationContextFiberRef.js";
-export { CorrelationContextService } from "./CorrelationContextService.js";
-export { CorrelationContextLive } from "./CorrelationContextLive.js";
-export { mergeCorrelationContext } from "./mergeCorrelationContext.js";
-export { getCurrentCorrelationContext } from "./getCurrentCorrelationContext.js";
-export { getCurrentCorrelationContextEffect } from "./getCurrentCorrelationContextEffect.js";
-export { updateCurrentCorrelationContext } from "./updateCurrentCorrelationContext.js";
-export { runWithCorrelationContext } from "./runWithCorrelationContext.js";
-export { withCorrelationContext } from "./withCorrelationContext.js";
-export { withCurrentCorrelationContext } from "./withCurrentCorrelationContext.js";
-export { correlationContextToLogAnnotations } from "./correlationContextToLogAnnotations.js";

package/src/_coreCorrelation/mergeCorrelationContext.js

@@ -1,51 +0,0 @@
-/** @typedef {import("./CorrelationContext.ts").CorrelationContext} CorrelationContext */
-/** @typedef {import("./CorrelationPatch.ts").CorrelationPatch} CorrelationPatch */
-/**
- * @param {unknown} value
- * @returns {string | undefined}
- */
-function cleanString(value) {
-  return typeof value === "string" && value.length > 0 ? value : undefined;
-}
-/**
- * @param {unknown} value
- * @returns {number | undefined}
- */
-function cleanNumber(value) {
-  return typeof value === "number" && Number.isFinite(value) ? value : undefined;
-}
-/**
- * @param {CorrelationPatch} patch
- * @returns {Partial<CorrelationContext> | undefined}
- */
-function normalizePatch(patch) {
-  if (!patch) return undefined;
-  const normalized = {};
-  const runId = cleanString(patch.runId);
-  const nodeId = cleanString(patch.nodeId);
-  const workflowName = cleanString(patch.workflowName);
-  const parentRunId = cleanString(patch.parentRunId);
-  const traceId = cleanString(patch.traceId);
-  const spanId = cleanString(patch.spanId);
-  const iteration = cleanNumber(patch.iteration);
-  const attempt = cleanNumber(patch.attempt);
-  if (runId) normalized.runId = runId;
-  if (nodeId) normalized.nodeId = nodeId;
-  if (workflowName) normalized.workflowName = workflowName;
-  if (parentRunId) normalized.parentRunId = parentRunId;
-  if (traceId) normalized.traceId = traceId;
-  if (spanId) normalized.spanId = spanId;
-  if (iteration !== undefined) normalized.iteration = iteration;
-  if (attempt !== undefined) normalized.attempt = attempt;
-  return Object.keys(normalized).length > 0 ? normalized : undefined;
-}
-/**
- * @param {CorrelationContext | null} [base]
- * @param {CorrelationPatch} [patch]
- * @returns {CorrelationContext | undefined}
- */
-export function mergeCorrelationContext(base, patch) {
-  const normalizedPatch = normalizePatch(patch);
-  const merged = { ...base, ...normalizedPatch };
-  return merged.runId ? merged : undefined;
-}

package/src/_coreCorrelation/runWithCorrelationContext.js

@@ -1,14 +0,0 @@
-import { correlationStorage } from "./_correlationStorage.js";
-import { mergeCorrelationContext } from "./mergeCorrelationContext.js";
-/** @typedef {import("./CorrelationPatch.ts").CorrelationPatch} CorrelationPatch */
-
-/**
- * @template T
- * @param {CorrelationPatch} patch
- * @param {() => T} fn
- * @returns {T}
- */
-export function runWithCorrelationContext(patch, fn) {
-  const next = mergeCorrelationContext(correlationStorage.getStore(), patch);
-  return next ? correlationStorage.run(next, fn) : fn();
-}

package/src/_coreCorrelation/updateCurrentCorrelationContext.js

@@ -1,17 +0,0 @@
-import { Effect } from "effect";
-import { getCurrentCorrelationContextEffect } from "./getCurrentCorrelationContextEffect.js";
-import { mergeCorrelationContext } from "./mergeCorrelationContext.js";
-/** @typedef {import("./CorrelationContext.ts").CorrelationContext} CorrelationContext */
-/** @typedef {import("./CorrelationPatch.ts").CorrelationPatch} CorrelationPatch */
-
-/**
- * @param {CorrelationPatch} patch
- * @returns {Effect.Effect<CorrelationContext | undefined>}
- */
-export function updateCurrentCorrelationContext(patch) {
-  return Effect.gen(function* () {
-    const current = yield* getCurrentCorrelationContextEffect();
-    const next = mergeCorrelationContext(current, patch);
-    return next;
-  });
-}

package/src/_coreCorrelation/withCorrelationContext.js

@@ -1,38 +0,0 @@
-import { Effect } from "effect";
-import { correlationContextFiberRef } from "./correlationContextFiberRef.js";
-import { correlationStorage } from "./_correlationStorage.js";
-import { mergeCorrelationContext } from "./mergeCorrelationContext.js";
-/** @typedef {import("./CorrelationPatch.ts").CorrelationPatch} CorrelationPatch */
-
-/**
- * Bridge the Effect-tracked correlation context onto the imperative
- * AsyncLocalStorage store so plain (non-Effect) `getCurrentCorrelationContext()`
- * reads — e.g. from the imperative logger — see the active run/node correlation
- * while the effect executes.
- *
- * IMPORTANT: run the resulting effect with `Effect.runPromise`/`runFork`, never
- * `Effect.runSync`. The acquire step calls `AsyncLocalStorage.enterWith()`, which
- * mutates the *caller's* async context. Under `runSync` the caller is whatever
- * synchronous context invoked it (e.g. a test-runner's root context); enabling
- * ALS async-hooks there leaks into every subsequent timer/promise on that
- * context. `runPromise`/`runFork` execute on an ephemeral fiber context, keeping
- * the enterWith scoped to that fiber.
- *
- * @template A, E, R
- * @param {Effect.Effect<A, E, R>} effect
- * @param {CorrelationPatch} patch
- */
-export function withCorrelationContext(effect, patch) {
-  const next = mergeCorrelationContext(correlationStorage.getStore(), patch);
-  if (!next) return effect;
-  const located = effect.pipe(Effect.provideService(correlationContextFiberRef, next));
-  return Effect.acquireUseRelease(
-    Effect.sync(() => {
-      const previous = correlationStorage.getStore();
-      correlationStorage.enterWith(next);
-      return previous;
-    }),
-    () => located,
-    (previous) => Effect.sync(() => correlationStorage.enterWith(previous)),
-  );
-}

package/src/_coreCorrelation/withCurrentCorrelationContext.js

@@ -1,11 +0,0 @@
-import { Effect } from "effect";
-import { correlationContextFiberRef } from "./correlationContextFiberRef.js";
-import { correlationStorage } from "./_correlationStorage.js";
-/**
- * @template A, E, R
- * @param {Effect.Effect<A, E, R>} effect
- */
-export function withCurrentCorrelationContext(effect) {
-  const current = correlationStorage.getStore();
-  return current ? effect.pipe(Effect.provideService(correlationContextFiberRef, current)) : effect;
-}

package/src/_coreMetrics.js

@@ -1,14 +0,0 @@
-import { Context } from "effect";
-/** @typedef {import("./_coreMetricsShape.ts").MetricsServiceShape} MetricsServiceShape */
-
-/** @typedef {Context.ServiceClass.Shape<"MetricsService", MetricsServiceShape>} MetricsService */
-const MetricsServiceTag = /** @type {Context.ServiceClass<MetricsService, "MetricsService", MetricsServiceShape>} */ (
-  Context.Service()("MetricsService")
-);
-export const MetricsService = /** @type {Context.ServiceClass<MetricsService, "MetricsService", MetricsServiceShape>} */ (
-  class MetricsService extends MetricsServiceTag {
-    constructor(...args) {
-      super(...args);
-    }
-  }
-);

package/src/_coreMetricsShape.ts

@@ -1,44 +0,0 @@
-import type { Effect } from "effect";
-import type { MetricLabels } from "./_corePrometheusShape.ts";
-import type { MetricName } from "./MetricName.ts";
-
-export type SmithersMetricEvent = {
-  readonly type: string;
-  readonly [key: string]: unknown;
-};
-
-export type CounterEntry = {
-  readonly type: "counter";
-  value: number;
-  readonly labels: MetricLabels;
-};
-
-export type GaugeEntry = {
-  readonly type: "gauge";
-  value: number;
-  readonly labels: MetricLabels;
-};
-
-export type HistogramEntry = {
-  readonly type: "histogram";
-  sum: number;
-  count: number;
-  readonly labels: MetricLabels;
-  readonly buckets: Map<number, number>;
-};
-
-export type MetricEntry = CounterEntry | GaugeEntry | HistogramEntry;
-
-export type MetricsSnapshot = ReadonlyMap<string, MetricEntry>;
-
-export type MetricsServiceShape = {
-  readonly increment: (name: MetricName, labels?: MetricLabels) => Effect.Effect<void>;
-  readonly incrementBy: (name: MetricName, value: number, labels?: MetricLabels) => Effect.Effect<void>;
-  readonly gauge: (name: MetricName, value: number, labels?: MetricLabels) => Effect.Effect<void>;
-  readonly histogram: (name: MetricName, value: number, labels?: MetricLabels) => Effect.Effect<void>;
-  readonly recordEvent: (event: SmithersMetricEvent) => Effect.Effect<void>;
-  readonly updateProcessMetrics: () => Effect.Effect<void>;
-  readonly updateAsyncExternalWaitPending: (kind: "approval" | "event", delta: number) => Effect.Effect<void>;
-  readonly renderPrometheus: () => Effect.Effect<string>;
-  readonly snapshot: () => Effect.Effect<MetricsSnapshot>;
-};

package/src/_corePrometheus.js

@@ -1,91 +0,0 @@
-/** @typedef {import("./_corePrometheusShape.ts").MetricLabels} MetricLabels */
-/** @typedef {import("./_corePrometheusShape.ts").PrometheusSample} PrometheusSample */
-/**
- * @param {string} name
- * @returns {string}
- */
-export function toPrometheusMetricName(name) {
-  const next = name.replace(/[^a-zA-Z0-9_:]/g, "_");
-  return /^[a-zA-Z_:]/.test(next) ? next : `_${next}`;
-}
-/**
- * @param {string} text
- * @returns {string}
- */
-function escapeText(text) {
-  return text.replace(/\\/g, "\\\\").replace(/\n/g, "\\n");
-}
-/**
- * @param {string} value
- * @returns {string}
- */
-function escapeLabelValue(value) {
-  return escapeText(value).replace(/"/g, '\\"');
-}
-/**
- * @param {number} value
- * @returns {string}
- */
-function formatNumber(value) {
-  if (Number.isNaN(value)) return "NaN";
-  if (value === Number.POSITIVE_INFINITY) return "+Inf";
-  if (value === Number.NEGATIVE_INFINITY) return "-Inf";
-  return String(value);
-}
-/**
- * @param {MetricLabels} labels
- * @returns {string}
- */
-function formatLabels(labels) {
-  const entries = Object.entries(labels).sort(([left], [right]) => left.localeCompare(right));
-  if (entries.length === 0) return "";
-  return `{${entries
-    .map(([key, value]) => `${toPrometheusMetricName(key)}="${escapeLabelValue(String(value))}"`)
-    .join(",")}}`;
-}
-/**
- * @param {MetricLabels} labels
- * @param {MetricLabels} extra
- * @returns {MetricLabels}
- */
-function mergeLabels(labels, extra) {
-  return { ...labels, ...extra };
-}
-/**
- * @param {readonly PrometheusSample[]} samples
- * @returns {string}
- */
-export function renderPrometheusSamples(samples) {
-  const grouped = new Map();
-  for (const sample of samples) {
-    const name = toPrometheusMetricName(sample.name);
-    const group =
-      grouped.get(name) ??
-      (() => {
-        const created = { type: sample.type, lines: [] };
-        grouped.set(name, created);
-        return created;
-      })();
-    if (sample.type === "histogram") {
-      const buckets = [...(sample.buckets ?? new Map()).entries()].sort(([left], [right]) => left - right);
-      for (const [boundary, count] of buckets) {
-        group.lines.push(
-          `${name}_bucket${formatLabels(mergeLabels(sample.labels, { le: boundary }))} ${formatNumber(count)}`,
-        );
-      }
-      group.lines.push(
-        `${name}_bucket${formatLabels(mergeLabels(sample.labels, { le: "+Inf" }))} ${formatNumber(sample.count ?? 0)}`,
-      );
-      group.lines.push(`${name}_sum${formatLabels(sample.labels)} ${formatNumber(sample.sum ?? 0)}`);
-      group.lines.push(`${name}_count${formatLabels(sample.labels)} ${formatNumber(sample.count ?? 0)}`);
-    } else {
-      group.lines.push(`${name}${formatLabels(sample.labels)} ${formatNumber(sample.value ?? 0)}`);
-    }
-  }
-  const lines = [];
-  for (const [name, group] of [...grouped.entries()].sort(([left], [right]) => left.localeCompare(right))) {
-    lines.push(`# TYPE ${name} ${group.type}`);
-    lines.push(...group.lines.sort());
-  }
-  return lines.join("\n") + (lines.length > 0 ? "\n" : "");
-}

package/src/_corePrometheusShape.ts

@@ -1,11 +0,0 @@
-export type MetricLabels = Readonly<Record<string, string | number | boolean>>;
-
-export type PrometheusSample = {
-  readonly name: string;
-  readonly type: "counter" | "gauge" | "histogram";
-  readonly labels: MetricLabels;
-  readonly value?: number;
-  readonly buckets?: ReadonlyMap<number, number>;
-  readonly sum?: number;
-  readonly count?: number;
-};

package/src/_coreTracing.js

@@ -1,132 +0,0 @@
-import { Context, Effect, Layer } from "effect";
-import {
-  correlationContextToLogAnnotations,
-  getCurrentCorrelationContext,
-  withCorrelationContext,
-} from "./_coreCorrelation/index.js";
-import { smithersSpanAttributeAliases } from "./_smithersSpanAttributeAliases.js";
-/** @typedef {import("./SmithersLogFormat.ts").SmithersLogFormat} SmithersLogFormat */
-/** @typedef {import("./_coreTracingShape.ts").SmithersSpanAttributesInput} SmithersSpanAttributesInput */
-/** @typedef {import("./_coreTracingShape.ts").TracingServiceShape} TracingServiceShape */
-
-/** @type {"text/plain; version=0.0.4; charset=utf-8"} */
-export const prometheusContentType = "text/plain; version=0.0.4; charset=utf-8";
-/** @type {{ readonly run: "smithers.run"; readonly task: "smithers.task"; readonly agent: "smithers.agent"; readonly tool: "smithers.tool" }} */
-export const smithersSpanNames = {
-  run: "smithers.run",
-  task: "smithers.task",
-  agent: "smithers.agent",
-  tool: "smithers.tool",
-};
-/** @typedef {Context.ServiceClass.Shape<"TracingService", TracingServiceShape>} TracingService */
-const TracingServiceTag = /** @type {Context.ServiceClass<TracingService, "TracingService", TracingServiceShape>} */ (
-  Context.Service()("TracingService")
-);
-export const TracingService = /** @type {Context.ServiceClass<TracingService, "TracingService", TracingServiceShape>} */ (
-  class TracingService extends TracingServiceTag {
-    constructor(...args) {
-      super(...args);
-    }
-  }
-);
-/**
- * @param {SmithersSpanAttributesInput} [attributes]
- * @returns {Record<string, unknown>}
- */
-export function makeSmithersSpanAttributes(attributes = {}) {
-  const aliases = smithersSpanAttributeAliases;
-  const result = {};
-  for (const [key, value] of Object.entries(attributes)) {
-    if (value !== undefined) {
-      result[key.startsWith("smithers.") ? key : (aliases[key] ?? key)] = value;
-    }
-  }
-  return result;
-}
-/**
- * @param {SmithersSpanAttributesInput} [attributes]
- * @returns {attributes is SmithersSpanAttributesInput}
- */
-function hasAttributes(attributes) {
-  return Boolean(attributes && Object.keys(attributes).length > 0);
-}
-/**
- * @param {string} name
- * @param {SmithersSpanAttributesInput} [attributes]
- * @returns {string}
- */
-function inferSmithersSpanName(name, attributes) {
-  if (name.startsWith("smithers.")) return name;
-  if (name.startsWith("tool:") || "toolName" in (attributes ?? {}) || "tool_name" in (attributes ?? {})) {
-    return smithersSpanNames.tool;
-  }
-  if (name.startsWith("agent:") || name.startsWith("agent.") || "agent" in (attributes ?? {})) {
-    return smithersSpanNames.agent;
-  }
-  if ("nodeId" in (attributes ?? {}) || "node_id" in (attributes ?? {})) {
-    return smithersSpanNames.task;
-  }
-  if ("runId" in (attributes ?? {}) || "run_id" in (attributes ?? {})) {
-    return smithersSpanNames.run;
-  }
-  return name;
-}
-/**
- * @param {SmithersSpanAttributesInput} [attributes]
- * @returns {Effect.Effect<void>}
- */
-export function annotateSmithersTrace(attributes = {}) {
-  const spanAttributes = makeSmithersSpanAttributes(attributes);
-  let program = Effect.void;
-  if (Object.keys(spanAttributes).length > 0) {
-    program = program.pipe(
-      Effect.tap(() => Effect.annotateCurrentSpan(spanAttributes).pipe(Effect.catch(() => Effect.void))),
-    );
-  }
-  if (hasAttributes(attributes)) {
-    program = program.pipe(Effect.annotateLogs(attributes));
-  }
-  return program;
-}
-/**
- * @template A, E, R
- * @param {string} name
- * @param {Effect.Effect<A, E, R>} effect
- * @param {SmithersSpanAttributesInput} [attributes]
- * @returns {Effect.Effect<A, E, R>}
- */
-export function withSmithersSpan(name, effect, attributes) {
-  const spanAttributes = makeSmithersSpanAttributes(attributes);
-  return Effect.suspend(() => {
-    const annotations = correlationContextToLogAnnotations(getCurrentCorrelationContext());
-    let program = effect;
-    if (Object.keys(spanAttributes).length > 0) {
-      program = program.pipe(Effect.annotateSpans(spanAttributes));
-    }
-    if (hasAttributes(attributes)) {
-      program = program.pipe(Effect.annotateLogs(attributes));
-    }
-    if (annotations) {
-      program = program.pipe(Effect.annotateLogs(annotations));
-    }
-    return program.pipe(
-      Effect.withLogSpan(name),
-      Effect.withSpan(inferSmithersSpanName(name, attributes), {
-        attributes: spanAttributes,
-      }),
-    );
-  });
-}
-/** @type {Layer.Layer<TracingService, never, never>} */
-export const TracingServiceLive = Layer.succeed(TracingService, {
-  withSpan: (name, effect, attributes) => {
-    return withSmithersSpan(name, effect, attributes);
-  },
-  annotate: (attributes) => {
-    const spanAttributes = makeSmithersSpanAttributes(attributes);
-    return Object.keys(spanAttributes).length > 0
-      ? Effect.annotateCurrentSpan(spanAttributes).pipe(Effect.catch(() => Effect.void))
-      : Effect.void;
-  },
-  withCorrelation: (context, effect) => withCorrelationContext(effect, context),
-});