import { GenAISystem } from "./types.js";

//#region src/gen-ai/system-derivation.d.ts

/**
 * Canonical mapping from a provider class name (or substring) to the
 * `gen_ai.system` enum value. The table is an export so consumers
 * (e.g. provider adapters in Phase 06) can introspect or extend it.
 *
 * @stable
 */
declare const PROVIDER_CLASS_TO_GEN_AI_SYSTEM: ReadonlyArray<readonly [RegExp, GenAISystem]>;
/**
 * Override the WARN-once sink used for unrecognised provider class
 * names. Useful in tests so the suite does not pollute stderr.
 *
 * @internal
 */
declare function setGenAISystemWarnSink(sink: (line: string) => void): void;
/**
 * Reset the WARN-once cache. Test-only.
 *
 * @internal
 */
declare function _resetGenAISystemWarningsForTesting(): void;
/**
 * Derive the canonical `gen_ai.system` value from a provider class
 * name. Returns `null` when the name does not match any known
 * pattern; callers should declare `Provider.genAiSystem` explicitly
 * in that case.
 *
 * The first time an unknown class name is seen, the function emits
 * one structured WARN line to the configured sink so operators
 * notice the gap. Subsequent lookups for the same class are silent.
 *
 * @stable
 */
declare function deriveGenAISystem(providerClassName: string): GenAISystem | null;
//#endregion
export { PROVIDER_CLASS_TO_GEN_AI_SYSTEM, _resetGenAISystemWarningsForTesting, deriveGenAISystem, setGenAISystemWarnSink };
//# sourceMappingURL=system-derivation.d.ts.map