@geminixiang/mikan 1.0.0-beta.8 → 1.0.0-beta.81

package/dist/observability/index.js

@@ -0,0 +1,273 @@
+import { metrics, SpanStatusCode, trace } from "@opentelemetry/api";
+import { addSentryBreadcrumb, captureSentryError, closeSentry, createRunScopeAttributes, recordSentryCounter, recordSentryDistribution, recordSentryGauge, sanitizeTelemetryString, sanitizeValue, withSentryRunScope, } from "./sentry.js";
+import { isOpenTelemetryMetricsEnabled, shutdownOpenTelemetry } from "./otel.js";
+const tracer = trace.getTracer("@geminixiang/mikan");
+const meter = metrics.getMeter("@geminixiang/mikan");
+const counters = new Map();
+const histograms = new Map();
+const gauges = new Map();
+const MAX_FINGERPRINT_CLASS_LENGTH = 80;
+const UNEXPECTED_SUBAGENT_STATUSES = new Set([
+    "failed",
+    "invalid_output",
+]);
+export function metricAttributes(attributes) {
+    return Object.fromEntries(Object.entries(attributes).flatMap(([key, value]) => {
+        if (value === undefined)
+            return [];
+        const sanitized = sanitizeValue(value, key);
+        return typeof sanitized === "string" ||
+            typeof sanitized === "number" ||
+            typeof sanitized === "boolean"
+            ? [[key, sanitized]]
+            : [];
+    }));
+}
+export function recordCounter(name, value, attributes = {}) {
+    const safeAttributes = metricAttributes(attributes);
+    if (!isOpenTelemetryMetricsEnabled()) {
+        recordSentryCounter(name, value, safeAttributes);
+        return;
+    }
+    let counter = counters.get(name);
+    if (!counter) {
+        counter = meter.createCounter(name);
+        counters.set(name, counter);
+    }
+    counter.add(value, safeAttributes);
+}
+export function recordDistribution(name, value, options = {}) {
+    const safeAttributes = metricAttributes(options.attributes ?? {});
+    if (!isOpenTelemetryMetricsEnabled()) {
+        recordSentryDistribution(name, value, {
+            unit: options.unit ? options.unit : undefined,
+            attributes: safeAttributes,
+        });
+        return;
+    }
+    const key = `${name}\0${options.unit ?? ""}`;
+    let histogram = histograms.get(key);
+    if (!histogram) {
+        histogram = meter.createHistogram(name, options.unit ? { unit: options.unit } : undefined);
+        histograms.set(key, histogram);
+    }
+    histogram.record(value, safeAttributes);
+}
+export function recordGauge(name, value, options = {}) {
+    const safeAttributes = metricAttributes(options.attributes ?? {});
+    if (!isOpenTelemetryMetricsEnabled()) {
+        recordSentryGauge(name, value, {
+            unit: options.unit ? options.unit : undefined,
+            attributes: safeAttributes,
+        });
+        return;
+    }
+    const key = `${name}\0${options.unit ?? ""}`;
+    let gauge = gauges.get(key);
+    if (!gauge) {
+        gauge = meter.createGauge(name, options.unit ? { unit: options.unit } : undefined);
+        gauges.set(key, gauge);
+    }
+    gauge.record(value, safeAttributes);
+}
+export function createRunAttributionAttributes(context) {
+    return metricAttributes({
+        ...createRunScopeAttributes(context),
+        "gen_ai.operation.name": "invoke_agent",
+        "gen_ai.agent.name": "mikan",
+        "gen_ai.conversation.id": context.sessionKey,
+        "openinference.span.kind": "AGENT",
+        "session.id": context.sessionKey,
+    });
+}
+export async function withRunSpan(context, body) {
+    const attribution = createRunAttributionAttributes(context);
+    return tracer.startActiveSpan("agent.run", { attributes: attribution }, (span) => withSentryRunScope(context, async () => {
+        try {
+            return await body();
+        }
+        catch (error) {
+            span.setStatus({ code: SpanStatusCode.ERROR, message: safeErrorType(error) });
+            throw error;
+        }
+        finally {
+            span.end();
+        }
+    }));
+}
+export function startOperationSpan(name, attributes = {}) {
+    const span = tracer.startSpan(name, {
+        attributes: metricAttributes(attributes),
+    });
+    return {
+        end(options = {}) {
+            if (options.attributes) {
+                span.setAttributes(metricAttributes(options.attributes));
+            }
+            if (options.error !== undefined) {
+                const errorType = safeErrorType(options.error);
+                span.setAttribute("error.type", errorType);
+                span.setStatus({ code: SpanStatusCode.ERROR, message: errorType });
+            }
+            span.end();
+        },
+    };
+}
+export function updateActiveSpanAttribution(attributes) {
+    trace.getActiveSpan()?.setAttributes(metricAttributes(attributes));
+}
+export function addLifecycleEvent(name, attributes) {
+    const safeAttributes = attributes ? metricAttributes(attributes) : undefined;
+    trace.getActiveSpan()?.addEvent(name, safeAttributes);
+    addSentryBreadcrumb(name, safeAttributes);
+}
+export function recordDiagnosticEvent(name, data) {
+    const spanAttributes = metricAttributes(Object.fromEntries(Object.entries(data).filter((entry) => {
+        const value = entry[1];
+        return typeof value === "string" || typeof value === "number" || typeof value === "boolean";
+    })));
+    trace.getActiveSpan()?.addEvent(name, spanAttributes);
+    const recovered = name === "slack.update.recovered";
+    addSentryBreadcrumb(recovered
+        ? "Slack update recovered"
+        : name === "slack.update.rejected"
+            ? "Slack update rejected"
+            : name, data, {
+        category: name.startsWith("slack.update.") ? "slack.update" : "diagnostic",
+        level: name.endsWith(".rejected") ? "warning" : "info",
+        log: recovered,
+    });
+}
+export function reportUserFacingError(error, options) {
+    if (options.expected)
+        return undefined;
+    const span = trace.getActiveSpan();
+    if (span) {
+        span.setAttribute("error.type", safeErrorType(error));
+        span.setStatus({ code: SpanStatusCode.ERROR, message: safeErrorType(error) });
+    }
+    return captureSentryError(error, options);
+}
+export function captureError(error) {
+    return reportUserFacingError(error, {
+        domain: "mikan",
+        surface: "process",
+        operation: "shutdown",
+        severity: "error",
+    });
+}
+export async function shutdownObservability(timeoutMs) {
+    let openTelemetryFailure;
+    try {
+        await shutdownOpenTelemetry();
+    }
+    catch (error) {
+        openTelemetryFailure = error;
+    }
+    let sentryClosed;
+    try {
+        sentryClosed = await closeSentry(timeoutMs);
+    }
+    catch (error) {
+        if (openTelemetryFailure !== undefined) {
+            const failure = new Error("Observability shutdown failed", { cause: error });
+            Object.assign(failure, { errors: [openTelemetryFailure, error] });
+            throw failure;
+        }
+        throw new Error("Sentry shutdown failed", { cause: error });
+    }
+    if (openTelemetryFailure !== undefined)
+        throw openTelemetryFailure;
+    return sentryClosed;
+}
+function safeErrorType(error) {
+    if (error instanceof Error && /^[A-Za-z][A-Za-z0-9_.-]{0,79}$/.test(error.name))
+        return error.name;
+    return "Error";
+}
+export function recordSubagentOutcome(report) {
+    const attributes = metricAttributes({
+        status: report.status,
+        profile: report.profile,
+        mode: report.mode,
+    });
+    recordCounter("agent.subagent.runs", 1, attributes);
+    if (report.durationMs !== undefined) {
+        recordDistribution("agent.subagent.duration", report.durationMs, {
+            unit: "millisecond",
+            attributes,
+        });
+    }
+    addLifecycleEvent("agent.subagent.completed", {
+        item_id: report.itemId,
+        status: report.status,
+        profile: report.profile,
+        mode: report.mode,
+        turns: report.turns,
+        tool_calls: report.toolCalls,
+        tokens: report.tokens,
+        cost_usd: report.costUsd,
+        duration_ms: report.durationMs,
+        cleanup_pending: report.cleanupPending,
+    });
+    if (!UNEXPECTED_SUBAGENT_STATUSES.has(report.status))
+        return undefined;
+    const errorClass = sanitizeTelemetryString((report.error ?? report.status).split(":")[0].trim()).slice(0, MAX_FINGERPRINT_CLASS_LENGTH);
+    return reportUserFacingError(new Error(`Subagent ${report.status}: ${report.error ?? "no error detail"}`), {
+        domain: "subagent",
+        surface: "subagent_tool",
+        operation: "run",
+        severity: "error",
+        toolName: "subagent",
+        fingerprint: ["subagent", report.status, errorClass],
+        tags: {
+            subagent_status: report.status,
+            subagent_profile: report.profile,
+            subagent_mode: report.mode,
+            cleanup_pending: report.cleanupPending,
+        },
+        context: {
+            itemId: report.itemId,
+            error: report.error,
+            turns: report.turns,
+            toolCalls: report.toolCalls,
+            tokens: report.tokens,
+            costUsd: report.costUsd,
+            durationMs: report.durationMs,
+        },
+    });
+}
+export function reportSubagentLaunchError(error, report) {
+    return reportUserFacingError(error, {
+        domain: "subagent",
+        surface: "subagent_tool",
+        operation: "launch",
+        severity: "error",
+        toolName: "subagent",
+        tags: { subagent_profile: report.profile, subagent_mode: report.mode },
+        context: { itemId: report.itemId },
+    });
+}
+export function recordJevOutcome(report) {
+    const attributes = metricAttributes({ caller: report.caller, status: report.status });
+    recordCounter("agent.jev.calls", 1, attributes);
+    if (report.costUsd !== undefined) {
+        recordDistribution("agent.jev.cost", report.costUsd, { attributes });
+    }
+    if (report.durationMs !== undefined) {
+        recordDistribution("agent.jev.duration", report.durationMs, {
+            unit: "millisecond",
+            attributes,
+        });
+    }
+    addLifecycleEvent("agent.jev.completed", {
+        caller: report.caller,
+        status: report.status,
+        error_type: report.errorType,
+        input_tokens: report.inputTokens,
+        output_tokens: report.outputTokens,
+        cost_usd: report.costUsd,
+        duration_ms: report.durationMs,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { metrics, SpanStatusCode, trace, type Attributes } from \"@opentelemetry/api\";\nimport {\n  addSentryBreadcrumb,\n  captureSentryError,\n  closeSentry,\n  createRunScopeAttributes,\n  recordSentryCounter,\n  recordSentryDistribution,\n  recordSentryGauge,\n  sanitizeTelemetryString,\n  sanitizeValue,\n  withSentryRunScope,\n} from \"./sentry.js\";\nimport { isOpenTelemetryMetricsEnabled, shutdownOpenTelemetry } from \"./otel.js\";\nimport type {\n  JevOutcomeReport,\n  ObservabilityAttributes,\n  ReportUserFacingErrorOptions,\n  RunScopeContext,\n  SubagentOutcomeReport,\n  SubagentOutcomeStatus,\n} from \"./types.js\";\n\nexport interface ObservabilitySpan {\n  end(options?: { attributes?: ObservabilityAttributes; error?: unknown }): void;\n}\n\nconst tracer = trace.getTracer(\"@geminixiang/mikan\");\nconst meter = metrics.getMeter(\"@geminixiang/mikan\");\nconst counters = new Map<string, ReturnType<typeof meter.createCounter>>();\nconst histograms = new Map<string, ReturnType<typeof meter.createHistogram>>();\nconst gauges = new Map<string, ReturnType<typeof meter.createGauge>>();\nconst MAX_FINGERPRINT_CLASS_LENGTH = 80;\nconst UNEXPECTED_SUBAGENT_STATUSES: ReadonlySet<SubagentOutcomeStatus> = new Set([\n  \"failed\",\n  \"invalid_output\",\n]);\n\nexport function metricAttributes(\n  attributes: Record<string, string | number | boolean | undefined>,\n): ObservabilityAttributes {\n  return Object.fromEntries(\n    Object.entries(attributes).flatMap(([key, value]) => {\n      if (value === undefined) return [];\n      const sanitized = sanitizeValue(value, key);\n      return typeof sanitized === \"string\" ||\n        typeof sanitized === \"number\" ||\n        typeof sanitized === \"boolean\"\n        ? [[key, sanitized] as const]\n        : [];\n    }),\n  );\n}\n\nexport function recordCounter(\n  name: string,\n  value: number,\n  attributes: ObservabilityAttributes = {},\n): void {\n  const safeAttributes = metricAttributes(attributes);\n  if (!isOpenTelemetryMetricsEnabled()) {\n    recordSentryCounter(name, value, safeAttributes);\n    return;\n  }\n  let counter = counters.get(name);\n  if (!counter) {\n    counter = meter.createCounter(name);\n    counters.set(name, counter);\n  }\n  counter.add(value, safeAttributes as Attributes);\n}\n\nexport function recordDistribution(\n  name: string,\n  value: number,\n  options: { unit?: string; attributes?: ObservabilityAttributes } = {},\n): void {\n  const safeAttributes = metricAttributes(options.attributes ?? {});\n  if (!isOpenTelemetryMetricsEnabled()) {\n    recordSentryDistribution(name, value, {\n      unit: options.unit ? options.unit : undefined,\n      attributes: safeAttributes,\n    });\n    return;\n  }\n  const key = `${name}\\0${options.unit ?? \"\"}`;\n  let histogram = histograms.get(key);\n  if (!histogram) {\n    histogram = meter.createHistogram(name, options.unit ? { unit: options.unit } : undefined);\n    histograms.set(key, histogram);\n  }\n  histogram.record(value, safeAttributes as Attributes);\n}\n\nexport function recordGauge(\n  name: string,\n  value: number,\n  options: { unit?: string; attributes?: ObservabilityAttributes } = {},\n): void {\n  const safeAttributes = metricAttributes(options.attributes ?? {});\n  if (!isOpenTelemetryMetricsEnabled()) {\n    recordSentryGauge(name, value, {\n      unit: options.unit ? options.unit : undefined,\n      attributes: safeAttributes,\n    });\n    return;\n  }\n  const key = `${name}\\0${options.unit ?? \"\"}`;\n  let gauge = gauges.get(key);\n  if (!gauge) {\n    gauge = meter.createGauge(name, options.unit ? { unit: options.unit } : undefined);\n    gauges.set(key, gauge);\n  }\n  gauge.record(value, safeAttributes as Attributes);\n}\n\nexport function createRunAttributionAttributes(context: RunScopeContext): ObservabilityAttributes {\n  return metricAttributes({\n    ...createRunScopeAttributes(context),\n    \"gen_ai.operation.name\": \"invoke_agent\",\n    \"gen_ai.agent.name\": \"mikan\",\n    \"gen_ai.conversation.id\": context.sessionKey,\n    \"openinference.span.kind\": \"AGENT\",\n    \"session.id\": context.sessionKey,\n  });\n}\n\nexport async function withRunSpan<T>(context: RunScopeContext, body: () => Promise<T>): Promise<T> {\n  const attribution = createRunAttributionAttributes(context);\n  return tracer.startActiveSpan(\"agent.run\", { attributes: attribution as Attributes }, (span) =>\n    withSentryRunScope(context, async () => {\n      try {\n        return await body();\n      } catch (error) {\n        span.setStatus({ code: SpanStatusCode.ERROR, message: safeErrorType(error) });\n        throw error;\n      } finally {\n        span.end();\n      }\n    }),\n  );\n}\n\nexport function startOperationSpan(\n  name: string,\n  attributes: ObservabilityAttributes = {},\n): ObservabilitySpan {\n  const span = tracer.startSpan(name, {\n    attributes: metricAttributes(attributes) as Attributes,\n  });\n  return {\n    end(options = {}) {\n      if (options.attributes) {\n        span.setAttributes(metricAttributes(options.attributes) as Attributes);\n      }\n      if (options.error !== undefined) {\n        const errorType = safeErrorType(options.error);\n        span.setAttribute(\"error.type\", errorType);\n        span.setStatus({ code: SpanStatusCode.ERROR, message: errorType });\n      }\n      span.end();\n    },\n  };\n}\n\nexport function updateActiveSpanAttribution(attributes: ObservabilityAttributes): void {\n  trace.getActiveSpan()?.setAttributes(metricAttributes(attributes) as Attributes);\n}\n\nexport function addLifecycleEvent(\n  name: string,\n  attributes?: Record<string, string | number | boolean | undefined>,\n): void {\n  const safeAttributes = attributes ? metricAttributes(attributes) : undefined;\n  trace.getActiveSpan()?.addEvent(name, safeAttributes as Attributes | undefined);\n  addSentryBreadcrumb(name, safeAttributes);\n}\n\nexport function recordDiagnosticEvent(name: string, data: Record<string, unknown>): void {\n  const spanAttributes = metricAttributes(\n    Object.fromEntries(\n      Object.entries(data).filter((entry): entry is [string, string | number | boolean] => {\n        const value = entry[1];\n        return typeof value === \"string\" || typeof value === \"number\" || typeof value === \"boolean\";\n      }),\n    ),\n  );\n  trace.getActiveSpan()?.addEvent(name, spanAttributes as Attributes);\n  const recovered = name === \"slack.update.recovered\";\n  addSentryBreadcrumb(\n    recovered\n      ? \"Slack update recovered\"\n      : name === \"slack.update.rejected\"\n        ? \"Slack update rejected\"\n        : name,\n    data,\n    {\n      category: name.startsWith(\"slack.update.\") ? \"slack.update\" : \"diagnostic\",\n      level: name.endsWith(\".rejected\") ? \"warning\" : \"info\",\n      log: recovered,\n    },\n  );\n}\n\nexport function reportUserFacingError(\n  error: unknown,\n  options: ReportUserFacingErrorOptions,\n): string | undefined {\n  if (options.expected) return undefined;\n  const span = trace.getActiveSpan();\n  if (span) {\n    span.setAttribute(\"error.type\", safeErrorType(error));\n    span.setStatus({ code: SpanStatusCode.ERROR, message: safeErrorType(error) });\n  }\n  return captureSentryError(error, options);\n}\n\nexport function captureError(error: unknown): string | undefined {\n  return reportUserFacingError(error, {\n    domain: \"mikan\",\n    surface: \"process\",\n    operation: \"shutdown\",\n    severity: \"error\",\n  });\n}\n\nexport async function shutdownObservability(timeoutMs: number): Promise<boolean> {\n  let openTelemetryFailure: unknown;\n  try {\n    await shutdownOpenTelemetry();\n  } catch (error) {\n    openTelemetryFailure = error;\n  }\n\n  let sentryClosed: boolean;\n  try {\n    sentryClosed = await closeSentry(timeoutMs);\n  } catch (error) {\n    if (openTelemetryFailure !== undefined) {\n      const failure = new Error(\"Observability shutdown failed\", { cause: error });\n      Object.assign(failure, { errors: [openTelemetryFailure, error] });\n      throw failure;\n    }\n    throw new Error(\"Sentry shutdown failed\", { cause: error });\n  }\n\n  if (openTelemetryFailure !== undefined) throw openTelemetryFailure;\n  return sentryClosed;\n}\n\nfunction safeErrorType(error: unknown): string {\n  if (error instanceof Error && /^[A-Za-z][A-Za-z0-9_.-]{0,79}$/.test(error.name))\n    return error.name;\n  return \"Error\";\n}\n\nexport function recordSubagentOutcome(report: SubagentOutcomeReport): string | undefined {\n  const attributes = metricAttributes({\n    status: report.status,\n    profile: report.profile,\n    mode: report.mode,\n  });\n  recordCounter(\"agent.subagent.runs\", 1, attributes);\n  if (report.durationMs !== undefined) {\n    recordDistribution(\"agent.subagent.duration\", report.durationMs, {\n      unit: \"millisecond\",\n      attributes,\n    });\n  }\n  addLifecycleEvent(\"agent.subagent.completed\", {\n    item_id: report.itemId,\n    status: report.status,\n    profile: report.profile,\n    mode: report.mode,\n    turns: report.turns,\n    tool_calls: report.toolCalls,\n    tokens: report.tokens,\n    cost_usd: report.costUsd,\n    duration_ms: report.durationMs,\n    cleanup_pending: report.cleanupPending,\n  });\n  if (!UNEXPECTED_SUBAGENT_STATUSES.has(report.status)) return undefined;\n  const errorClass = sanitizeTelemetryString(\n    (report.error ?? report.status).split(\":\")[0]!.trim(),\n  ).slice(0, MAX_FINGERPRINT_CLASS_LENGTH);\n  return reportUserFacingError(\n    new Error(`Subagent ${report.status}: ${report.error ?? \"no error detail\"}`),\n    {\n      domain: \"subagent\",\n      surface: \"subagent_tool\",\n      operation: \"run\",\n      severity: \"error\",\n      toolName: \"subagent\",\n      fingerprint: [\"subagent\", report.status, errorClass],\n      tags: {\n        subagent_status: report.status,\n        subagent_profile: report.profile,\n        subagent_mode: report.mode,\n        cleanup_pending: report.cleanupPending,\n      },\n      context: {\n        itemId: report.itemId,\n        error: report.error,\n        turns: report.turns,\n        toolCalls: report.toolCalls,\n        tokens: report.tokens,\n        costUsd: report.costUsd,\n        durationMs: report.durationMs,\n      },\n    },\n  );\n}\n\nexport function reportSubagentLaunchError(\n  error: unknown,\n  report: Pick<SubagentOutcomeReport, \"itemId\" | \"mode\" | \"profile\">,\n): string | undefined {\n  return reportUserFacingError(error, {\n    domain: \"subagent\",\n    surface: \"subagent_tool\",\n    operation: \"launch\",\n    severity: \"error\",\n    toolName: \"subagent\",\n    tags: { subagent_profile: report.profile, subagent_mode: report.mode },\n    context: { itemId: report.itemId },\n  });\n}\n\nexport function recordJevOutcome(report: JevOutcomeReport): void {\n  const attributes = metricAttributes({ caller: report.caller, status: report.status });\n  recordCounter(\"agent.jev.calls\", 1, attributes);\n  if (report.costUsd !== undefined) {\n    recordDistribution(\"agent.jev.cost\", report.costUsd, { attributes });\n  }\n  if (report.durationMs !== undefined) {\n    recordDistribution(\"agent.jev.duration\", report.durationMs, {\n      unit: \"millisecond\",\n      attributes,\n    });\n  }\n  addLifecycleEvent(\"agent.jev.completed\", {\n    caller: report.caller,\n    status: report.status,\n    error_type: report.errorType,\n    input_tokens: report.inputTokens,\n    output_tokens: report.outputTokens,\n    cost_usd: report.costUsd,\n    duration_ms: report.durationMs,\n  });\n}\n"]}

package/dist/observability/instrument.js

@@ -1,10 +1,13 @@
 import * as Sentry from "@sentry/node";
-import { resolveSentryDsn, resolveStateDirFromArgv } from "../config.js";
-import { setEnvAliases } from "../utils/env.js";
+import { resolveStateDir } from "../cli/arg-grammar.js";
+import { resolveSentryDsn } from "../settings/index.js";
+import { setEnvAliases } from "../env-manifest.js";
+import { initializeOpenTelemetry, resolveOpenTelemetryConfiguration } from "./otel.js";
 import { createSentryInitOptions } from "./sentry.js";
-if (!process.env.STATE_DIR && !process.env.MIKAN_STATE_DIR) {
-    setEnvAliases("STATE_DIR", resolveStateDirFromArgv());
-}
+setEnvAliases("STATE_DIR", resolveStateDir());
 const sentryDsn = resolveSentryDsn();
-Sentry.init(createSentryInitOptions(sentryDsn));
+const otel = resolveOpenTelemetryConfiguration();
+const customOpenTelemetry = otel.traces;
+Sentry.init(createSentryInitOptions(sentryDsn, customOpenTelemetry));
+initializeOpenTelemetry();
 //# sourceMappingURL=instrument.js.map

package/dist/observability/instrument.js.map

@@ -1 +1 @@
-{"version":3,"file":"instrument.js","sourceRoot":"","sources":["../../src/observability/instrument.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEtD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;IAC3D,aAAa,CAAC,WAAW,EAAE,uBAAuB,EAAE,CAAC,CAAC;AACxD,CAAC;AACD,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;AAErC,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC,CAAC","sourcesContent":["import * as Sentry from \"@sentry/node\";\nimport { resolveSentryDsn, resolveStateDirFromArgv } from \"../config.js\";\nimport { setEnvAliases } from \"../utils/env.js\";\nimport { createSentryInitOptions } from \"./sentry.js\";\n\nif (!process.env.STATE_DIR && !process.env.MIKAN_STATE_DIR) {\n  setEnvAliases(\"STATE_DIR\", resolveStateDirFromArgv());\n}\nconst sentryDsn = resolveSentryDsn();\n\nSentry.init(createSentryInitOptions(sentryDsn));\n"]}
+{"version":3,"file":"instrument.js","sourceRoot":"","sources":["../../src/observability/instrument.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,iCAAiC,EAAE,MAAM,WAAW,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEtD,aAAa,CAAC,WAAW,EAAE,eAAe,EAAE,CAAC,CAAC;AAC9C,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;AACrC,MAAM,IAAI,GAAG,iCAAiC,EAAE,CAAC;AACjD,MAAM,mBAAmB,GAAG,IAAI,CAAC,MAAM,CAAC;AACxC,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,CAAC;AACrE,uBAAuB,EAAE,CAAC","sourcesContent":["import * as Sentry from \"@sentry/node\";\nimport { resolveStateDir } from \"../cli/arg-grammar.js\";\nimport { resolveSentryDsn } from \"../settings/index.js\";\nimport { setEnvAliases } from \"../env-manifest.js\";\nimport { initializeOpenTelemetry, resolveOpenTelemetryConfiguration } from \"./otel.js\";\nimport { createSentryInitOptions } from \"./sentry.js\";\n\nsetEnvAliases(\"STATE_DIR\", resolveStateDir());\nconst sentryDsn = resolveSentryDsn();\nconst otel = resolveOpenTelemetryConfiguration();\nconst customOpenTelemetry = otel.traces;\nSentry.init(createSentryInitOptions(sentryDsn, customOpenTelemetry));\ninitializeOpenTelemetry();\n"]}

package/dist/observability/otel.d.ts

@@ -0,0 +1,10 @@
+export interface OpenTelemetryConfiguration {
+    traces: boolean;
+    metrics: boolean;
+}
+export declare function resolveOpenTelemetryConfiguration(env?: NodeJS.ProcessEnv): OpenTelemetryConfiguration;
+export declare function initializeOpenTelemetry(): boolean;
+export declare function isOpenTelemetryMetricsEnabled(): boolean;
+export declare function shutdownOpenTelemetry(): Promise<void>;
+export declare function resolveOpenTelemetryResourceAttributes(env?: NodeJS.ProcessEnv): Record<string, string>;
+//# sourceMappingURL=otel.d.ts.map

package/dist/observability/otel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.d.ts","sourceRoot":"","sources":["../../src/observability/otel.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,iCAAiC,CAC/C,GAAG,GAAE,MAAM,CAAC,UAA8C,GACzD,0BAA0B,CAuB5B;AAED,wBAAgB,uBAAuB,IAAI,OAAO,CAkCjD;AAED,wBAAgB,6BAA6B,IAAI,OAAO,CAEvD;AAED,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAkB3D;AAmCD,wBAAgB,sCAAsC,CACpD,GAAG,GAAE,MAAM,CAAC,UAA8C,GACzD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYxB"}

package/dist/observability/otel.js

@@ -0,0 +1,182 @@
+import { metrics } from "@opentelemetry/api";
+import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-proto";
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-proto";
+import { resourceFromAttributes } from "@opentelemetry/resources";
+import { MeterProvider, PeriodicExportingMetricReader } from "@opentelemetry/sdk-metrics";
+import { BatchSpanProcessor, NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
+import { SentryContextManager } from "@sentry/node";
+import { SentryPropagator } from "@sentry/opentelemetry";
+import { readStandardEnv } from "../env-manifest.js";
+import { sanitizeTelemetryString } from "./sentry.js";
+const SAFE_RESOURCE_KEYS = new Set([
+    "deployment.environment.name",
+    "openinference.project.name",
+    "service.namespace",
+    "service.version",
+]);
+let tracerProvider;
+let meterProvider;
+let metricsEnabled = false;
+export function resolveOpenTelemetryConfiguration(env = currentOpenTelemetryEnvironment()) {
+    if (env.OTEL_SDK_DISABLED?.toLowerCase() === "true")
+        return { traces: false, metrics: false };
+    return {
+        traces: protocolSupported(env.OTEL_EXPORTER_OTLP_TRACES_PROTOCOL ?? env.OTEL_EXPORTER_OTLP_PROTOCOL) &&
+            exporterEnabled(env.OTEL_TRACES_EXPORTER) &&
+            effectiveEndpointIsValid(env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT, env.OTEL_EXPORTER_OTLP_ENDPOINT),
+        metrics: protocolSupported(env.OTEL_EXPORTER_OTLP_METRICS_PROTOCOL ?? env.OTEL_EXPORTER_OTLP_PROTOCOL) &&
+            exporterEnabled(env.OTEL_METRICS_EXPORTER) &&
+            effectiveEndpointIsValid(env.OTEL_EXPORTER_OTLP_METRICS_ENDPOINT, env.OTEL_EXPORTER_OTLP_ENDPOINT),
+    };
+}
+export function initializeOpenTelemetry() {
+    const env = currentOpenTelemetryEnvironment();
+    const configuration = resolveOpenTelemetryConfiguration(env);
+    metricsEnabled = configuration.metrics;
+    if (!configuration.traces && !configuration.metrics)
+        return false;
+    const resource = resourceFromAttributes(resolveOpenTelemetryResourceAttributes(env));
+    if (configuration.metrics) {
+        meterProvider = new MeterProvider({
+            resource,
+            readers: [
+                new PeriodicExportingMetricReader({
+                    exporter: new OTLPMetricExporter(),
+                    exportIntervalMillis: positiveInteger(env.OTEL_METRIC_EXPORT_INTERVAL),
+                    exportTimeoutMillis: positiveInteger(env.OTEL_METRIC_EXPORT_TIMEOUT),
+                }),
+            ],
+        });
+        metrics.setGlobalMeterProvider(meterProvider);
+    }
+    if (configuration.traces) {
+        tracerProvider = new NodeTracerProvider({
+            resource,
+            spanProcessors: [new BatchSpanProcessor(new OTLPTraceExporter())],
+        });
+        tracerProvider.register({
+            contextManager: new SentryContextManager(),
+            propagator: new SentryPropagator(),
+        });
+    }
+    return true;
+}
+export function isOpenTelemetryMetricsEnabled() {
+    return metricsEnabled;
+}
+export async function shutdownOpenTelemetry() {
+    const providers = [tracerProvider, meterProvider].filter((provider) => provider !== undefined);
+    const flushResults = await Promise.allSettled(providers.map((provider) => provider.forceFlush()));
+    const shutdownResults = await Promise.allSettled(providers.map((provider) => provider.shutdown()));
+    tracerProvider = undefined;
+    meterProvider = undefined;
+    metricsEnabled = false;
+    const failures = [...flushResults, ...shutdownResults].flatMap((result) => result.status === "rejected" ? [result.reason] : []);
+    if (failures.length > 0) {
+        throw new AggregateError(failures, "OpenTelemetry shutdown failed");
+    }
+}
+function exporterEnabled(value) {
+    if (!value)
+        return true;
+    return value
+        .split(",")
+        .map((entry) => entry.trim().toLowerCase())
+        .includes("otlp");
+}
+function protocolSupported(value) {
+    return !value || value.trim().toLowerCase() === "http/protobuf";
+}
+function effectiveEndpointIsValid(signalEndpoint, baseEndpoint) {
+    return validEndpoint(signalEndpoint ?? baseEndpoint);
+}
+function validEndpoint(value) {
+    if (!value)
+        return false;
+    try {
+        const endpoint = new URL(value);
+        return ((endpoint.protocol === "http:" || endpoint.protocol === "https:") &&
+            endpoint.username === "" &&
+            endpoint.password === "");
+    }
+    catch {
+        return false;
+    }
+}
+export function resolveOpenTelemetryResourceAttributes(env = currentOpenTelemetryEnvironment()) {
+    const serviceName = safeResourceValue(env.OTEL_SERVICE_NAME) ?? "mikan";
+    const attributes = { "service.name": serviceName };
+    const parsed = parseResourceAttributes(env.OTEL_RESOURCE_ATTRIBUTES);
+    if (!parsed)
+        return attributes;
+    for (const [key, value] of Object.entries(parsed)) {
+        if (!SAFE_RESOURCE_KEYS.has(key))
+            continue;
+        const safeValue = safeResourceValue(value);
+        if (safeValue !== undefined)
+            attributes[key] = safeValue;
+    }
+    return attributes;
+}
+function parseResourceAttributes(value) {
+    if (!value)
+        return {};
+    const attributes = {};
+    try {
+        for (const rawEntry of value.split(",").filter((entry) => entry.trim() !== "")) {
+            const parts = rawEntry.split("=");
+            if (parts.length !== 2)
+                return undefined;
+            const rawKey = parts[0]?.trim();
+            const rawValue = parts[1]?.trim();
+            if (!rawKey || rawValue === undefined)
+                return undefined;
+            const key = decodeURIComponent(rawKey);
+            const decodedValue = decodeURIComponent(rawValue);
+            if (key.length > 255 || decodedValue.length > 255)
+                return undefined;
+            attributes[key] = decodedValue;
+        }
+    }
+    catch {
+        return undefined;
+    }
+    return attributes;
+}
+function safeResourceValue(value) {
+    const trimmed = value?.trim();
+    if (!trimmed || trimmed.length > 128)
+        return undefined;
+    if ([...trimmed].some((character) => {
+        const code = character.charCodeAt(0);
+        return code <= 31 || code === 127;
+    })) {
+        return undefined;
+    }
+    return sanitizeTelemetryString(trimmed) === trimmed ? trimmed : undefined;
+}
+function currentOpenTelemetryEnvironment() {
+    const names = [
+        "OTEL_SDK_DISABLED",
+        "OTEL_SERVICE_NAME",
+        "OTEL_RESOURCE_ATTRIBUTES",
+        "OTEL_TRACES_EXPORTER",
+        "OTEL_METRICS_EXPORTER",
+        "OTEL_EXPORTER_OTLP_ENDPOINT",
+        "OTEL_EXPORTER_OTLP_TRACES_ENDPOINT",
+        "OTEL_EXPORTER_OTLP_METRICS_ENDPOINT",
+        "OTEL_EXPORTER_OTLP_PROTOCOL",
+        "OTEL_EXPORTER_OTLP_TRACES_PROTOCOL",
+        "OTEL_EXPORTER_OTLP_METRICS_PROTOCOL",
+        "OTEL_METRIC_EXPORT_INTERVAL",
+        "OTEL_METRIC_EXPORT_TIMEOUT",
+    ];
+    return Object.fromEntries(names.map((name) => [name, readStandardEnv(name)]));
+}
+function positiveInteger(value) {
+    if (!value)
+        return undefined;
+    const parsed = Number(value);
+    return Number.isInteger(parsed) && parsed > 0 ? parsed : undefined;
+}
+//# sourceMappingURL=otel.js.map

package/dist/observability/otel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.js","sourceRoot":"","sources":["../../src/observability/otel.ts"],"names":[],"mappings":"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","sourcesContent":["import { metrics } from \"@opentelemetry/api\";\nimport { OTLPMetricExporter } from \"@opentelemetry/exporter-metrics-otlp-proto\";\nimport { OTLPTraceExporter } from \"@opentelemetry/exporter-trace-otlp-proto\";\nimport { resourceFromAttributes } from \"@opentelemetry/resources\";\nimport { MeterProvider, PeriodicExportingMetricReader } from \"@opentelemetry/sdk-metrics\";\nimport { BatchSpanProcessor, NodeTracerProvider } from \"@opentelemetry/sdk-trace-node\";\nimport { SentryContextManager } from \"@sentry/node\";\nimport { SentryPropagator } from \"@sentry/opentelemetry\";\nimport { readStandardEnv } from \"../env-manifest.js\";\nimport { sanitizeTelemetryString } from \"./sentry.js\";\n\nconst SAFE_RESOURCE_KEYS = new Set([\n  \"deployment.environment.name\",\n  \"openinference.project.name\",\n  \"service.namespace\",\n  \"service.version\",\n]);\n\nlet tracerProvider: NodeTracerProvider | undefined;\nlet meterProvider: MeterProvider | undefined;\nlet metricsEnabled = false;\n\nexport interface OpenTelemetryConfiguration {\n  traces: boolean;\n  metrics: boolean;\n}\n\nexport function resolveOpenTelemetryConfiguration(\n  env: NodeJS.ProcessEnv = currentOpenTelemetryEnvironment(),\n): OpenTelemetryConfiguration {\n  if (env.OTEL_SDK_DISABLED?.toLowerCase() === \"true\") return { traces: false, metrics: false };\n\n  return {\n    traces:\n      protocolSupported(\n        env.OTEL_EXPORTER_OTLP_TRACES_PROTOCOL ?? env.OTEL_EXPORTER_OTLP_PROTOCOL,\n      ) &&\n      exporterEnabled(env.OTEL_TRACES_EXPORTER) &&\n      effectiveEndpointIsValid(\n        env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT,\n        env.OTEL_EXPORTER_OTLP_ENDPOINT,\n      ),\n    metrics:\n      protocolSupported(\n        env.OTEL_EXPORTER_OTLP_METRICS_PROTOCOL ?? env.OTEL_EXPORTER_OTLP_PROTOCOL,\n      ) &&\n      exporterEnabled(env.OTEL_METRICS_EXPORTER) &&\n      effectiveEndpointIsValid(\n        env.OTEL_EXPORTER_OTLP_METRICS_ENDPOINT,\n        env.OTEL_EXPORTER_OTLP_ENDPOINT,\n      ),\n  };\n}\n\nexport function initializeOpenTelemetry(): boolean {\n  const env = currentOpenTelemetryEnvironment();\n  const configuration = resolveOpenTelemetryConfiguration(env);\n  metricsEnabled = configuration.metrics;\n  if (!configuration.traces && !configuration.metrics) return false;\n\n  const resource = resourceFromAttributes(resolveOpenTelemetryResourceAttributes(env));\n\n  if (configuration.metrics) {\n    meterProvider = new MeterProvider({\n      resource,\n      readers: [\n        new PeriodicExportingMetricReader({\n          exporter: new OTLPMetricExporter(),\n          exportIntervalMillis: positiveInteger(env.OTEL_METRIC_EXPORT_INTERVAL),\n          exportTimeoutMillis: positiveInteger(env.OTEL_METRIC_EXPORT_TIMEOUT),\n        }),\n      ],\n    });\n    metrics.setGlobalMeterProvider(meterProvider);\n  }\n\n  if (configuration.traces) {\n    tracerProvider = new NodeTracerProvider({\n      resource,\n      spanProcessors: [new BatchSpanProcessor(new OTLPTraceExporter())],\n    });\n    tracerProvider.register({\n      contextManager: new SentryContextManager(),\n      propagator: new SentryPropagator(),\n    });\n  }\n\n  return true;\n}\n\nexport function isOpenTelemetryMetricsEnabled(): boolean {\n  return metricsEnabled;\n}\n\nexport async function shutdownOpenTelemetry(): Promise<void> {\n  const providers = [tracerProvider, meterProvider].filter(\n    (provider): provider is NodeTracerProvider | MeterProvider => provider !== undefined,\n  );\n  const flushResults = await Promise.allSettled(providers.map((provider) => provider.forceFlush()));\n  const shutdownResults = await Promise.allSettled(\n    providers.map((provider) => provider.shutdown()),\n  );\n  tracerProvider = undefined;\n  meterProvider = undefined;\n  metricsEnabled = false;\n\n  const failures = [...flushResults, ...shutdownResults].flatMap((result) =>\n    result.status === \"rejected\" ? [result.reason] : [],\n  );\n  if (failures.length > 0) {\n    throw new AggregateError(failures, \"OpenTelemetry shutdown failed\");\n  }\n}\n\nfunction exporterEnabled(value: string | undefined): boolean {\n  if (!value) return true;\n  return value\n    .split(\",\")\n    .map((entry) => entry.trim().toLowerCase())\n    .includes(\"otlp\");\n}\n\nfunction protocolSupported(value: string | undefined): boolean {\n  return !value || value.trim().toLowerCase() === \"http/protobuf\";\n}\n\nfunction effectiveEndpointIsValid(\n  signalEndpoint: string | undefined,\n  baseEndpoint: string | undefined,\n): boolean {\n  return validEndpoint(signalEndpoint ?? baseEndpoint);\n}\n\nfunction validEndpoint(value: string | undefined): boolean {\n  if (!value) return false;\n  try {\n    const endpoint = new URL(value);\n    return (\n      (endpoint.protocol === \"http:\" || endpoint.protocol === \"https:\") &&\n      endpoint.username === \"\" &&\n      endpoint.password === \"\"\n    );\n  } catch {\n    return false;\n  }\n}\n\nexport function resolveOpenTelemetryResourceAttributes(\n  env: NodeJS.ProcessEnv = currentOpenTelemetryEnvironment(),\n): Record<string, string> {\n  const serviceName = safeResourceValue(env.OTEL_SERVICE_NAME) ?? \"mikan\";\n  const attributes: Record<string, string> = { \"service.name\": serviceName };\n  const parsed = parseResourceAttributes(env.OTEL_RESOURCE_ATTRIBUTES);\n  if (!parsed) return attributes;\n\n  for (const [key, value] of Object.entries(parsed)) {\n    if (!SAFE_RESOURCE_KEYS.has(key)) continue;\n    const safeValue = safeResourceValue(value);\n    if (safeValue !== undefined) attributes[key] = safeValue;\n  }\n  return attributes;\n}\n\nfunction parseResourceAttributes(value: string | undefined): Record<string, string> | undefined {\n  if (!value) return {};\n  const attributes: Record<string, string> = {};\n  try {\n    for (const rawEntry of value.split(\",\").filter((entry) => entry.trim() !== \"\")) {\n      const parts = rawEntry.split(\"=\");\n      if (parts.length !== 2) return undefined;\n      const rawKey = parts[0]?.trim();\n      const rawValue = parts[1]?.trim();\n      if (!rawKey || rawValue === undefined) return undefined;\n      const key = decodeURIComponent(rawKey);\n      const decodedValue = decodeURIComponent(rawValue);\n      if (key.length > 255 || decodedValue.length > 255) return undefined;\n      attributes[key] = decodedValue;\n    }\n  } catch {\n    return undefined;\n  }\n  return attributes;\n}\n\nfunction safeResourceValue(value: string | undefined): string | undefined {\n  const trimmed = value?.trim();\n  if (!trimmed || trimmed.length > 128) return undefined;\n  if (\n    [...trimmed].some((character) => {\n      const code = character.charCodeAt(0);\n      return code <= 31 || code === 127;\n    })\n  ) {\n    return undefined;\n  }\n  return sanitizeTelemetryString(trimmed) === trimmed ? trimmed : undefined;\n}\n\nfunction currentOpenTelemetryEnvironment(): NodeJS.ProcessEnv {\n  const names = [\n    \"OTEL_SDK_DISABLED\",\n    \"OTEL_SERVICE_NAME\",\n    \"OTEL_RESOURCE_ATTRIBUTES\",\n    \"OTEL_TRACES_EXPORTER\",\n    \"OTEL_METRICS_EXPORTER\",\n    \"OTEL_EXPORTER_OTLP_ENDPOINT\",\n    \"OTEL_EXPORTER_OTLP_TRACES_ENDPOINT\",\n    \"OTEL_EXPORTER_OTLP_METRICS_ENDPOINT\",\n    \"OTEL_EXPORTER_OTLP_PROTOCOL\",\n    \"OTEL_EXPORTER_OTLP_TRACES_PROTOCOL\",\n    \"OTEL_EXPORTER_OTLP_METRICS_PROTOCOL\",\n    \"OTEL_METRIC_EXPORT_INTERVAL\",\n    \"OTEL_METRIC_EXPORT_TIMEOUT\",\n  ] as const;\n  return Object.fromEntries(names.map((name) => [name, readStandardEnv(name)]));\n}\n\nfunction positiveInteger(value: string | undefined): number | undefined {\n  if (!value) return undefined;\n  const parsed = Number(value);\n  return Number.isInteger(parsed) && parsed > 0 ? parsed : undefined;\n}\n"]}

package/dist/observability/sentry.d.ts

@@ -1,30 +1,49 @@
-import type { Breadcrumb, ErrorEvent, Event, EventHint, Scope } from "@sentry/node";
-export type { ReportUserFacingErrorOptions, SentryAttributionAttributes, SentryRunScopeContext, SentrySpanPayload, SentryTransactionPayload, } from "./types.js";
+import type { Breadcrumb, Event, EventHint, Scope } from "@sentry/node";
+import * as Sentry from "@sentry/node";
 import type { ReportUserFacingErrorOptions, SentryAttributionAttributes, SentryRunScopeContext, SentrySpanPayload, SentryTransactionPayload } from "./types.js";
-export declare function createSentryInitOptions(dsn?: string): {
+export declare function createSentryInitOptions(dsn?: string, customOpenTelemetry?: boolean): {
     dsn: string | undefined;
     environment: string;
     enabled: boolean;
     sendDefaultPii: boolean;
-    tracesSampleRate: number;
+    tracesSampleRate: number | undefined;
+    skipOpenTelemetrySetup: boolean;
+    registerEsmLoaderHooks: boolean | undefined;
     includeLocalVariables: boolean;
     enableLogs: boolean;
-    beforeSend(event: ErrorEvent, hint: EventHint): ErrorEvent | null;
-    beforeSendSpan(span: SentrySpanPayload): SentrySpanPayload;
-    beforeSendTransaction(event: SentryTransactionPayload): SentryTransactionPayload | null;
-    beforeBreadcrumb(breadcrumb: Breadcrumb): Breadcrumb | null;
+    integrations(defaultIntegrations: ReturnType<typeof Sentry.getDefaultIntegrations>): import("@sentry/core").Integration[];
+    beforeSend: typeof sanitizeEvent;
+    beforeSendSpan: typeof applySpanAttribution;
+    beforeSendTransaction: typeof sanitizeTransactionEvent;
+    beforeBreadcrumb: typeof sanitizeBreadcrumb;
 };
-export declare function reportUserFacingError(error: unknown, options: ReportUserFacingErrorOptions): string | undefined;
-export declare function createRunAttributionAttributes(context: SentryRunScopeContext): SentryAttributionAttributes;
+export declare function captureSentryError(error: unknown, options: ReportUserFacingErrorOptions): string | undefined;
+export declare function closeSentry(timeoutMs: number): Promise<boolean>;
+export declare function recordSentryCounter(name: string, value: number, attributes: SentryAttributionAttributes): void;
+export declare function recordSentryDistribution(name: string, value: number, options: {
+    unit?: string;
+    attributes: SentryAttributionAttributes;
+}): void;
+export declare function recordSentryGauge(name: string, value: number, options: {
+    unit?: string;
+    attributes: SentryAttributionAttributes;
+}): void;
+export declare function addSentryBreadcrumb(message: string, data?: Record<string, unknown>, options?: {
+    category?: string;
+    level?: "info" | "warning";
+    log?: boolean;
+}): void;
+export declare function withSentryRunScope<T>(context: SentryRunScopeContext, body: () => T): T;
+export declare function createRunScopeAttributes(context: SentryRunScopeContext): SentryAttributionAttributes;
 export declare function registerTraceAttribution(span: {
     setAttributes(attributes: SentryAttributionAttributes): unknown;
 }, attributes: SentryAttributionAttributes): void;
-export declare function updateActiveSpanAttribution(attributes: SentryAttributionAttributes): void;
 export declare function applyRunScope(scope: Scope, context: SentryRunScopeContext): void;
-export declare function metricAttributes(attributes: Record<string, string | number | boolean | undefined>): Record<string, string | number | boolean>;
-export declare function addLifecycleBreadcrumb(message: string, data?: Record<string, string | number | boolean | undefined>): void;
 export declare function sanitizeEvent<T extends Event>(event: T, _hint?: EventHint): T | null;
 export declare function applySpanAttribution<T extends SentrySpanPayload>(span: T): T;
+declare function sanitizeTransactionEvent<T extends SentryTransactionPayload>(event: T): T | null;
 export declare function sanitizeBreadcrumb(breadcrumb: Breadcrumb): Breadcrumb | null;
 export declare function sanitizeValue(value: unknown, key?: string, depth?: number): unknown;
+export declare function sanitizeTelemetryString(value: string): string;
+export {};
 //# sourceMappingURL=sentry.d.ts.map