import type { AnyFn, SpanTraceOptions } from "./types";
/**
 * A decorator factory for tracing operations in an LLM application.
 *
 * This decorator wraps class methods to automatically create OpenTelemetry spans
 * for tracing purposes. It leverages the `withSpan` function internally to ensure
 * consistent tracing behavior across the library.
 *
 * The decorator binds the original method at call time so the traced wrapper runs
 * with the correct `this` value for each invocation.
 *
 * @experimental This API is experimental and may change in future versions
 *
 * @param options - Configuration options for the tracing behavior
 * @param options.tracer - Custom tracer instance to use (otherwise the current global tracer
 * provider is resolved when the decorated method is invoked)
 * @param options.name - Custom span name (defaults to method name)
 * @param options.openTelemetrySpanKind - OpenTelemetry span kind (defaults to INTERNAL)
 * @param options.kind - OpenInference span kind (defaults to CHAIN)
 * @param options.processInput - Custom input processing function (optional)
 * @param options.processOutput - Custom output processing function (optional)
 *
 * @returns A decorator function that can be applied to class methods
 *
 * @example
 * ```typescript
 * class MyService {
 *   @observe({ name: "processData", kind: "LLM" })
 *   async processData(input: string) {
 *     // Method implementation
 *     return `processed: ${input}`;
 *   }
 * }
 * ```
 */
export declare function observe<Fn extends AnyFn>(options?: SpanTraceOptions): (originalMethod: Fn, ctx: ClassMethodDecoratorContext) => Fn;
//# sourceMappingURL=decorators.d.ts.map