@signa-so/sdk 0.7.0 → 0.8.0

package/dist/generated/api-types.d.ts

@@ -335,7 +335,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** @description INTERNAL/beta — requires the `image-search:read` scope (internal + design-partner keys only until GA). Search trademarks by logo/image similarity. Accepts a multipart `image` upload, an `{image_url}` (https, SSRF-guarded), or a `{media_id}` (reuse an existing mark logo). Returns mark-level hits with named signal channels + thumbnails. Billed as `image_search`. Bounded top-K (limit ≤ 100). The query image is never stored. */
+        /** @description INTERNAL/beta — requires the `image-search:read` scope (internal + design-partner keys only until GA). Search trademarks by logo/image similarity. Accepts a multipart `image` upload, an `{image_url}` (https, SSRF-guarded), or a `{media_id}` (reuse an existing mark logo). Returns mark-level hits with named signal channels + thumbnails. Metered as `image_search`: **0 credits by default** while the image index is being built, 5 credits once image-search billing is enabled. Zero-billed calls carry no `X-Credits-*` headers (nothing is debited). Bounded top-K (limit ≤ 100). The query image is never stored. */
         post: operations["searchTrademarksByImage"];
         delete?: never;
         options?: never;
@@ -467,66 +467,15 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/trademarks/{id}/history": {
+    "/v1/trademarks/{id}/events": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** @description Paginated prosecution event timeline, reverse chronological. Maps to trademark_event table. */
-        get: operations["listTrademarkHistory"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/trademarks/{id}/changes": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** @description Version-level change history from the trademark_changes ledger, reverse chronological. This is an OBSERVED-changes feed: each entry records a mutation Signa observed to the record (office re-ingest diffs, Madrid ir_id link/unlink, retractions), not the office's own filing history. Entries are retained for a rolling 12-month window; older changes are pruned. The top-level `observed_since` field is the record's first-observation date (when Signa first ingested it) — the effective start of the visible history is max(observed_since, now − 12 months). */
-        get: operations["listTrademarkChanges"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/trademarks/{id}/related": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** @description Mark-to-mark relationships: Madrid designations, divisionals, seniority claims. Maps to trademark_relationship table. */
-        get: operations["listTrademarkRelated"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/trademarks/{id}/source": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** @description Raw-record provenance metadata. Returns where the data came from and when. Falls back to trademark-record metadata when no raw-record version is available — in that case some fields (e.g. the full raw payload reference and response-type classification) are omitted but the response is still 200. Only returns 404 when the trademark itself does not exist. */
-        get: operations["getTrademarkSource"];
+        /** @description Paginated prosecution event timeline for THIS mark, reverse chronological (maps to the trademark_event table): filings, publications, registrations, status changes. This is the office-reported history of a single trademark — not the org-level `/v1/events` activity feed. */
+        get: operations["listTrademarkEvents"];
         put?: never;
         post?: never;
         delete?: never;
@@ -586,40 +535,6 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/trademarks/{id}/coverage": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** @description Madrid designation territories. Maps to trademark_coverage table. Meaningful only for marks with filing_route = madrid_ir. */
-        get: operations["listTrademarkCoverage"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/trademarks/{id}/media/{mediaId}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** @description Proxy endpoint serving trademark images. Fetches the image server-side from the upstream office or CDN and streams it back. Unauthenticated — suitable for use in <img> tags. */
-        get: operations["getTrademarkMedia"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/v1/owners/{id}/analytics": {
         parameters: {
             query?: never;
@@ -1556,6 +1471,118 @@ export interface paths {
 export type webhooks = Record<string, never>;
 export interface components {
     schemas: {
+        SourceRecordRef: {
+            /** @example WO */
+            source_office_code: string | null;
+            /** @example US */
+            territory_code: string | null;
+            trademark?: {
+                id: string;
+                href: string;
+            };
+        };
+        DetailCoverageTerritory: {
+            /** @example US */
+            territory: string;
+            /** @example active */
+            primary: string;
+            /** @example registered */
+            stage: string;
+            /** @example protected */
+            protection_status: string | null;
+            /** @example 2024-06-01 */
+            designation_date: string | null;
+            /** @example 2025-01-20 */
+            protection_date: string | null;
+            /**
+             * @description The designation record covering this territory. Always present.
+             * @example tm_7d4e1f2a-3b8c-4d0e-9f1a-2b3c4d5e6f70
+             */
+            trademark_id: string;
+            /** @example United States of America */
+            territory_name: string | null;
+            /** @example 2025-03-11 */
+            refusal_date: string | null;
+            /** @example 2025-06-01 */
+            status_effective_date: string | null;
+            /** @example false */
+            is_subsequent_designation: boolean | null;
+            /** @example madrid_protocol */
+            designation_protocol: string | null;
+            /** @description Reconciliation alternates for a dual-feed territory (the WIPO-feed record folded into a winning national-feed record, or vice versa). Empty for a single-feed territory. */
+            source_records: components["schemas"]["SourceRecordRef"][];
+        };
+        DetailCoverage: {
+            /** @example 50 */
+            territory_count: number;
+            /**
+             * @example {
+             *       "active": 46,
+             *       "pending": 2,
+             *       "inactive": 2
+             *     }
+             */
+            by_primary: {
+                [key: string]: number;
+            };
+            /**
+             * @example {
+             *       "registered": 46,
+             *       "pending": 2,
+             *       "refused": 2
+             *     }
+             */
+            by_stage: {
+                [key: string]: number;
+            };
+            territories: components["schemas"]["DetailCoverageTerritory"][];
+        };
+        TrademarkRelationship: {
+            /** @example based_on_basic_registration */
+            type: string;
+            /**
+             * @example child
+             * @enum {string}
+             */
+            direction: "child" | "parent";
+            /** @example tm_7d4e1f2a-3b8c-4d0e-9f1a-2b3c4d5e6f70 */
+            trademark_id: string | null;
+            /**
+             * @description ST.3 office code of the counterpart as reported by the office. Null on `parent` edges (the counterpart is identified by `trademark_id`).
+             * @example US
+             */
+            target_office_code: string | null;
+            /**
+             * @description Office-native identifier of the counterpart. Null on `parent` edges (the counterpart is identified by `trademark_id`).
+             * @example 97123456
+             */
+            target_record_id: string | null;
+            /** @example US */
+            office_code: string | null;
+            /** @example SIGNA */
+            mark_text: string | null;
+            /** @example registered */
+            status_stage: string | null;
+            /** @example 2024-03-15 */
+            effective_date: string | null;
+        };
+        Provenance: {
+            /**
+             * @description Date of the office data file/response this record was built from.
+             * @example 2026-03-18
+             */
+            source_data_date: string | null;
+            /**
+             * @description The office's own last-modified timestamp for the record, when it publishes one.
+             * @example 2026-03-17T00:00:00Z
+             */
+            office_updated_at: string | null;
+            /**
+             * @description When Signa last fetched the full detail record from the office.
+             * @example 2026-03-18T04:00:00Z
+             */
+            retrieved_at: string | null;
+        };
         TrademarkDetailV1: {
             /** @example tm_7d4e1f2a3b8c9d0e */
             id: string;
@@ -1620,16 +1647,6 @@ export interface components {
             publication_date: string | null;
             priority_date: string | null;
             termination_date: string | null;
-            /**
-             * @description Timestamp reported by the source office for the record, when available.
-             * @example 2026-03-18T04:00:00Z
-             */
-            office_updated_at: string | null;
-            /**
-             * @description Timestamp of the most recent detail enrichment fetch when that office populates it; null otherwise.
-             * @example 2026-03-18T04:30:00Z
-             */
-            retrieved_at: string | null;
             protection_effective_date: string | null;
             designation_date: string | null;
             dependency_period_end_date: string | null;
@@ -1899,29 +1916,18 @@ export interface components {
                 } | null;
             } | null;
             has_media: boolean;
+            /**
+             * @description Media-proxy URL for the primary mark image. Null when the mark has no media.
+             * @example https://api.signa.so/v1/trademarks/tm_abc/media/01234567-89ab-cdef-0123-456789abcdef
+             */
+            primary_image_url: string | null;
+            /** @description Per-territory coverage for a grouped Madrid IR (the same reconciled rollup the search row carries, plus per-designation detail). Null on designation legs and on direct/regional marks. */
+            coverage: components["schemas"]["DetailCoverage"] | null;
+            /** @description Mark-to-mark relationships. Excludes Madrid designations (see coverage.territories[]) and seniority claims (see seniority_claims[]). Capped at 200 per mark. */
+            relationships: components["schemas"]["TrademarkRelationship"][];
             events_count: number;
             proceedings_count: number;
-            coverage_count: number;
-            relationships_count: number;
-            data_freshness: {
-                /** @example 2026-03-18 */
-                source_data_date: string | null;
-                /** @example dtd_v2.0 */
-                source_format: string | null;
-                /** @example 2026-03-18T04:00:00Z */
-                last_updated_at: string;
-            };
-            madrid?: {
-                ir_number: string;
-                holder_name: string | null;
-                origin_office: string | null;
-                expiry_date: string | null;
-                designation_count: number;
-                designated_countries: string[];
-                nice_classes: number[];
-                status_stage: string | null;
-                fetched_at: string | null;
-            } | null;
+            provenance: components["schemas"]["Provenance"];
             /** @example 2024-03-16T00:00:00Z */
             created_at: string;
             /** @example 2026-03-18T04:00:00Z */
@@ -2096,18 +2102,6 @@ export interface components {
                 /** @example 2025-01-20 */
                 protection_date: string | null;
             }[];
-            /** @example /v1/trademarks/tm_IR1293856/coverage */
-            href: string;
-        };
-        SourceRecordRef: {
-            /** @example WO */
-            source_office_code: string | null;
-            /** @example US */
-            territory_code: string | null;
-            trademark?: {
-                id: string;
-                href: string;
-            };
         };
         TerritoryMatch: {
             /**
@@ -3511,7 +3505,7 @@ export interface components {
                 international_registrations: "grouped" | "expanded";
                 /**
                  * @description Present when a grouped request falls back to expanded because a filter, sort, or option cannot be served by the grouped index.
-                 * @example filter:vienna_codes forced expanded
+                 * @example filter:filing_date forced expanded
                  */
                 fallback_reason?: string;
                 /**
@@ -3575,7 +3569,11 @@ export interface components {
             aggregation_metadata?: components["schemas"]["AggregationMetadata"];
             request_id: string;
         };
-        TrademarkHistoryEvent: {
+        TrademarkEvent: {
+            /** @example evt_7d4e1f2a-3b8c-4d0e-9f1a-2b3c4d5e6f70 */
+            id: string;
+            /** @enum {string} */
+            object: "event";
             /** @example 2025-01-20 */
             event_date: string | null;
             /** @example registration */
@@ -3599,108 +3597,10 @@ export interface components {
             /** @example 12 */
             sequence_no: number | null;
         };
-        TrademarkHistoryResponse: {
-            /** @enum {string} */
-            object: "list";
-            data: components["schemas"]["TrademarkHistoryEvent"][];
-            has_more: boolean;
-            pagination: {
-                cursor: string | null;
-                total_count?: number;
-                total_count_approximate?: boolean;
-            };
-            request_id: string;
-        };
-        TrademarkChange: {
-            /** @example evt_019d2141-6ce9-771b-872e-bc8b20e49fcf */
-            id: string;
-            /** @enum {string} */
-            object: "trademark_change";
-            /** @example 12 */
-            version: number;
-            /** @example updated */
-            change_type: string;
-            /**
-             * @example [
-             *       "status_stage",
-             *       "registration_date"
-             *     ]
-             */
-            changed_fields: string[];
-            /**
-             * @example {
-             *       "status_stage": "examining",
-             *       "registration_date": null
-             *     }
-             */
-            old_values: {
-                [key: string]: string | number | boolean | unknown[] | {
-                    [key: string]: unknown;
-                } | null;
-            } | null;
-            /**
-             * @example {
-             *       "status_stage": "registered",
-             *       "registration_date": "2026-03-15"
-             *     }
-             */
-            new_values: {
-                [key: string]: string | number | boolean | unknown[] | {
-                    [key: string]: unknown;
-                } | null;
-            };
-            /** @example 2026-03-15 */
-            source_data_date: string | null;
-            /** @example US */
-            office_code: string | null;
-            /** @example 2026-03-15T12:00:00Z */
-            created_at: string;
-        };
-        TrademarkChangesResponse: {
-            /** @enum {string} */
-            object: "list";
-            data: components["schemas"]["TrademarkChange"][];
-            has_more: boolean;
-            pagination: {
-                cursor: string | null;
-                total_count?: number;
-                total_count_approximate?: boolean;
-            };
-            /**
-             * Format: date-time
-             * @description ISO 8601 date-time the trademark was first observed by Signa (first ingest). Changes older than the rolling 12-month retention window are pruned.
-             */
-            observed_since: string | null;
-            request_id: string;
-        };
-        TrademarkRelated: {
-            /** @example tm_xyz */
-            related_trademark_id: string | null;
-            /** @example madrid_designation_of */
-            relationship_type: string;
-            /** @example 2024-06-01 */
-            effective_date: string | null;
-            /** @example SIGNA */
-            mark_text: string | null;
-            /** @example EM */
-            office_code: string | null;
-            /** @example registered */
-            status_stage: string | null;
-            /** @example child */
-            direction: string;
-            /** @example null */
-            target_office_code: string | null;
-            /** @example null */
-            target_record_id: string | null;
-            /** @example null */
-            metadata: string | number | boolean | unknown[] | {
-                [key: string]: unknown;
-            } | null;
-        };
-        TrademarkRelatedResponse: {
+        TrademarkEventsResponse: {
             /** @enum {string} */
             object: "list";
-            data: components["schemas"]["TrademarkRelated"][];
+            data: components["schemas"]["TrademarkEvent"][];
             has_more: boolean;
             pagination: {
                 cursor: string | null;
@@ -3709,27 +3609,6 @@ export interface components {
             };
             request_id: string;
         };
-        TrademarkSource: {
-            /** @enum {string} */
-            object: "trademark_source";
-            /** @example tm_abc */
-            trademark_id: string;
-            /** @example US */
-            office_code: string | null;
-            /** @example 2026-03-18T04:00:00Z */
-            observed_at: string;
-            /** @example dtd_v2.0 */
-            source_format: string;
-            /** @example daily_bulk_xml */
-            source_response_type: string | null;
-            /** @example apc18840407-20251231-01.zip/entry-1234.xml */
-            source_locator: string | null;
-            /** @example sha256:a1b2c3d4... */
-            payload_hash: string;
-        };
-        TrademarkSourceResponse: components["schemas"]["TrademarkSource"] & {
-            request_id: string;
-        };
         TrademarkProceedingParty: {
             /** @example own_xyz */
             owner_id: string | null;
@@ -3930,57 +3809,6 @@ export interface components {
             source_sync: components["schemas"]["TrademarkDocumentSourceSync"];
             request_id: string;
         };
-        TrademarkCoverage: {
-            /** @example GB */
-            territory_code: string | null;
-            /** @example United Kingdom */
-            territory_name: string | null;
-            /** @example active */
-            primary: string | null;
-            /** @example registered */
-            stage: string | null;
-            /** @example protected */
-            protection_status: string | null;
-            /** @example 2024-06-01 */
-            designation_date: string | null;
-            /** @example 2025-02-15 */
-            protection_date: string | null;
-            /** @example null */
-            refusal_date: string | null;
-            /** @example 2025-02-15 */
-            status_effective_date: string | null;
-            /** @example false */
-            is_subsequent_designation: boolean | null;
-            /** @example madrid */
-            designation_protocol: string | null;
-            /** @example null */
-            goods_limitations: string | number | boolean | unknown[] | {
-                [key: string]: unknown;
-            } | null;
-            /** @example null */
-            status_detail: string | number | boolean | unknown[] | {
-                [key: string]: unknown;
-            } | null;
-            /** @description WIPO/national reconciliation alternates for this territory (§12.1) on grouped IR-parent rows — additive, never a duplicate row. Empty/absent for single-feed territories and non-IR marks. */
-            source_records?: {
-                /** @example WO */
-                source_office_code: string | null;
-                /** @example US */
-                territory_code: string | null;
-            }[];
-        };
-        TrademarkCoverageResponse: {
-            /** @enum {string} */
-            object: "list";
-            data: components["schemas"]["TrademarkCoverage"][];
-            has_more: boolean;
-            pagination: {
-                cursor: string | null;
-                total_count?: number;
-                total_count_approximate?: boolean;
-            };
-            request_id: string;
-        };
         AnalyticsPortfolioBlock: {
             mark_count: number;
             active_count: number;
@@ -4395,7 +4223,7 @@ export interface components {
                 international_registrations: "grouped" | "expanded";
                 /**
                  * @description Present when a grouped request falls back to expanded because a filter, sort, or option cannot be served by the grouped index.
-                 * @example filter:vienna_codes forced expanded
+                 * @example filter:filing_date forced expanded
                  */
                 fallback_reason?: string;
                 /**
@@ -4633,7 +4461,7 @@ export interface components {
                 international_registrations: "grouped" | "expanded";
                 /**
                  * @description Present when a grouped request falls back to expanded because a filter, sort, or option cannot be served by the grouped index.
-                 * @example filter:vienna_codes forced expanded
+                 * @example filter:filing_date forced expanded
                  */
                 fallback_reason?: string;
                 /**
@@ -4872,7 +4700,7 @@ export interface components {
                 international_registrations: "grouped" | "expanded";
                 /**
                  * @description Present when a grouped request falls back to expanded because a filter, sort, or option cannot be served by the grouped index.
-                 * @example filter:vienna_codes forced expanded
+                 * @example filter:filing_date forced expanded
                  */
                 fallback_reason?: string;
                 /**
@@ -5167,7 +4995,7 @@ export interface components {
                 international_registrations: "grouped" | "expanded";
                 /**
                  * @description Present when a grouped request falls back to expanded because a filter, sort, or option cannot be served by the grouped index.
-                 * @example filter:vienna_codes forced expanded
+                 * @example filter:filing_date forced expanded
                  */
                 fallback_reason?: string;
                 /**
@@ -6396,6 +6224,8 @@ export interface components {
              */
             status: "active" | "revoked" | "expired";
             expires_at: string | null;
+            /** @description When this key was rotated (superseded). Non-null means expires_at is a rotation grace deadline, not a customer-set expiry. */
+            rotated_at: string | null;
             last_used_at: string | null;
             metadata: {
                 [key: string]: string;
@@ -6427,6 +6257,8 @@ export interface components {
                  */
                 status: "active" | "revoked" | "expired";
                 expires_at: string | null;
+                /** @description When this key was rotated (superseded). Non-null means expires_at is a rotation grace deadline, not a customer-set expiry. */
+                rotated_at: string | null;
                 last_used_at: string | null;
                 metadata: {
                     [key: string]: string;
@@ -6577,16 +6409,19 @@ export interface components {
         StripeCheckoutSessionResponse: {
             checkout_url: string | null;
             session_id: string;
+            request_id: string;
         };
         StripeBillingPortalResponse: {
             portal_url: string;
             session_id: string;
+            request_id: string;
         };
         StripeCreditPackCheckoutResponse: {
             checkout_url: string | null;
             session_id: string;
             credits: number;
             plan: string;
+            request_id: string;
         };
         AutoTopUpConfigResponse: {
             enabled: boolean;
@@ -6597,6 +6432,7 @@ export interface components {
             saved_payment_method: string | null;
             month_to_date_spend_usd: number;
             last_failure_reason: string | null;
+            request_id: string;
         };
         NotificationCategory: {
             key: string;
@@ -8398,7 +8234,7 @@ export interface operations {
             };
         };
     };
-    listTrademarkHistory: {
+    listTrademarkEvents: {
         parameters: {
             query?: {
                 event_type?: string[] | null;
@@ -8416,196 +8252,13 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Trademark event history */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["TrademarkHistoryResponse"];
-                };
-            };
-            /** @description Invalid ID */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Missing or invalid API key */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Missing required scope */
-            403: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Trademark not found */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-        };
-    };
-    listTrademarkChanges: {
-        parameters: {
-            query?: {
-                changed_field?: string;
-                sort?: "-changed_at" | "changed_at";
-                limit?: number;
-                cursor?: string;
-            };
-            header?: never;
-            path: {
-                id: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Trademark change history */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["TrademarkChangesResponse"];
-                };
-            };
-            /** @description Invalid ID */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Missing or invalid API key */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Missing required scope */
-            403: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Trademark not found */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-        };
-    };
-    listTrademarkRelated: {
-        parameters: {
-            query?: {
-                relationship_type?: string;
-                limit?: number;
-                cursor?: string;
-            };
-            header?: never;
-            path: {
-                id: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Trademark relationships */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["TrademarkRelatedResponse"];
-                };
-            };
-            /** @description Invalid ID */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Missing or invalid API key */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Missing required scope */
-            403: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Trademark not found */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-        };
-    };
-    getTrademarkSource: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                id: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Source provenance (synthesized from trademark-record metadata when no raw-record version exists — reduced field set) */
+            /** @description Trademark prosecution events */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["TrademarkSourceResponse"];
+                    "application/json": components["schemas"]["TrademarkEventsResponse"];
                 };
             };
             /** @description Invalid ID */
@@ -8836,116 +8489,6 @@ export interface operations {
             };
         };
     };
-    listTrademarkCoverage: {
-        parameters: {
-            query?: {
-                protection_status?: string;
-                limit?: number;
-                cursor?: string;
-            };
-            header?: never;
-            path: {
-                id: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Trademark coverage territories */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["TrademarkCoverageResponse"];
-                };
-            };
-            /** @description Invalid ID */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Missing or invalid API key */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Missing required scope */
-            403: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Trademark not found */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-        };
-    };
-    getTrademarkMedia: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                id: string;
-                mediaId: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Image content */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Invalid ID */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Media not found */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Upstream image unavailable */
-            502: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-        };
-    };
     retrieveOwnerAnalytics: {
         parameters: {
             query?: never;