@nvisy/sdk 0.41.0 → 0.42.0

package/dist/{index-Co9cILnx.d.ts → index-B42oglvJ.d.ts}

@@ -5976,7 +5976,7 @@ interface paths {
     };
     /**
      * Get detection intermediates
-     * @description Returns the detection's enrichment intermediates — an image's OCR layout, an audio clip's transcript, or tokenized text — as `{ body, parts }`, so a client can search the extracted content and add entities the analysis missed. A detection whose analysis ran no enricher has no intermediates (404).
+     * @description Returns the detection's enrichment intermediates — an image's OCR layout, an audio clip's transcript, or tokenized text — as an object with a `parts` list, each part carrying its path `id`, `modality`, and the extracted `artifact`, so a client can search the content and add entities the analysis missed. A detection whose analysis ran no enricher has no intermediates (404).
      */
     get: {
       parameters: {
@@ -9541,48 +9541,33 @@ interface components {
       token: string;
     };
     ArtifactSet: {
-      body: ({
+      parts: ({
         artifact: components["schemas"]["Tokens"];
+        id: string[];
         /** @constant */
         modality: "text";
       } | {
         artifact: components["schemas"]["Layout"];
+        id: string[];
         /** @constant */
         modality: "image";
       } | {
         artifact: components["schemas"]["Transcription"];
+        id: string[];
         /** @constant */
         modality: "audio";
       } | {
         artifact: components["schemas"]["Tokens"];
+        id: string[];
         /** @constant */
         modality: "tabular";
-      }) | null;
-      parts: {
-        [key: string]: {
-          artifact: components["schemas"]["Tokens"];
-          /** @constant */
-          modality: "text";
-        } | {
-          artifact: components["schemas"]["Layout"];
-          /** @constant */
-          modality: "image";
-        } | {
-          artifact: components["schemas"]["Transcription"];
-          /** @constant */
-          modality: "audio";
-        } | {
-          artifact: components["schemas"]["Tokens"];
-          /** @constant */
-          modality: "tabular";
-        };
-      };
+      })[];
     };
     /**
      * @description Author-supplied rationale for a redaction: *under what authority* it was made.
      *
      *     Where the matched selection rule answers *which rule fired*, an
-     *     `Attribution` answers *why the policy demanded it* — a compliance clause, an
+     *     `Attribution` answers *why the policy demanded it*, a compliance clause, an
      *     internal policy, a data-handling rule. A policy author attaches it to a
      *     selection rule (`Rule::because` in `elide-redaction`); the anonymizer records
      *     it on the entity's [`Redaction`] event so an audit can trace a change back to
@@ -9629,31 +9614,42 @@ interface components {
       /** @description What the reviewer says this is. */
       label: components["schemas"]["LabelRef"];
       /**
-       * @description Where it sits, in the coordinates of the group it joins.
+       * @description Where it sits, in the coordinates of the part it joins.
        *
-       *     For text in a container, that is the body's decoded stream —
-       *     a DOCX's `word/document.xml` text *is* the body, not a part.
-       *     A caller who has raw file bytes rather than a decoded offset
-       *     (a reviewer selecting rendered text, say) leaves `range`
-       *     empty and fills [`TextLocation::source`] instead, which the
-       *     engine reverse-resolves.
+       *     Each medium addresses its own way: text a character range
+       *     over the decoded stream, images a bounding box, audio a time
+       *     span, tabular a row and column. A DOCX's
+       *     `word/document.xml` text belongs to the document part
+       *     itself, not to a nested one.
        *
+       *     For text specifically, a caller holding raw file bytes
+       *     rather than a decoded offset — a reviewer selecting rendered
+       *     text, say — leaves [`TextLocation::range`] empty and fills
+       *     [`TextLocation::source`] instead, which the engine
+       *     reverse-resolves. The other three have no such alternative:
+       *     their coordinates are the only way in.
+       *
+       *     [`TextLocation::range`]: elide::modality::text::TextLocation::range
        *     [`TextLocation::source`]: elide::modality::text::TextLocation::source
        */
       location: components["schemas"]["AudioLocation"];
       /**
-       * @description The container part this belongs to, e.g.
-       *     `"word/media/image1.png"`. `None` puts it on the body.
+       * @description The part this belongs to, as a path: `["report.docx"]` for
+       *     the document itself, `["report.docx", "word/media/image1.png"]`
+       *     for media it embeds. `None` means the request's sole
+       *     document, which is the common case and saves a caller
+       *     naming what it already sent.
        *
-       *     For the media a container embeds, which the report holds as
-       *     its own group: an image entity lives under its part, and an
-       *     addition to one has nowhere to go without naming it.
+       *     Nested media needs this: the report holds an embedded image
+       *     as its own part, and an addition to one has nowhere to go
+       *     without naming it. Text usually does not — where a span came
+       *     from is already in `TextLocation::source`, which carries the
+       *     part alongside the raw range.
        *
-       *     Text does not need this. A container's text is its body, and
-       *     where a span came from is already in `TextLocation::source`,
-       *     which carries the part alongside the raw range.
+       *     `None` is an error when the request carried several
+       *     documents, since there is then no sole document to mean.
        */
-      part?: string;
+      part?: string[];
       /** @description The rationale, when one was given. */
       reason?: string;
     };
@@ -9839,13 +9835,13 @@ interface components {
      *
      *     Carries the encoded audio bytes; an optional filename aids diagnostics
      *     and encoding inference (the container format a decoder should expect).
-     *     The recognizable text — a timestamped transcript — is *not* held here;
+     *     The recognizable text, a timestamped transcript, is *not* held here;
      *     a speech-to-text [`Enricher`] stamps it onto the call's
      *     [`artifact`], keeping
      *     `AudioData` the codec's payload alone.
      *
      *     [`Audio`]: super::Audio
-     *     [`Enricher`]: crate::recognition::Enricher
+     *     [`Enricher`]: crate::enrichment::Enricher
      *     [`artifact`]: crate::recognition::RecognizerContext::artifact
      */
     AudioData: {
@@ -9899,7 +9895,7 @@ interface components {
        * @description Tamper-evident audit trail: every contributing detection, the fusion
        *     event if any, and the redaction that hid it, as a hash-linked DAG. It is
        *     also the single source of truth for whether a reviewer
-       *     [suppressed](Self::is_suppressed) the entity — a suppression is a
+       *     [suppressed](Self::is_suppressed) the entity, a suppression is a
        *     [`Manual`] event on this trail, not a separate flag.
        *
        *     [`Manual`]: crate::entity::audit::AuditKind::Manual
@@ -9936,7 +9932,7 @@ interface components {
       location: components["schemas"]["AudioLocation"];
       /**
        * @description Byte range of the match in the *recognized text* it was found in (the
-       *     OCR layout text, the audio transcript, or the text payload itself) —
+       *     OCR layout text, the audio transcript, or the text payload itself),
        *     the stable key back into that enrichment artifact, where the rich
        *     context lives (which OCR block, which speaker) that the geometric
        *     [`location`] cannot hold. `None` for entities not found via text
@@ -9952,11 +9948,11 @@ interface components {
      *     for a nearby value.
      *
      *     Out-of-band by nature: a hint is *not* a sub-span of the value it
-     *     informs — it lives elsewhere in the source (a table's column header, a
+     *     informs; it lives elsewhere in the source (a table's column header, a
      *     JSON object key, a log field name). So `location` points at where the
      *     hint text actually sits, and `data` is the hint text itself. Carrying
      *     the location (rather than a bare string) lets a confidence boost record
-     *     *which* hint lifted a score and *where* it came from — provenance a
+     *     *which* hint lifted a score and *where* it came from, provenance a
      *     review consumer can resolve back to the document.
      *
      *     Mirrors [`Entity`]'s `location` + `data` shape, so the same
@@ -9990,7 +9986,7 @@ interface components {
     /**
      * @description A human override, outside automatic detection: an entity a reviewer added by
      *     hand, or a detected one they marked to ignore. Its provenance is a person's
-     *     decision, not a recognizer's — so the trail records *why* (an
+     *     decision, not a recognizer's, so the trail records *why* (an
      *     [`Attribution`], when supplied). *Who* made the override is the event's
      *     [`source`], not a payload field.
      *
@@ -10006,7 +10002,7 @@ interface components {
       /**
        * @description Which human decision this records: including a missed entity, or
        *     suppressing a detected one. This is the authority on whether the entity
-       *     is redacted — [`AuditLog::is_suppressed`] reads it, so there is no
+       *     is redacted, [`AuditLog::is_suppressed`] reads it, so there is no
        *     separate flag to keep in sync.
        *
        *     [`AuditLog::is_suppressed`]: crate::entity::audit::AuditLog::is_suppressed
@@ -10172,16 +10168,18 @@ interface components {
        */
       context: components["schemas"]["DocumentContext"];
       /**
-       * @description The detections: elide's own report, body and container
-       *     parts, each entity carrying its provenance chain.
+       * @description The detections: elide's own report, every document and the
+       *     parts nested in one, each entity carrying its provenance
+       *     chain.
        *
-       *     Edit it through [`Report`]'s own API — [`include`],
-       *     [`suppress`], [`entities`] — for the decisions elide models.
+       *     Edit it through [`Report`]'s own API — [`include_part`],
+       *     [`suppress_part`], [`part_entities`] — for the decisions
+       *     elide models.
        *
        *     [`Report`]: elide::Report
-       *     [`include`]: elide::Report::include
-       *     [`suppress`]: elide::Report::suppress
-       *     [`entities`]: elide::Report::entities
+       *     [`include_part`]: elide::Report::include_part
+       *     [`suppress_part`]: elide::Report::suppress_part
+       *     [`part_entities`]: elide::Report::part_entities
        */
       report: components["schemas"]["Report"];
       /**
@@ -10511,7 +10509,7 @@ interface components {
     ConfidenceThreshold: number;
     /**
      * @description A competing detection of a *different* label over the same span was resolved
-     *     against this (winning) entity — the loser is recorded, not dropped.
+     *     against this (winning) entity, the loser is recorded, not dropped.
      */
     Conflict: {
       /** @description The loser's confidence at resolution time. */
@@ -10927,7 +10925,7 @@ interface components {
      * @description The coarseness a [`GeneralizeDate`] reduces a date/timestamp to.
      *
      *     Every rendering is an ISO-8601 form, so the output is locale-independent
-     *     by construction — no localized month names or week markers to configure.
+     *     by construction, no localized month names or week markers to configure.
      */
     DateGranularity: "year" | "year_month" | "hour";
     /**
@@ -11606,31 +11604,42 @@ interface components {
       /** @description What the reviewer says this is. */
       label: components["schemas"]["LabelRef"];
       /**
-       * @description Where it sits, in the coordinates of the group it joins.
+       * @description Where it sits, in the coordinates of the part it joins.
        *
-       *     For text in a container, that is the body's decoded stream —
-       *     a DOCX's `word/document.xml` text *is* the body, not a part.
-       *     A caller who has raw file bytes rather than a decoded offset
-       *     (a reviewer selecting rendered text, say) leaves `range`
-       *     empty and fills [`TextLocation::source`] instead, which the
-       *     engine reverse-resolves.
+       *     Each medium addresses its own way: text a character range
+       *     over the decoded stream, images a bounding box, audio a time
+       *     span, tabular a row and column. A DOCX's
+       *     `word/document.xml` text belongs to the document part
+       *     itself, not to a nested one.
        *
+       *     For text specifically, a caller holding raw file bytes
+       *     rather than a decoded offset — a reviewer selecting rendered
+       *     text, say — leaves [`TextLocation::range`] empty and fills
+       *     [`TextLocation::source`] instead, which the engine
+       *     reverse-resolves. The other three have no such alternative:
+       *     their coordinates are the only way in.
+       *
+       *     [`TextLocation::range`]: elide::modality::text::TextLocation::range
        *     [`TextLocation::source`]: elide::modality::text::TextLocation::source
        */
       location: components["schemas"]["ImageLocation"];
       /**
-       * @description The container part this belongs to, e.g.
-       *     `"word/media/image1.png"`. `None` puts it on the body.
+       * @description The part this belongs to, as a path: `["report.docx"]` for
+       *     the document itself, `["report.docx", "word/media/image1.png"]`
+       *     for media it embeds. `None` means the request's sole
+       *     document, which is the common case and saves a caller
+       *     naming what it already sent.
        *
-       *     For the media a container embeds, which the report holds as
-       *     its own group: an image entity lives under its part, and an
-       *     addition to one has nowhere to go without naming it.
+       *     Nested media needs this: the report holds an embedded image
+       *     as its own part, and an addition to one has nowhere to go
+       *     without naming it. Text usually does not — where a span came
+       *     from is already in `TextLocation::source`, which carries the
+       *     part alongside the raw range.
        *
-       *     Text does not need this. A container's text is its body, and
-       *     where a span came from is already in `TextLocation::source`,
-       *     which carries the part alongside the raw range.
+       *     `None` is an error when the request carried several
+       *     documents, since there is then no sole document to mean.
        */
-      part?: string;
+      part?: string[];
       /** @description The rationale, when one was given. */
       reason?: string;
     };
@@ -11874,7 +11883,7 @@ interface components {
        * @description Tamper-evident audit trail: every contributing detection, the fusion
        *     event if any, and the redaction that hid it, as a hash-linked DAG. It is
        *     also the single source of truth for whether a reviewer
-       *     [suppressed](Self::is_suppressed) the entity — a suppression is a
+       *     [suppressed](Self::is_suppressed) the entity, a suppression is a
        *     [`Manual`] event on this trail, not a separate flag.
        *
        *     [`Manual`]: crate::entity::audit::AuditKind::Manual
@@ -11911,7 +11920,7 @@ interface components {
       location: components["schemas"]["ImageLocation"];
       /**
        * @description Byte range of the match in the *recognized text* it was found in (the
-       *     OCR layout text, the audio transcript, or the text payload itself) —
+       *     OCR layout text, the audio transcript, or the text payload itself),
        *     the stable key back into that enrichment artifact, where the rich
        *     context lives (which OCR block, which speaker) that the geometric
        *     [`location`] cannot hold. `None` for entities not found via text
@@ -11927,11 +11936,11 @@ interface components {
      *     for a nearby value.
      *
      *     Out-of-band by nature: a hint is *not* a sub-span of the value it
-     *     informs — it lives elsewhere in the source (a table's column header, a
+     *     informs; it lives elsewhere in the source (a table's column header, a
      *     JSON object key, a log field name). So `location` points at where the
      *     hint text actually sits, and `data` is the hint text itself. Carrying
      *     the location (rather than a bare string) lets a confidence boost record
-     *     *which* hint lifted a score and *where* it came from — provenance a
+     *     *which* hint lifted a score and *where* it came from, provenance a
      *     review consumer can resolve back to the document.
      *
      *     Mirrors [`Entity`]'s `location` + `data` shape, so the same
@@ -11970,7 +11979,7 @@ interface components {
     /**
      * @description A human override, outside automatic detection: an entity a reviewer added by
      *     hand, or a detected one they marked to ignore. Its provenance is a person's
-     *     decision, not a recognizer's — so the trail records *why* (an
+     *     decision, not a recognizer's, so the trail records *why* (an
      *     [`Attribution`], when supplied). *Who* made the override is the event's
      *     [`source`], not a payload field.
      *
@@ -11986,7 +11995,7 @@ interface components {
       /**
        * @description Which human decision this records: including a missed entity, or
        *     suppressing a detected one. This is the authority on whether the entity
-       *     is redacted — [`AuditLog::is_suppressed`] reads it, so there is no
+       *     is redacted, [`AuditLog::is_suppressed`] reads it, so there is no
        *     separate flag to keep in sync.
        *
        *     [`AuditLog::is_suppressed`]: crate::entity::audit::AuditLog::is_suppressed
@@ -12255,7 +12264,7 @@ interface components {
      *
      *     # Identity
      *
-     *     Labels are identified by [`id`] — a stable lowercase `snake_case`
+     *     Labels are identified by [`id`], a stable lowercase `snake_case`
      *     string (`"phone_number"`), never localized, and the catalog key that a
      *     [`LabelRef`] resolves through. Selectors match by id. Derived equality
      *     is *structural*: two labels with the same id but different
@@ -12266,7 +12275,7 @@ interface components {
      *     The display name and description are localized per [`LanguageTag`].
      *     English (`"en"`) is required at construction and is the fallback when a
      *     requested locale is absent, so [`localization`] always returns some
-     *     text — NER and LLM read the analysis language's name and description to
+     *     text, NER and LLM read the analysis language's name and description to
      *     prompt the model, keyed by the stable id.
      *
      *     # Category and tags
@@ -12276,7 +12285,7 @@ interface components {
      *     labels ship with one; a custom label has none unless set.
      *
      *     [`tags`] is a free-form list of *cross-cutting* markers a policy selector
-     *     matches against — sensitivity flags a label may carry several of (`pii`,
+     *     matches against, sensitivity flags a label may carry several of (`pii`,
      *     `phi`, `pci`, `sad`, `secret`). Distinct from the category: a label has at
      *     most one category but any number of tags. Custom labels can ship with zero
      *     of either.
@@ -12323,7 +12332,7 @@ interface components {
      * @description A label's human-facing text in one language: a display name and an
      *     optional fuller description.
      *
-     *     The `name` is a short, natural-language phrase (`"phone number"`) — the
+     *     The `name` is a short, natural-language phrase (`"phone number"`), the
      *     label a zero-shot NER model like GLiNER matches on, and the primary
      *     text an LLM prompt shows. The `description` is optional extra guidance
      *     for backends that consume it (GLiNER-2.0's bi-encoder, an LLM); leave
@@ -12484,7 +12493,7 @@ interface components {
      * @description An image's recognized text, laid out in space.
      *
      *     An ordered set of [`LayoutBlock`]s (the recognized text regions). The flat
-     *     [`text`] — the blocks joined — is what a recognizer
+     *     [`text`], the blocks joined, is what a recognizer
      *     inspects; [`resolve`] maps a byte range of that text back
      *     to the [`ImageLocation`] it occupies, using the blocks' (and their
      *     words') bounding boxes. Empty when the backend recognized nothing.
@@ -12533,7 +12542,7 @@ interface components {
      *     < Partial < Irrecoverable`. Surfaced through
      *     [`Operator::leak_profile`] for policy authoring and audit reporting.
      *
-     *     [`Operator::leak_profile`]: crate::operator::Operator::leak_profile
+     *     [`Operator::leak_profile`]: crate::redaction::Operator::leak_profile
      */
     LeakProfile: "recoverable" | "partial" | "irrecoverable";
     /** @description Query parameters for listing files. */
@@ -12613,7 +12622,7 @@ interface components {
      *
      *     The reusable mechanism behind any text that varies by language: a
      *     [`Label`]'s display name and description, a redaction operator's bucket
-     *     label, and so on. English (`"en"`) is the conventional anchor —
+     *     label, and so on. English (`"en"`) is the conventional anchor,
      *     constructors seed it, and [`resolve`] falls back to it (then to any
      *     entry) when a requested locale is absent, so a caller that supplied
      *     English always gets *some* value.
@@ -12643,7 +12652,7 @@ interface components {
       rememberMe?: boolean;
     };
     /**
-     * @description Which human decision a [`Manual`] event records — the reviewer actions on a
+     * @description Which human decision a [`Manual`] event records, the reviewer actions on a
      *     finding: [`Flag`](ManualIntent::Flag) a miss, [`Suppress`](ManualIntent::Suppress)
      *     a false positive, or [`Amend`](ManualIntent::Amend) an existing finding.
      */
@@ -12756,9 +12765,9 @@ interface components {
       version?: string;
     };
     /**
-     * @description Model detail for a model-backed recognizer or enricher: which model it
-     *     called and the tokens that cost. Absent from a pure-CPU component (a
-     *     pattern recognizer, a language enricher).
+     * @description The model a model-backed recognizer or enricher called, and its token cost.
+     *
+     *     Absent from a pure-CPU component (a pattern recognizer, a language enricher).
      */
     ModelUsage: {
       /** @description Model name the backend called (e.g. `"gpt-4o"`, `"gliner-multi"`). */
@@ -13832,42 +13841,27 @@ interface components {
       acceptInvite: boolean;
     };
     Report: {
-      body: ({
+      parts: ({
         entities: components["schemas"]["TextEntity"][];
+        id: string[];
         /** @constant */
         modality: "text";
       } | {
         entities: components["schemas"]["ImageEntity"][];
+        id: string[];
         /** @constant */
         modality: "image";
       } | {
         entities: components["schemas"]["AudioEntity"][];
+        id: string[];
         /** @constant */
         modality: "audio";
       } | {
         entities: components["schemas"]["TabularEntity"][];
+        id: string[];
         /** @constant */
         modality: "tabular";
-      }) | null;
-      parts: {
-        [key: string]: {
-          entities: components["schemas"]["TextEntity"][];
-          /** @constant */
-          modality: "text";
-        } | {
-          entities: components["schemas"]["ImageEntity"][];
-          /** @constant */
-          modality: "image";
-        } | {
-          entities: components["schemas"]["AudioEntity"][];
-          /** @constant */
-          modality: "audio";
-        } | {
-          entities: components["schemas"]["TabularEntity"][];
-          /** @constant */
-          modality: "tabular";
-        };
-      };
+      })[];
       usage?: components["schemas"]["UsageReport"];
     };
     /**
@@ -13943,7 +13937,7 @@ interface components {
     };
     /**
      * @description A serializable summary of *which selection rule* bound an operator to an
-     *     entity — the automatic "why" behind a redaction.
+     *     entity, the automatic "why" behind a redaction.
      *
      *     The anonymizer selects an operator by walking an ordered rule list and
      *     taking the first match. That decision is recorded on the [`Redaction`]
@@ -13995,8 +13989,8 @@ interface components {
      *     Built once with the `with_*` chain and passed by reference to the
      *     analyzer, which borrows it into a fresh [`RecognizerContext`] per
      *     payload. It holds only what the *caller* asserts about the analysis as a
-     *     whole — languages, jurisdictions, document labels, the target catalog, a
-     *     correlation id — none of which depends on the medium, so one [`Scope`]
+     *     whole, languages, jurisdictions, document labels, the target catalog, a
+     *     correlation id, none of which depends on the medium, so one [`Scope`]
      *     drives a text, image, or audio analysis alike.
      *
      *     Per-medium regions (caller-supplied inclusions and exclusions, which are
@@ -14010,7 +14004,7 @@ interface components {
      *     the *request* driving it.
      *
      *     Three axes of opaque classification strings elide neither ships nor
-     *     interprets — a downstream policy layer chooses what `"medical"` or
+     *     interprets, a downstream policy layer chooses what `"medical"` or
      *     `"fraud_detection"` or `"auditor"` mean. They are read in two places: a
      *     recognizer may bias its detection on them (the LLM prompt lists them so the
      *     model attends to the right terms), and a scope-aware operator predicate may
@@ -14020,7 +14014,7 @@ interface components {
      *     - [`tags`] classify the *document* (`"medical"`, `"gdpr-request"`).
      *     - [`purpose`] is why the request exists (`"fraud_detection"`).
      *     - [`audience`] is who the redacted output is for (`"support_agent"`,
-     *       `"auditor"`) — the axis PCI-style "same document, two masks" branches on.
+     *       `"auditor"`), the axis PCI-style "same document, two masks" branches on.
      *
      *     [`tags`]: Self::tags
      *     [`purpose`]: Self::purpose
@@ -14058,7 +14052,7 @@ interface components {
       tags?: string[];
     };
     /**
-     * @description An operator was *picked* to hide the entity — the redaction decision,
+     * @description An operator was *picked* to hide the entity, the redaction decision,
      *     recorded before it is applied so it can be reviewed (and the entity edited)
      *     first. The [`Redaction`] event that follows records the operator actually
      *     run.
@@ -14076,7 +14070,7 @@ interface components {
       matched_by: components["schemas"]["RuleMatch"];
       /**
        * @description Identity (name + version) of the operator picked. Its *config* is not
-       *     recorded — it lives in the policy that will run it, so apply re-resolves
+       *     recorded; it lives in the policy that will run it, so apply re-resolves
        *     the configured operator rather than reading it here.
        */
       operator: components["schemas"]["OperatorId"];
@@ -14134,8 +14128,8 @@ interface components {
     /** @description Sort order direction. */
     SortOrder: "asc" | "desc";
     /**
-     * @description A reference back to the original source: a byte range, and — for a container
-     *     whose body spans several files — which part that range indexes.
+     * @description A reference back to the original source: a byte range, and, for a container
+     *     whose body spans several files, which part that range indexes.
      *
      *     [`TextLocation`]'s `range` indexes the *decoded* text stream a codec hands
      *     the pipeline (entities resolved, container parts concatenated). A `SourceRef`
@@ -14340,31 +14334,42 @@ interface components {
       /** @description What the reviewer says this is. */
       label: components["schemas"]["LabelRef"];
       /**
-       * @description Where it sits, in the coordinates of the group it joins.
+       * @description Where it sits, in the coordinates of the part it joins.
        *
-       *     For text in a container, that is the body's decoded stream —
-       *     a DOCX's `word/document.xml` text *is* the body, not a part.
-       *     A caller who has raw file bytes rather than a decoded offset
-       *     (a reviewer selecting rendered text, say) leaves `range`
-       *     empty and fills [`TextLocation::source`] instead, which the
-       *     engine reverse-resolves.
+       *     Each medium addresses its own way: text a character range
+       *     over the decoded stream, images a bounding box, audio a time
+       *     span, tabular a row and column. A DOCX's
+       *     `word/document.xml` text belongs to the document part
+       *     itself, not to a nested one.
        *
+       *     For text specifically, a caller holding raw file bytes
+       *     rather than a decoded offset — a reviewer selecting rendered
+       *     text, say — leaves [`TextLocation::range`] empty and fills
+       *     [`TextLocation::source`] instead, which the engine
+       *     reverse-resolves. The other three have no such alternative:
+       *     their coordinates are the only way in.
+       *
+       *     [`TextLocation::range`]: elide::modality::text::TextLocation::range
        *     [`TextLocation::source`]: elide::modality::text::TextLocation::source
        */
       location: components["schemas"]["TabularLocation"];
       /**
-       * @description The container part this belongs to, e.g.
-       *     `"word/media/image1.png"`. `None` puts it on the body.
+       * @description The part this belongs to, as a path: `["report.docx"]` for
+       *     the document itself, `["report.docx", "word/media/image1.png"]`
+       *     for media it embeds. `None` means the request's sole
+       *     document, which is the common case and saves a caller
+       *     naming what it already sent.
        *
-       *     For the media a container embeds, which the report holds as
-       *     its own group: an image entity lives under its part, and an
-       *     addition to one has nowhere to go without naming it.
+       *     Nested media needs this: the report holds an embedded image
+       *     as its own part, and an addition to one has nowhere to go
+       *     without naming it. Text usually does not — where a span came
+       *     from is already in `TextLocation::source`, which carries the
+       *     part alongside the raw range.
        *
-       *     Text does not need this. A container's text is its body, and
-       *     where a span came from is already in `TextLocation::source`,
-       *     which carries the part alongside the raw range.
+       *     `None` is an error when the request carried several
+       *     documents, since there is then no sole document to mean.
        */
-      part?: string;
+      part?: string[];
       /** @description The rationale, when one was given. */
       reason?: string;
     };
@@ -14592,7 +14597,7 @@ interface components {
        * @description Tamper-evident audit trail: every contributing detection, the fusion
        *     event if any, and the redaction that hid it, as a hash-linked DAG. It is
        *     also the single source of truth for whether a reviewer
-       *     [suppressed](Self::is_suppressed) the entity — a suppression is a
+       *     [suppressed](Self::is_suppressed) the entity, a suppression is a
        *     [`Manual`] event on this trail, not a separate flag.
        *
        *     [`Manual`]: crate::entity::audit::AuditKind::Manual
@@ -14629,7 +14634,7 @@ interface components {
       location: components["schemas"]["TabularLocation"];
       /**
        * @description Byte range of the match in the *recognized text* it was found in (the
-       *     OCR layout text, the audio transcript, or the text payload itself) —
+       *     OCR layout text, the audio transcript, or the text payload itself),
        *     the stable key back into that enrichment artifact, where the rich
        *     context lives (which OCR block, which speaker) that the geometric
        *     [`location`] cannot hold. `None` for entities not found via text
@@ -14645,11 +14650,11 @@ interface components {
      *     for a nearby value.
      *
      *     Out-of-band by nature: a hint is *not* a sub-span of the value it
-     *     informs — it lives elsewhere in the source (a table's column header, a
+     *     informs; it lives elsewhere in the source (a table's column header, a
      *     JSON object key, a log field name). So `location` points at where the
      *     hint text actually sits, and `data` is the hint text itself. Carrying
      *     the location (rather than a bare string) lets a confidence boost record
-     *     *which* hint lifted a score and *where* it came from — provenance a
+     *     *which* hint lifted a score and *where* it came from, provenance a
      *     review consumer can resolve back to the document.
      *
      *     Mirrors [`Entity`]'s `location` + `data` shape, so the same
@@ -14713,7 +14718,7 @@ interface components {
     /**
      * @description A human override, outside automatic detection: an entity a reviewer added by
      *     hand, or a detected one they marked to ignore. Its provenance is a person's
-     *     decision, not a recognizer's — so the trail records *why* (an
+     *     decision, not a recognizer's, so the trail records *why* (an
      *     [`Attribution`], when supplied). *Who* made the override is the event's
      *     [`source`], not a payload field.
      *
@@ -14729,7 +14734,7 @@ interface components {
       /**
        * @description Which human decision this records: including a missed entity, or
        *     suppressing a detected one. This is the authority on whether the entity
-       *     is redacted — [`AuditLog::is_suppressed`] reads it, so there is no
+       *     is redacted, [`AuditLog::is_suppressed`] reads it, so there is no
        *     separate flag to keep in sync.
        *
        *     [`AuditLog::is_suppressed`]: crate::entity::audit::AuditLog::is_suppressed
@@ -14934,31 +14939,42 @@ interface components {
       /** @description What the reviewer says this is. */
       label: components["schemas"]["LabelRef"];
       /**
-       * @description Where it sits, in the coordinates of the group it joins.
+       * @description Where it sits, in the coordinates of the part it joins.
        *
-       *     For text in a container, that is the body's decoded stream —
-       *     a DOCX's `word/document.xml` text *is* the body, not a part.
-       *     A caller who has raw file bytes rather than a decoded offset
-       *     (a reviewer selecting rendered text, say) leaves `range`
-       *     empty and fills [`TextLocation::source`] instead, which the
-       *     engine reverse-resolves.
+       *     Each medium addresses its own way: text a character range
+       *     over the decoded stream, images a bounding box, audio a time
+       *     span, tabular a row and column. A DOCX's
+       *     `word/document.xml` text belongs to the document part
+       *     itself, not to a nested one.
        *
+       *     For text specifically, a caller holding raw file bytes
+       *     rather than a decoded offset — a reviewer selecting rendered
+       *     text, say — leaves [`TextLocation::range`] empty and fills
+       *     [`TextLocation::source`] instead, which the engine
+       *     reverse-resolves. The other three have no such alternative:
+       *     their coordinates are the only way in.
+       *
+       *     [`TextLocation::range`]: elide::modality::text::TextLocation::range
        *     [`TextLocation::source`]: elide::modality::text::TextLocation::source
        */
       location: components["schemas"]["TextLocation"];
       /**
-       * @description The container part this belongs to, e.g.
-       *     `"word/media/image1.png"`. `None` puts it on the body.
+       * @description The part this belongs to, as a path: `["report.docx"]` for
+       *     the document itself, `["report.docx", "word/media/image1.png"]`
+       *     for media it embeds. `None` means the request's sole
+       *     document, which is the common case and saves a caller
+       *     naming what it already sent.
        *
-       *     For the media a container embeds, which the report holds as
-       *     its own group: an image entity lives under its part, and an
-       *     addition to one has nowhere to go without naming it.
+       *     Nested media needs this: the report holds an embedded image
+       *     as its own part, and an addition to one has nowhere to go
+       *     without naming it. Text usually does not — where a span came
+       *     from is already in `TextLocation::source`, which carries the
+       *     part alongside the raw range.
        *
-       *     Text does not need this. A container's text is its body, and
-       *     where a span came from is already in `TextLocation::source`,
-       *     which carries the part alongside the raw range.
+       *     `None` is an error when the request carried several
+       *     documents, since there is then no sole document to mean.
        */
-      part?: string;
+      part?: string[];
       /** @description The rationale, when one was given. */
       reason?: string;
     };
@@ -15197,7 +15213,7 @@ interface components {
        * @description Tamper-evident audit trail: every contributing detection, the fusion
        *     event if any, and the redaction that hid it, as a hash-linked DAG. It is
        *     also the single source of truth for whether a reviewer
-       *     [suppressed](Self::is_suppressed) the entity — a suppression is a
+       *     [suppressed](Self::is_suppressed) the entity, a suppression is a
        *     [`Manual`] event on this trail, not a separate flag.
        *
        *     [`Manual`]: crate::entity::audit::AuditKind::Manual
@@ -15234,7 +15250,7 @@ interface components {
       location: components["schemas"]["TextLocation"];
       /**
        * @description Byte range of the match in the *recognized text* it was found in (the
-       *     OCR layout text, the audio transcript, or the text payload itself) —
+       *     OCR layout text, the audio transcript, or the text payload itself),
        *     the stable key back into that enrichment artifact, where the rich
        *     context lives (which OCR block, which speaker) that the geometric
        *     [`location`] cannot hold. `None` for entities not found via text
@@ -15250,11 +15266,11 @@ interface components {
      *     for a nearby value.
      *
      *     Out-of-band by nature: a hint is *not* a sub-span of the value it
-     *     informs — it lives elsewhere in the source (a table's column header, a
+     *     informs; it lives elsewhere in the source (a table's column header, a
      *     JSON object key, a log field name). So `location` points at where the
      *     hint text actually sits, and `data` is the hint text itself. Carrying
      *     the location (rather than a bare string) lets a confidence boost record
-     *     *which* hint lifted a score and *where* it came from — provenance a
+     *     *which* hint lifted a score and *where* it came from, provenance a
      *     review consumer can resolve back to the document.
      *
      *     Mirrors [`Entity`]'s `location` + `data` shape, so the same
@@ -15298,7 +15314,7 @@ interface components {
     /**
      * @description A human override, outside automatic detection: an entity a reviewer added by
      *     hand, or a detected one they marked to ignore. Its provenance is a person's
-     *     decision, not a recognizer's — so the trail records *why* (an
+     *     decision, not a recognizer's, so the trail records *why* (an
      *     [`Attribution`], when supplied). *Who* made the override is the event's
      *     [`source`], not a payload field.
      *
@@ -15314,7 +15330,7 @@ interface components {
       /**
        * @description Which human decision this records: including a missed entity, or
        *     suppressing a detected one. This is the authority on whether the entity
-       *     is redacted — [`AuditLog::is_suppressed`] reads it, so there is no
+       *     is redacted, [`AuditLog::is_suppressed`] reads it, so there is no
        *     separate flag to keep in sync.
        *
        *     [`AuditLog::is_suppressed`]: crate::entity::audit::AuditLog::is_suppressed
@@ -15596,8 +15612,10 @@ interface components {
       text: string;
     };
     /**
-     * @description Token counts a model reported, each optional because providers differ in
-     *     what they return — some give only a total, some none at all.
+     * @description The token counts a model reported.
+     *
+     *     Each is optional because providers differ in what they return: some give
+     *     only a total, some none at all.
      */
     TokenCounts: {
       /**
@@ -15612,7 +15630,7 @@ interface components {
       output?: number;
       /**
        * Format: uint64
-       * @description Total tokens — may be reported even when the input/output split is not.
+       * @description Total tokens, may be reported even when the input/output split is not.
        */
       total?: number;
     };
@@ -15639,7 +15657,7 @@ interface components {
      *     consumer-side code assumes this). A context enhancer borrows the underlying
      *     slice via [`as_slice`](Tokens::as_slice) and walks it by count when scoring an
      *     entity's neighbourhood. Empty ([`Default`]) until a tokenizing enricher fills
-     *     it — the enhancer then tokenizes on demand instead.
+     *     it, the enhancer then tokenizes on demand instead.
      */
     Tokens: components["schemas"]["Token"][];
     /**
@@ -15684,7 +15702,7 @@ interface components {
      * @description Timestamped transcript of an audio stream.
      *
      *     An ordered set of [`TranscriptSegment`]s. The flat
-     *     [`text`] — the segments joined — is what a recognizer
+     *     [`text`], the segments joined, is what a recognizer
      *     inspects; [`resolve`] maps a byte range of that text back
      *     to the [`TimeSpan`] it occupies, using the segments' (and their words')
      *     timings. Empty when the backend produced nothing (silence, or a no-op
@@ -16664,4 +16682,4 @@ type RetentionSettings = Schemas["RetentionSettings"];
 type RetentionOverride = Schemas["RetentionOverride"];
 //#endregion
 export { PolicyRule as $, Token as $i, SyncStatus as $n, ImageHint as $r, ReplyInvite as $t, Color as A, ActivityPayload as Aa, TabularModel as Ai, RedactionResultPage as An, Audit as Ar, NotificationPage as At, Label as B, WebhookActivityParams as Ba, TextEntity as Bi, ConnectionVerification as Bn, Dimensions as Br, MemberSortField as Bt, Language as C, UsageAnalytics as Ca, TabularAuditKind as Ci, DetectionPage as Cn, AudioHint as Cr, DetectionCompletedParams as Ct, ScopeMetadata as D, ActivityExportOptions as Da, TabularHint as Di, RedactDetection as Dn, AudioPattern as Dr, MemberJoinedParams as Dt, Languages as E, Activity as Ea, TabularEntity as Ei, PipelineDetectionsQuery as En, AudioModel as Er, MemberInvitedParams as Et, GdprArticle9Treatment as F, InviteActivityParams as Fa, TextAuditEvent as Fi, ConnectionConfig as Fn, CitedAttribution as Fr, UnreadStatus as Ft, LanguageTag as G, PasswordChange as Ga, TextPattern as Gi, OpenAiCredentials as Gn, FreeformAttribution as Gr, InviteCode as Gt, LabelLocale as H, Account as Ha, TextLocation as Hi, CreateConnection as Hn, Dpi as Hr, CreateInvite as Ht, GdprSensitiveScope as I, MemberActivityParams as Ia, TextAuditKind as Ii, ConnectionId as In, CodecParams as Ir, UpdateNotificationSettings as It, PciDssPart as J, paths as Ja, TimeSpan as Ji, SyncConnection as Jn, ImageAuditKind as Jr, InvitePreview as Jt, LocalizedText as K, PublicAccount as Ka, TextRefinement as Ki, S3Credentials as Kn, ImageAdd as Kr, InviteExpiration as Kt, HipaaAccountNumbers as L, PipelineActivityParams as La, TextAuditLog as Li, ConnectionPage as Ln, Conflict as Lr, ListMembers as Lt, CreatePolicy as M, ConnectionActivityParams as Ma, TabularRefinement as Mi, AnthropicCredentials as Mn, BoundingBox as Mr, NotificationSettings as Mt, DateGranularity as N, DetectionActivityParams as Na, TabularRetag as Ni, AzureCredentials as Nn, Calibration as Nr, RedactionCreatedParams as Nt, AudioRedaction as O, ActivityFilterQuery as Oa, TabularLocation as Oi, RedactionId as On, AudioRefinement as Or, Notification as Ot, DateStyle as P, FileActivityParams as Pa, TextAdd as Pi, Connection as Pn, Category as Pr, UnreadCountEvent as Pt, PolicyDraft as Q, LayoutWord as Qi, SyncScheduleInput as Qn, ImageEntity as Qr, ListInvites as Qt, HipaaDeidMethod as R, PolicyActivityParams as Ra, TextData as Ri, ConnectionSync as Rn, Contested as Rr, Member as Rt, CountryCode as S, Usage as Sa, TabularAuditEvent as Si, DetectionMetadata as Sn, AudioEntity as Sr, ConnectionSyncFailedParams as St, LanguageSpan as T, WorkspaceAnalytics as Ta, TabularEdit as Ti, DetectionStatusEvent as Tn, AudioManual as Tr, MarkedReadStatus as Tt, LabelRef as U, AccountRef as Ua, TextManual as Ui, GcsCredentials as Un, EditSet as Ur, GenerateInviteCode as Ut, LabelEntry as V, WorkspaceActivityParams as Va, TextHint as Vi, ConnectionsQuery as Vn, DocumentContext as Vr, UpdateMember as Vt, LabelScope as W, Handle as Wa, TextModel as Wi, LlmConfig as Wn, EntityCoRef as Wr, Invite as Wt, Policy as X, Layout as Xi, SyncMode as Xn, ImageData as Xr, InviteSortField as Xt, PciPanRender as Y, ArtifactSet as Yi, SyncDeletionPolicy as Yn, ImageAuditLog as Yr, InviteSent as Yt, PolicyDefinition as Z, LayoutBlock as Zi, SyncSchedule as Zn, ImageEdit as Zr, InviteStatus as Zt, WebhookId as _, ProviderType as _a, RuleMatch as _i, ErrorResponse as _n, AudioAuditEvent as _r, PipelineSummaryPage as _t, RetentionSettings as a, ApiTokenPage as aa, ImageRetag as ai, DeletedFiles as an, ChatSessionPage as ar, TabularRedaction as at, WebhookStatus as b, StorageKindEntry as ba, Suppress as bi, Detection as bn, AudioData as br, CursorPagination as bt, WorkspacePage as c, CreateApiToken as ca, ModelEvent as ci, FileKind as cn, SendChatMessage as cr, TextRedaction as ct, CreateWebhook as d, DetectionAnalytics as da, Point as di, ListFiles as dn, RegisteredRecognizer as dr, CreatePipeline as dt, Tokens as ea, ImageLocation as ei, SortOrder as en, SyncTriggerType as er, PolicySummary as et, TestWebhook as f, DetectionDayEntry as fa, Polygon as fi, ModalityToken as fn, AuthToken as fr, Pipeline as ft, WebhookEvent as g, ModelUsageEntry as ga, Report as gi, ExportQuery as gn, AudioAdd as gr, PipelineSummary as gt, WebhookCreated as h, ModelUsage as ha, Redaction as hi, ExportFormat as hn, Attribution as hr, PipelineStatus as ht, RetentionOverride as i, ApiToken as ia, ImageRefinement as ii, DeleteFiles as in, ChatSession as ir, Sha2Algorithm as it, ConfidenceThreshold as j, ActivityType as ja, TabularPattern as ji, WorkspaceDetectionsQuery as jn, AuditHash as jr, NotificationPayload as jt, ClampBucket as k, ActivityPage as ka, TabularManual as ki, RedactionResult as kn, AudioRetag as kr, NotificationEvent as kt, WorkspaceRole as l, TokenExpiration as la, OperatorId as li, FilePage as ln, LabelCatalog as lr, UpdatePolicy as lt, Webhook as m, DetectionTimeSeries as ma, RasterMode as mi, DateWindow as mn, Signup as mr, PipelineFilter as mt, RasterPolicy as n, TranscriptWord as na, ImageModel as ni, Health as nn, ChatMessage as nr, PolicyTemplate as nt, UpdateWorkspace as o, ApiTokenType as oa, LeakProfile as oi, File as on, ChatToken as or, TemplateOrigin as ot, UpdateWebhook as p, DetectionStatusEntry as pa, RangeOfUint as pi, UpdateFile as pn, Login as pr, PipelineDefinition as pt, ModalityRedactions as q, UpdateAccount as qa, TextRetag as qi, StorageConfig as qn, ImageAuditEvent as qr, InvitePage as qt, Retention as r, Transcription as ra, ImagePattern as ri, HealthStatus as rn, ChatRole as rr, Predicate as rt, Workspace as s, ApiTokenWithJWT as sa, ManualIntent as si, FileHash as sn, CreateChatSession as sr, TerminalFallback as st, CreateWorkspace as t, TranscriptSegment as ta, ImageManual as ti, ComponentHealth as tn, UpdateConnection as tr, PolicySummaryPage as tt, WorkspaceSettings as u, UpdateApiToken as ua, PatternEvent as ui, FormatToken as un, RecognizerCatalog as ur, Waveform as ut, WebhookPage as v, RecognizerId as va, Selection as vi, ValidationErrorDetail as vn, AudioAuditKind as vr, PipelineTriggerType as vt, LanguageProvenance as w, UsageReport as wa, TabularAuditLog as wi, DetectionStatus as wn, AudioLocation as wr, DetectionFailedParams as wt, Confidence as x, TokenCounts as xa, TabularAdd as xi, DetectionId as xn, AudioEdit as xr, ConnectionSyncCompletedParams as xt, WebhookResult as y, StorageAnalytics as ya, SourceRef as yi, CreateDetection as yn, AudioAuditLog as yr, UpdatePipeline as yt, ImageRedaction as z, RedactionActivityParams as za, TextEdit as zi, ConnectionSyncPage as zn, Deduplication as zr, MemberPage as zt };
-//# sourceMappingURL=index-Co9cILnx.d.ts.map
+//# sourceMappingURL=index-B42oglvJ.d.ts.map