@graph8/sdk 0.295.2 → 0.302.0

package/dist/types/version.d.ts

@@ -5,6 +5,6 @@
  * both together (the version-parity gate already pins package.json, the
  * lockfile and the CHANGELOG to each other).
  */
-export declare const SDK_VERSION = "0.295.2";
+export declare const SDK_VERSION = "0.302.0";
 /** Value of the `X-G8-Client` header every SDK request carries (I-13). */
-export declare const SDK_CLIENT_ID = "js-sdk/0.295.2";
+export declare const SDK_CLIENT_ID = "js-sdk/0.302.0";

package/docs/agents.md

@@ -9,7 +9,7 @@ grows every week and your training data is older than this file.
 
 graph8 is a B2B go-to-market platform: CRM (contacts, companies, deals, custom objects), a 700M-person
 data index with enrichment, intent signals, sequences and campaigns across email/SMS/LinkedIn/voice, a unified
-inbox, meetings, workflows and more. This SDK reaches all of it: **3255 Developer API
+inbox, meetings, workflows and more. This SDK reaches all of it: **3258 Developer API
 operations** in 141 areas.
 
 ## 1. The short version
@@ -92,7 +92,7 @@ g8.init({ apiKey: process.env.G8_API_KEY! });
 | | Hand-written clients | `g8.api` (generated) |
 |---|---|---|
 | Example | `g8.contacts.upsert({ list_id, work_email })` | `g8.api.assertUpsert.assertContact({ body: { list_id, work_email } })` |
-| Coverage | 289 methods, reaching 258 operations | all 3255 operations |
+| Coverage | 289 methods, reaching 258 operations | all 3258 operations |
 | Returns | the unwrapped value (usually `data`) | the full envelope; read `result.data` |
 | Arguments | positional / friendly names | `{ path?, query?, headers?, body? }`, exactly as the contract names them |
 | Reference | [sdk-clients.md](sdk-clients.md) | [api/README.md](api/README.md) |
