@supersoniks/concorde 4.9.96 → 4.9.98-visual-stack.0

package/dist/types/core/components/functional/infer/hugging-face/hf-schema.d.ts

@@ -0,0 +1,1251 @@
+/**
+ * Schémas des options d'appel, par tâche.
+ *
+ * Ces schémas servent à valider à l'exécution ce qu'un descripteur SDUI (ou
+ * un attribut HTML) passe dans `options.call`, et à documenter le catalogue
+ * MCP (`hfCallOptionsJsonSchema`).
+ *
+ * Ils ne peuvent pas diverger des types de Transformers.js :
+ * - chaque tâche doit lister TOUTES les options sérialisables de son pipeline
+ *   (clé manquante = erreur de compilation) ;
+ * - une clé qui n'existe pas dans le pipeline est refusée ;
+ * - tout ce qu'un schéma accepte doit être une valeur valide du type de
+ *   l'option (sinon erreur de compilation « schema-trop-large »).
+ *
+ * Les bornes (`maximum`, `maxItems`…) protègent le poste : un descripteur
+ * SDUI ne peut pas demander 10 000 jetons ou 200 faisceaux.
+ */
+import type { HfCallOptions, HfTask } from "./types";
+export type HfValueSchema = {
+    readonly type: "boolean";
+} | {
+    readonly type: "number";
+    readonly integer?: boolean;
+    readonly minimum?: number;
+    readonly maximum?: number;
+} | {
+    readonly type: "string";
+    readonly maxLength?: number;
+} | {
+    readonly type: "null";
+} | {
+    readonly enum: readonly (string | number | boolean)[];
+} | {
+    readonly type: "array";
+    readonly items: HfValueSchema;
+    readonly maxItems?: number;
+} | {
+    readonly type: "tuple";
+    readonly prefixItems: readonly HfValueSchema[];
+} | {
+    readonly anyOf: readonly HfValueSchema[];
+};
+/** Valeurs acceptées par un schéma (niveau types). */
+export type HfSchemaValue<S> = S extends {
+    type: "boolean";
+} ? boolean : S extends {
+    type: "number";
+} ? number : S extends {
+    type: "string";
+} ? string : S extends {
+    type: "null";
+} ? null : S extends {
+    enum: readonly (infer E)[];
+} ? E : S extends {
+    type: "array";
+    items: infer I;
+} ? HfSchemaValue<I>[] : S extends {
+    type: "tuple";
+    prefixItems: infer P;
+} ? {
+    -readonly [K in keyof P]: HfSchemaValue<P[K]>;
+} : S extends {
+    anyOf: readonly (infer A)[];
+} ? HfSchemaValue<A> : never;
+export declare const HF_CALL_OPTION_SCHEMAS: {
+    readonly "feature-extraction": {
+        readonly pooling: {
+            readonly enum: readonly ["none", "mean", "cls", "first_token", "eos", "last_token"];
+        };
+        readonly normalize: {
+            readonly type: "boolean";
+        };
+        readonly quantize: {
+            readonly type: "boolean";
+        };
+        readonly precision: {
+            readonly enum: readonly ["binary", "ubinary"];
+        };
+    };
+    readonly "text-classification": {
+        readonly top_k: {
+            readonly anyOf: readonly [{
+                readonly type: "number";
+                readonly integer: true;
+                readonly minimum: number | undefined;
+                readonly maximum: number | undefined;
+            }, {
+                readonly type: "null";
+            }];
+        };
+    };
+    readonly "zero-shot-classification": {
+        readonly candidate_labels: {
+            readonly anyOf: readonly [{
+                readonly type: "string";
+                readonly maxLength: number;
+            }, {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                    readonly maxLength: number;
+                };
+                readonly maxItems: 50;
+            }];
+        };
+        readonly hypothesis_template: {
+            readonly type: "string";
+            readonly maxLength: number;
+        };
+        readonly multi_label: {
+            readonly type: "boolean";
+        };
+    };
+    readonly translation: {
+        readonly max_length: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly max_new_tokens: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly min_length: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly min_new_tokens: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly early_stopping: {
+            readonly anyOf: readonly [{
+                readonly type: "boolean";
+            }, {
+                readonly enum: readonly ["never"];
+            }];
+        };
+        readonly max_time: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly do_sample: {
+            readonly type: "boolean";
+        };
+        readonly num_beams: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly num_beam_groups: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly penalty_alpha: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly use_cache: {
+            readonly type: "boolean";
+        };
+        readonly temperature: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly top_k: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly top_p: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly typical_p: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly epsilon_cutoff: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly eta_cutoff: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly diversity_penalty: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly repetition_penalty: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly encoder_repetition_penalty: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly length_penalty: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly no_repeat_ngram_size: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly bad_words_ids: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                    readonly integer: true;
+                    readonly minimum: number | undefined;
+                    readonly maximum: number | undefined;
+                };
+                readonly maxItems: number;
+            };
+            readonly maxItems: number;
+        };
+        readonly force_words_ids: {
+            readonly anyOf: readonly [{
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "number";
+                        readonly integer: true;
+                        readonly minimum: number | undefined;
+                        readonly maximum: number | undefined;
+                    };
+                    readonly maxItems: number;
+                };
+                readonly maxItems: number;
+            }, {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "number";
+                            readonly integer: true;
+                            readonly minimum: number | undefined;
+                            readonly maximum: number | undefined;
+                        };
+                        readonly maxItems: number;
+                    };
+                    readonly maxItems: number;
+                };
+                readonly maxItems: 64;
+            }];
+        };
+        readonly renormalize_logits: {
+            readonly type: "boolean";
+        };
+        readonly forced_bos_token_id: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly forced_eos_token_id: {
+            readonly anyOf: readonly [{
+                readonly type: "number";
+                readonly integer: true;
+                readonly minimum: number | undefined;
+                readonly maximum: number | undefined;
+            }, {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                    readonly integer: true;
+                    readonly minimum: number | undefined;
+                    readonly maximum: number | undefined;
+                };
+                readonly maxItems: number;
+            }];
+        };
+        readonly remove_invalid_values: {
+            readonly type: "boolean";
+        };
+        readonly exponential_decay_length_penalty: {
+            readonly type: "tuple";
+            readonly prefixItems: readonly [{
+                readonly type: "number";
+                readonly integer: true;
+                readonly minimum: number | undefined;
+                readonly maximum: number | undefined;
+            }, {
+                readonly type: "number";
+                readonly minimum: number | undefined;
+                readonly maximum: number | undefined;
+            }];
+        };
+        readonly suppress_tokens: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly integer: true;
+                readonly minimum: number | undefined;
+                readonly maximum: number | undefined;
+            };
+            readonly maxItems: number;
+        };
+        readonly begin_suppress_tokens: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly integer: true;
+                readonly minimum: number | undefined;
+                readonly maximum: number | undefined;
+            };
+            readonly maxItems: number;
+        };
+        readonly forced_decoder_ids: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "tuple";
+                readonly prefixItems: readonly [{
+                    readonly type: "number";
+                    readonly integer: true;
+                    readonly minimum: number | undefined;
+                    readonly maximum: number | undefined;
+                }, {
+                    readonly type: "number";
+                    readonly integer: true;
+                    readonly minimum: number | undefined;
+                    readonly maximum: number | undefined;
+                }];
+            };
+            readonly maxItems: 64;
+        };
+        readonly guidance_scale: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly num_return_sequences: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly output_attentions: {
+            readonly type: "boolean";
+        };
+        readonly output_hidden_states: {
+            readonly type: "boolean";
+        };
+        readonly output_scores: {
+            readonly type: "boolean";
+        };
+        readonly return_dict_in_generate: {
+            readonly type: "boolean";
+        };
+        readonly pad_token_id: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly bos_token_id: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly eos_token_id: {
+            readonly anyOf: readonly [{
+                readonly type: "number";
+                readonly integer: true;
+                readonly minimum: number | undefined;
+                readonly maximum: number | undefined;
+            }, {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                    readonly integer: true;
+                    readonly minimum: number | undefined;
+                    readonly maximum: number | undefined;
+                };
+                readonly maxItems: number;
+            }];
+        };
+        readonly encoder_no_repeat_ngram_size: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly decoder_start_token_id: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+    };
+    readonly "token-classification": {
+        readonly ignore_labels: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+                readonly maxLength: number;
+            };
+            readonly maxItems: 50;
+        };
+        readonly aggregation_strategy: {
+            readonly enum: readonly ["none", "simple"];
+        };
+    };
+    readonly "fill-mask": {
+        readonly top_k: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+    };
+    readonly "question-answering": {
+        readonly context: {
+            readonly anyOf: readonly [{
+                readonly type: "string";
+                readonly maxLength: number;
+            }, {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                    readonly maxLength: number;
+                };
+                readonly maxItems: 20;
+            }];
+        };
+        readonly top_k: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+    };
+    readonly "image-classification": {
+        readonly top_k: {
+            readonly anyOf: readonly [{
+                readonly type: "number";
+                readonly integer: true;
+                readonly minimum: number | undefined;
+                readonly maximum: number | undefined;
+            }, {
+                readonly type: "null";
+            }];
+        };
+    };
+    readonly "zero-shot-image-classification": {
+        readonly candidate_labels: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+                readonly maxLength: number;
+            };
+            readonly maxItems: 50;
+        };
+        readonly hypothesis_template: {
+            readonly type: "string";
+            readonly maxLength: number;
+        };
+    };
+    readonly "object-detection": {
+        readonly threshold: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly percentage: {
+            readonly type: "boolean";
+        };
+    };
+    readonly "zero-shot-object-detection": {
+        readonly candidate_labels: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+                readonly maxLength: number;
+            };
+            readonly maxItems: 50;
+        };
+        readonly threshold: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly top_k: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly percentage: {
+            readonly type: "boolean";
+        };
+    };
+    readonly "image-feature-extraction": {
+        readonly pool: {
+            readonly type: "boolean";
+        };
+    };
+    readonly "image-segmentation": {
+        readonly threshold: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly mask_threshold: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly overlap_mask_area_threshold: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly subtask: {
+            readonly anyOf: readonly [{
+                readonly type: "string";
+                readonly maxLength: number;
+            }, {
+                readonly type: "null";
+            }];
+        };
+        readonly label_ids_to_fuse: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly integer: true;
+                readonly minimum: number | undefined;
+                readonly maximum: number | undefined;
+            };
+            readonly maxItems: number;
+        };
+        readonly target_sizes: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                    readonly integer: true;
+                    readonly minimum: number | undefined;
+                    readonly maximum: number | undefined;
+                };
+                readonly maxItems: number;
+            };
+            readonly maxItems: number;
+        };
+    };
+    readonly "depth-estimation": {};
+    readonly "background-removal": {};
+    readonly "image-to-text": {
+        readonly max_length: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly max_new_tokens: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly min_length: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly min_new_tokens: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly early_stopping: {
+            readonly anyOf: readonly [{
+                readonly type: "boolean";
+            }, {
+                readonly enum: readonly ["never"];
+            }];
+        };
+        readonly max_time: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly do_sample: {
+            readonly type: "boolean";
+        };
+        readonly num_beams: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly num_beam_groups: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly penalty_alpha: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly use_cache: {
+            readonly type: "boolean";
+        };
+        readonly temperature: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly top_k: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly top_p: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly typical_p: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly epsilon_cutoff: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly eta_cutoff: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly diversity_penalty: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly repetition_penalty: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly encoder_repetition_penalty: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly length_penalty: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly no_repeat_ngram_size: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly bad_words_ids: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                    readonly integer: true;
+                    readonly minimum: number | undefined;
+                    readonly maximum: number | undefined;
+                };
+                readonly maxItems: number;
+            };
+            readonly maxItems: number;
+        };
+        readonly force_words_ids: {
+            readonly anyOf: readonly [{
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "number";
+                        readonly integer: true;
+                        readonly minimum: number | undefined;
+                        readonly maximum: number | undefined;
+                    };
+                    readonly maxItems: number;
+                };
+                readonly maxItems: number;
+            }, {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "number";
+                            readonly integer: true;
+                            readonly minimum: number | undefined;
+                            readonly maximum: number | undefined;
+                        };
+                        readonly maxItems: number;
+                    };
+                    readonly maxItems: number;
+                };
+                readonly maxItems: 64;
+            }];
+        };
+        readonly renormalize_logits: {
+            readonly type: "boolean";
+        };
+        readonly forced_bos_token_id: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly forced_eos_token_id: {
+            readonly anyOf: readonly [{
+                readonly type: "number";
+                readonly integer: true;
+                readonly minimum: number | undefined;
+                readonly maximum: number | undefined;
+            }, {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                    readonly integer: true;
+                    readonly minimum: number | undefined;
+                    readonly maximum: number | undefined;
+                };
+                readonly maxItems: number;
+            }];
+        };
+        readonly remove_invalid_values: {
+            readonly type: "boolean";
+        };
+        readonly exponential_decay_length_penalty: {
+            readonly type: "tuple";
+            readonly prefixItems: readonly [{
+                readonly type: "number";
+                readonly integer: true;
+                readonly minimum: number | undefined;
+                readonly maximum: number | undefined;
+            }, {
+                readonly type: "number";
+                readonly minimum: number | undefined;
+                readonly maximum: number | undefined;
+            }];
+        };
+        readonly suppress_tokens: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly integer: true;
+                readonly minimum: number | undefined;
+                readonly maximum: number | undefined;
+            };
+            readonly maxItems: number;
+        };
+        readonly begin_suppress_tokens: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly integer: true;
+                readonly minimum: number | undefined;
+                readonly maximum: number | undefined;
+            };
+            readonly maxItems: number;
+        };
+        readonly forced_decoder_ids: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "tuple";
+                readonly prefixItems: readonly [{
+                    readonly type: "number";
+                    readonly integer: true;
+                    readonly minimum: number | undefined;
+                    readonly maximum: number | undefined;
+                }, {
+                    readonly type: "number";
+                    readonly integer: true;
+                    readonly minimum: number | undefined;
+                    readonly maximum: number | undefined;
+                }];
+            };
+            readonly maxItems: 64;
+        };
+        readonly guidance_scale: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly num_return_sequences: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly output_attentions: {
+            readonly type: "boolean";
+        };
+        readonly output_hidden_states: {
+            readonly type: "boolean";
+        };
+        readonly output_scores: {
+            readonly type: "boolean";
+        };
+        readonly return_dict_in_generate: {
+            readonly type: "boolean";
+        };
+        readonly pad_token_id: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly bos_token_id: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly eos_token_id: {
+            readonly anyOf: readonly [{
+                readonly type: "number";
+                readonly integer: true;
+                readonly minimum: number | undefined;
+                readonly maximum: number | undefined;
+            }, {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                    readonly integer: true;
+                    readonly minimum: number | undefined;
+                    readonly maximum: number | undefined;
+                };
+                readonly maxItems: number;
+            }];
+        };
+        readonly encoder_no_repeat_ngram_size: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly decoder_start_token_id: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+    };
+    readonly "audio-classification": {
+        readonly top_k: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+    };
+    readonly "automatic-speech-recognition": {
+        readonly return_timestamps: {
+            readonly anyOf: readonly [{
+                readonly type: "boolean";
+            }, {
+                readonly enum: readonly ["word"];
+            }];
+        };
+        readonly chunk_length_s: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly stride_length_s: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly force_full_sequences: {
+            readonly type: "boolean";
+        };
+        readonly language: {
+            readonly type: "string";
+            readonly maxLength: number;
+        };
+        readonly task: {
+            readonly enum: readonly ["transcribe", "translate"];
+        };
+        readonly num_frames: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly max_length: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly max_new_tokens: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly min_length: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly min_new_tokens: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly early_stopping: {
+            readonly anyOf: readonly [{
+                readonly type: "boolean";
+            }, {
+                readonly enum: readonly ["never"];
+            }];
+        };
+        readonly max_time: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly do_sample: {
+            readonly type: "boolean";
+        };
+        readonly num_beams: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly num_beam_groups: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly penalty_alpha: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly use_cache: {
+            readonly type: "boolean";
+        };
+        readonly temperature: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly top_k: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly top_p: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly typical_p: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly epsilon_cutoff: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly eta_cutoff: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly diversity_penalty: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly repetition_penalty: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly encoder_repetition_penalty: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly length_penalty: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly no_repeat_ngram_size: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly bad_words_ids: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                    readonly integer: true;
+                    readonly minimum: number | undefined;
+                    readonly maximum: number | undefined;
+                };
+                readonly maxItems: number;
+            };
+            readonly maxItems: number;
+        };
+        readonly force_words_ids: {
+            readonly anyOf: readonly [{
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "number";
+                        readonly integer: true;
+                        readonly minimum: number | undefined;
+                        readonly maximum: number | undefined;
+                    };
+                    readonly maxItems: number;
+                };
+                readonly maxItems: number;
+            }, {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "number";
+                            readonly integer: true;
+                            readonly minimum: number | undefined;
+                            readonly maximum: number | undefined;
+                        };
+                        readonly maxItems: number;
+                    };
+                    readonly maxItems: number;
+                };
+                readonly maxItems: 64;
+            }];
+        };
+        readonly renormalize_logits: {
+            readonly type: "boolean";
+        };
+        readonly forced_bos_token_id: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly forced_eos_token_id: {
+            readonly anyOf: readonly [{
+                readonly type: "number";
+                readonly integer: true;
+                readonly minimum: number | undefined;
+                readonly maximum: number | undefined;
+            }, {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                    readonly integer: true;
+                    readonly minimum: number | undefined;
+                    readonly maximum: number | undefined;
+                };
+                readonly maxItems: number;
+            }];
+        };
+        readonly remove_invalid_values: {
+            readonly type: "boolean";
+        };
+        readonly exponential_decay_length_penalty: {
+            readonly type: "tuple";
+            readonly prefixItems: readonly [{
+                readonly type: "number";
+                readonly integer: true;
+                readonly minimum: number | undefined;
+                readonly maximum: number | undefined;
+            }, {
+                readonly type: "number";
+                readonly minimum: number | undefined;
+                readonly maximum: number | undefined;
+            }];
+        };
+        readonly suppress_tokens: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly integer: true;
+                readonly minimum: number | undefined;
+                readonly maximum: number | undefined;
+            };
+            readonly maxItems: number;
+        };
+        readonly begin_suppress_tokens: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly integer: true;
+                readonly minimum: number | undefined;
+                readonly maximum: number | undefined;
+            };
+            readonly maxItems: number;
+        };
+        readonly forced_decoder_ids: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "tuple";
+                readonly prefixItems: readonly [{
+                    readonly type: "number";
+                    readonly integer: true;
+                    readonly minimum: number | undefined;
+                    readonly maximum: number | undefined;
+                }, {
+                    readonly type: "number";
+                    readonly integer: true;
+                    readonly minimum: number | undefined;
+                    readonly maximum: number | undefined;
+                }];
+            };
+            readonly maxItems: 64;
+        };
+        readonly guidance_scale: {
+            readonly type: "number";
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly num_return_sequences: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly output_attentions: {
+            readonly type: "boolean";
+        };
+        readonly output_hidden_states: {
+            readonly type: "boolean";
+        };
+        readonly output_scores: {
+            readonly type: "boolean";
+        };
+        readonly return_dict_in_generate: {
+            readonly type: "boolean";
+        };
+        readonly pad_token_id: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly bos_token_id: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly eos_token_id: {
+            readonly anyOf: readonly [{
+                readonly type: "number";
+                readonly integer: true;
+                readonly minimum: number | undefined;
+                readonly maximum: number | undefined;
+            }, {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                    readonly integer: true;
+                    readonly minimum: number | undefined;
+                    readonly maximum: number | undefined;
+                };
+                readonly maxItems: number;
+            }];
+        };
+        readonly encoder_no_repeat_ngram_size: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+        readonly decoder_start_token_id: {
+            readonly type: "number";
+            readonly integer: true;
+            readonly minimum: number | undefined;
+            readonly maximum: number | undefined;
+        };
+    };
+};
+export declare class HfOptionsError extends Error {
+    constructor(message: string);
+}
+/**
+ * Valide des options d'appel venues de l'extérieur (SDUI, attribut HTML).
+ * Clés inconnues refusées, types et bornes vérifiés.
+ */
+export declare function validateCallOptions<T extends HfTask>(task: T, options: unknown): HfCallOptions<T>;
+/** JSON Schema (draft 2020-12) des options d'appel d'une tâche, pour le catalogue MCP. */
+export declare function hfCallOptionsJsonSchema(task: HfTask): Record<string, unknown>;
+//# sourceMappingURL=hf-schema.d.ts.map