import { AISpan, SpanType } from "@graphorin/core";

//#region src/openinference/index.d.ts

/**
 * Canonical OpenInference span-kind enum.
 *
 * @stable
 */
type OpenInferenceSpanKind = 'AGENT' | 'EVALUATOR' | 'LLM' | 'TOOL' | 'RETRIEVER' | 'EMBEDDING' | 'CHAIN' | 'RERANKER';
/**
 * Span types intentionally excluded from OpenInference span-kind
 * emission per the canonical table - `skill.*`, `mcp.connect`,
 * `mcp.list-tools`, and `replay.*` markers do not have a clean
 * OpenInference equivalent.
 *
 * @stable
 */
declare const OPEN_INFERENCE_EXCLUDED_TYPES: ReadonlyArray<SpanType>;
/**
 * Resolve the OpenInference span kind for a Graphorin span type.
 * Returns `null` for types intentionally excluded from emission.
 *
 * @stable
 */
declare function openInferenceKindFor<T extends SpanType>(type: T): OpenInferenceSpanKind | null;
/**
 * Attach the `openinference.span.kind` attribute to a span. No-op for
 * span types that lack a clean OpenInference equivalent. The attribute
 * is tagged `'public'` because the enum value is bounded and contains
 * no PII.
 *
 * @stable
 */
declare function emitOpenInferenceKind<T extends SpanType>(span: AISpan<T>): void;
/**
 * Full canonical span-to-kind table - exposed for tooling and tests
 * that need to introspect the mapping.
 *
 * @stable
 */
declare const OPEN_INFERENCE_KIND_TABLE: readonly (readonly [SpanType, OpenInferenceSpanKind])[];
//#endregion
export { OPEN_INFERENCE_EXCLUDED_TYPES, OPEN_INFERENCE_KIND_TABLE, OpenInferenceSpanKind, emitOpenInferenceKind, openInferenceKindFor };
//# sourceMappingURL=index.d.ts.map