@@ -141,7 +141,7 @@ Hand-written modules:
 | [`g8.webhooks`](sdk-clients.md#g8-webhooks) | 1 | API key |
 | [`g8.workflows`](sdk-clients.md#g8-workflows) | 21 | API key |
 
-`g8.api` namespaces (operation counts): `accounts` (16), `adCampaigns` (19), `adCreatives` (40), `agency` (24), `agent` (8), `agents` (65), `aiInbox` (79), `analytics` (51), `apiKeys` (6), `appDeployments` (7), `appDomains` (5), `appLogs` (2), `appObjects` (10), `appPages` (16), `appPlatformTokens` (3), `appointments` (92), `apps` (22), `assertUpsert` (6), `audienceSyncs` (8), `brandKit` (30), `bugReports` (7), `calendarInvites` (3), `campaignWorkflows` (5), `campaigns` (29), `channels` (5), `cliCampaigns` (6), `cliPipelines` (12), `clickHouse` (2), `companies` (50), `companyIntelligence` (14), `contacts` (70), `content` (41), `contentGridSkills` (6), `copilot` (39), `crmSyncs` (6), `customerSuccess` (19), `deals` (48), `deliverability` (17), `desk` (71), `dialer` (46), `dialerAnalytics` (6), `documents` (35), `duplicates` (7), `eSign` (1), `eSignature` (7), `enrichment` (115), `events` (1), `fields` (8), `forms` (35), `gtmCampaigns` (22), `gtmContext` (51), `gtmDeliverability` (1), `gtmKnowledgeBase` (2), `gtmLaunchHelpers` (2), `gtmLibrary` (20), `health` (1), `imageLibrary` (14), `imports` (3), `inbox` (22), `install` (6), `installedApps` (4), `integrationStatus` (6), `integrations` (83), `intent` (16), `knowledge` (21), `knowledgeBase` (2), `landingPages` (59), `leads` (4), `library` (9), `linkedIn` (5), `linkedInOutreach` (20), `lists` (36), `logs` (1), `mailboxes` (38), `marketingIntelligence` (10), `marketplace` (142), `mcp` (1), `me` (1), `meetings` (17), `newsletter` (61), `notes` (19), `notifications` (2), `objects` (18), `openSearch` (4), `ops` (5), `orgGovernance` (17), `orgVideos` (6), `organizationSettings` (22), `phoneNumbers` (16), `profile` (14), `programmaticPages` (15), `providerDomains` (34), `providerUsage` (5), `public` (1), `publicCopilot` (1), `publicSignals` (1), `publicVisitors` (2), `quotes` (56), `radar` (42), `radarReports` (8), `recordRoles` (4), `repos` (4), `research` (13), `revenue` (14), `revenueAnalytics` (6), `revenueLifecycle` (5), `revenueRecords` (15), `roles` (21), `salesCoach` (37), `sandbox` (9), `scans` (2), `scheduleBuy` (9), `scraping` (10), `sdrAnalytics` (5), `search` (19), `seo` (11), `sequenceLifecycle` (8), `sequences` (71), `settings` (18), `signals` (56), `signatures` (24), `skills` (12), `snippet` (3), `socialPublishing` (22), `studioDocuments` (9), `support` (1), `suppressions` (6), `surveys` (21), `tasks` (25), `teamMembers` (21), `teams` (35), `usage` (9), `visitors` (26), `voice` (187), `webAnalytics` (38), `webChat` (46), `webhooks` (8), `websiteEditor` (12), `work` (59), `workbench` (107), `workflows` (59).
+`g8.api` namespaces (operation counts): `accounts` (16), `adCampaigns` (19), `adCreatives` (40), `agency` (24), `agent` (8), `agents` (65), `aiInbox` (79), `analytics` (51), `apiKeys` (6), `appDeployments` (7), `appDomains` (5), `appLogs` (2), `appObjects` (10), `appPages` (16), `appPlatformTokens` (3), `appointments` (92), `apps` (22), `assertUpsert` (6), `audienceSyncs` (8), `brandKit` (30), `bugReports` (7), `calendarInvites` (3), `campaignWorkflows` (5), `campaigns` (29), `channels` (5), `cliCampaigns` (6), `cliPipelines` (12), `clickHouse` (2), `companies` (50), `companyIntelligence` (14), `contacts` (70), `content` (41), `contentGridSkills` (6), `copilot` (39), `crmSyncs` (6), `customerSuccess` (19), `deals` (48), `deliverability` (17), `desk` (71), `dialer` (46), `dialerAnalytics` (6), `documents` (35), `duplicates` (7), `eSign` (1), `eSignature` (7), `enrichment` (115), `events` (1), `fields` (8), `forms` (35), `gtmCampaigns` (22), `gtmContext` (51), `gtmDeliverability` (1), `gtmKnowledgeBase` (2), `gtmLaunchHelpers` (2), `gtmLibrary` (20), `health` (1), `imageLibrary` (14), `imports` (3), `inbox` (22), `install` (6), `installedApps` (4), `integrationStatus` (6), `integrations` (83), `intent` (16), `knowledge` (21), `knowledgeBase` (2), `landingPages` (59), `leads` (4), `library` (9), `linkedIn` (5), `linkedInOutreach` (20), `lists` (36), `logs` (1), `mailboxes` (38), `marketingIntelligence` (10), `marketplace` (142), `mcp` (1), `me` (1), `meetings` (17), `newsletter` (61), `notes` (19), `notifications` (2), `objects` (18), `openSearch` (4), `ops` (5), `orgGovernance` (17), `orgVideos` (6), `organizationSettings` (22), `phoneNumbers` (16), `profile` (14), `programmaticPages` (15), `providerDomains` (34), `providerUsage` (5), `public` (1), `publicCopilot` (1), `publicSignals` (1), `publicVisitors` (2), `quotes` (56), `radar` (42), `radarReports` (8), `recordRoles` (4), `repos` (4), `research` (13), `revenue` (14), `revenueAnalytics` (6), `revenueLifecycle` (5), `revenueRecords` (15), `roles` (21), `salesCoach` (37), `sandbox` (9), `scans` (2), `scheduleBuy` (9), `scraping` (10), `sdrAnalytics` (5), `search` (19), `seo` (14), `sequenceLifecycle` (8), `sequences` (71), `settings` (18), `signals` (56), `signatures` (24), `skills` (12), `snippet` (3), `socialPublishing` (22), `studioDocuments` (9), `support` (1), `suppressions` (6), `surveys` (21), `tasks` (25), `teamMembers` (21), `teams` (35), `usage` (9), `visitors` (26), `voice` (187), `webAnalytics` (38), `webChat` (46), `webhooks` (8), `websiteEditor` (12), `work` (59), `workbench` (107), `workflows` (59).
 
 ## 5. How to find the right call
 
@@ -196,7 +196,7 @@ Every operation carries a tier:
 
 | Tier | What it means | Count |
 |---|---|---|
-| `read` | reads data; safe to call and to retry | 1510 |
+| `read` | reads data; safe to call and to retry | 1513 |
 | `write` | creates or changes records; the SDK sends an Idempotency-Key and retries transient failures | 811 |
 | `destructive` | deletes or archives data; confirm with a human before calling | 300 |
 | `billable` | spends credits; the SDK never blindly retries it; confirm cost before bulk use | 383 |

package/docs/api/README.md

@@ -2,7 +2,7 @@
 
 # `g8.api`: every Developer API operation
 
-`g8.api` is generated from the published OpenAPI contract, so it covers all 3255 operations across 141 namespaces (1510 read, 811 write, 300 destructive, 383 billable, 251 external).
+`g8.api` is generated from the published OpenAPI contract, so it covers all 3258 operations across 141 namespaces (1513 read, 811 write, 300 destructive, 383 billable, 251 external).
 
 - Found a REST path in a curl example or the web docs? Look it up in [by-path.md](by-path.md).
 - Prefer a hand-written method where one exists: [../sdk-clients.md](../sdk-clients.md).
@@ -137,7 +137,7 @@
 | `g8.api.scraping` | Scraping | 10 | none | [scraping.md](scraping.md) | [scraping.d.ts](scraping.d.ts) |
 | `g8.api.sdrAnalytics` | SDR Analytics | 5 | none | [sdrAnalytics.md](sdrAnalytics.md) | [sdrAnalytics.d.ts](sdrAnalytics.d.ts) |
 | `g8.api.search` | Search | 19 | 4 | [search.md](search.md) | [search.d.ts](search.d.ts) |
-| `g8.api.seo` | SEO | 11 | none | [seo.md](seo.md) | [seo.d.ts](seo.d.ts) |
+| `g8.api.seo` | SEO | 14 | none | [seo.md](seo.md) | [seo.d.ts](seo.d.ts) |
 | `g8.api.sequenceLifecycle` | Sequence Lifecycle | 8 | 6 | [sequenceLifecycle.md](sequenceLifecycle.md) | [sequenceLifecycle.d.ts](sequenceLifecycle.d.ts) |
 | `g8.api.sequences` | Sequences | 71 | 6 | [sequences.md](sequences.md) | [sequences.d.ts](sequences.d.ts) |
 | `g8.api.settings` | Settings | 18 | none | [settings.md](settings.md) | [settings.d.ts](settings.d.ts) |

package/docs/api/by-path.md

@@ -2466,6 +2466,9 @@ Every Developer API route, sorted by path, with the SDK call that reaches it. Th
 | POST | `/api/v1/seo/audits` | [`g8.api.seo.startSeoAudit`](seo.md#op-startseoaudit) | billable |
 | GET | `/api/v1/seo/audits/{audit_id}` | [`g8.api.seo.getSeoAudit`](seo.md#op-getseoaudit) | read |
 | GET | `/api/v1/seo/audits/{audit_id}/issues` | [`g8.api.seo.getSeoAuditIssues`](seo.md#op-getseoauditissues) | read |
+| GET | `/api/v1/seo/domains/tracked` | [`g8.api.seo.listSeoTrackedDomains`](seo.md#op-listseotrackeddomains) | read |
+| GET | `/api/v1/seo/domains/tracked/{domain}` | [`g8.api.seo.getSeoTrackedDomain`](seo.md#op-getseotrackeddomain) | read |
+| GET | `/api/v1/seo/domains/tracked/{domain}/pages` | [`g8.api.seo.listSeoDomainPages`](seo.md#op-listseodomainpages) | read |
 | GET | `/api/v1/seo/domains/{domain}/backlinks` | [`g8.api.seo.getSeoDomainBacklinks`](seo.md#op-getseodomainbacklinks) | billable |
 | GET | `/api/v1/seo/domains/{domain}/overview` | [`g8.api.seo.getSeoDomainOverview`](seo.md#op-getseodomainoverview) | billable |
 | POST | `/api/v1/seo/keywords/research` | [`g8.api.seo.researchSeoKeywords`](seo.md#op-researchseokeywords) | billable |

package/docs/api/companies.d.ts

@@ -1074,6 +1074,13 @@ export interface Column {
   id?: number | null;
   /** Automatically computed: True if object_id is None/empty, False otherwise. */
   is_global: boolean;
+  /**
+   * Human-readable display name (CF-09), e.g. ``CONTACT_FIRST_NAME`` ->
+   * "First name", ``COMPANY_NAICS`` -> "Company NAICS". Custom columns keep
+   * their own title. Additive and read-only: ``name`` / ``title`` stay the
+   * storage key, because callers send them back as identifiers.
+   */
+  label: string | null;
   name?: string | null;
   object_id?: string | null;
   source?: ColumnSource;

package/docs/api/companies.md

@@ -1479,6 +1479,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `is_global` | `boolean` | yes | Automatically computed: True if object_id is None/empty, False otherwise. |
+| `label` | `string \| null` | yes | Human-readable display name (CF-09), e.g. ``CONTACT_FIRST_NAME`` -> "First name", ``COMPANY_NAICS`` -> "Company NAICS". Custom columns keep their own title. Additive and read-only: ``name`` / ``title`` stay the storage key, because callers send them back as identifiers. |
 | `title` | `string` | yes |  |
 | `data_type` | `ColumnType` | no | default `"text"` |
 | `id` | `integer \| null` | no |  |

package/docs/api/contacts.d.ts

@@ -1422,6 +1422,13 @@ export interface Column {
   id?: number | null;
   /** Automatically computed: True if object_id is None/empty, False otherwise. */
   is_global: boolean;
+  /**
+   * Human-readable display name (CF-09), e.g. ``CONTACT_FIRST_NAME`` ->
+   * "First name", ``COMPANY_NAICS`` -> "Company NAICS". Custom columns keep
+   * their own title. Additive and read-only: ``name`` / ``title`` stay the
+   * storage key, because callers send them back as identifiers.
+   */
+  label: string | null;
   name?: string | null;
   object_id?: string | null;
   source?: ColumnSource;

package/docs/api/contacts.md

@@ -1772,6 +1772,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `is_global` | `boolean` | yes | Automatically computed: True if object_id is None/empty, False otherwise. |
+| `label` | `string \| null` | yes | Human-readable display name (CF-09), e.g. ``CONTACT_FIRST_NAME`` -> "First name", ``COMPANY_NAICS`` -> "Company NAICS". Custom columns keep their own title. Additive and read-only: ``name`` / ``title`` stay the storage key, because callers send them back as identifiers. |
 | `title` | `string` | yes |  |
 | `data_type` | `ColumnType` | no | default `"text"` |
 | `id` | `integer \| null` | no |  |

package/docs/api/enrichment.d.ts

@@ -2618,16 +2618,24 @@ export interface EnrichmentPreflightResponse {
   contact_count: number;
   /** Contact IDs that will be enriched: duplicates removed, order kept */
   contact_ids: Array<number>;
+  /** Waterfall only: the most one contact can cost, in graph8 credits. A record is charged its dearest graph8-funded step that finds a value (steps are not added together); steps on your own key cost 0. Null when the pipeline could not be priced. */
+  credits_per_record?: number | null;
   /** How many repeated contact IDs were dropped */
   duplicates_removed?: number;
   list_id: number;
   list_name?: string | null;
+  /** Waterfall only: priced_records x credits_per_record, the most this run can charge. Records the pipeline skips (values already present, run conditions) cost less. Null when not priced. */
+  max_total_credits?: number | null;
   /** Providers whose step would be skipped because the org has no key for them */
   missing_credentials?: Array<string>;
   /** Resolved mode: 'waterfall' or 'ai-research' */
   mode: string;
   /** Contact IDs that are not on the list; the run skips them and does not charge for them */
   not_in_list?: Array<number>;
+  /** column_id of the saved waterfall pipeline the run would reuse. Null when the run would create a new pipeline (it is created on confirm) or in 'ai-research' mode. Pass it to POST /enrichment/waterfall/validate-credits for the record-exact quote. */
+  pipeline_column_id?: string | null;
+  /** Waterfall only: contacts the price covers (unique contacts that are on the list). */
+  priced_records?: number | null;
   /** Providers that would run, in order (empty = the saved pipeline) */
   providers?: Array<string>;
   providers_detail?: Array<ProviderStepDetail>;

package/docs/api/enrichment.md

@@ -3312,10 +3312,14 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `contact_ids` | `Array<integer>` | yes | Contact IDs that will be enriched: duplicates removed, order kept |
 | `list_id` | `integer` | yes |  |
 | `mode` | `string` | yes | Resolved mode: 'waterfall' or 'ai-research' |
+| `credits_per_record` | `integer \| null` | no | Waterfall only: the most one contact can cost, in graph8 credits. A record is charged its dearest graph8-funded step that finds a value (steps are not added together); steps on your own key cost 0. Null when the pipeline could not be priced. |
 | `duplicates_removed` | `integer` | no | How many repeated contact IDs were dropped default `0` |
 | `list_name` | `string \| null` | no |  |
+| `max_total_credits` | `integer \| null` | no | Waterfall only: priced_records x credits_per_record, the most this run can charge. Records the pipeline skips (values already present, run conditions) cost less. Null when not priced. |
 | `missing_credentials` | `Array<string>` | no | Providers whose step would be skipped because the org has no key for them |
 | `not_in_list` | `Array<integer>` | no | Contact IDs that are not on the list; the run skips them and does not charge for them |
+| `pipeline_column_id` | `string \| null` | no | column_id of the saved waterfall pipeline the run would reuse. Null when the run would create a new pipeline (it is created on confirm) or in 'ai-research' mode. Pass it to POST /enrichment/waterfall/validate-credits for the record-exact quote. |
+| `priced_records` | `integer \| null` | no | Waterfall only: contacts the price covers (unique contacts that are on the list). |
 | `providers` | `Array<string>` | no | Providers that would run, in order (empty = the saved pipeline) |
 | `providers_detail` | `Array<ProviderStepDetail>` | no |  |
 | `target_field` | `string \| null` | no | Canonical column for target_field, when given |

package/docs/api/lists.d.ts

@@ -469,6 +469,8 @@ export interface ListsOperations {
       page?: number;
       /** Items per page (max 200) */
       limit?: number;
+      /** Case-insensitive substring match on the list title. Omit for every list. */
+      search?: string | null;
     };
     headers?: {
       "X-Target-Org-Id"?: string | null;
@@ -1016,6 +1018,10 @@ export interface ListResponse {
   /** Source of the list */
   source?: string | null;
   status?: string | null;
+  /** Human-readable explanation of status_reason. */
+  status_detail?: string | null;
+  /** Why the list is not usable, or null when it is fine: 'import_failed' (a file import raised; status_detail carries the reason when known), 'import_not_finished' (an uploaded list still processing with no records an hour after it was created: the import never ran) or 'build_failed' (a list built another way, e.g. from Search, failed; re-run it from its source). */
+  status_reason?: string | null;
   tags?: Array<string>;
   title: string;
   total?: number;

package/docs/api/lists.md

@@ -1063,7 +1063,7 @@ const result = await g8.api.lists.listListFolders();
 - API-key scope: `lists:read`
 - ★ Hand-written: [`g8.lists.list()`](../sdk-clients.md#g8-lists-list)
 
-List all lists (audiences) in the organization.
+List all lists (audiences) in the organization, optionally filtered by title.
 
 **Input**
 
@@ -1071,6 +1071,7 @@ List all lists (audiences) in the organization.
 |---|---|---|---|
 | `query.page` | `integer` | no | Page number (1-indexed) default `1` |
 | `query.limit` | `integer` | no | Items per page (max 200) default `50` |
+| `query.search` | `string \| null` | no | Case-insensitive substring match on the list title. Omit for every list. |
 
 **Returns** `ApiResponse_list_ListResponse__`: the envelope `{ data: Array<ListResponse>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
 
@@ -1090,6 +1091,8 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `is_dynamic` | `boolean` | no | default `false` |
 | `source` | `string \| null` | no | Source of the list |
 | `status` | `string \| null` | no |  |
+| `status_detail` | `string \| null` | no | Human-readable explanation of status_reason. |
+| `status_reason` | `string \| null` | no | Why the list is not usable, or null when it is fine: 'import_failed' (a file import raised; status_detail carries the reason when known), 'import_not_finished' (an uploaded list still processing with no records an hour after it was created: the import never ran) or 'build_failed' (a list built another way, e.g. from Search, failed; re-run it from its source). |
 | `tags` | `Array<string>` | no |  |
 | `total` | `integer` | no | default `0` |
 | `type` | `string \| null` | no | List type (contacts, companies, suppressions, deals, leads) |
@@ -1504,6 +1507,8 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `is_dynamic` | `boolean` | no | default `false` |
 | `source` | `string \| null` | no | Source of the list |
 | `status` | `string \| null` | no |  |
+| `status_detail` | `string \| null` | no | Human-readable explanation of status_reason. |
+| `status_reason` | `string \| null` | no | Why the list is not usable, or null when it is fine: 'import_failed' (a file import raised; status_detail carries the reason when known), 'import_not_finished' (an uploaded list still processing with no records an hour after it was created: the import never ran) or 'build_failed' (a list built another way, e.g. from Search, failed; re-run it from its source). |
 | `tags` | `Array<string>` | no |  |
 | `total` | `integer` | no | default `0` |
 | `type` | `string \| null` | no | List type (contacts, companies, suppressions, deals, leads) |

package/docs/api/seo.d.ts

@@ -1,7 +1,7 @@
 /* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
 
 /**
- * Types for `g8.api.seo` (SEO): 11 operations.
+ * Types for `g8.api.seo` (SEO): 14 operations.
  *
  * For reading. In code, import from the package instead:
  *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
@@ -18,7 +18,10 @@ export interface SeoMembers {
   getSeoDomainBacklinks: "get_seo_domain_backlinks_seo_domains__domain__backlinks_get";
   getSeoDomainOverview: "get_seo_domain_overview_seo_domains__domain__overview_get";
   getSeoRankHistory: "get_seo_rank_history_seo_rank_tracking__keyword_id__history_get";
+  getSeoTrackedDomain: "get_seo_tracked_domain_seo_domains_tracked__domain__get";
   listSeoAudits: "list_seo_audits_seo_audits_get";
+  listSeoDomainPages: "list_seo_domain_pages_seo_domains_tracked__domain__pages_get";
+  listSeoTrackedDomains: "list_seo_tracked_domains_seo_domains_tracked_get";
   listSeoTrackedKeywords: "list_seo_tracked_keywords_seo_rank_tracking_get";
   removeSeoTrackedKeywords: "remove_seo_tracked_keywords_seo_rank_tracking_keywords_remove_post";
   researchSeoKeywords: "research_seo_keywords_seo_keywords_research_post";
@@ -115,6 +118,23 @@ export interface SeoOperations {
   };
     output: ApiResponse_SeoRankHistory_;
   };
+  /**
+   * GET /seo/domains/tracked/{domain}
+   * Get Seo Tracked Domain
+   * tier: read · scope: intent:read
+   */
+  get_seo_tracked_domain_seo_domains_tracked__domain__get: {
+    input: {
+    path: {
+      /** A saved domain from `GET /seo/domains/tracked`. */
+      domain: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SeoTrackedDomainDetail_;
+  };
   /**
    * GET /seo/audits
    * List Seo Audits
@@ -131,6 +151,47 @@ export interface SeoOperations {
   };
     output: ApiResponse_List_SeoAudit__;
   };
+  /**
+   * GET /seo/domains/tracked/{domain}/pages
+   * List Seo Domain Pages
+   * tier: read · scope: intent:read
+   */
+  list_seo_domain_pages_seo_domains_tracked__domain__pages_get: {
+    input: {
+    path: {
+      /** A saved domain from `GET /seo/domains/tracked`. */
+      domain: string;
+    };
+    query?: {
+      /** Rows to skip (the saved pages are capped at 1,000). */
+      offset?: number;
+      /** Rows to return. */
+      limit?: number;
+      /** Sort column: estimated_traffic, ranking_keywords_count, best_position, url, traffic_change_30d or audit_issues. */
+      sort?: string;
+      order?: "asc" | "desc";
+      /** Only pages whose URL contains this text. */
+      q?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SeoDomainPages_;
+  };
+  /**
+   * GET /seo/domains/tracked
+   * List Seo Tracked Domains
+   * tier: read · scope: intent:read
+   */
+  list_seo_tracked_domains_seo_domains_tracked_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SeoTrackedDomains_;
+  };
   /**
    * GET /seo/rank-tracking
    * List Seo Tracked Keywords
@@ -206,7 +267,7 @@ export interface SeoOperations {
   };
 }
 
-// 27 schemas referenced above (the same as G8Contract.<Name>).
+// 37 schemas referenced above (the same as G8Contract.<Name>).
 
 export interface ApiResponse_List_SeoAudit__ {
   data: Array<SeoAudit>;
@@ -238,6 +299,11 @@ export interface ApiResponse_SeoDomainOverviewResponse_ {
   pagination?: PaginationMeta | null;
 }
 
+export interface ApiResponse_SeoDomainPages_ {
+  data: SeoDomainPages;
+  pagination?: PaginationMeta | null;
+}
+
 export interface ApiResponse_SeoRankHistory_ {
   data: SeoRankHistory;
   pagination?: PaginationMeta | null;
@@ -253,6 +319,16 @@ export interface ApiResponse_SeoResearchKeywordsResponse_ {
   pagination?: PaginationMeta | null;
 }
 
+export interface ApiResponse_SeoTrackedDomainDetail_ {
+  data: SeoTrackedDomainDetail;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SeoTrackedDomains_ {
+  data: SeoTrackedDomains;
+  pagination?: PaginationMeta | null;
+}
+
 export interface PaginationMeta {
   /** Whether there are more pages */
   has_next: boolean;
@@ -335,6 +411,16 @@ export interface SeoBacklinksOverview {
   total_backlinks?: number | null;
 }
 
+/**
+ * Mirrors `DomainChangeDTO`: the current snapshot against the one nearest
+ * 30 days back. `traffic_pct` is null when the baseline traffic was zero.
+ */
+export interface SeoDomainChange {
+  keywords_delta?: number | null;
+  since?: string | null;
+  traffic_pct?: number | null;
+}
+
 /**
  * Mirrors `DomainOverviewResponse`. `data_freshness` labels how old the
  * provider's view of the domain is - research surfaces must say.
@@ -346,6 +432,29 @@ export interface SeoDomainOverviewResponse {
   top_pages: Array<Record<string, unknown>>;
 }
 
+/** Mirrors `DomainPageDTO`. */
+export interface SeoDomainPage {
+  audit_issues?: number | null;
+  best_position?: number | null;
+  estimated_traffic: number;
+  ranking_keywords_count: number;
+  top_keyword?: string | null;
+  traffic_change_30d?: number | null;
+  url: string;
+}
+
+/**
+ * Mirrors `DomainPagesResponse`. `refreshed_at` is null when the pages
+ * were never fetched; `total` counts every saved page, `rows` is one page.
+ */
+export interface SeoDomainPages {
+  audit_completed_at?: string | null;
+  cap: number;
+  refreshed_at?: string | null;
+  rows: Array<SeoDomainPage>;
+  total: number;
+}
+
 /** Mirrors `KeywordRow`. */
 export interface SeoKeywordRow {
   competition?: number;
@@ -437,6 +546,64 @@ export interface SeoTrackKeywordItem {
   search_volume?: number | null;
 }
 
+/**
+ * Mirrors `TrackedDomainDTO`. `kind` is `own` for the organisation's own
+ * sites and `competitor` for the Radar competitors shown beside them.
+ */
+export interface SeoTrackedDomain {
+  change_30d?: SeoDomainChange | null;
+  domain: string;
+  is_primary?: boolean;
+  kind: "own" | "competitor";
+  metrics?: SeoTrackedDomainMetrics | null;
+  name?: string | null;
+  snapshot_at?: string | null;
+}
+
+/**
+ * Mirrors `TrackedDomainDetailResponse`: one domain's saved snapshot,
+ * rendered without any paid call. Empty until the first refresh in the app.
+ */
+export interface SeoTrackedDomainDetail {
+  backlinks?: SeoBacklinksOverview | null;
+  change_30d?: SeoDomainChange | null;
+  data_freshness?: string;
+  domain: string;
+  is_primary?: boolean;
+  kind: "own" | "competitor";
+  metrics?: SeoTrackedDomainMetrics | null;
+  name?: string | null;
+  overview?: Record<string, unknown> | null;
+  refreshed?: boolean;
+  snapshot_at?: string | null;
+  top_keywords?: Array<Record<string, unknown>>;
+  top_pages?: Array<Record<string, unknown>>;
+}
+
+/** Mirrors `TrackedDomainMetricsDTO`. */
+export interface SeoTrackedDomainMetrics {
+  authority_score?: number | null;
+  estimated_traffic?: number | null;
+  organic_keywords?: number | null;
+  referring_domains?: number | null;
+  top3_positions?: number | null;
+}
+
+/**
+ * Mirrors `TrackedDomainsResponse`: the saved domains (own first, primary
+ * first, then competitors) plus the credit price of each paid refresh, so a
+ * caller can quote the cost before anyone asks for one.
+ */
+export interface SeoTrackedDomains {
+  domains: Array<SeoTrackedDomain>;
+  max_own_domains: number;
+  page_keywords_credits: number;
+  page_keywords_limit: number;
+  pages_cap: number;
+  pages_max_credits: number;
+  refresh_credits: number;
+}
+
 /** Mirrors `TrackedKeywordDTO`. */
 export interface SeoTrackedKeyword {
   cadence: string;