Skip to content

Remove experimental labels from samplingMode in spec and explainer #226

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
michaelwasserman merged 1 commit into from
Oct 27, 2026
Merged

Remove experimental labels from samplingMode in spec and explainer #226

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 7 additions & 4 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,19 +45,22 @@ The following are potential goals we are not yet certain of:

Both of these potential goals could pose challenges to interoperability, so we want to investigate more how important such functionality is to developers to find the right tradeoff.

## Experiments and Updates
## Updates and Deprecations

### Sampling Parameters

Developers have expressed the value of tuning language model sampling parameters for testing and optimizing task-specific model behavior. At the same time, web standards engagements have highlighted the need for more interoperable API shapes for sampling parameters among different models.

The API was initially made available in extension contexts with the following sampling parameter options and attributes:
The API was initially made available in extension contexts with the following raw sampling parameter features:

* The static method `LanguageModel.params()`, which exposes default and maximum values for sampling parameters: `defaultTemperature`, `maxTemperature`, `defaultTopK`, `maxTopK`.
* The `temperature` and `topK` options, which may be provided to `LanguageModel.create()` to control the sampling behavior of individual language model sessions.
* The `temperature` and `topK` attributes on `LanguageModel` session instances, which expose the current values of the sampling parameters for that session.

Access to these features is limited to extension and experimental web contexts. Ongoing experimentation and community engagement will explore different API shapes that satisfy developer requirements and address interoperability concerns.
Support for raw sampling parameters is now deprecated and only functional within web extension contexts (see [Legacy: Configuration of per-session raw parameters](#legacy-configuration-of-per-session-raw-parameters)). Instead, developers can configure output variety and creativity using interoperable [`samplingMode`](#configuration-of-sampling-modes) presets:

* The `samplingMode` option on `LanguageModel.create()` and `LanguageModel.availability()`, which accepts a `LanguageModelSamplingMode` preset (`"most-predictable"`, `"predictable"`, `"slightly-predictable"`, `"balanced"`, `"slightly-creative"`, `"creative"`, or `"most-creative"`).
* The `samplingMode` attribute on `LanguageModel` session instances, which exposes the resolved preset for that session.

### Renamed Features

Expand Down Expand Up @@ -1008,7 +1011,7 @@ if (availability !== "unavailable") {
const session = await LanguageModel.create(options);
// ... Use session ...
} else {
// Either the API overall, or the expected languages and temperature setting, is not available.
// Either the API overall, or the expected input types and languages, is not available.
console.error("No language model for us :(");
}
```
Expand Down
2 changes: 0 additions & 2 deletions index.bs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -91,7 +91,6 @@ interface LanguageModel : EventTarget {
// **DEPRECATED**: This attribute will be removed; use samplingMode instead. Only available in extension contexts.
readonly attribute float temperature;

// **EXPERIMENTAL**: Only available in experimental contexts.
readonly attribute LanguageModelSamplingMode? samplingMode;

@michaelwasserman michaelwasserman Oct 27, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Consider adding a brief comment like "The resolved sampling mode for the session."
Maybe we can comment that it might be null in extension contexts, while those still support legacy params?


Promise<LanguageModel> clone(optional LanguageModelCloneOptions options = {});
Expand Down Expand Up @@ -126,7 +125,6 @@ dictionary LanguageModelCreateCoreOptions {
// **DEPRECATED**: This option will be removed; use samplingMode instead. Only available in extension contexts.
unrestricted double temperature;

// **EXPERIMENTAL**: Only available in experimental contexts.
LanguageModelSamplingMode samplingMode;

@michaelwasserman michaelwasserman Oct 27, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Consider add a brief comment like "The requested sampling mode for this session."


// The expected types and languages for the session.
Expand Down
Loading