Finish summarizer API pages

files/en-us/web/api/createmonitor/downloadprogress_event/index.md

@@ -0,0 +1,48 @@
+---
+title: "CreateMonitor: downloadprogress event"
+short-title: downloadprogress
+slug: Web/API/CreateMonitor/downloadprogress_event
+page-type: web-api-event
+status:
+  - experimental
+browser-compat: api.CreateMonitor.downloadprogress_event
+---
+
+{{APIRef("Summarizer API")}}{{SeeCompatTable}}
+
+The **`downloadprogress`** event of the {{domxref("CreateMonitor")}} interface is fired when progress is made on the summarizer download.
+
+EDITORIAL: Again, I'm not really sure about exactly what this is showing the progress of.
+
+## Syntax
+
+Use the event name in methods like {{domxref("EventTarget.addEventListener", "addEventListener()")}}, or set an event handler property.
+
+```js
+addEventListener("downloadprogress", (event) => {});
+
+ondownloadprogress = (event) => {};
+```
+
+## Event type
+
+A {{domxref("ProgressEvent")}}. Inherits from {{domxref("Event")}}.
+
+{{InheritanceDiagram("ProgressEvent")}}
+
+## Examples
+
+See the main {{domxref("CreateMonitor")}} page for an example.
+
+## Specifications
+
+{{Specifications}}
+
+## Browser compatibility
+
+{{Compat}}
+
+## See also
+
+- [Using the Summarizer API](/en-US/docs/Web/API/Summarizer_API/Using)
+- [Web AI demos](https://chrome.dev/web-ai-demos/) on chrome.dev.

files/en-us/web/api/createmonitor/index.md

@@ -0,0 +1,52 @@
+---
+title: CreateMonitor
+slug: Web/API/CreateMonitor
+page-type: web-api-interface
+status:
+  - experimental
+browser-compat: api.CreateMonitor
+---
+
+{{APIRef("Summarizer API")}}{{SeeCompatTable}}
+
+The **`CreateMonitor`** interface of the Writing Assistance APIs ({{domxref("Summarizer API", "Summarizer API", "", "nocode")}} provides information on the progress of a summarizer download.
+
+{{InheritanceDiagram}}
+
+## Events
+
+_Inherits events from its parent, {{DOMxRef("EventTarget")}}._
+
+- {{domxref("CreateMonitor/downloadprogress_event", "downloadprogress")}} {{Experimental_Inline}}
+  - : Fired when progress is made on the summarizer download.
+
+## Examples
+
+```js
+const summarizer = await Summarizer.create({
+  sharedContext:
+    "A general summary to help a user decide if the text is worth reading",
+  monitor: (monitor) => {
+    monitor.addEventListener("downloadprogress", (e) => {
+      console.log(`download progress: ${e.loaded}/${e.total}`);
+    });
+  },
+});
+
+const summary = await summarizer.summarize(myText);
+```
+
+EDITORIAL: I can get this to work, but I'm not really sure what exactly it is monitoring progress of. It would be good to get some more information on this.
+
+## Specifications
+
+{{Specifications}}
+
+## Browser compatibility
+
+{{Compat}}
+
+## See also
+
+- [Using the Summarizer API](/en-US/docs/Web/API/Summarizer_API/Using)
+- [Web AI demos](https://chrome.dev/web-ai-demos/) on chrome.dev.

files/en-us/web/api/summarizer/availability_static/index.md

@@ -55,6 +55,15 @@ Possible values include:
 
 EDITORIAL: I am guessing at how language model updates are identified and downloaded. Is this something that is done programmatically, or does the app need to instruct the user to do so? I'm assuming how this is handled will be implementation-dependant, but we ought to given an example of how Chrome does it. I probably need to give some more details on "best fit" languages, as per the example mentioned in the spec. More research needed.
 
+### Exceptions
+
+- `NotAllowedError` {{domxref("DOMException")}}
+  - : Thrown if usage of the Summarizer API is blocked by a {{httpheader('Permissions-Policy/summarizer','summarizer')}} {{httpheader("Permissions-Policy")}}.
+- `NotSupportedError` {{domxref("DOMException")}}
+  - : Thrown if the provided `context` is not in language the `Summarizer` supports.
+- `UnknownError` {{domxref("DOMException")}}
+  - : Thrown if the `measureInputUsage()` call failed for any other reason, or a reason the user agent did not wish to disclose.
+
 ## Examples
 
 ### Basic `availability()` usage

files/en-us/web/api/summarizer/create_static/index.md

@@ -54,6 +54,8 @@ A {{jsxref("Promise")}} that fulfills with a `Summarizer` object instance.
 
 ### Exceptions
 
+- `NotAllowedError` {{domxref("DOMException")}}
+  - : Thrown if usage of the Summarizer API is blocked by a {{httpheader('Permissions-Policy/summarizer','summarizer')}} {{httpheader("Permissions-Policy")}}.
 - `NotSupportedError` {{domxref("DOMException")}}
   - : Thrown if any of the language tags specified in `expectedContextLanguages`, `expectedInputLanguages`, or `outputLanguage` are invalid, or not supported.
 - `OperationError` {{domxref("DOMException")}}

files/en-us/web/api/summarizer/index.md

@@ -44,7 +44,7 @@ The **`Summarizer`** interface of the {{domxref("Summarizer API", "Summarizer AP
 - {{domxref("Summarizer.destroy", "destroy()")}} {{Experimental_Inline}}
   - : Destroys the `Summarizer` instance it is called on.
 - {{domxref("Summarizer.measureInputUsage", "measureInputUsage()")}} {{Experimental_Inline}}
-  - : Reports how much input quota is used by a given summarize operation.
+  - : Reports how much input quota would be used by a summarize operation for a given text input.
 - {{domxref("Summarizer.summarize", "summarize()")}} {{Experimental_Inline}}
   - : Generates a new summary string.
 - {{domxref("Summarizer.summarizeStreaming", "summarizeStreaming()")}} {{Experimental_Inline}}

files/en-us/web/api/summarizer/measureinputusage/index.md

@@ -0,0 +1,79 @@
+---
+title: "Summarizer: measureInputUsage() method"
+short-title: measureInputUsage()
+slug: Web/API/Summarizer/measureInputUsage
+page-type: web-api-instance-method
+status:
+  - experimental
+browser-compat: api.Summarizer.measureInputUsage
+---
+
+{{APIRef("Summarizer API")}}{{SeeCompatTable}}
+
+The **`measureInputUsage()`** method of the {{domxref("Summarizer")}} interface reports how much input quota would be used by a summarize operation for a given text input.
+
+## Syntax
+
+```js-nolint
+measureInputUsage(input)
+measureInputUsage(input, options)
+```
+
+### Parameters
+
+- `input`
+  - : A string representing the input text you want an input usage measurement for.
+- `options` {{optional_inline}}
+  - : An object specifying configuration options for the `measureInputUsage()` operation. Possible values include:
+    - `context`
+      - : A string describing the context the input text would be used in, to help generate a more suitable summary.
+    - `signal`
+      - : An {{domxref("AbortSignal")}} object instance, which allows the `measureInputUsage()` operation to be aborted via the associated {{domxref("AbortController")}}.
+
+EDITORIAL: Aborting the call via an abort signal doesn't seem to work. Am I missing something?
+
+### Return value
+
+A {{jsxref("Promise")}} that fulfills with a number specifying the {{domxref("Summarizer.inputQuota", "inputQuota")}} usage of the given input text.
+
+EDITORIAL: As I said on the inputQuota page, I ought to include some information about input quota and how it is determined for each implenentation. Maybe just including all of that info on the inputQuota page and then linking to it from here would be enough? I should specify how accurate the value returned by measureInputUsage is, whether it an estimaate, etc.?
+
+### Exceptions
+
+- `NotAllowedError` {{domxref("DOMException")}}
+  - : Thrown if usage of the Summarizer API is blocked by a {{httpheader('Permissions-Policy/summarizer','summarizer')}} {{httpheader("Permissions-Policy")}}.
+- `NotReadableError` {{domxref("DOMException")}}
+  - : Thrown if the output summary was filtered by the user agent, for example because it was detected to be harmful, inaccurate, or nonsensical.
+- `NotSupportedError` {{domxref("DOMException")}}
+  - : Thrown if the provided `context` is not in language the `Summarizer` supports.
+- `UnknownError` {{domxref("DOMException")}}
+  - : Thrown if the `measureInputUsage()` call failed for any other reason, or a reason the user agent did not wish to disclose.
+
+## Examples
+
+### Basic `measureInputUsage()` usage
+
+```js
+const summarizer = await Summarizer.create({
+  sharedContext:
+    "A general summary to help a user decide if the text is worth reading",
+  type: "tl;dr",
+  length: "short",
+});
+
+const inputUsage = await summarizer.measureInputUsage(myText);
+console.log(`Input usage: ${inputUsage}`);
+```
+
+## Specifications
+
+{{Specifications}}
+
+## Browser compatibility
+
+{{Compat}}
+
+## See also
+
+- [Using the Summarizer API](/en-US/docs/Web/API/Summarizer_API/Using)
+- [Web AI demos](https://chrome.dev/web-ai-demos/) on chrome.dev.

files/en-us/web/api/summarizer/summarize/index.md

@@ -40,6 +40,14 @@ A {{jsxref("Promise")}} that fulfills with a string containing the generated sum
 
 - `InvalidStateError` {{domxref("DOMException")}}
   - : Thrown if the current {{domxref("Document")}} is not active.
+- `NotAllowedError` {{domxref("DOMException")}}
+  - : Thrown if usage of the Summarizer API is blocked by a {{httpheader('Permissions-Policy/summarizer','summarizer')}} {{httpheader("Permissions-Policy")}}.
+- `NotReadableError` {{domxref("DOMException")}}
+  - : Thrown if the output summary was filtered by the user agent, for example because it was detected to be harmful, inaccurate, or nonsensical.
+- `NotSupportedError` {{domxref("DOMException")}}
+  - : Thrown if the provided `context` is not in language the `Summarizer` supports.
+- `UnknownError` {{domxref("DOMException")}}
+  - : Thrown if the `summarize()` call failed for any other reason, or a reason the user agent did not wish to disclose.
 
 ## Examples
 

files/en-us/web/api/summarizer/summarizestreaming/index.md

@@ -40,6 +40,14 @@ A {{jsxref("Promise")}} that fulfills with a {{domxref("ReadableStream")}} conta
 
 - `InvalidStateError` {{domxref("DOMException")}}
   - : Thrown if the current {{domxref("Document")}} is not active.
+- `NotAllowedError` {{domxref("DOMException")}}
+  - : Thrown if usage of the Summarizer API is blocked by a {{httpheader('Permissions-Policy/summarizer','summarizer')}} {{httpheader("Permissions-Policy")}}.
+- `NotReadableError` {{domxref("DOMException")}}
+  - : Thrown if the output summary was filtered by the user agent, for example because it was detected to be harmful, inaccurate, or nonsensical.
+- `NotSupportedError` {{domxref("DOMException")}}
+  - : Thrown if the provided `context` is not in language the `Summarizer` supports.
+- `UnknownError` {{domxref("DOMException")}}
+  - : Thrown if the `summarizeStreaming()` call failed for any other reason, or a reason the user agent did not wish to disclose.
 
 ## Examples
 

files/en-us/web/api/summarizer_api/index.md

@@ -38,6 +38,11 @@ See [Using the Summarizer API](/en-US/docs/Web/API/Summarizer_API/Using) for a w
 - {{domxref("Summarizer")}} {{Experimental_Inline}}
   - : Contains all the functionality for the Summarizer API, including checking AI model availability, creating a new `Summarizer` instance, using it to generate a new summary, and more.
 
+## HTTP headers
+
+- {{httpheader("Permissions-Policy")}}; the {{httpheader('Permissions-Policy/summarizer','summarizer')}} directive
+  - : Controls access to the Summarizer API. Where a policy specifically disallows the use of the Summarizer API, any attempts to call the API's methods will fail with a `NotAllowedError` {{domxref("DOMException")}}.
+
 ## Examples
 
 For a full example, see [Using the Summarizer API](/en-US/docs/Web/API/Summarizer_API/Using)

files/en-us/web/http/reference/headers/permissions-policy/index.md

@@ -210,6 +210,10 @@ You can specify
 
   - : Controls whether a document loaded in a third-party context (i.e., embedded in an {{htmlelement("iframe")}}) is allowed to use the {{domxref("Storage Access API", "Storage Access API", "", "nocode")}} to request access to unpartitioned cookies.
 
+- {{httpheader("Permissions-Policy/summarizer", "summarizer")}} {{Experimental_Inline}}
+
+  - : Controls access to the [Summarizer API](/en-US/docs/Web/API/Summarizer_API).
+
 - {{httpheader('Permissions-Policy/usb', 'usb')}} {{Experimental_Inline}}
 
   - : Controls whether the current document is allowed to use the [WebUSB API](/en-US/docs/Web/API/WebUSB_API).

files/en-us/web/http/reference/headers/permissions-policy/summarizer/index.md

@@ -0,0 +1,40 @@
+---
+title: "Permissions-Policy: summarizer"
+slug: Web/HTTP/Reference/Headers/Permissions-Policy/summarizer
+page-type: http-permissions-policy-directive
+status:
+  - experimental
+browser-compat: http.headers.Permissions-Policy.summarizer
+---
+
+{{HTTPSidebar}}{{SeeCompatTable}}
+
+The HTTP {{HTTPHeader("Permissions-Policy")}} header `summarizer` directive controls access to the [Summarizer API](/en-US/docs/Web/API/Summarizer_API).
+
+Specifically, where a defined policy blocks Summarizer API usage, any attempts to call the API's methods will fail with a `NotAllowedError` {{domxref("DOMException")}}.
+
+## Syntax
+
+```http
+Permissions-Policy: summarizer=<allowlist>;
+```
+
+- `<allowlist>`
+  - : A list of origins for which permission is granted to use the feature. See [`Permissions-Policy` > Syntax](/en-US/docs/Web/HTTP/Reference/Headers/Permissions-Policy#syntax) for more details.
+
+## Default policy
+
+The default allowlist for `summarizer` is `self`.
+
+## Specifications
+
+{{Specifications}}
+
+## Browser compatibility
+
+{{Compat}}
+
+## See also
+
+- {{HTTPHeader("Permissions-Policy")}} header
+- [Permissions Policy](/en-US/docs/Web/HTTP/Guides/Permissions_Policy)