@signa-so/sdk 0.8.0 → 0.14.0

package/dist/types.d.ts

@@ -1,207 +1,54 @@
-import type { components } from './generated/api-types.js';
+import type { components, operations } from './generated/api-types.js';
 /** Full trademark with all optional includes (retrieve response). */
 export type Trademark = components['schemas']['TrademarkDetailResponse'];
-/** Compact trademark in list responses. */
+/**
+ * The one trademark row (0.14.0): search hits, `list()` rows, party and
+ * portfolio trademark lists and screening hits all return it. Top-level dates
+ * are the office's values (null when it published none); everything the
+ * rulebook computes is under `derived`. IR family rows (a grouped Madrid
+ * family) also carry `coverage`, `source_records` and `owners_mixed`.
+ */
 export type TrademarkSummary = components['schemas']['TrademarkSummaryV1'];
+/** Which unit a trademark row is: a `mark` (standalone filing or IR family) or one `record` (a leg). */
+export type TrademarkGrain = TrademarkSummary['grain'];
 /** One inline `relationships[]` edge on the trademark detail. */
 export type TrademarkRelationship = components['schemas']['TrademarkRelationship'];
-/** Trademark prosecution event (GET /v1/trademarks/{id}/events). */
-export type Event = components['schemas']['TrademarkEvent'];
-/** Stats object shape returned by ?include=stats on attorney detail. */
-export interface AttorneyStats {
-    trademark_count: number | null;
-    registered_count: number | null;
-    expired_count: number | null;
-    cancelled_count: number | null;
-    pending_count: number | null;
-    abandoned_count: number | null;
-    /** @deprecated Use `grant_rate` — same value. `registration_rate` is a misnomer (share of concluded prosecutions ever granted, not share currently registered). */
-    registration_rate: number | null;
-    /** Share of concluded prosecutions that were ever granted. Same value as the deprecated `registration_rate`. */
-    grant_rate: number | null;
-    abandonment_rate: number | null;
-    avg_prosecution_days: number | null;
-    jurisdiction_count: number | null;
-    earliest_filing: string | null;
-    latest_filing: string | null;
-    computed_at: string | null;
-}
-/** Stats object shape returned by ?include=stats on owner detail. */
-export interface OwnerStats {
-    trademark_count: number | null;
-    registered_count: number | null;
-    expired_count: number | null;
-    cancelled_count: number | null;
-    pending_count: number | null;
-    abandoned_count: number | null;
-    /** @deprecated Use `grant_rate` — same value. `registration_rate` is a misnomer (share of concluded prosecutions ever granted, not share currently registered). */
-    registration_rate: number | null;
-    /** Share of concluded prosecutions that were ever granted. Same value as the deprecated `registration_rate`. */
-    grant_rate: number | null;
-    abandonment_rate: number | null;
-    jurisdiction_count: number | null;
-    earliest_filing: string | null;
-    latest_filing: string | null;
-    computed_at: string | null;
-}
-/** Full owner detail (retrieve response). */
-export type Owner = components['schemas']['OwnerResponse'] & {
-    trademark_count?: number | null;
-    active_count?: number | null;
-    /** @deprecated Use `grant_rate` — same value; `registration_rate` is a misnomer. */
-    registration_rate?: number | null;
-    /** Share of concluded prosecutions that were ever granted. Same value as the deprecated `registration_rate`. */
-    grant_rate?: number | null;
-    latest_filing?: string | null;
-    /** Resolved-entity id this owner belongs to (the derived `ent_<owner-uuid>`
-     *  singleton when unlinked). Always present. */
-    entity_id?: string;
-    entity_id_type?: 'resolved' | 'derived';
-    /** Whether the (possibly entity-inherited) company set includes an active SEC
-     *  company with a ticker. */
-    publicly_traded?: boolean;
-    /** First SEC ticker across the (possibly inherited) company set. */
-    ticker?: string | null;
-    /** First GLEIF LEI across the (possibly inherited) company set. */
-    lei?: string | null;
-    /** Whether any GLEIF LEI is present across the (possibly inherited) set. */
-    has_lei?: boolean;
-    /** `entity` when company facts are inherited across entity members; `direct`
-     *  for an unlinked singleton. */
-    companies_source?: 'entity' | 'direct';
-    /** Public companies — when linked, the union of all members' company links
-     *  (served through the entity). Omitted entirely when empty. */
-    companies?: EntityCompany[];
-    related_entities?: {
-        parent: {
-            id: string;
-            object: 'owner';
-            name: string;
-            canonical_name: string;
-            country_code: string | null;
-            entity_type: string | null;
-        } | null;
-        children: Array<{
-            id: string;
-            object: 'owner';
-            name: string;
-            canonical_name: string;
-            country_code: string | null;
-            entity_type: string | null;
-        }>;
-    };
-    stats?: OwnerStats;
-};
+/**
+ * A prosecution-history row (`GET /v1/trademarks/{id}/events`): object
+ * `trademark_event`, `hst_` id, the office's code and label in `raw`. The same
+ * object is `trademark_event` on an `office_action.issued` v2 payload.
+ */
+export type TrademarkEvent = components['schemas']['TrademarkEvent'];
+/** Alias of {@link TrademarkEvent}. */
+export type Event = TrademarkEvent;
+/** Stats object on attorney detail (`stats`), null until first computed. */
+export type AttorneyStats = NonNullable<components['schemas']['Attorney']['stats']>;
+/** Stats object on owner detail (`stats`), null until first computed. */
+export type OwnerStats = NonNullable<components['schemas']['Owner']['stats']>;
+/**
+ * The one address shape (0.14.0) on owners, attorneys, trademark parties and
+ * assignment parties: `lines` verbatim from the office, components only when
+ * the office supplied them, `formatted` the office's own single-string
+ * rendering (null when it sent components only). Fields holding an address
+ * are `Address | null`.
+ */
+export type Address = NonNullable<components['schemas']['Address']>;
+/**
+ * Full owner detail (retrieve response). `entity_id` is the resolved entity
+ * the owner is linked into, or `null` when it is not linked (0.14.0: no
+ * derived `ent_<owner-uuid>` id and no `entity_id_type`).
+ */
+export type Owner = components['schemas']['OwnerResponse'];
 /** Composed live portfolio analytics report for an owner, attorney, firm, or entity. */
-export interface AnalyticsReport {
-    object: 'analytics_report';
-    subject: {
-        id: string;
-        object: 'owner' | 'attorney' | 'firm' | 'entity';
-        name: string;
-    };
-    portfolio: {
-        mark_count: number;
-        active_count: number;
-        dead_count: number;
-        status_distribution: Record<string, number>;
-        class_distribution: Record<string, number>;
-        jurisdiction_spread: Record<string, number>;
-        filing_trend: Record<string, number>;
-    };
-    litigation: {
-        subject: {
-            owner_id: string | null;
-            entity_id: string | null;
-        };
-        proceedings_total: number;
-        as_challenger: {
-            total: number;
-            by_type: Record<string, number>;
-            outcomes: Record<string, number>;
-            decided: number;
-            win_rate: number | null;
-            avg_duration_days: number | null;
-        };
-        as_defendant: {
-            total: number;
-            by_type: Record<string, number>;
-            outcomes: Record<string, number>;
-            decided: number;
-            win_rate: number | null;
-            avg_duration_days: number | null;
-        };
-    } | null;
-    transactions: {
-        transaction_count: number;
-        by_type: Record<string, number>;
-        unreleased_security_interests: number;
-        marks_with_liens: number;
-        acquired_count: number;
-        divested_count: number;
-        first_transaction_date: string | null;
-        last_transaction_date: string | null;
-    } | null;
-    generated_at: string;
-    /** Per-request id echoed at the top level of the response body (`AnalyticsReportResponse` in the OpenAPI spec). */
-    request_id: string;
-}
-/** Compact owner in list responses. */
-export type OwnerSummary = components['schemas']['OwnerSummary'] & {
-    trademark_count?: number | null;
-    active_count?: number | null;
-    /** @deprecated Use `grant_rate` — same value; `registration_rate` is a misnomer. */
-    registration_rate?: number | null;
-    /** Share of concluded prosecutions that were ever granted. Same value as the deprecated `registration_rate`. */
-    grant_rate?: number | null;
-    latest_filing?: string | null;
-    entity_id?: string;
-    entity_id_type?: 'resolved' | 'derived';
-};
+export type AnalyticsReport = components['schemas']['AnalyticsReportResponse'];
+/** Compact owner in list responses. `entity_id` is the linked entity or `null`. */
+export type OwnerSummary = components['schemas']['OwnerSummary'];
 /** Full attorney detail (retrieve response). */
-export type Attorney = components['schemas']['AttorneyResponse'] & {
-    firm_id?: string | null;
-    email?: string | null;
-    phone?: string | null;
-    address?: unknown | null;
-    trademark_count?: number | null;
-    active_count?: number | null;
-    /** @deprecated Use `grant_rate` — same value; `registration_rate` is a misnomer. */
-    registration_rate?: number | null;
-    /** Share of concluded prosecutions that were ever granted. Same value as the deprecated `registration_rate`. */
-    grant_rate?: number | null;
-    latest_filing?: string | null;
-    recent_trademarks?: Array<Record<string, unknown>>;
-    recent_trademarks_has_more?: boolean;
-    stats?: AttorneyStats;
-};
+export type Attorney = components['schemas']['AttorneyResponse'];
 /** Compact attorney in list responses. */
