mlx-bun library API
    Preparing search index...
    interface StepSamplerOptions {
        curve?: CurveParams;
        frequencyContextSize?: number;
        frequencyPenalty?: number;
        grammar?: StepGrammar | null;
        hlg?: HlgConfig;
        logitBias?: Record<number, number>;
        minP?: number;
        minTokensToKeep?: number;
        presenceContextSize?: number;
        presencePenalty?: number;
        repetitionContextSize?: number;
        repetitionPenalty?: number;
        seed?: number;
        temperature?: number;
        topK?: number;
        topP?: number;
        xtcProbability?: number;
        xtcSpecialTokens?: number[];
        xtcThreshold?: number;
    }

    Hierarchy (View Summary)

    Index
    curve?: CurveParams

    v2 log-prob transfer-curve sampler. When set, the drawn monotone curve REPLACES temperature+softmax entirely (stochastic, seeded) — see packages/inference/src/sampling/curve.ts. Identity curve ≡ temperature 1.

    frequencyContextSize?: number
    frequencyPenalty?: number

    OpenAI-style frequency penalty: subtracted once PER OCCURRENCE of the token in the recent window. May be negative.

    grammar?: StepGrammar | null
    hlg?: HlgConfig

    HLG tone-curve sampling. When enabled, replaces temperature's flat slope with the piecewise curve (temperature becomes the mid gain). Off/undefined ⇒ the plain temperature path, unchanged. 02d723a:docs/archive/hlg-sampling.md.

    logitBias?: Record<number, number>

    Additive per-token-id logit bias, applied before any penalty (mlx-lm's logit_bias: {tokenId: bias}).

    minP?: number

    min-p: keep tokens whose probability ≥ minP · p(top token). mlx-lm's min_p. Applied after top-p, before XTC/top-k (reference chain order).

    minTokensToKeep?: number

    Minimum number of tokens min-p may never filter out. Default 1.

    presenceContextSize?: number
    presencePenalty?: number

    OpenAI-style presence penalty: subtracted ONCE from a token's logit if it occurred at all in the recent window. May be negative.

    repetitionContextSize?: number
    repetitionPenalty?: number
    seed?: number
    temperature?: number
    topK?: number
    topP?: number
    xtcProbability?: number

    XTC ("exclude top choices"): with this probability per step, drop every token above the threshold EXCEPT the least likely of them.

    xtcSpecialTokens?: number[]

    Token ids XTC never removes (mlx-lm's server passes EOS + "\n").

    xtcThreshold?: number

    Probability a token must exceed to be an XTC removal candidate. [0, 0.5].