/**
 * Duck-typed interface describing the expected shape of a Galileo span object
 * that can be injected into the OpenAI Agents tracing flow.
 *
 * Mirrors the fields extracted by galileo-python's GalileoCustomSpan handler:
 * input, output, metadata (user_metadata), tags, status_code, and type.
 */
export interface GalileoSpanLike {
    type?: string;
    input?: unknown;
    output?: unknown;
    name?: string;
    metadata?: Record<string, string>;
    tags?: string[];
    statusCode?: number;
}
/**
 * A lightweight subtype of CustomSpanData that carries a reference to a
 * pre-configured GalileoSpan so it can be injected into the agent tracing flow.
 *
 * The __galileoCustom flag is used by mapSpanType() to distinguish this from
 * ordinary CustomSpanData objects.
 */
export interface GalileoCustomSpanData {
    /** Always 'custom' to satisfy the SDK's SpanData union discriminant. */
    type: 'custom';
    /** (Optional) Display name for the span. */
    name?: string;
    /** Arbitrary data payload, must contain a 'galileoSpan' key with the GalileoSpan reference. */
    data: Record<string, unknown> & {
        galileoSpan: GalileoSpanLike;
    };
    /** Sentinel flag used internally by mapSpanType() to identify this type. */
    __galileoCustom: true;
}
/**
 * Creates a GalileoCustomSpanData object that wraps an existing Galileo span.
 * @param galileoSpan - The Galileo span object to embed.
 * @param name - (Optional) Display name for the span.
 * @param extraData - (Optional) Additional data to include in the span data payload.
 * @returns A GalileoCustomSpanData object.
 */
export declare function createGalileoCustomSpanData(galileoSpan: GalileoSpanLike, name?: string, extraData?: Record<string, unknown>): GalileoCustomSpanData;
/**
 * Type guard that checks whether a span data object is a GalileoCustomSpanData.
 * @param spanData - The span data to check.
 * @returns True if the span data is a GalileoCustomSpanData.
 */
export declare function isGalileoCustomSpanData(spanData: unknown): spanData is GalileoCustomSpanData;