-export type AttorneySummary = components['schemas']['AttorneySummary'] & {
-    firm_id?: string | null;
-    trademark_count?: number | null;
-    active_count?: number | null;
-    /** @deprecated Use `grant_rate` — same value; `registration_rate` is a misnomer. */
-    registration_rate?: number | null;
-    /** Share of concluded prosecutions that were ever granted. Same value as the deprecated `registration_rate`. */
-    grant_rate?: number | null;
-    latest_filing?: string | null;
-};
-/** Full firm detail (retrieve response). */
-export interface Firm {
-    id: string;
-    object: 'firm';
-    name: string;
-    canonical_name: string;
-    attorney_count: number;
-    trademark_count: number;
-    active_count: number;
-    /** @deprecated Use `grant_rate` — same value; `registration_rate` is a misnomer. */
-    registration_rate: number | null;
-    /** Share of concluded prosecutions that were ever granted. Same value as the deprecated `registration_rate`. */
-    grant_rate: number | null;
-    latest_filing: string | null;
-    created_at: string;
-    updated_at: string;
+export type AttorneySummary = components['schemas']['AttorneySummary'];
+/** Full firm detail (retrieve response); `attorneys` only with `include: ['attorneys']`. */
+export type Firm = components['schemas']['FirmResponse'] & {
     attorneys?: Array<{
         id: string;
         object: 'attorney';
@@ -212,161 +59,60 @@ export interface Firm {
         trademark_count: number | null;
     }>;
     attorneys_has_more?: boolean;
-    request_id: string;
-}
+};
 /** Compact firm in list responses. */
-export interface FirmSummary {
-    id: string;
-    object: 'firm';
-    name: string;
-    canonical_name: string;
-    attorney_count: number;
-    trademark_count: number;
-    active_count: number;
-    /** @deprecated Use `grant_rate` — same value; `registration_rate` is a misnomer. */
-    registration_rate: number | null;
-    /** Share of concluded prosecutions that were ever granted. Same value as the deprecated `registration_rate`. */
-    grant_rate: number | null;
-    latest_filing: string | null;
-    created_at: string;
-}
+export type FirmSummary = components['schemas']['FirmSummary'];
 /** Public-company reference inherited onto an entity member / owner. */
-export interface EntityCompany {
-    source: 'sec' | 'gleif';
-    source_id: string;
-    legal_name?: string;
-    ticker: string | null;
-    exchange: string | null;
-    lei: string | null;
-    entity_status: string;
-    confidence?: number;
-    verified_at?: string | null;
-    verified_by?: string | null;
-}
-/** Public per-member link provenance on an entity-detail member. */
-export interface EntityMemberLink {
-    /** How this member was linked into the entity (stable public vocabulary). */
-    method: 'international_registration' | 'shared_identifier' | 'public_company' | 'portfolio_overlap' | 'manual_review' | 'other';
-    /** Coarse confidence band; null when not scored. */
-    match_strength: 'high' | 'medium' | 'low' | null;
-    /** Whether the link was confirmed by adjudication/manual review. */
-    reviewed: boolean;
-    /** matched canonical IR numbers (international_registration), when present. */
-    matched_irs?: string[];
-    /** matched office-identifier values (shared_identifier), when present. */
-    matched_identifiers?: string[];
-}
+export type EntityCompany = NonNullable<components['schemas']['Owner']['companies']>[number];
+/** Public per-member link provenance on an entity-detail member. Never null. */
+export type EntityMemberLink = components['schemas']['EntityMemberLink'];
 /** A member owner embedded in an entity-detail response. */
-export interface EntityMember {
-    id: string;
-    object: 'owner';
-    name: string;
-    canonical_name: string;
-    country_code: string | null;
-    entity_type: string | null;
-    office_code: string | null;
-    /** null on a derived singleton's self-member (it was never linked). */
-    link: EntityMemberLink | null;
-}
+export type EntityMember = components['schemas']['EntityMember'];
 /** Compact entity in list responses (`GET /v1/entities`). */
-export interface EntitySummary {
-    id: string;
-    object: 'entity';
-    name: string;
-    country_code: string | null;
-    entity_type: string | null;
-    entity_id_type: 'resolved' | 'derived';
-    publicly_traded: boolean;
-    ticker: string | null;
-    lei: string | null;
-    trademark_count: number;
-    active_count: number;
-    member_count: number;
-}
-/** The nearest listed ancestor of a `subsidiary_of_listed` entity, when it
- *  resolves to a live entity in our system. */
-export interface EntityListedAncestor {
-    id: string;
-    object: 'entity';
-    name: string;
-    /** The listed ancestor's own ticker. */
-    ticker: string | null;
-}
-/** Public-listing decoration (ENG-117). Present on {@link EntityDetail} ONLY when
- *  the entity is listed or a subsidiary of a listed company; OMITTED otherwise
- *  (absence ≠ confirmed-private). */
-export interface EntityListing {
-    /** 'listed' = the entity is itself publicly listed; 'subsidiary_of_listed' =
-     *  it inherits a ticker from a listed ancestor. */
-    status: 'listed' | 'subsidiary_of_listed';
-    /** The entity's own ticker (listed) or the inherited ancestor ticker (subsidiary). */
-    ticker: string | null;
-    /** Exchange / market code (display only). */
-    exch_code: string | null;
-    /** LEI of the listed company: the entity's own LEI when listed, else the ancestor's. */
-    lei: string | null;
-    /** Derived from status: 'listed' → 'direct', 'subsidiary_of_listed' → 'inherited'. */
-    source: 'direct' | 'inherited';
-    /** The nearest listed ancestor; null for a directly-listed entity or when unresolvable. */
-    listed_ancestor: EntityListedAncestor | null;
-}
-/** Full entity detail (`GET /v1/entities/{id}`). Resolved entities embed
- *  members[] with link evidence; derived singletons carry a member-of-one. */
-export interface EntityDetail {
-    id: string;
-    object: 'entity';
-    name: string;
-    country_code: string | null;
-    entity_type: string | null;
-    entity_id_type: 'resolved' | 'derived';
-    /** True when a member company is an active SEC ticker OR the entity itself is
-     *  listed / a subsidiary of a listed company (ENG-117 — matches the list filter).
-     *  A derived singleton exposes the owner's own public-company facts (pco-linked),
-     *  else false. */
-    publicly_traded: boolean;
-    /** Survivorship ticker (first of {@link tickers}); null when none. */
-    ticker: string | null;
-    /** Deduped uppercased tickers: member-company SEC tickers UNION the entity's own
-     *  direct/inherited (subsidiary_of_listed) listing_ticker (ENG-117). Includes
-     *  inherited subsidiary tickers; direct-vs-inherited provenance is in {@link listing}. */
-    tickers: string[];
-    lei: string | null;
-    /** Whether any member company carries a GLEIF LEI. */
-    has_lei: boolean;
-    trademark_count: number;
-    active_count: number;
-    member_count: number;
-    /** Resolved entities only — the GLEIF parent entity id, when present. */
-    parent_entity_id?: string | null;
-    /** Public-listing block (ENG-117). Present only when the entity is listed or a
-     *  subsidiary of a listed company; omitted otherwise. */
-    listing?: EntityListing;
-    members: EntityMember[];
-    updated_at: string;
-    request_id: string;
-}
+export type EntitySummary = components['schemas']['EntitySummary'];
+/** The nearest listed ancestor of a `subsidiary_of_listed` entity. */
+export type EntityListedAncestor = components['schemas']['EntityListedAncestor'];
+/**
+ * Public-listing decoration (ENG-117). Present on {@link EntityDetail} ONLY when
+ * the entity is listed or a subsidiary of a listed company; OMITTED otherwise
+ * (absence is not confirmed-private).
+ */
+export type EntityListing = components['schemas']['EntityListing'];
+/** Full entity detail (`GET /v1/entities/{id}`), members[] with link evidence. */
+export type EntityDetail = components['schemas']['EntityResponse'];
 /** A node in an entity's GLEIF family (`GET /v1/entities/{id}/family`). */
-export interface EntityFamilyNode {
-    id: string;
-    object: 'entity';
-    name: string;
-    country_code: string | null;
-    relationship: 'parent' | 'direct_subsidiary';
-    source: 'gleif';
-}
+export type EntityFamilyNode = components['schemas']['EntityFamilyNode'];
 /** GLEIF-curated direct family (parent + direct children, 1 level). */
-export interface EntityFamily {
-    object: 'entity_family';
-    parent: EntityFamilyNode | null;
-    children: EntityFamilyNode[];
-    source: 'gleif';
-    coverage_caveat: string;
-    request_id: string;
-}
+export type EntityFamily = components['schemas']['EntityFamilyResponse'];
 /** Proceeding in list responses. */
 export type Proceeding = components['schemas']['Proceeding'];
 /** Full proceeding detail with embedded trademark (retrieve response). */
 export type ProceedingDetail = components['schemas']['ProceedingResponse'];
+/**
+ * An office-action citation: a prior mark an examiner cited against a pending
+ * application. USPTO §2(d) refusals today — see `capabilities.citations` on
+ * `signa.references.offices()` for per-office coverage.
+ */
+export type Citation = components['schemas']['Citation'];
+/**
+ * Citing/cited mark summary embedded in a citation. Null means there is no
+ * persisted link to a Signa record, NOT that the mark is absent from the
+ * register: resolution runs once, at extraction time, so a mark ingested after
+ * its citations were extracted keeps a null link forever. Read a null
+ * `cited_trademark` as "matched by reference only" and use `cited_ref`.
+ */
+export type CitationTrademarkSummary = components['schemas']['CitationTrademarkSummary'];
+/** How a citation resolved. Null while pending the daily disposition refresh. */
+export type CitationDisposition = NonNullable<Citation['disposition']>;
+/**
+ * Office-action stage the citation REACHED — not provenance about the source
+ * document. A citation first raised in a nonfinal action reads `final` once a
+ * later dated final action maintained the refusal, so `final` does not mean the
+ * row was extracted from a final action.
+ */
+export type CitationActionStage = NonNullable<Citation['action_stage']>;
+/** Office-local refusal ground vocabulary (USPTO `2d` = §2(d) confusion). */
+export type CitationRefusalType = Citation['refusal_type'];
 /** Recorded assignment in list responses. */
 export type Assignment = components['schemas']['Assignment'];
 /** Full assignment detail with parties and affected marks. */
@@ -381,12 +127,64 @@ export type TrademarkBatchResponse = components['schemas']['TrademarkBatchRespon
 export type TrademarkSuggestion = components['schemas']['TrademarkSuggestion'];
 /** Attorney client (owner) entry with shared count. */
 export type AttorneyClient = components['schemas']['AttorneyClient'];
-/** Search result item (V2 with match explanations and faceted aggregations). */
-export type TrademarkSearchResult = components['schemas']['TrademarkSearchResult'];
-/** Cross-entity suggestion item. */
-export type CrossEntitySuggestion = components['schemas']['CrossEntitySuggestion'];
+/**
+ * @deprecated Since 0.14.0 search hits, list rows and portfolio rows are one
+ * type: use {@link TrademarkSummary}. This alias is the same type.
+ */
+export type TrademarkSearchResult = TrademarkSummary;
 /** Goods & services term (Nice classification). */
 export type GoodsServicesTerm = components['schemas']['GoodsServicesTerm'];
+/** Request body for `POST /v1/goods-services/validate`. */
+export type GoodsServicesValidateParams = Omit<components['schemas']['GoodsServicesValidateRequest'], 'language'> & {
+    /** Catalog language. Defaults to `en`; no other language is available in v1. */
+    language?: 'en';
+};
+/** One submitted item in a goods/services catalog validation request. */
+export type GoodsServicesValidateItem = components['schemas']['GoodsServicesValidateItem'];
+/** One per-item result from goods/services catalog validation. */
+export type GoodsServicesValidation = components['schemas']['GoodsServicesValidation'];
+/** Advisory same-class wording or USPTO template candidate. */
+export type GoodsServicesValidationCandidate = components['schemas']['GoodsServicesValidationCandidate'];
+/** Half-open token span into the submitted wording. */
+export type GoodsServicesValidationSpan = components['schemas']['GoodsServicesValidationSpan'];
+/** USPTO drafting template attached to a template candidate. */
+export type GoodsServicesValidationTemplate = components['schemas']['GoodsServicesValidationTemplate'];
+/** One fillable placeholder in a USPTO drafting template. */
+export type GoodsServicesValidationTemplateSlot = components['schemas']['GoodsServicesValidationTemplateSlot'];
+/** Descriptive token coverage for one submitted item. */
+export type GoodsServicesValidationCoverage = components['schemas']['GoodsServicesValidationCoverage'];
+/** Whether same-class candidate search completed reliably. */
+export type CandidateSearch = components['schemas']['CandidateSearch'];
+/** Why same-class candidate search did not complete. */
+export type CandidateSearchReason = components['schemas']['CandidateSearchReason'];
+/** Suggested class provenance when `class_source` is `inferred`. */
+export type GoodsServicesClassInference = NonNullable<GoodsServicesValidation['class_inference']>;
+/** Source of the resolved Nice class, including advisory inference. */
+export type GoodsServicesClassSource = GoodsServicesValidation['class_source'];
+/** Cited, non-predictive guidance about potentially indefinite wording. */
+export type WordingWarning = components['schemas']['WordingWarning'];
+/** Catalog source and its last-known upstream refresh date. */
+export type GoodsServicesValidationCatalogFreshness = components['schemas']['GoodsServicesValidationCatalogFreshness'];
+/** Candidate-search rollup across all submitted items. */
+export type GoodsServicesValidationSummaryCandidateSearch = components['schemas']['GoodsServicesValidationSummaryCandidateSearch'];
+/** Warning totals grouped by severity. */
+export type GoodsServicesValidationSummaryWarningCount = components['schemas']['GoodsServicesValidationSummaryWarningCount'];
+/** Full response from `POST /v1/goods-services/validate`. */
+export type GoodsServicesValidationResponse = components['schemas']['GoodsServicesValidationListResponse'];
+/** Item-level catalog validation status. */
+export type ValidationItemStatus = components['schemas']['ValidationItemStatus'];
+/** Per-office catalog validation status. */
+export type OfficeVerdictStatus = components['schemas']['OfficeVerdictStatus'];
+export type FeeRule = components['schemas']['FeeRule'];
+export type FeeSource = components['schemas']['FeeSource'];
+export type FeeEstimateLine = components['schemas']['FeeEstimateLine'];
+export type FeeEstimateParams = components['schemas']['FeeEstimateRequest'];
+export type FeeEstimate = components['schemas']['FeeEstimateResponse'];
+export type FeeListResponse = components['schemas']['FeeListResponse'];
+export type FeeListParams = {
+    office?: string;
+    action?: FeeEstimateParams['action'];
+};
 /** Single maintenance deadline rule (item in `GET /v1/deadline-rules`). */
 export type DeadlineRule = components['schemas']['DeadlineRule'];
 /** Single computed maintenance deadline. */
@@ -394,11 +192,53 @@ export type ComputedDeadline = components['schemas']['ComputedDeadline'];
 /** Per-item result from `POST /v1/deadlines/compute`. */
 export type DeadlineComputation = components['schemas']['DeadlineComputation'];
 /** Input item for `POST /v1/deadlines/compute`. */
-export type DeadlineComputeItem = components['schemas']['DeadlineComputeItem'];
+export type DeadlineComputeItem = components['schemas']['DeadlineComputeRequest']['items'][number];
+export type DeadlineComputeResult = components['schemas']['DeadlineComputeResponse']['data'][number];
+export type DeadlineListRow = components['schemas']['DeadlineListRow'];
+/**
+ * A maintenance rule that applies to a mark but was declined because the
+ * record lacks the date the statute anchors it on, so no deadline row exists
+ * for it. Carried as `unsupported_rules` on `POST /v1/deadlines/compute`
+ * items and `unsupported_marks[]` entries, and as
+ * `derived.deadlines.unsupported_rules` on a trademark row.
+ */
+export type UnsupportedDeadlineRule = components['schemas']['UnsupportedDeadlineRule'];
+/**
+ * A mark in a deadline list's scope whose schedule was not computed
+ * (`supported: false`, no rows) or computed only in part (`supported: true`
+ * with `unsupported_rules`). Same coverage fields as a compute item.
+ */
+export type DeadlineUnsupportedMark = components['schemas']['DeadlineUnsupportedMark'];
+export type DeadlineListParams = Omit<NonNullable<operations['listDeadlines']['parameters']['query']>, 'portfolio_id' | 'trademark_id'> & ({
+    portfolio_id: string;
+    trademark_id?: never;
+} | {
+    trademark_id: string;
+    portfolio_id?: never;
+});
 /** Request body for `POST /v1/deadlines/compute`. */
 export type DeadlineComputeParams = components['schemas']['DeadlineComputeRequest'];
 /** List response from `POST /v1/deadlines/compute`. */
 export type DeadlineComputeResponse = components['schemas']['DeadlineComputeResponse'];
+/**
+ * Why a deadline was not computed.
+ *
+ * Open enum — widened in the prosecution release from two maintenance values
+ * to the full engine vocabulary. Keep a default branch.
+ */
+export type DeadlineUnsupportedReason = components['schemas']['DeadlineUnsupportedReason'];
+/** Per-deadline-type capability on a `POST /v1/deadlines/compute` result. */
+export type DeadlineSupport = components['schemas']['DeadlineSupport'];
+/** One prosecution fact instance sent on `items[].facts`. */
+export type ProsecutionFact = components['schemas']['ProsecutionFact'];
+/** The maintenance filing under examination, for post-registration refusals. */
+export type ProsecutionMaintenanceFiling = components['schemas']['ProsecutionMaintenanceFiling'];
+/** One computed prosecution deadline, with the rule provenance behind it. */
+export type ProsecutionDeadline = components['schemas']['ProsecutionDeadline'];
+/** The rule identity + sources stamped onto a computed prosecution deadline. */
+export type ProsecutionRuleIdentity = components['schemas']['ProsecutionRuleIdentity'];
+/** A citable source behind a prosecution rule. */
+export type ProsecutionRuleSource = components['schemas']['ProsecutionRuleSource'];
 /** Single opposition window rule (item in `GET /v1/opposition-rules`). */
 export type OppositionRule = components['schemas']['OppositionRule'];
 /** Common extension available for an opposition window, when modeled. */
@@ -425,6 +265,20 @@ export type ReconcileParams = components['schemas']['ReconcileRequest'];
 export type Reconciliation = components['schemas']['Reconciliation'];
 /** List response from `POST /v1/reconcile`. */
 export type ReconcileResponse = components['schemas']['ReconcileResponse'];
+/** Three-source per-field verdict row (`POST /v1/reconcile` with `verdict_detail: true`). */
+export type FieldVerdict = components['schemas']['ReconcileFieldVerdict'];
+/** The 7-value verdict partition on a `FieldVerdict`. */
+export type ReconcileVerdict = FieldVerdict['verdict'];
+/** Which sources produced a value for a `FieldVerdict`. */
+export type VerdictBasis = FieldVerdict['basis'];
+/** One caller-docketed deadline (`your_fields.docketed_deadlines[]`, requires `verdict_detail: true`). */
+export type DocketedDeadline = components['schemas']['DocketedDeadline'];
+/** Identifier-interpretation echo on a verdict_detail result. */
+export type ReconcileLookup = components['schemas']['ReconcileLookup'];
+/** Computed-schedule context on a verdict_detail result. */
+export type ReconcileComputedContext = components['schemas']['ReconcileComputedContext'];
+/** Totals over `field_verdicts[]` — every verdict key explicit. */
+export type ReconcileVerdictCounts = components['schemas']['ReconcileVerdictCounts'];
 /** Statutory citation + URL surfaced on rule items. */
 export type RuleSource = components['schemas']['RuleSource'];
 /** Vienna design code. */
@@ -449,47 +303,138 @@ export type GoodsServicesSuggestResult = components['schemas']['GoodsServicesSug
 export type Office = components['schemas']['Office'];
 /** Trademark office with detail (retrieve response). */
 export type OfficeDetail = components['schemas']['OfficeDetailResponse'];
+/** One office-coverage vote cast by the authenticated organization. */
+export type OfficeVote = components['schemas']['OfficeVoteResource'];
+/** Confirmation returned by `references.retractOfficeVote(...)`. */
+export type OfficeVoteDeleted = components['schemas']['OfficeVoteDeleted'];
+/** Body for `references.castOfficeVotes(...)`. */
+export interface CastOfficeVotesParams {
+    /**
+     * Office codes to vote for (1–50). ST.3 / ISO country codes, any case
+     * (surrounding whitespace is trimmed); legacy internal codes and reserved
+     * aliases like `UK` are canonicalized. Offices Signa already covers are
+     * rejected — vote for what you want added. Codes your organization already
+     * voted for are no-ops, never double counts.
+     */
+    office_codes: string[];
+}
 /** Jurisdiction. */
 export type Jurisdiction = components['schemas']['Jurisdiction'];
 /** Jurisdiction with detail (retrieve response). */
 export type JurisdictionDetail = components['schemas']['JurisdictionDetailResponse'];
-/** Canonical status with office mappings (Phase 2 — manually typed while route is gated). */
-export interface Status {
-    object: 'status_mapping';
-    office_code: string;
-    raw_code: string;
-    status_stage: string;
-    status_reason: string | null;
-    challenge_states: string[];
-    status_source: string;
-    confidence: number;
-    notes: string | null;
-}
 /** Event type code. */
 export type EventType = components['schemas']['EventTypeMapping'];
-/** Portfolio (retrieve response). */
+/**
+ * One office status code (`GET /v1/status-codes`): the office's verbatim
+ * `raw.code` and `raw.label` (null when we hold no verbatim office label for
+ * the code, for example USPTO codes today) and the normalised
+ * `primary`/`stage`/`reason` Signa maps it to. Decode a trademark's
+ * `status.raw.code` with it.
+ */
+export type StatusCode = components['schemas']['StatusCode'];
+/** Query params for `references.eventTypes()`. */
+export interface EventTypeListParams {
+    /** Office code (WIPO ST.3, e.g. `US`, `EM`). Omit for every office. */
+    office_code?: string;
+    /** Page size (1-500, default 100). */
+    limit?: number;
+    cursor?: string;
+}
+/** Query params for `references.statusCodes()`. */
+export interface StatusCodeListParams {
+    /** Office code (WIPO ST.3, e.g. `US`, `EM`). Omit for every office. */
+    office_code?: string;
+    /** Page size (1-500, default 100). */
+    limit?: number;
+    cursor?: string;
+}
+/**
+ * One membership row of a portfolio: the trademark summary the rest of the API
+ * returns ({@link TrademarkSummary}), plus the three fields that describe the
+ * MEMBERSHIP rather than the mark — `added_at`, `added_by` (`key_*`, or `null`
+ * when it predates attribution) and `external_ref` (your own docketing
+ * reference for THIS membership, `null` when none is bound; the same mark in
+ * two portfolios can carry two different references, or none).
+ *
+ * Generated, not hand-written: the API publishes `PortfolioMark` as a
+ * component, so the two shapes cannot drift.
+ */
+export type PortfolioMark = components['schemas']['PortfolioMark'];
+/** The embedded membership page returned by `portfolios.retrieve()`. */
+export type PortfolioMarkList = components['schemas']['PortfolioMarkList'];
+/**
+ * A portfolio as it appears in the rows of `portfolios.list()` — the fields
+ * every representation shares, and nothing else.
+ *
+ * The three single-object responses each carry strictly more, so they have
+ * their own types: `create()` / `update()` return {@link PortfolioResponse}
+ * (adds the top-level `request_id` every single-object response echoes), and
+ * `retrieve()` returns {@link PortfolioDetail} (adds the embedded membership
+ * page on top of that). List ROWS carry neither: `request_id` sits once on the
+ * list envelope, and the embedded page is a detail-only projection.
+ */
 export interface Portfolio {
     id: string;
     object: 'portfolio';
     name: string;
     description: string | null;
-    mark_count: number;
-    metadata: Record<string, string> | null;
+    trademark_count: number;
+    /**
+     * Always an object, never `null` — an unset `metadata` is `{}`. The column is
+     * `NOT NULL DEFAULT '{}'`, every read path coerces, and both write paths type
+     * the field as a record, so no request can store a null here.
+     */
+    metadata: Record<string, string>;
     created_at: string;
     updated_at: string;
 }
-/** Saved search (retrieve response). */
-export interface SavedSearch {
-    id: string;
-    object: 'saved_search';
-    name: string;
-    description: string | null;
-    query: Record<string, unknown>;
-    last_executed_at: string | null;
-    result_count: number | null;
-    metadata: Record<string, string> | null;
-    created_at: string;
-    updated_at: string;
+/**
+ * Portfolio as returned by `portfolios.create()` and `portfolios.update()`:
+ * the shared {@link Portfolio} fields plus the `request_id` of the call that
+ * produced it. No embedded marks — only `retrieve()` projects those.
+ */
+export interface PortfolioResponse extends Portfolio {
+    /** Per-request id echoed at the top level of every single-object response. */
+    request_id: string;
+}
+/**
+ * Portfolio as returned by `portfolios.retrieve()`, with its membership page
+ * embedded.
+ *
+ * `trademarks` is ALWAYS present, including for `limit: 0` (where `data` is
+ * empty and `has_more` reports whether the portfolio holds anything at all)
+ * and for a `?external_ref=` filter that matches nothing — so it is required,
+ * not optional. See {@link PortfolioRetrieveParams}.
+ *
+ * Generated, not hand-written: the retrieve 200 publishes the `PortfolioDetail`
+ * component (`Portfolio` + `trademarks`), so the two shapes cannot drift.
+ */
+export type PortfolioDetail = components['schemas']['PortfolioDetail'];
+/**
+ * Receipt returned by `portfolios.addTrademarks()`. Counts are over the
+ * DISTINCT input marks; on any `409` the whole batch is rolled back and no
+ * receipt is returned at all.
+ */
+export interface PortfolioMarksAddResult {
+    object: 'portfolio_marks_result';
+    /** Memberships created by this call. */
+    added: number;
+    /** Marks that were already members (no-ops), including repeated ids. */
+    already_in_portfolio: number;
+    /** Ids that resolved to no trademark. Lenient: they do not fail the batch. */
+    not_found: number;
+    request_id: string;
+}
+/**
+ * Receipt returned by `portfolios.removeTrademarks()`. Entries that match no
+ * membership are simply skipped, so `removed` can be lower than the number of
+ * entries sent — and `0` is a success, not an error.
+ */
+export interface PortfolioMarksRemoveResult {
+    object: 'portfolio_marks_result';
+    /** Memberships actually deleted by this call. */
+    removed: number;
+    request_id: string;
 }
 /** One of the five watch types (VAL-PRODUCT-001). */
 export type WatchType = 'mark' | 'portfolio' | 'owner' | 'class' | 'similarity';
@@ -595,12 +540,48 @@ export type AlertEventType = 'trademark.created' | 'trademark.updated' | 'tradem
 export type AlertSeverity = 'normal' | 'high' | 'critical';
 /** Opposition-window state for the matched mark, when applicable. */
 export type OppositionWindowStatus = 'open' | 'closing_soon' | 'critical' | 'closed';
+/**
+ * What a holiday calendar did to a served date. `moved` / `unchanged`: a
+ * calendar was consulted. `not_checked`: no pinned closure list verified the
+ * date, so the true date can only be the same or LATER (correct-or-EARLY; do
+ * not diarise as final). `month_end_overflow`: the period's end day does not
+ * exist in the target month and was clamped.
+ */
+export type HolidayAdjustment = 'moved' | 'unchanged' | 'not_checked' | 'month_end_overflow';
 /**
  * One entry in an alert's `event.diff`. Parent-field changes carry real
  * `from`/`to` values; child-entity changes are opaque (`{ path, op:'changed' }`,
  * `from`/`to` absent).
  */
 export interface AlertDiffEntry {
+    /**
+     * PUBLIC trademark field name — the same vocabulary `changed_fields` and
+     * `changes` use on `trademark.status_changed`, and the same names you read
+     * back from `trademarks.retrieve()`: `status`, `mark_text`,
+     * `publication_date`, `ir_number`, or a changed child collection (`owners`,
+     * `attorneys`, `classifications`, `media`, …).
+     *
+     * Status is FLATTENED: the resource nests status under an object, this list
+     * is flat, so `status.primary` is `status` and the rest are `status_<key>`
+     * (`status_stage`, `status_reason`, `status_challenges`,
+     * `status_effective_date`, `status_basis`, `status_raw_code`,
+     * `status_raw_label`).
+     *
+     * 0.14.0: REST alerts and `alert.created` payload v2 follow the new trademark
+     * row: `office_record_id` (was `source_primary_id`), `status_basis` (was
+     * `status_source`), no `*_date_basis` entries, and office-stated values only
+     * for `expiry_date` / `renewal_due_date`. A v1 `alert.created` delivery keeps
+     * the v1 names.
+     *
+     * Fields Signa tracks internally but does not publish never appear — they
+     * are dropped rather than renamed, so every `path` is resolvable against the
+     * trademark resource and a diff can be shorter than the raw change was.
+     *
+     * BETA BREAK: this used to carry internal column tokens
+     * (`status_primary`, `mark_text_primary`, `trademark_owners`, …). Redelivered
+     * and retried deliveries of older alerts are re-emitted with the public
+     * names, so only one vocabulary ever reaches your handler.
+     */
     path: string;
     op: 'set' | 'unset' | 'changed';
     from?: unknown;
@@ -681,7 +662,12 @@ export interface Alert {
     customer_reference: string | null;
     event: {
         type: AlertEventType;
-        /** Short human-readable description, e.g. `"Status primary changed: pending → registered"`. */
+        /**
+         * Short human-readable description, e.g.
+         * `"Status changed: pending → registered"`. Composed from the same PUBLIC
+         * field names as {@link AlertDiffEntry.path}, so the headline and the
+         * structured diff always agree.
+         */
         summary: string;
         diff: AlertDiffEntry[];
         /**
@@ -700,6 +686,13 @@ export interface Alert {
         opposition_window_status: OppositionWindowStatus | null;
         /** Computed customer-action deadline; null if no deadline applies. */
         must_act_by: string | null;
+        /**
+         * Whether a holiday calendar stood behind `must_act_by` when it was frozen
+         * onto this alert. `null` on alerts emitted before this field existed and
+         * on alerts with no opposition window: read it as "no marker was
+         * recorded", never as "verified".
+         */
+        must_act_by_adjustment: HolidayAdjustment | null;
     };
     /**
      * True when this alert was generated well after the underlying change
@@ -732,8 +725,24 @@ export interface Alert {
      */
     provenance: AlertProvenance;
 }
-/** Webhook event types delivered by the dispatcher. */
-export type WebhookEventType = 'alert.created' | 'webhook.test';
+/**
+ * Webhook event types delivered by the dispatcher.
+ *
+ * The first three are the STATIC subscribable set for `enabled_events` — the
+ * API accepts them at all times, independently of our rollout state. Source of
+ * truth: `WEBHOOK_SUBSCRIBABLE_EVENT_TYPES` in `@signa/types`, pinned by
+ * `packages/types/src/api-events.test.ts` (a source-text pin, because the
+ * published SDK must not depend on `@signa/types` at runtime).
+ *
+ * `trademark.status_changed` and `office_action.issued` are accepted for
+ * subscription but are NOT YET EMITTED: they begin delivering when the API
+ * events projector is enabled. Subscribing early is safe and means you receive
+ * them from the first delivery.
+ *
+ * `webhook.test` is the shape delivered by `webhooks.test()` only; it is not a
+ * subscribable type and `enabled_events` rejects it.
+ */
+export type WebhookEventType = 'alert.created' | 'trademark.status_changed' | 'office_action.issued' | 'webhook.test';
 /**
  * What arrives at a customer webhook endpoint, in the body of the POST
  * (Round 4 R4.5 — TSK-111 monitoring v1).
@@ -743,7 +752,7 @@ export type WebhookEventType = 'alert.created' | 'webhook.test';
  * (`standardwebhooks` on npm, `svix-webhooks` for Python, etc.) before
  * trusting `data`.
  *
- * `id` is a prefixed public ID (e.g. `alt_<uuid>` for `alert.created`) — the
+ * `id` is a prefixed event ID (`evt_*`) — the
  * same value as the `webhook-id` header. `timestamp` is an ISO 8601 UTC
  * instant captured at signing. `data` is the event-specific payload
  * (see {@link AlertCreatedPayload}).
@@ -752,17 +761,17 @@ export interface WebhookEvent<T = unknown> {
     type: WebhookEventType;
     /** Prefixed event ID — matches the `webhook-id` header. */
     id: string;
+    /** Version of the public event payload contract carried in `data`. */
+    payload_version?: number;
     /** ISO 8601 UTC timestamp. */
     timestamp: string;
     data: T;
 }
 /**
- * Preserved FLAT fields on an `alert.created` webhook delivery.
+ * Alert fields nested under `data.alert` on an `alert.created` delivery.
  *
- * These are the lean, backward-compatible top-level fields the dispatcher has
- * always emitted. They are kept alongside the rich {@link Alert} object (see
- * {@link AlertCreatedPayload}) so existing consumers that read flat fields
- * never break.
+ * Phase 3 intentionally moved these fields beneath `data.alert`; consumers of
+ * the beta flat envelope must update to the nested shape.
  *
  * IDs are prefixed (Round 4 R4.5) — `alert_id`, `watch_id`, and
  * `trademark_record_id` feed straight into `GET /v1/alerts/{id}` etc.
@@ -771,6 +780,9 @@ export interface WebhookEvent<T = unknown> {
  * Note the absence of `org_id`: the dispatcher omits it because the
  * customer's webhook endpoint already implies the tenant, and
  * cross-referencing internal tenant UUIDs is not part of the public API.
+ *
+ * @deprecated The flat alert fields were removed from the webhook contract.
+ * Use {@link AlertCreatedData.alert}, the rich alert resource.
  */
 export interface AlertCreatedFlatFields {
     /** Prefixed alert ID, e.g. `alt_018f...`. */
@@ -805,31 +817,205 @@ export interface AlertCreatedFlatFields {
     source_data_hash: string | null;
 }
 /**
- * Inner payload of an `alert.created` webhook delivery.
+ * Self-contained alert resource nested at `data.alert`.
  *
  * The dispatcher (`buildSelfContainedAlertData` in
  * `workers/webhook-dispatcher/src/dispatcher.ts`) emits a SELF-CONTAINED body:
  * the full rich {@link Alert} object (`watch`, `event`, `match`, `trademark`,
  * `deadline`, `timestamps`, `schema_version`, `customer_reference`, `links`,
- * `id`, `object`) SPREAD together with the preserved {@link AlertCreatedFlatFields}.
- * Rich-first, flat-last, so the lean flat fields win on any future key overlap.
- *
- * The flat fields ({@link AlertCreatedFlatFields}) are ALWAYS present. The rich
- * half mirrors the REST {@link Alert} resource MINUS `evaluation_epoch`
- * (REST-only — the webhook carries the epoch as a flat field instead, see
- * {@link AlertCreatedFlatFields.evaluation_epoch}), and is OPTIONAL: the rich
- * fields (`event`, `trademark`, `match`, `watch`, `deadline`, `timestamps`,
- * `schema_version`, `links`, `id`, `object`, `customer_reference`) are present
- * on normal deliveries but ABSENT on the rare lean-fallback delivery — when the
- * alert row was hard-deleted between emit and dispatch, hydration returns null
- * and the dispatcher emits ONLY the flat fields.
+ * `id`, `object`).
  *
- * Consumers that read rich fields should feature-detect, e.g.
- * `if (data.event) { … }`, rather than assume they are present.
+ * The rich object mirrors the REST {@link Alert} resource minus
+ * `evaluation_epoch` and `provenance`; the event builder DLQs when it cannot
+ * hydrate that complete resource.
  */
-export type AlertCreatedPayload = AlertCreatedFlatFields & Partial<Omit<Alert, 'evaluation_epoch' | 'provenance'>>;
+export type AlertCreatedPayload = Omit<Alert, 'evaluation_epoch' | 'provenance'>;
 /** Webhook envelope for an `alert.created` delivery. */
-export type AlertCreatedEvent = WebhookEvent<AlertCreatedPayload>;
+export interface AlertCreatedData {
+    /** Stable spine event ID; identical to the envelope id and webhook-id header. */
+    event_id: string;
+    /** Prefixed alert resource ID. */
+    alert_id: string;
+    /** Self-contained alert payload. */
+    alert: AlertCreatedPayload;
+}
+export type AlertCreatedEvent = Omit<WebhookEvent<AlertCreatedData>, 'type' | 'payload_version'> & {
+    type: 'alert.created';
+    payload_version: number;
+};
+/**
+ * A portfolio this mark belonged to when the event was recorded (ENG-344
+ * follow-up A3), with the `external_ref` you set on the membership.
+ *
+ * FROZEN at record time. Editing the membership or its reference afterwards
+ * never rewrites an event you already received, which is what keeps a
+ * redelivery byte-identical to the original. `external_ref` is `null` when the
+ * membership carries none, or when the event predates the snapshot column —
+ * read it as "unknown or unset", never as "cleared".
+ */
+export interface EventPortfolioRef {
+    /** Prefixed portfolio ID (`ptf_*`). */
+    id: string;
+    external_ref: string | null;
+}
+/**
+ * `trademark.status_changed` data. v1 and v2 share every key; they differ in
+ * the change vocabulary of `changed_fields` / `changes` (see
+ * {@link TrademarkStatusChangedData.changed_fields}). Read the envelope's
+ * `payload_version` to tell them apart.
+ */
+export interface TrademarkStatusChangedData {
+    event_id: string;
+    trademark_id: string;
+    office_code: string | null;
+    jurisdiction_code: string;
+    version: number;
+    mark_text: string | null;
+    status: string | null;
+    status_stage: string;
+    status_reason: string | null;
+    owner_name: string | null;
+    /**
+     * PUBLIC field names of the trademark resource that changed — never Signa's
+     * internal column names. `status_primary` reads as `status`,
+     * `mark_text_primary` as `mark_text`, `publication_date_first` as
+     * `publication_date`, `international_registration_number` as `ir_number`,
+     * `challenge_states` as `status_challenges`; a changed child collection reads
+     * as its resource name (`owners`, `classifications`, `media`, ...). Columns
+     * Signa tracks but does not publish are OMITTED rather than renamed, so this
+     * list can be shorter than the number of columns that moved.
+     *
+     * `payload_version` 2 follows the 0.14.0 trademark row: `office_record_id`
+     * (v1 `source_primary_id`) and `status_basis` (v1 `status_source`, values in
+     * the `status.basis` vocabulary: `office`, `event_derived`,
+     * `dispatch_derived`, `computed`); `expiry_date_basis` and
+     * `renewal_due_date_basis` are never listed. In v2 `expiry_date` and
+     * `renewal_due_date` carry office-stated values only (a side Signa computed
+     * is `null`, and a change between two computed values is omitted),
+     * `status_raw_label` follows the verbatim-label rule, `registration_number`
+     * has no `WO` prefix and `office_record_id` is `null` for a Madrid key Signa
+     * composed.
+     */
+    changed_fields: string[];
+    /** Field-level diff keyed by the same public names as `changed_fields`. */
+    changes: Record<string, {
+        before: unknown;
+        after: unknown;
+    }>;
+    /**
+     * When SIGNA produced this event (ISO-8601) — the moment ingestion stored the
+     * change, NOT the moment the office published it. The two differ by the
+     * office publication lag (1 to 14 days), so a docket sorted only on
+     * `occurred_at` is wrong by that lag. Use {@link source_date} for the
+     * office's own date.
+     */
+    occurred_at: string;
+    /**
+     * The office-reported DATA DATE of the change as stored by Signa
+     * (`YYYY-MM-DD`), or `null` when the feed reports none.
+     *
+     * Day precision, and what it means varies by office: USPTO transaction date,
+     * WIPO gazette date, snapshot offices the crawl date. It is NOT a legal
+     * effective date — look in `changes.status_effective_date` for that. Sorting
+     * a docket by `source_date` is meaningful WITHIN ONE OFFICE; across offices
+     * you are comparing different kinds of date.
+     */
+    source_date: string | null;
+    /**
+     * Portfolios this mark was in when the event was recorded. Empty when it was
+     * in none. See {@link EventPortfolioRef}.
+     *
+     * OPTIONAL because deliveries persisted before this release do not carry it:
+     * `/redeliver` and retry attempts 2..7 replay the stored payload verbatim, so
+     * an event first delivered before the field shipped stays without it forever.
+     * Treat `undefined` as "this delivery predates the field", not as "empty".
+     */
+    portfolios?: EventPortfolioRef[];
+}
+export type TrademarkStatusChangedEvent = Omit<WebhookEvent<TrademarkStatusChangedData>, 'type' | 'payload_version'> & {
+    type: 'trademark.status_changed';
+    payload_version: number;
+};
+/**
+ * `office_action.issued` data at `payload_version` 1: the prosecution row's
+ * fields flattened beside the identity fields.
+ */
+export interface OfficeActionIssuedDataV1 {
+    /** Stable event ID; identical to the envelope id and the webhook-id header. */
+    event_id: string;
+    trademark_id: string;
+    office_code: string | null;
+    event_date: string;
+    event_code: string | null;
+    event_label: string | null;
+    scope: string | null;
+    status_after_event: string | null;
+    nice_class_number: number | null;
+    description: string | null;
+    source_identifier: string | null;
+    sequence_no: number | null;
+    jurisdiction_code: string | null;
+    /**
+     * When SIGNA produced this event (ISO-8601) — the moment ingestion stored the
+     * office-action row, not the moment the office issued it. Use
+     * {@link source_date} (or the equal {@link event_date}) for the office's date.
+     */
+    occurred_at: string;
+    /**
+     * The office-reported data date this action is from (`YYYY-MM-DD`) — the same
+     * value as `event_date`, restated under the name every event family shares so
+     * a mixed feed sorts by office date without branching on `type`.
+     */
+    source_date: string | null;
+    /**
+     * Portfolios this mark was in when the event was recorded. Empty when it was
+     * in none. See {@link EventPortfolioRef}.
+     *
+     * OPTIONAL because deliveries persisted before this release do not carry it —
+     * see {@link TrademarkStatusChangedData.portfolios}.
+     */
+    portfolios?: EventPortfolioRef[];
+}
+/**
+ * `office_action.issued` data at `payload_version` 2: the identity fields and
+ * the prosecution row itself as `trademark_event`, the same object
+ * `trademarks.events()` returns (`hst_` id, `raw {code, label}`,
+ * `nice_class`, `sequence_number`).
+ */
+export interface OfficeActionIssuedDataV2 {
+    /** Stable event ID; identical to the envelope id and the webhook-id header. */
+    event_id: string;
+    trademark_id: string;
+    office_code: string | null;
+    /** Designation jurisdiction (two letters); null for mark-level actions. */
+    jurisdiction_code: string | null;
+    /** When SIGNA produced this event (ISO-8601), never the office's date. */
+    occurred_at: string;
+    /** The office's date for the action (`YYYY-MM-DD`), equal to `trademark_event.event_date`. */
+    source_date: string | null;
+    trademark_event: TrademarkEvent;
+    /** Portfolios this mark was in when the event was recorded. See {@link EventPortfolioRef}. */
+    portfolios: EventPortfolioRef[];
+}
+/** `office_action.issued` data, either version. Narrow on the envelope's `payload_version`. */
+export type OfficeActionIssuedData = OfficeActionIssuedDataV1 | OfficeActionIssuedDataV2;
+/**
+ * An `office_action.issued` delivery. Every event keeps the version it was
+ * stored with: automatic retries, `/redeliver` and `GET /v1/events/{id}` of a
+ * v1 event stay v1, so handle both.
+ *
+ * ```typescript
+ * if (event.payload_version === 2) handleRow(event.data.trademark_event);
+ * else handleLegacy(event.data.event_code, event.data.sequence_no);
+ * ```
+ */
+export type OfficeActionIssuedEvent = (Omit<WebhookEvent<OfficeActionIssuedDataV1>, 'type' | 'payload_version'> & {
+    type: 'office_action.issued';
+    payload_version: 1;
+}) | (Omit<WebhookEvent<OfficeActionIssuedDataV2>, 'type' | 'payload_version'> & {
+    type: 'office_action.issued';
+    payload_version: 2;
+});
 /** Webhook endpoint status. */
 export type WebhookStatus = 'active' | 'disabled';
 /**
@@ -854,6 +1040,13 @@ export interface Webhook {
     url: string;
     description: string | null;
     enabled_events: WebhookEventType[] | string[];
+    /**
+     * Optional portfolio scope (`ptf_*`). Applies to EVERY event type,
+     * `alert.created` included: the endpoint receives an event only when its mark
+     * was a member of this portfolio at the time the event was recorded. Null =
+     * no scope; the endpoint receives everything it is subscribed to.
+     */
+    portfolio_id: string | null;
     status: WebhookStatus;
     secret_version: number;
     consecutive_failures: number;
@@ -915,13 +1108,23 @@ export interface WatchPreviewResponse {
     estimated_match_count: number;
     trial_window_days: number;
     /**
-     * Present ONLY when `estimated_match_count` is an upper-bound estimate
-     * rather than an exact count. One value, three triggers: the candidacy
-     * scan overflowed the server-side cap, search was temporarily
-     * unreachable, or the server-side time budget expired after candidates
-     * were found (partial result). Absent = exact count.
+     * Present ONLY when `estimated_match_count` is not an exact count.
+     * `query_upper_bound`: the time budget ran out after the search but before
+     * the change check; the count is the marks that matched `q` in the window,
+     * so it can only be too high. `lower_bound`: the search timed out or lost a
+     * shard, more than 10,000 marks matched `q` in the window, or the change
+     * check timed out; the count is the verified matches (0 if none), so it can
+     * only be too low. `candidacy_upper_bound`: a watch without a text query
+     * could not be fully evaluated; the count is the changed marks in the
+     * window. Absent = exact count.
      */
-    estimate_basis?: 'candidacy_upper_bound';
+    estimate_basis?: 'candidacy_upper_bound' | 'query_upper_bound' | 'lower_bound';
+    /**
+     * True when the preview did not finish: the time budget ran out, the search
+     * timed out or lost a shard, or the results page could not be loaded (then
+     * `results` is empty and `has_more` false, but the count stands).
+     */
+    partial?: boolean;
     /**
      * A page of the actual matching trademarks in the canonical summary shape
      * (identical to `GET /v1/trademarks` results). Returned BY DEFAULT; omitted
@@ -1005,8 +1208,31 @@ export interface WatchDiagnostics {
     alert_id: string | null;
     opposition: {
         must_act_by: string | null;
+        /**
+         * Stable opaque slug of the opposition rule cited for this mark (e.g.
+         * `us_opposition`), and the join key to `GET /v1/opposition-rules`.
+         * Opaque — do not parse it. Effectively always present when the
+         * `opposition` block is present: an unmodeled office yields a null block
+         * rather than a block with a null `rule_id`. It is still emitted when the
+         * window could not be computed (`rule_source`/`rule_version` null), so a
+         * degraded block stays joinable; that degraded path, with an empty rule
+         * lookup, is the only way this is null.
+         */
+        rule_id: string | null;
         rule_source: string | null;
         rule_version: string | null;
+        /**
+         * The window close recomputed at request time. May legitimately differ
+         * from the frozen `must_act_by` (a later closure notice, a rule
+         * correction, wider calendar coverage).
+         */
+        recomputed_close: string | null;
+        /**
+         * Describes the SERVED date (`must_act_by`): the alert's frozen marker
+         * when it carries one, otherwise `not_checked` when the two dates
+         * disagree, otherwise the recomputed marker.
+         */
+        close_adjustment: HolidayAdjustment | null;
         window_status: WatchDiagnosticsWindowStatus | null;
     } | null;
     data_window: {
@@ -1030,12 +1256,32 @@ export interface WatchAttestationGap {
     through: string;
     /**
      * `office_lagging` = coverage was stale beyond the office SLO for this
-     * interval. `evaluation_failed` is reserved (not emitted in v1: gaps cover
-     * coverage-staleness only).
+     * interval. `evaluation_missing` = no evaluation ran for the interval at all
+     * although one should have (pause, credit lock, lease starvation, or no
+     * evaluation evidence for longer than the continuity backstop).
+     * `budget_declined` (ENG-286) = a specific office sync run was NOT evaluated
+     * because it exceeded the evaluator's per-run change budget; later coverage
+     * does not close it, only an audited re-drive or a recorded suppression does.
+     * A budget-declined run is reported under `budget_declined` only, never also
+     * as `evaluation_missing`. `evaluation_failed` is reserved (not emitted).
+     */
+    reason: 'office_lagging' | 'evaluation_missing' | 'evaluation_failed' | 'budget_declined';
+    /**
+     * True once coverage caught back up within the period (`office_lagging`),
+     * evaluation demonstrably resumed at the end of the interval
+     * (`evaluation_missing`), or an operator closed the declined run within the
+     * period (`budget_declined`). A resolution AFTER the period is deliberately
+     * invisible, so a closed period's artifact never mutates.
      */
-    reason: 'office_lagging' | 'evaluation_failed';
-    /** True once coverage caught back up within the period. */
     resolved: boolean;
+    /** Present only on `budget_declined` gaps: the run that was not evaluated. */
+    sync_run_id?: string;
+    /**
+     * Present only on a RESOLVED `budget_declined` gap. `redriven` = the run was
+     * re-evaluated (the changes were eventually assessed); `suppressed` = an
+     * operator recorded that it never will be. Not the same claim.
+     */
+    resolution?: 'redriven' | 'suppressed';
 }
 /**
  * Per-office attestation entry. `status: 'unsupported'` (an in-scope office
@@ -1061,6 +1307,12 @@ export interface WatchAttestationOffice {
     coverage_through?: string | null;
     coverage_basis?: 'source_dates' | 'date_range' | 'run_completed' | null;
     gaps?: WatchAttestationGap[];
+    /**
+     * Every supported office (`no_evaluations` and `evaluated` alike): evaluation
+     * resumed AFTER the period. A generation-time fact, excluded from
+     * `content_hash` — the period's own gaps stay permanently unresolved.
+     */
+    evaluation_resumed_after_period?: boolean;
 }
 /**
  * The filable monthly proof-of-monitoring artifact. Deterministic for a closed
@@ -1103,6 +1355,14 @@ export interface WatchAttestation {
     totals: {
         evaluations: number;
         alerts_emitted: number;
+        /**
+         * ENG-286 — office sync runs in the period that were DECLINED without
+         * evaluation (per-run change budget). Each is disclosed as a
+         * `budget_declined` gap on its office.
+         */
+        declined_runs: number;
+        /** Subset of `declined_runs` still outstanding at the end of the period. */
+        declined_runs_unresolved: number;
     };
     reconciliation: 'consistent' | 'mismatch';
     statement: string;
@@ -1140,20 +1400,83 @@ export interface OrgEvent {
     id: string;
     object: 'event';
     type: string;
-    trademark_id: string;
-    office_code: string;
+    trademark_id: string | null;
+    office_code: string | null;
+    /**
+     * When SIGNA produced this event (ISO-8601). Its meaning is per family:
+     * ingestion time for `trademark.*` and `office_action.*`, alert-creation time
+     * for `alert.created`. It is never the office's own date — the detail bodies
+     * carry that as `source_date`.
+     */
+    occurred_at: string;
+    recorded_at: string;
     created_at: string;
 }
-/** Org-level event detail (with field-level before/after diffs). */
-export interface OrgEventDetail extends OrgEvent {
+/** Trademark-family event detail (with field-level before/after diffs). */
+export interface TrademarkOrgEventDetail extends OrgEvent {
+    type: `trademark.${string}`;
+    payload_version: number;
+    trademark_id: string;
     version: number;
+    mark_text: string | null;
+    status: string | null;
+    status_stage: string;
+    status_reason: string | null;
+    owner_name: string | null;
+    jurisdiction_code: string;
+    /**
+     * PUBLIC trademark-resource field names that changed — same vocabulary as
+     * the `trademark.status_changed` webhook body (see
+     * {@link TrademarkStatusChangedData.changed_fields}). Fields Signa tracks but
+     * does not publish are omitted rather than renamed.
+     */
     changed_fields: string[];
+    /** Field-level diff keyed by the same public names as `changed_fields`. */
     changes: Record<string, {
         before: unknown;
         after: unknown;
     }>;
+    /** Office-reported data date, day precision. See {@link TrademarkStatusChangedData.source_date}. */
+    source_date?: string | null;
+    /** Frozen membership snapshot. See {@link EventPortfolioRef}. */
+    portfolios?: EventPortfolioRef[];
+    request_id: string;
+}
+/** Alert-family event detail. Family-specific trademark fields are absent. */
+export interface AlertCreatedOrgEventDetail {
+    id: string;
+    object: 'event';
+    type: 'alert.created';
+    payload_version: number;
+    alert_id: string;
+    alert: Record<string, unknown>;
+    office_code: null;
+    occurred_at: string;
+    recorded_at: string;
+    created_at: string;
     request_id: string;
 }
+/**
+ * Office-action event detail returned by the org event feed, in the version the
+ * event was stored with: v1 flat fields, or v2 `trademark_event`.
+ */
+export type OfficeActionIssuedOrgEventDetail = OrgEvent & {
+    type: 'office_action.issued';
+    trademark_id: string;
+    jurisdiction_code: string | null;
+    /** Office-reported data date. See {@link OfficeActionIssuedDataV1.source_date}. */
+    source_date?: string | null;
+    /** Frozen membership snapshot. See {@link EventPortfolioRef}. */
+    portfolios?: EventPortfolioRef[];
+    request_id: string;
+} & (({
+    payload_version: 1;
+} & Omit<OfficeActionIssuedDataV1, 'event_id' | 'trademark_id' | 'office_code' | 'jurisdiction_code' | 'occurred_at' | 'source_date' | 'portfolios'>) | {
+    payload_version: 2;
+    trademark_event: TrademarkEvent;
+});
+/** Org-level event detail, discriminated by event family. */
+export type OrgEventDetail = TrademarkOrgEventDetail | OfficeActionIssuedOrgEventDetail | AlertCreatedOrgEventDetail;
 /** Identity (GET /v1/organization/me). */
 export type Identity = components['schemas']['Identity'];
 /** Usage (GET /v1/organization/usage). */
@@ -1178,6 +1501,18 @@ export type UsageSummaryResponse = components['schemas']['UsageSummaryResponse']
 export type UsageSummaryItem = components['schemas']['UsageSummaryItem'];
 /** Billing period context on a usage summary response. */
 export type UsageBillingPeriod = components['schemas']['BillingPeriodContext'];
+/** Usage estimate response (GET /v1/organization/usage/estimate). */
+export type UsageEstimate = components['schemas']['UsageEstimate'];
+/** Per-action row of `UsageEstimate.by_action`. */
+export type UsageEstimateAction = components['schemas']['UsageEstimateAction'];
+/** Route the credit schedule does not recognize (`UsageEstimate.unmapped`). */
+export type UsageEstimateUnmapped = components['schemas']['UsageEstimateUnmapped'];
+/** Plan the estimated traffic lands on (`UsageEstimate.plan_for`). */
+export type UsageEstimatePlan = components['schemas']['UsageEstimatePlan'];
+/** Beta thank-you discount on that plan (`UsageEstimate.offer`). */
+export type UsageEstimateOffer = components['schemas']['UsageEstimateOffer'];
+/** Extra credits the landing plan needs: one whole-dollar purchase at the plan rate (`UsageEstimate.packs_needed`). */
+export type UsageEstimatePacks = components['schemas']['UsageEstimatePacks'];
 /** Pooled credit balance response (GET /v1/organization/credits). */
 export type CreditBalance = components['schemas']['CreditBalanceResponse'];
 /** Remaining-credit breakdown by grant type on a credit balance response. */
@@ -1211,27 +1546,6 @@ export interface TrademarkDocument {
 }
 /** Owner related entity (GLEIF corporate hierarchy). */
 export type OwnerRelated = components['schemas']['OwnerRelated'];
-/**
- * A `search_meta.warnings[]` element (mirror of the API spec). Two families
- * share this shape:
- *   • strategy-skip warnings — a REQUESTED strategy produced zero clauses for
- *     the query shape (e.g. `strategies=[phonetic]` on a query too short or
- *     high-collision); carries `strategy`.
- *   • filter-coverage warnings — an applied filter (e.g. `opposition_status`,
- *     `seniority_claims`) has partial index coverage; carries `severity`,
- *     `affected_filter`, `affected_offices`, `behavior`.
- */
-export interface SearchWarning {
-    code: string;
-    message: string;
-    strategy?: string;
-    severity?: 'info' | 'warning';
-    affected_filter?: string;
-    /** WIPO ST.3 office codes (e.g. 'US', 'EM', 'WO') affected by the caveat. */
-    affected_offices?: string[];
-    behavior?: string;
-}
-/** Search metadata (V2 — timing, totals, strategy info). */
 /**
  * ENG-106 — how the query text is matched against the mark text.
  * `similar` (default) runs the ranked strategies ladder (relevance scoring).
@@ -1241,41 +1555,26 @@ export interface SearchWarning {
  * additionally needs a folded query of at least 3 characters.
  */
 export type MatchMode = 'similar' | 'exact' | 'starts_with' | 'ends_with' | 'contains';
-export interface SearchMeta {
-    search_id: string;
-    query: string | null;
-    /** Public strategies used for the served set. Empty `[]` for deterministic match modes. */
-    strategies_used: string[];
-    /**
-     * ENG-106 — the match mode actually applied. Echoed for ALL modes (including
-     * `'similar'`).
-     */
-    match: MatchMode;
-    international_registrations: 'grouped' | 'expanded';
-    fallback_reason?: string;
-    /**
-     * The `jurisdictions` matching mode actually applied: `'protection'` (default,
-     * regional-membership expansion) or `'direct'` (literal territory legs).
-     * Echoed on every response, including when no `jurisdictions` filter is present.
-     */
-    territory_match: TerritoryMatchMode;
-    /**
-     * Search warnings. Two families share this array: per-strategy skip warnings
-     * (a REQUESTED strategy produced zero clauses for the query shape) and
-     * filter-coverage warnings (an applied filter has partial index coverage).
-     * Omitted when there is nothing to warn about.
-     */
-    warnings?: SearchWarning[];
-    /**
-     * NOTE: the total matching-result count is NOT on `search_meta`. It surfaces
-     * as `pagination.total_count` (+ `pagination.total_count_approximate`) when
-     * the caller sets `options.include_total = true` — see
-     * `SignaList.total_count`. The former `search_meta.total_results` /
-     * `total_count_exact` / `total_count_approximate` fields were removed in the
-     * ENG-14 beta break.
-     */
-    execution_time_ms: number;
-}
+/**
+ * Search metadata on trademark search and list responses.
+ *
+ * 0.14.0: `fallback_reason` is gone; every caveat is a coded entry in
+ * `warnings[]` (e.g. `expanded_fallback` with `affected_filters`, or
+ * `partial_results`). `index_generation` names the index that served the page;
+ * cursors are bound to it, so a cursor from before an index rebuild returns
+ * `400 cursor_invalid` and pagination restarts.
+ *
+ * The total matching-result count is NOT here: it is `pagination.total_count`
+ * (`SignaList.total_count`) when the request sets `include_total`.
+ */
+export type SearchMeta = NonNullable<components['schemas']['SearchResponseV2']['search_meta']>;
+/**
+ * A `search_meta.warnings[]` element: a stable `code` plus a human `message`,
+ * and the code's own detail fields (`strategy`, `affected_filter(s)`,
+ * `affected_offices`, `dropped_strategies`, ...). Keep a default branch: new
+ * codes can appear.
+ */
+export type SearchWarning = NonNullable<SearchMeta['warnings']>[number];
 /** API error body (RFC 9457-inspired). */
 export interface APIErrorBody {
     type: string;
@@ -1293,6 +1592,89 @@ export interface APIErrorBody {
     retryable?: boolean;
     /** Server-suggested seconds to wait before retrying (body-level mirror of the Retry-After header). */
     retry_after?: number;
+    /**
+     * Human-readable remediation for this error — safe to surface to an end
+     * user or an agent as the next step.
+     *
+     * OPTIONAL because the API does not emit it on every response: the server
+     * backfills it from a per-slug map and otherwise sends nothing, so a 4xx
+     * slug outside that map arrives WITHOUT a suggestion (5xx faults always
+     * carry one — they fall back to the feedback-channel hint). Non-JSON
+     * envelopes synthesized by the SDK for WAF/ALB responses never carry one
+     * either. Always narrow before displaying.
+     */
+    suggestion?: string;
+}
+/**
+ * `409 external_ref_conflict` (ENG-342) — a portfolio membership's
+ * `external_ref` cannot be bound as requested. Distinct from the generic
+ * `conflict` slug because it is the ONE conflict a docketing integration can
+ * resolve itself. Two causes, one slug:
+ *
+ * - the membership already carries a DIFFERENT non-null reference (references
+ *   are immutable once set — remove the mark and add it again to rebind), or
+ * - the reference is already bound to a different mark in that portfolio.
+ *
+ * `detail` names the conflicting reference and may name the conflicting
+ * `tm_*` id. The whole batch is rolled back. Narrow with
+ * {@link isExternalRefConflict}.
+ */
+export interface ExternalRefConflictErrorBody extends APIErrorBody {
+    type: 'external_ref_conflict';
+    /**
+     * Always present on this slug. The remedy differs per cause, so the text
+     * names both and defers the specifics to `detail` (which says which one
+     * fired and quotes the conflicting reference):
+     *
+     * > External references are unique within a portfolio and immutable once
+     * > set. Choose a different `external_ref`, or remove the trademark from the
+     * > portfolio and add it again to rebind.
+     */
+    suggestion?: string;
+}
+/**
+ * Which per-plan resource cap a `resource_quota_exceeded` refers to.
+ *
+ * `managed_marks` (ENG-342) is NOT a row count: it is the number of DISTINCT
+ * trademarks across ALL of the organization's portfolios, so a mark filed in
+ * three portfolios costs one. The others count rows.
+ */
+export type QuotaScope = 'managed_marks' | 'portfolios' | 'watches';
+/**
+ * `409 resource_quota_exceeded` — the organization is at a per-plan RESOURCE
+ * cap. Distinct from the `429 quota_exceeded` request counter: retrying does
+ * not help, so `retryable` is `false`.
+ *
+ * Narrow with {@link isResourceQuotaExceeded}; the extras below are what a
+ * client needs to decide how much of the batch to retry with, without parsing
+ * `detail` prose.
+ */
+export interface ResourceQuotaExceededErrorBody extends APIErrorBody {
+    type: 'resource_quota_exceeded';
+    quota_scope: QuotaScope;
+    /** The plan's cap for this scope. */
+    quota_limit: number;
+    /** How much of the cap is already consumed. */
+    quota_used?: number;
+    /**
+     * How much this request would have ADDED. For `managed_marks` that is the
+     * number of distinct candidate marks not already managed anywhere in the
+     * organization — so re-adding marks you already manage costs nothing and
+     * succeeds even at the cap.
+     */
+    quota_attempted?: number;
+    /**
+     * Always present on this slug, and scope-specific. `managed_marks`
+     * overrides the generic copy (which would read "Delete an existing
+     * managed_mark") with the actual remedy:
+     *
+     * > Remove marks from portfolios or upgrade your plan.
+     *
+     * Other scopes fall back to the generic
+     * "Delete an existing resource or upgrade your plan. See
+     * https://docs.signa.so/api-reference/plans."
+     */
+    suggestion?: string;
 }
 export type TrademarkSearchInclude = 'full_goods_services';
 export type TrademarkDetailInclude = 'office_extensions';
@@ -1330,7 +1712,16 @@ export interface TrademarkRetrieveParams {
  * `GET /v1/trademarks?aggregations=` and `POST /v1/trademarks` `options.aggregations`.
  * Mirrors the server-side `AggregationEnum` and the generated OpenAPI enum.
  */
-export type TrademarkAggregationName = 'status_stage' | 'office_code' | 'jurisdiction_code' | 'nice_classes' | 'filing_year' | 'mark_feature_type' | 'mark_legal_category' | 'filing_route' | 'right_kind' | 'scope_kind' | 'firm_id' | 'attorney_id' | 'owner_country' | 'owner_id' | 'entity_id';
+export type TrademarkAggregationName = 'status_stage' | 'office_code' | 'jurisdiction_code' | 'nice_classes' | 'filing_year' | 'mark_feature_type' | 'mark_legal_category' | 'filing_route' | 'right_kind' | 'scope_kind' | 'firm_id' | 'attorney_id' | 'owner_country' | 'owner_id' | 'entity_id'
+/** `{ value }`: distinct owner records (per office) in the result set. */
+ | 'owner_count'
+/**
+ * `{ value }`: distinct parties across offices (resolved entities; an owner
+ * not resolved yet counts once per office record). Use for crowding.
+ */
+ | 'entity_count';
+/** How aggregation counts relate to filters (`aggregation_mode`). */
+export type TrademarkAggregationMode = 'filtered' | 'exclude_own_filter';
 export interface TrademarkListParams {
     /**
      * Coarse status bucket. Accepts a single value or an array to match any of
@@ -1364,10 +1755,17 @@ export interface TrademarkListParams {
     vienna_codes?: string | string[];
     us_design_codes?: string | string[];
     filing_basis?: string | string[];
-    us_register_type?: 'principal' | 'supplemental';
+    /**
+     * The office register (`register.type`), case-insensitive: `principal` or
+     * `supplemental` (US), the CIPO register category (CA), ... Replaces
+     * `us_register_type` (0.14.0).
+     */
+    register_type?: string;
     opposition_status?: OppositionStatus;
-    opposition_closes_before?: string;
-    opposition_closes_after?: string;
+    /** Opposition window closes on or after this date (YYYY-MM-DD). Replaces `opposition_closes_after`. */
+    opposition_closes_gte?: string;
+    /** Opposition window closes on or before this date (YYYY-MM-DD). Replaces `opposition_closes_before`. */
+    opposition_closes_lte?: string;
     seniority_claims?: SeniorityClaims;
     filing_date_gte?: string;
     filing_date_gt?: string;
@@ -1413,6 +1811,15 @@ export interface TrademarkListParams {
     updated_at_gt?: string;
     updated_at_lte?: string;
     updated_at_lt?: string;
+    /**
+     * When the mark family last changed. Grouped view only (a record-grain
+     * request is a 400); pairs with `sort: 'family_updated_at'` for incremental
+     * sync, which pages past 10,000 results on filter-only requests.
+     */
+    family_updated_at_gte?: string;
+    family_updated_at_gt?: string;
+    family_updated_at_lte?: string;
+    family_updated_at_lt?: string;
     owner_id?: string;
     owner_name?: string;
     owner_publicly_traded?: boolean;
@@ -1421,9 +1828,9 @@ export interface TrademarkListParams {
     owner_lei?: string;
     /**
      * PLN-118 — resolved-entity filter (`ent_*`). The GLOBAL-portfolio feature:
-     * returns marks across ALL member owners of the entity (every office). Accepts
-     * a derived `ent_<owner-uuid>` (a singleton) too. Over the member cap → 422
-     * `entity_too_large`.
+     * returns marks across ALL member owners of the entity (every office). An
+     * owner id in entity form (`ent_<owner-uuid>`) matches nothing (0.14.0); use
+     * `owner_id` for a single owner.
      */
     entity_id?: string;
     /**
@@ -1444,6 +1851,8 @@ export interface TrademarkListParams {
     q?: string;
     /** ENG-67 — faceted bucket counts (TMview "Statistics view"). Field names to aggregate. */
     aggregations?: TrademarkAggregationName[];
+    /** `filtered` (default): aggregations respect every filter. `exclude_own_filter`: each aggregation ignores its own filter (drill-down sidebars). */
+    aggregation_mode?: TrademarkAggregationMode;
     /** ENG-67 — when true, return only aggregation counts (no result documents). */
     aggregations_only?: boolean;
     /** Search strategies to apply (e.g. 'exact', 'phonetic', 'fuzzy', 'prefix'). */
@@ -1459,6 +1868,17 @@ export interface TrademarkListParams {
     match?: MatchMode;
     /** ENG-106 — exclude marks whose text contains this substring (case/accent-insensitive). Composable with any match mode. */
     mark_text_not_contains?: string;
+    /**
+     * Several exact terms in ONE request: every mark that is an exact match
+     * under `match: 'exact'` rules (case, accents, punctuation and spacing) for
+     * ANY of the terms. 1-200 terms. Implies
+     * `match: 'exact'` and replaces `q`; each hit carries `matched_terms[]`.
+     * One page costs the same as any search page regardless of term count.
+     *
+     * `list()` sends the terms comma-joined, so it rejects an empty array and
+     * any term containing a comma. Use `search()` (POST) for such terms.
+     */
+    q_any?: string[];
     /** When true, include total_count in pagination (adds latency). */
     include_total?: boolean;
     /** When true, include match highlight spans. */
@@ -1471,7 +1891,8 @@ export interface TrademarkListParams {
     fields?: string[];
     goods_services_text?: string;
     origin_office_code?: string;
-    renewal_due_before?: string;
+    /** Firm of record on the attorney rows (the name the office recorded). */
+    attorney_firm_name?: string;
     /**
      * Sort spec. Prefix with `-` for descending. Comma-separated for multi-field.
      * E.g. `-filing_date`, `registration_date`, `-filing_date,office_code`.
@@ -1499,6 +1920,8 @@ export interface TrademarkSuggestParams {
     status_stage?: string | string[];
 }
 export interface TrademarkProceedingsParams {
+    /** Only proceedings where this mark is the `contested` or was `asserted` by the opposer / petitioner. */
+    trademark_role?: 'contested' | 'asserted';
     proceeding_type?: string;
     status?: string;
     limit?: number;
@@ -1518,6 +1941,19 @@ export interface TrademarkDocumentParams {
     limit?: number;
     cursor?: string;
 }
+/**
+ * Query params for BOTH trademark citation sub-resources
+ * (`trademarks.citations()` and `trademarks.citedBy()`). Sort is fixed
+ * `-action_date, id` server-side — there is no `sort` param.
+ */
+export interface TrademarkCitationsParams {
+    disposition?: CitationDisposition | CitationDisposition[];
+    action_stage?: CitationActionStage | CitationActionStage[];
+    limit?: number;
+    cursor?: string;
+}
+/** Query params for `trademarks.citedBy()` — identical to `TrademarkCitationsParams`. */
+export type TrademarkCitedByParams = TrademarkCitationsParams;
 export interface OwnerRelatedParams {
     limit?: number;
     cursor?: string;
@@ -1533,7 +1969,8 @@ export type EntityRetrieveParams = Record<string, never>;
 export interface EntityListParams {
     q?: string;
     country_code?: string;
-    entity_type?: string;
+    /** The kind of legal person (the rows' `legal_form`). Replaces `entity_type` (0.14.0). */
+    legal_form?: string;
     publicly_traded?: boolean;
     ticker?: string;
     has_lei?: boolean;
@@ -1558,7 +1995,8 @@ export type EntityFamilyParams = Record<string, never>;
 export interface OwnerListParams {
     q?: string;
     country_code?: string;
-    entity_type?: string;
+    /** The kind of legal person (the rows' `legal_form`). Replaces `entity_type` (0.14.0). */
+    legal_form?: string;
     ticker?: string;
     lei?: string;
     publicly_traded?: boolean;
@@ -1605,10 +2043,17 @@ export interface OwnerTrademarksParams {
     vienna_codes?: string | string[];
     us_design_codes?: string | string[];
     filing_basis?: string | string[];
-    us_register_type?: 'principal' | 'supplemental';
+    /**
+     * The office register (`register.type`), case-insensitive: `principal` or
+     * `supplemental` (US), the CIPO register category (CA), ... Replaces
+     * `us_register_type` (0.14.0).
+     */
+    register_type?: string;
     opposition_status?: OppositionStatus;
-    opposition_closes_before?: string;
-    opposition_closes_after?: string;
+    /** Opposition window closes on or after this date (YYYY-MM-DD). Replaces `opposition_closes_after`. */
+    opposition_closes_gte?: string;
+    /** Opposition window closes on or before this date (YYYY-MM-DD). Replaces `opposition_closes_before`. */
+    opposition_closes_lte?: string;
     seniority_claims?: SeniorityClaims;
     filing_date_gte?: string;
     filing_date_gt?: string;
@@ -1654,6 +2099,15 @@ export interface OwnerTrademarksParams {
     updated_at_gt?: string;
     updated_at_lte?: string;
     updated_at_lt?: string;
+    /**
+     * When the mark family last changed. Grouped view only (a record-grain
+     * request is a 400); pairs with `sort: 'family_updated_at'` for incremental
+     * sync, which pages past 10,000 results on filter-only requests.
+     */
+    family_updated_at_gte?: string;
+    family_updated_at_gt?: string;
+    family_updated_at_lte?: string;
+    family_updated_at_lt?: string;
     owner_name?: string;
     owner_publicly_traded?: boolean;
     owner_has_lei?: boolean;
@@ -1734,10 +2188,17 @@ export interface AttorneyTrademarksParams {
     vienna_codes?: string | string[];
     us_design_codes?: string | string[];
     filing_basis?: string | string[];
-    us_register_type?: 'principal' | 'supplemental';
+    /**
+     * The office register (`register.type`), case-insensitive: `principal` or
+     * `supplemental` (US), the CIPO register category (CA), ... Replaces
+     * `us_register_type` (0.14.0).
+     */
+    register_type?: string;
     opposition_status?: OppositionStatus;
-    opposition_closes_before?: string;
-    opposition_closes_after?: string;
+    /** Opposition window closes on or after this date (YYYY-MM-DD). Replaces `opposition_closes_after`. */
+    opposition_closes_gte?: string;
+    /** Opposition window closes on or before this date (YYYY-MM-DD). Replaces `opposition_closes_before`. */
+    opposition_closes_lte?: string;
     seniority_claims?: SeniorityClaims;
     filing_date_gte?: string;
     filing_date_gt?: string;
@@ -1783,6 +2244,15 @@ export interface AttorneyTrademarksParams {
     updated_at_gt?: string;
     updated_at_lte?: string;
     updated_at_lt?: string;
+    /**
+     * When the mark family last changed. Grouped view only (a record-grain
+     * request is a 400); pairs with `sort: 'family_updated_at'` for incremental
+     * sync, which pages past 10,000 results on filter-only requests.
+     */
+    family_updated_at_gte?: string;
+    family_updated_at_gt?: string;
+    family_updated_at_lte?: string;
+    family_updated_at_lt?: string;
     owner_name?: string;
     owner_id?: string;
     owner_publicly_traded?: boolean;
@@ -1869,10 +2339,17 @@ export interface FirmTrademarksParams {
     vienna_codes?: string | string[];
     us_design_codes?: string | string[];
     filing_basis?: string | string[];
-    us_register_type?: 'principal' | 'supplemental';
+    /**
+     * The office register (`register.type`), case-insensitive: `principal` or
+     * `supplemental` (US), the CIPO register category (CA), ... Replaces
+     * `us_register_type` (0.14.0).
+     */
+    register_type?: string;
     opposition_status?: OppositionStatus;
-    opposition_closes_before?: string;
-    opposition_closes_after?: string;
+    /** Opposition window closes on or after this date (YYYY-MM-DD). Replaces `opposition_closes_after`. */
+    opposition_closes_gte?: string;
+    /** Opposition window closes on or before this date (YYYY-MM-DD). Replaces `opposition_closes_before`. */
+    opposition_closes_lte?: string;
     seniority_claims?: SeniorityClaims;
     filing_date_gte?: string;
     filing_date_gt?: string;
@@ -1918,6 +2395,15 @@ export interface FirmTrademarksParams {
     updated_at_gt?: string;
     updated_at_lte?: string;
     updated_at_lt?: string;
+    /**
+     * When the mark family last changed. Grouped view only (a record-grain
+     * request is a 400); pairs with `sort: 'family_updated_at'` for incremental
+     * sync, which pages past 10,000 results on filter-only requests.
+     */
+    family_updated_at_gte?: string;
+    family_updated_at_gt?: string;
+    family_updated_at_lte?: string;
+    family_updated_at_lt?: string;
     owner_name?: string;
     owner_id?: string;
     owner_publicly_traded?: boolean;
@@ -1947,9 +2433,11 @@ export interface FirmTrademarksParams {
     limit?: number;
     cursor?: string;
 }
-export type ProceedingAggregation = 'outcome' | 'party_role' | 'nice_class' | 'office_code' | 'filed_year';
+export type ProceedingAggregation = 'outcome' | 'party_role' | 'nice_class' | 'office_code' | 'filed_year' | 'trademark_role';
 export interface ProceedingListParams {
     trademark_id?: string;
+    /** Which side the linked mark is on: `contested` (opposed / appealed) or `asserted` (pleaded by the opposer). */
+    trademark_role?: 'contested' | 'asserted';
     proceeding_type?: string;
     status?: string;
     q?: string;
@@ -1969,6 +2457,34 @@ export interface ProceedingListParams {
     limit?: number;
     cursor?: string;
 }
+/** Query params for the cross-mark `GET /v1/citations`. */
+export interface CitationListParams {
+    /**
+     * Issuing office, one value or a list (`'US'` or `['US', 'EM']`, serialized
+     * as `?offices=US,EM`). WIPO ST.3 uppercase (`US`); legacy acronym slugs
+     * (`uspto`) and `EU` are also accepted. Unknown codes return an empty list.
+     */
+    offices?: string | string[];
+    disposition?: CitationDisposition | CitationDisposition[];
+    action_stage?: CitationActionStage | CitationActionStage[];
+    refusal_type?: CitationRefusalType | CitationRefusalType[];
+    /** Filter by citing application (`tm_...`). */
+    trademark_id?: string;
+    /** Filter by cited mark (`tm_...`). */
+    cited_trademark_id?: string;
+    /**
+     * Exact cited reference (digits; punctuation is ignored). Requires
+     * `offices` — an office-less reference lookup is unindexable and 400s.
+     */
+    cited_ref?: string;
+    /** Office action date >= (YYYY-MM-DD). */
+    action_date_gte?: string;
+    /** Office action date <= (YYYY-MM-DD). */
+    action_date_lte?: string;
+    sort?: '-action_date' | 'action_date';
+    limit?: number;
+    cursor?: string;
+}
 export type ConveyanceType = 'assignment' | 'security_interest' | 'release' | 'merger' | 'name_change' | 'license' | 'partial_assignment' | 'correction' | 'entity_conversion' | 'other';
 export interface AssignmentListParams {
     owner_id?: string;
@@ -2130,6 +2646,14 @@ export interface TrademarkSearchBody {
     match?: MatchMode;
     /** ENG-106 — exclude marks whose text contains this substring (case/accent-insensitive). Composable with any match mode. */
     mark_text_not_contains?: string;
+    /**
+     * Several exact terms in ONE request: every mark that is an exact match
+     * under `match: 'exact'` rules (case, accents, punctuation and spacing) for
+     * ANY of the terms. 1-200 terms. Implies
+     * `match: 'exact'` and replaces `query`; each hit carries `matched_terms[]`.
+     * One page costs the same as any search page regardless of term count.
+     */
+    q_any?: string[];
     filters?: {
         /**
          * Coarse status bucket. Accepts a single value or an array to match any
@@ -2152,10 +2676,13 @@ export interface TrademarkSearchBody {
         vienna_codes?: string[];
         us_design_codes?: string[];
         filing_basis?: string[];
-        us_register_type?: 'principal' | 'supplemental';
+        /** The office register (`register.type`), case-insensitive. Replaces `us_register_type`. */
+        register_type?: string;
         opposition_status?: OppositionStatus;
-        opposition_closes_before?: string;
-        opposition_closes_after?: string;
+        /** Replaces `opposition_closes_after`. */
+        opposition_closes_gte?: string;
+        /** Replaces `opposition_closes_before`. */
+        opposition_closes_lte?: string;
         seniority_claims?: SeniorityClaims;
         goods_services_text?: string;
         filing_date?: DateRangeFilter;
@@ -2169,6 +2696,8 @@ export interface TrademarkSearchBody {
         first_use_in_commerce_date?: DateRangeFilter;
         termination_date?: DateRangeFilter;
         updated_at?: DateRangeFilter;
+        /** When the mark family last changed (grouped view only). */
+        family_updated_at?: DateRangeFilter;
         owner_id?: string;
         owner_name?: string;
         owner_publicly_traded?: boolean;
@@ -2177,6 +2706,13 @@ export interface TrademarkSearchBody {
         owner_lei?: string;
         attorney_id?: string;
         firm_id?: string;
+        attorney_firm_name?: string;
+        /** Resolved entity (`ent_*`); see {@link TrademarkListParams.entity_id}. */
+        entity_id?: string;
+        /** GLEIF family group (`ent_*`); see {@link TrademarkListParams.entity_group}. */
+        entity_group?: string;
+        /** Restrict to these trademark ids (`tm_*`). */
+        trademark_ids?: string[];
         application_number?: string;
         registration_number?: string;
         ir_number?: string;
@@ -2190,6 +2726,7 @@ export interface TrademarkSearchBody {
     };
     options?: {
         aggregations?: TrademarkAggregationName[];
+        aggregation_mode?: TrademarkAggregationMode;
         aggregations_only?: boolean;
         include_total?: boolean;
         highlights?: boolean;
@@ -2218,10 +2755,6 @@ export interface TrademarkSearchBody {
  * endpoint has been consolidated into `POST /v1/trademarks`.
  */
 export type SearchV2Body = TrademarkSearchBody;
-export interface CrossEntitySuggestParams {
-    q: string;
-    type?: 'trademark' | 'owner' | 'attorney' | 'firm';
-}
 /**
  * Query parameters for `GET /v1/goods-services` (browse/search the accepted
  * terms catalog). At least one of `q` or `class` must be provided.
@@ -2274,42 +2807,99 @@ export interface PortfolioListParams {
 export interface PortfolioRetrieveParams {
     limit?: number;
     cursor?: string;
+    /**
+     * Restrict the embedded trademarks list to the membership carrying this
+     * external reference (ENG-342). References are unique within a portfolio,
+     * so this returns at most one row. Compared with case-sensitive byte
+     * equality after trimming.
+     */
+    external_ref?: string;
 }
-export interface PortfolioAddTrademarksBody {
-    trademark_ids: string[];
+/** One entry of the `items` form of {@link PortfolioAddTrademarksBody}. */
+export interface PortfolioAddTrademarkItem {
+    /** Prefixed trademark id (`tm_*`). */
+    trademark_id: string;
+    /**
+     * Your own docketing reference for this membership (1-255 chars). Unique
+     * within the portfolio, compared with case-sensitive byte equality after
+     * trimming.
+     *
+     * **Immutable once set**: binding a different reference to a trademark that
+     * already carries one is a `409 external_ref_conflict` — remove the mark and
+     * add it again to rebind. Attaching a reference to a membership that has
+     * none is allowed. Reusing a reference already bound to a DIFFERENT mark in
+     * the same portfolio is the same 409.
+     */
+    external_ref?: string;
 }
-export interface PortfolioRemoveTrademarksBody {
+/**
+ * Body of `portfolios.addTrademarks()`. Supply EXACTLY ONE of `trademark_ids`
+ * or `items` — the `?: never` members make a body carrying both a compile-time
+ * error, and the API rejects it with a `400 validation_error`.
+ *
+ * The two forms differ in how they treat duplicates, deliberately: see the
+ * per-field docs below.
+ *
+ * Both forms are capped at 100 entries per request. That ceiling is physical,
+ * not a policy dial — the edge WAF caps request bodies at 8 KB.
+ *
+ * Any 409 (`external_ref_conflict`, or the `resource_quota_exceeded`
+ * managed-marks cap) rolls the WHOLE batch back. Unknown ids stay lenient and
+ * are counted under `not_found`.
+ */
+export type PortfolioAddTrademarksBody = {
+    /**
+     * Trademark ids to add (1-100). **LENIENT on duplicates**: a repeated id
+     * is silently deduplicated, and every membership is created with
+     * `external_ref: null`.
+     */
     trademark_ids: string[];
-}
-export interface PortfolioDeadlineParams {
-    due_before: string;
-    type?: string;
-    limit?: number;
-    cursor?: string;
-}
+    items?: never;
+} | {
+    /**
+     * Trademarks to add, each optionally carrying an `external_ref` (1-100).
+     * **STRICT on duplicates**: a repeated `trademark_id`, or a repeated
+     * `external_ref`, is a `400 validation_error` raised BEFORE any write —
+     * an explicit request that binds one mark to two references has no
+     * defensible resolution.
+     */
+    items: PortfolioAddTrademarkItem[];
+    trademark_ids?: never;
+};
+/**
+ * Body of `portfolios.removeTrademarks()`. Supply EXACTLY ONE of
+ * `trademark_ids` or `external_refs` — a body carrying both is a compile-time
+ * error here and a `400 validation_error` at the API.
+ */
+export type PortfolioRemoveTrademarksBody = {
+    /**
+     * Trademark ids to remove (1-100). Duplicates are silently deduplicated;
+     * ids that are not in the portfolio simply match nothing.
+     */
+    trademark_ids: string[];
+    external_refs?: never;
+} | {
+    /**
+     * External references to remove (1-100), for callers that only know
+     * their own docketing key (ENG-342). Duplicates are silently
+     * deduplicated; references that match no membership match nothing.
+     */
+    external_refs: string[];
+    trademark_ids?: never;
+};
+/**
+ * Query parameters for `GET /v1/portfolios/{id}/deadlines`.
+ *
+ * Derived from the spec, like the sibling {@link DeadlineListParams}: this used
+ * to be hand-written with `type?: string`, which stopped mirroring the contract
+ * once the route closed `type` to the deadline-type enum. `due_before` is an
+ * inclusive ISO 8601 `YYYY-MM-DD` cutoff; omitting it lets the API apply its
+ * own horizon (720 days after the computation date).
+ */
+export type PortfolioDeadlineParams = NonNullable<operations['listPortfolioDeadlines']['parameters']['query']>;
 export interface PortfolioDeadlinesIcalParams {
     reminder_days?: string;
 }
-export interface SavedSearchCreateParams {
-    name: string;
-    description?: string;
-    query: Record<string, unknown>;
-    metadata?: Record<string, string>;
-}
-export interface SavedSearchUpdateParams {
-    name?: string;
-    description?: string | null;
-    query?: Record<string, unknown>;
-    metadata?: Record<string, string | null>;
-}
-export interface SavedSearchListParams {
-    limit?: number;
-    cursor?: string;
-}
-export interface SavedSearchExecuteParams {
-    limit?: number;
-    cursor?: string;
-}
 /** Feedback type discriminator. */
 export type FeedbackType = 'data_issue' | 'bug' | 'feature_request' | 'other';
 /** Feedback lifecycle status. */
@@ -2365,14 +2955,11 @@ export interface FeedbackListParams {
 }
 /**
  * Body for `watches.create(...)`.
- *
- * Either `query` or `from_saved_search` (passed via the second-arg
- * `RequestOptions`-style query — see `WatchCreateOptions`) must be set.
  */
 export interface WatchCreateParams {
     name: string;
     watch_type: WatchType;
-    /** v1 watch query DSL. Required unless hydrating from a saved search. */
+    /** v1 watch query DSL. */
     query?: WatchQuery | Record<string, unknown>;
     /**
      * v1 accepts only `'always_per_alert'` — the API rejects the digest modes
@@ -2388,18 +2975,6 @@ export interface WatchCreateParams {
     customer_reference?: string | null;
     metadata?: Record<string, unknown>;
 }
-/**
- * Optional query string params for `watches.create(...)`. Pass via the
- * SDK's `?from_saved_search=ssr_...` query string.
- *
- * Note: `backfill_days` was removed — the server rejects it with 400
- * (`unsupported_in_v1`). Historical replay-from-date arrives in v1.1; in
- * v1 only future sync_runs trigger evaluation.
- */
-export interface WatchCreateQueryParams {
-    /** Hydrate `query` from a saved search id (`ssr_...`). */
-    from_saved_search?: string;
-}
 export interface WatchUpdateParams {
     name?: string;
     query?: WatchQuery | Record<string, unknown>;
@@ -2467,13 +3042,20 @@ export interface AlertLookupParams {
 export interface WebhookCreateParams {
     url: string;
     description?: string;
+    /**
+     * Subscribable types only: `alert.created`, `trademark.status_changed`,
+     * `office_action.issued`. The last two are accepted now but not yet emitted.
+     */
     enabled_events: Array<WebhookEventType | string>;
+    /** Portfolio scope, applied to every event type. See {@link Webhook.portfolio_id}. */
+    portfolio_id?: string | null;
     metadata?: Record<string, unknown>;
 }
 export interface WebhookUpdateParams {
     url?: string;
     description?: string | null;
     enabled_events?: Array<WebhookEventType | string>;
+    portfolio_id?: string | null;
     status?: WebhookStatus;
     metadata?: Record<string, unknown>;
 }
@@ -2498,6 +3080,15 @@ export interface OrgEventListParams {
     office_code?: string | string[];
     trademark_id?: string;
     since?: string;
+    sort?: '-id' | 'id';
+    after?: string;
+    /**
+     * `ptf_*` portfolio filter. Strict across EVERY family, `alert.created`
+     * included: an event matches only when its mark was a member of the
+     * portfolio at the time the event was recorded. Requires the
+     * `portfolios:manage` scope in addition to `events:read`.
+     */
+    portfolio_id?: string;
     cursor?: string;
     limit?: number;
 }
@@ -2539,7 +3130,7 @@ export interface LogListParams {
     method?: string;
     /** Filter by API key ID (key_...). */
     api_key_id?: string;
-    /** Filter by endpoint type (search, read, monitoring, screening, clearance, check, image_search, export, reference, utility). */
+    /** Filter by endpoint type (analytics, class_lookup, class_suggest, compare, compute, fees_estimate, gs_draft, gs_validate, image_search, listing_screening, market_analytics, mcp, monitoring, read, reconcile, reference, rules_lookup, screening, search, utility, write). Historical rows may carry a type the API no longer writes. */
     endpoint_type?: string;
     /** Case-insensitive substring match against path or request ID. */
     search?: string;
@@ -2557,6 +3148,16 @@ export interface UsageSummaryParams {
     /** Restrict summary to a specific endpoint type. */
     endpoint_type?: string;
 }
+/**
+ * Query params for `GET /v1/organization/usage/estimate`. Omit both for the
+ * last 30 days; give both to price a specific window.
+ */
+export interface UsageEstimateParams {
+    /** Start of the window (YYYY-MM-DD). Required with `to`. */
+    from?: string;
+    /** End of the window (YYYY-MM-DD), inclusive. Required with `from`. */
+    to?: string;
+}
 /** Shared `GET /v1/screening` options (everything except the candidate). */
 export interface ScreenOptions {
     /** Intended Nice class numbers (1-45). */
@@ -2836,7 +3437,52 @@ export type CompareConflict = {
     status?: 'active' | 'pending' | 'inactive' | 'unknown';
 };
 /** A compare batch contains at least one and at most ten conflicts. */
-export type CompareConflicts = [CompareConflict] | [CompareConflict, CompareConflict] | [CompareConflict, CompareConflict, CompareConflict] | [CompareConflict, CompareConflict, CompareConflict, CompareConflict] | [CompareConflict, CompareConflict, CompareConflict, CompareConflict, CompareConflict] | [CompareConflict, CompareConflict, CompareConflict, CompareConflict, CompareConflict, CompareConflict] | [CompareConflict, CompareConflict, CompareConflict, CompareConflict, CompareConflict, CompareConflict, CompareConflict] | [CompareConflict, CompareConflict, CompareConflict, CompareConflict, CompareConflict, CompareConflict, CompareConflict, CompareConflict] | [CompareConflict, CompareConflict, CompareConflict, CompareConflict, CompareConflict, CompareConflict, CompareConflict, CompareConflict, CompareConflict] | [CompareConflict, CompareConflict, CompareConflict, CompareConflict, CompareConflict, CompareConflict, CompareConflict, CompareConflict, CompareConflict, CompareConflict];
+export type CompareConflicts = [CompareConflict] | [CompareConflict, CompareConflict] | [CompareConflict, CompareConflict, CompareConflict] | [CompareConflict, CompareConflict, CompareConflict, CompareConflict] | [CompareConflict, CompareConflict, CompareConflict, CompareConflict, CompareConflict] | [
+    CompareConflict,
+    CompareConflict,
+    CompareConflict,
+    CompareConflict,
+    CompareConflict,
+    CompareConflict
+] | [
+    CompareConflict,
+    CompareConflict,
+    CompareConflict,
+    CompareConflict,
+    CompareConflict,
+    CompareConflict,
+    CompareConflict
+] | [
+    CompareConflict,
+    CompareConflict,
+    CompareConflict,
+    CompareConflict,
+    CompareConflict,
+    CompareConflict,
+    CompareConflict,
+    CompareConflict
+] | [
+    CompareConflict,
+    CompareConflict,
+    CompareConflict,
+    CompareConflict,
+    CompareConflict,
+    CompareConflict,
+    CompareConflict,
+    CompareConflict,
+    CompareConflict
+] | [
+    CompareConflict,
+    CompareConflict,
+    CompareConflict,
+    CompareConflict,
+    CompareConflict,
+    CompareConflict,
+    CompareConflict,
+    CompareConflict,
+    CompareConflict,
+    CompareConflict
+];
 /** `POST /v1/compare` request body. `conflicts` accepts 1-10 items. */
 export interface CompareParams {
     candidate: CompareCandidate;
@@ -3170,7 +3816,7 @@ export interface ListResponseBody<T> {
     request_id: string;
     search_meta?: SearchMeta;
     source_sync?: TrademarkDocumentSourceSync;
-    /** Faceted aggregation buckets (V2 search and saved search results). */
+    /** Faceted aggregation buckets (V2 search results). */
     aggregations?: Record<string, Record<string, number>>;
     /**
      * TSK-127 — display-name labels for aggregation bucket keys, shaped
@@ -3179,35 +3825,15 @@ export interface ListResponseBody<T> {
      * human-readable bucket labels without a follow-up lookup.
      */
     aggregation_metadata?: Record<string, Record<string, string>>;
+    /**
+     * Deadline lists only (`GET /v1/deadlines`, `GET /v1/portfolios/{id}/deadlines`):
+     * marks in scope that could not be fully computed. An array on the first page,
+     * `null` on continuation pages.
+     */
+    unsupported_marks?: DeadlineUnsupportedMark[] | null;
 }
-export interface OfficeAnalytics {
-    object: 'office_analytics';
-    code: string;
-    total_marks: number;
-    registered_count: number;
-    pending_count: number;
-    expired_count: number;
-    cancelled_count: number;
-    abandoned_count: number;
-    registration_rate: number | null;
-    jurisdiction_count: number;
-    earliest_filing: string | null;
-    latest_filing: string | null;
-    top_classes: Array<{
-        class: number;
-        count: number;
-        pct: number;
-    }> | null;
-    yearly_trend: Array<{
-        year: number;
-        filed: number;
-        registered: number;
-        abandoned: number;
-    }> | null;
-    stats_computed_at: string;
-    /** Per-request id echoed at the top level of the response body (`*Response` in the OpenAPI spec). */
-    request_id: string;
-}
+/** `GET /v1/analytics/offices/{code}`. */
+export type OfficeAnalytics = components['schemas']['OfficeAnalyticsResponse'];
 export interface MarketAnalytics {
     object: 'market_analytics';
     total_marks: number;
@@ -3236,4 +3862,7 @@ export interface ClassificationAnalytics {
     /** Per-request id echoed at the top level of the response body (`*Response` in the OpenAPI spec). */
     request_id: string;
 }
+/** Published credit prices, including the schedule version. */
+export type CreditPrice = components['schemas']['CreditPrice'];
+export type CreditPricingResponse = components['schemas']['CreditPricingResponse'];
 //# sourceMappingURL=types.d.ts.map