@graph8/sdk 0.265.0 → 0.277.0

package/docs/api/apps.d.ts

@@ -713,10 +713,16 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }
 
 /**

package/docs/api/apps.md

@@ -504,11 +504,13 @@ Can this app be built and run yet, and if not, what is missing (M9 J9).
 
 ANSWERS FROM THE CONTROL PLANE, AND SAYS SO. It reports what graph8 has
 recorded: a bound source, an assigned hostname, declared secrets, the last
-deployment's state. It does NOT claim the cluster side is ready, because the
-namespace provisioner, the image registry and the runtime objects are
-separate, unbuilt work. Reporting `ready: true` on that basis would be the
-most expensive kind of wrong: a builder would push and wait for something
-nothing can serve.
+deployment's state. The serving half -- namespace provisioner, registry
+credentials, and the deployed-image rollout -- now EXISTS as control-plane code
+(#22301), so this no longer blocks on it unconditionally. What it still checks
+is whether that code is CONFIGURED in this environment (`_unset_serving_runtime_vars`):
+reporting `ready: true` with the templates or registry credentials unset would
+be the most expensive kind of wrong, because a builder would push and wait for
+something nothing can serve.
 
 `blockers` is the field that matters. An agent driving a build needs to know
 WHY it cannot proceed; a bare `ready: false` sends it guessing, and guessing

package/docs/api/assertUpsert.d.ts

@@ -146,6 +146,8 @@ export interface BatchAssertResponse {
   errors?: Array<Record<string, unknown>>;
   total: number;
   updated?: number;
+  /** Advisory notes about values saved as sent that look wrong (e.g. an unrecognised seniority or country), prefixed with the row index. Empty when the input is clean. */
+  warnings?: Array<string>;
 }
 
 export interface BatchCompanyAssertRequest {
@@ -193,6 +195,8 @@ export interface CompanyAssertResponse {
   action: string;
   count?: number;
   custom_fields?: CustomFieldWriteReport;
+  /** Advisory notes about values saved as sent that look wrong (e.g. an unrecognised country). Empty when the input is clean. */
+  warnings?: Array<string>;
 }
 
 export interface ContactAssertRequest {
@@ -225,6 +229,8 @@ export interface ContactAssertResponse {
   action: string;
   count?: number;
   custom_fields?: CustomFieldWriteReport;
+  /** Advisory notes about values saved as sent that look wrong (e.g. an unrecognised seniority or country). Empty when the input is clean. */
+  warnings?: Array<string>;
 }
 
 /**
@@ -279,8 +285,14 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }

package/docs/api/assertUpsert.md

@@ -71,6 +71,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `custom_fields` | `CustomFieldWriteReport` | no |  |
 | `errors` | `Array<Record<string, unknown>>` | no | default `[]` |
 | `updated` | `integer` | no | default `0` |
+| `warnings` | `Array<string>` | no | Advisory notes about values saved as sent that look wrong (e.g. an unrecognised seniority or country), prefixed with the row index. Empty when the input is clean. |
 
 **Example**
 
@@ -129,6 +130,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `action` | `string` | yes | 'created' or 'updated' |
 | `count` | `integer` | no | default `1` |
 | `custom_fields` | `CustomFieldWriteReport` | no |  |
+| `warnings` | `Array<string>` | no | Advisory notes about values saved as sent that look wrong (e.g. an unrecognised country). Empty when the input is clean. |
 
 **Example**
 
@@ -191,6 +193,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `action` | `string` | yes | 'created' or 'updated' |
 | `count` | `integer` | no | default `1` |
 | `custom_fields` | `CustomFieldWriteReport` | no |  |
+| `warnings` | `Array<string>` | no | Advisory notes about values saved as sent that look wrong (e.g. an unrecognised seniority or country). Empty when the input is clean. |
 
 **Example**
 
@@ -240,6 +243,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `custom_fields` | `CustomFieldWriteReport` | no |  |
 | `errors` | `Array<Record<string, unknown>>` | no | default `[]` |
 | `updated` | `integer` | no | default `0` |
+| `warnings` | `Array<string>` | no | Advisory notes about values saved as sent that look wrong (e.g. an unrecognised seniority or country), prefixed with the row index. Empty when the input is clean. |
 
 **Example**
 

package/docs/api/audienceSyncs.d.ts

@@ -234,10 +234,16 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }
 
 export interface SyncErrorResponse {

package/docs/api/brandKit.d.ts

@@ -593,10 +593,16 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }
 
 /**

package/docs/api/bugReports.d.ts

@@ -174,8 +174,14 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }

package/docs/api/by-path.md

@@ -2367,6 +2367,7 @@ Every Developer API route, sorted by path, with the SDK call that reaches it. Th
 | GET | `/api/v1/roles` | [`g8.api.roles.listRoles`](roles.md#op-listroles) | read |
 | POST | `/api/v1/roles` | [`g8.api.roles.createRole`](roles.md#op-createrole) | write |
 | GET | `/api/v1/roles/domain-settings` | [`g8.api.roles.getDomainSettings`](roles.md#op-getdomainsettings) | read |
+| POST | `/api/v1/roles/invite` | [`g8.api.roles.inviteMember`](roles.md#op-invitemember) | external |
 | GET | `/api/v1/roles/join-requests` | [`g8.api.roles.listJoinRequests`](roles.md#op-listjoinrequests) | read |
 | GET | `/api/v1/roles/join-requests/count` | [`g8.api.roles.getJoinRequestCount`](roles.md#op-getjoinrequestcount) | read |
 | POST | `/api/v1/roles/join-requests/{request_id}/reject` | [`g8.api.roles.rejectJoinRequest`](roles.md#op-rejectjoinrequest) | write |

package/docs/api/calendarInvites.d.ts

@@ -110,8 +110,14 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }

package/docs/api/campaignWorkflows.d.ts

@@ -145,8 +145,14 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }

package/docs/api/campaigns.d.ts

@@ -674,10 +674,16 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }
 
 /**

package/docs/api/channels.d.ts

@@ -151,10 +151,16 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }
 
 /**

package/docs/api/cliCampaigns.d.ts

@@ -164,10 +164,16 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }
 
 export interface developer_api__interfaces__v1__cli_campaigns_router__CampaignCreateRequest {

package/docs/api/cliPipelines.d.ts

@@ -256,10 +256,16 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }
 
 export interface PipelineCreateRequest {

package/docs/api/clickHouse.d.ts

@@ -108,8 +108,14 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }

package/docs/api/companies.d.ts

@@ -633,9 +633,9 @@ export interface CompaniesOperations {
       employee_count_min?: number | null;
       /** Maximum employee count */
       employee_count_max?: number | null;
-      /** Filter by country (exact match) */
+      /** Filter by country (exact match, case-insensitive; surrounding spaces ignored). Common aliases match each other: United States = US = USA; United Kingdom = UK. */
       country?: string | null;
-      /** Filter by state (exact match) */
+      /** Filter by state (exact match, case-insensitive; surrounding spaces ignored) */
       state?: string | null;
       /** Filter by city (partial match) */
       city?: string | null;
@@ -1204,6 +1204,8 @@ export interface CompanyCreateResponse {
   company_id?: number | null;
   merged?: boolean;
   status: string;
+  /** Advisory notes about values that look wrong (e.g. an employee_count with no number, an unrecognised country, or a linkedin_url that is not a web address and was not saved). Empty when the input is clean. */
+  warnings?: Array<string>;
 }
 
 /** Lighter company representation for list endpoints. */
@@ -1526,10 +1528,16 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }
 
 /** Attach the output of a skill run to a record as a document. */

package/docs/api/companies.md

@@ -297,6 +297,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `status` | `string` | yes |  |
 | `company_id` | `integer \| null` | no |  |
 | `merged` | `boolean` | no | default `false` |
+| `warnings` | `Array<string>` | no | Advisory notes about values that look wrong (e.g. an employee_count with no number, an unrecognised country, or a linkedin_url that is not a web address and was not saved). Empty when the input is clean. |
 
 **Example**
 
@@ -1354,8 +1355,8 @@ List companies with optional filtering and pagination.
 | `query.name` | `string \| null` | no | Filter by company name (partial match) |
 | `query.employee_count_min` | `integer \| null` | no | Minimum employee count |
 | `query.employee_count_max` | `integer \| null` | no | Maximum employee count |
-| `query.country` | `string \| null` | no | Filter by country (exact match) |
-| `query.state` | `string \| null` | no | Filter by state (exact match) |
+| `query.country` | `string \| null` | no | Filter by country (exact match, case-insensitive; surrounding spaces ignored). Common aliases match each other: United States = US = USA; United Kingdom = UK. |
+| `query.state` | `string \| null` | no | Filter by state (exact match, case-insensitive; surrounding spaces ignored) |
 | `query.city` | `string \| null` | no | Filter by city (partial match) |
 | `query.description` | `string \| null` | no | Filter by company description (partial match) |
 | `query.revenue_min` | `integer \| null` | no | Minimum annual revenue |
@@ -2068,6 +2069,12 @@ const result = await g8.api.companies.startCompanyWorkflow({ path: { company_id:
 
 Update a company's fields (partial update).
 
+A ``name`` over 512 characters or a ``linkedin_url`` that is not a web
+address is refused with a 400 and nothing is written. An employee_count
+with no number, an unrecognised country, or a linkedin_url that is not on
+linkedin.com is saved as sent and flagged in ``warnings`` (present only
+when there is something to flag).
+
 **Input**
 
 | Field | Type | Required | Description |

package/docs/api/companyIntelligence.d.ts

@@ -292,8 +292,14 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }

package/docs/api/contacts.d.ts

@@ -844,7 +844,7 @@ export interface ContactsOperations {
       page?: number;
       /** Items per page (max 200) */
       limit?: number;
-      /** Filter by work email (exact match) */
+      /** Filter by work email (exact match, case-insensitive; surrounding spaces ignored) */
       email?: string | null;
       /** Filter by list ID */
       list_id?: number | null;
@@ -852,15 +852,15 @@ export interface ContactsOperations {
       name?: string | null;
       /** Filter by job title (partial match) */
       job_title?: string | null;
-      /** Filter by seniority level (exact match) */
+      /** Filter by seniority level (exact match, case-insensitive). Spellings of the same level match each other: VP = Vice President; SVP/EVP = SVP = EVP = Senior/Executive Vice President; C-Suite = C-Level = CXO. Pass several levels comma-separated to match any of them, e.g. `VP,SVP/EVP`. */
       seniority_level?: string | null;
       /** Filter by company name (partial match) */
       company_name?: string | null;
       /** Filter by company ID */
       company_id?: number | null;
-      /** Filter by country (exact match) */
+      /** Filter by country (exact match, case-insensitive; surrounding spaces ignored). Common aliases match each other: United States = US = USA; United Kingdom = UK. */
       country?: string | null;
-      /** Filter by state (exact match) */
+      /** Filter by state (exact match, case-insensitive; surrounding spaces ignored) */
       state?: string | null;
       /** Filter by city (partial match) */
       city?: string | null;
@@ -1540,6 +1540,8 @@ export interface ContactCreateResponse {
   merged?: boolean;
   status: string;
   validation_errors?: Array<string>;
+  /** Advisory notes about values saved as sent that look wrong (e.g. an unrecognised seniority or country). Empty when the input is clean. */
+  warnings?: Array<string>;
 }
 
 /** Mirrors `campaign_builder.models.contact_documents.UpdateContactDocumentRequest`. */
@@ -1553,8 +1555,14 @@ export interface ContactDocumentUpdateRequest {
 /** Lighter contact representation for list endpoints. */
 export interface ContactListItem {
   city?: string | null;
+  company_domain?: string | null;
+  company_employee_count?: string | null;
   company_id?: number | null;
+  company_industry?: string | null;
+  company_name?: string | null;
+  company_website?: string | null;
   country?: string | null;
+  created_at?: string | null;
   custom_fields?: (Record<string, string | null>) | null;
   direct_phone?: string | null;
   first_name?: string | null;
@@ -1568,6 +1576,7 @@ export interface ContactListItem {
   owner_name?: string | null;
   seniority_level?: string | null;
   state?: string | null;
+  updated_at?: string | null;
   work_email?: string | null;
 }
 
@@ -1930,10 +1939,16 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }
 
 /**

package/docs/api/contacts.md

@@ -245,7 +245,7 @@ const result = await g8.api.contacts.batchContactRelated({ body: { contact_ids:
 Full records for up to 100 contacts in ONE request. Writes nothing.
 
 Use this instead of looping `GET /contacts/{contact_id}`: `GET /contacts`
-returns 17 fields per contact, and the loop spends one rate-limit slot per
+returns a lean summary per contact, and the loop spends one rate-limit slot per
 contact to get the other fields. Each item is exactly what the per-contact
 route returns, through the same access check. A contact that does not exist
 or is outside the key's scope comes back `found: false`, rather than failing
@@ -544,6 +544,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `custom_fields` | `CustomFieldWriteReport` | no |  |
 | `merged` | `boolean` | no | default `false` |
 | `validation_errors` | `Array<string>` | no |  |
+| `warnings` | `Array<string>` | no | Advisory notes about values saved as sent that look wrong (e.g. an unrecognised seniority or country). Empty when the input is clean. |
 
 **Example**
 
@@ -1879,15 +1880,15 @@ List contacts with optional filtering and pagination.
 |---|---|---|---|
 | `query.page` | `integer` | no | Page number (1-indexed) default `1` |
 | `query.limit` | `integer` | no | Items per page (max 200) default `50` |
-| `query.email` | `string \| null` | no | Filter by work email (exact match) |
+| `query.email` | `string \| null` | no | Filter by work email (exact match, case-insensitive; surrounding spaces ignored) |
 | `query.list_id` | `integer \| null` | no | Filter by list ID |
 | `query.name` | `string \| null` | no | Filter by first or last name (partial match) |
 | `query.job_title` | `string \| null` | no | Filter by job title (partial match) |
-| `query.seniority_level` | `string \| null` | no | Filter by seniority level (exact match) |
+| `query.seniority_level` | `string \| null` | no | Filter by seniority level (exact match, case-insensitive). Spellings of the same level match each other: VP = Vice President; SVP/EVP = SVP = EVP = Senior/Executive Vice President; C-Suite = C-Level = CXO. Pass several levels comma-separated to match any of them, e.g. `VP,SVP/EVP`. |
 | `query.company_name` | `string \| null` | no | Filter by company name (partial match) |
 | `query.company_id` | `integer \| null` | no | Filter by company ID |
-| `query.country` | `string \| null` | no | Filter by country (exact match) |
-| `query.state` | `string \| null` | no | Filter by state (exact match) |
+| `query.country` | `string \| null` | no | Filter by country (exact match, case-insensitive; surrounding spaces ignored). Common aliases match each other: United States = US = USA; United Kingdom = UK. |
+| `query.state` | `string \| null` | no | Filter by state (exact match, case-insensitive; surrounding spaces ignored) |
 | `query.city` | `string \| null` | no | Filter by city (partial match) |
 | `query.job_department` | `string \| null` | no | Filter by job department (partial match) |
 | `query.industry` | `string \| null` | no | Filter by company industry (partial match) |
@@ -1902,8 +1903,14 @@ Other envelope fields: `pagination` (PaginationMeta).
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `city` | `string \| null` | no |  |
+| `company_domain` | `string \| null` | no |  |
+| `company_employee_count` | `string \| null` | no |  |
 | `company_id` | `integer \| null` | no |  |
+| `company_industry` | `string \| null` | no |  |
+| `company_name` | `string \| null` | no |  |
+| `company_website` | `string \| null` | no |  |
 | `country` | `string \| null` | no |  |
+| `created_at` | `string \| null` | no |  |
 | `custom_fields` | `Record<string, string \| null> \| null` | no |  |
 | `direct_phone` | `string \| null` | no |  |
 | `first_name` | `string \| null` | no |  |
@@ -1917,6 +1924,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `owner_name` | `string \| null` | no |  |
 | `seniority_level` | `string \| null` | no |  |
 | `state` | `string \| null` | no |  |
+| `updated_at` | `string \| null` | no |  |
 | `work_email` | `string \| null` | no |  |
 
 **Example**

package/docs/api/content.d.ts

@@ -893,10 +893,16 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }
 
 /**

package/docs/api/contentGridSkills.d.ts

@@ -170,8 +170,14 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }

package/docs/api/copilot.d.ts

@@ -819,10 +819,16 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }
 
 /** Mirror of `PersonalContactChoiceRequest`. */

package/docs/api/crmSyncs.d.ts

@@ -208,8 +208,14 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }

package/docs/api/customerSuccess.d.ts

@@ -484,8 +484,14 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }

package/docs/api/deals.d.ts

@@ -1652,10 +1652,16 @@ export interface PaginationMeta {
   limit: number;
   /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
   next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
   /** Current page number (1-indexed) */
   page: number;
   /** Total number of items */
   total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
 }
 
 export interface PipelineResponse {