import type { HostToolSet } from "./host-tools.js";
import type { ToolExecutionContext } from "./types.js";
/** Public API contract for host tool trace runner. */
export type HostToolTraceRunner = <TResult>(spanName: string, operation: () => TResult) => TResult;
/** Public API contract for host tool trace attributes. */
export type HostToolTraceAttributes = Record<string, unknown>;
/** Input payload for host tool trace attribute. */
export type HostToolTraceAttributeInput = {
    toolName: string;
    toolCallId: string | undefined;
    context: ToolExecutionContext | undefined;
};
/** Options accepted by trace host tools. */
export type TraceHostToolsOptions<TAttributes extends HostToolTraceAttributes = HostToolTraceAttributes> = {
    trace: HostToolTraceRunner;
    buildAttributes?: (input: HostToolTraceAttributeInput) => TAttributes | undefined;
    setAttributes?: (attributes: TAttributes) => void;
    getSpanName?: (toolName: string) => string;
};
/** Wrap host tools with tracing metadata. */
export declare function traceHostTools<TAttributes extends HostToolTraceAttributes = HostToolTraceAttributes>(tools: HostToolSet, options: TraceHostToolsOptions<TAttributes>): HostToolSet;
//# sourceMappingURL=tracing.d.ts.map