@graph8/sdk 0.362.0 → 0.370.0

package/docs/api/by-path.md

@@ -975,6 +975,7 @@ Every Developer API route, sorted by path, with the SDK call that reaches it. Th
 | POST | `/api/v1/desk/batch/start` | [`g8.api.desk.startDeskBatch`](desk.md#op-startdeskbatch) | write |
 | GET | `/api/v1/desk/blocks` | [`g8.api.desk.listDeskBlocks`](desk.md#op-listdeskblocks) | read |
 | GET | `/api/v1/desk/blocks/{list_id}/queue` | [`g8.api.desk.getDeskBlockQueue`](desk.md#op-getdeskblockqueue) | read |
+| POST | `/api/v1/desk/cards` | [`g8.api.desk.createDeskCard`](desk.md#op-createdeskcard) | write |
 | GET | `/api/v1/desk/committee-heat` | [`g8.api.desk.getDeskCommitteeHeat`](desk.md#op-getdeskcommitteeheat) | read |
 | GET | `/api/v1/desk/committee-targets` | [`g8.api.desk.getDeskCommitteeTargets`](desk.md#op-getdeskcommitteetargets) | read |
 | GET | `/api/v1/desk/compliance-summary` | [`g8.api.desk.getDeskComplianceSummary`](desk.md#op-getdeskcompliancesummary) | read |

package/docs/api/desk.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.desk` (Desk): 71 operations.
+ * Types for `g8.api.desk` (Desk): 72 operations.
  *
  * For reading. In code, import from the package instead:
  *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
@@ -17,6 +17,7 @@ export interface DeskMembers {
   askDesk: "ask_desk_desk_ask_post";
   checkCommitteePlay: "check_committee_play_desk_accounts__account_id__committee_plays__action_id__check_get";
   checkDeskPlanStageSweep: "check_desk_plan_stage_sweep_desk_org_settings_plan_stages_check_get";
+  createDeskCard: "create_desk_card_desk_cards_post";
   createOrReplanAccountPlan: "create_or_replan_account_plan_desk_accounts__account_id__plan_post";
   decideDeskPlayApproval: "decide_desk_play_approval_desk_plays_approvals__execution_id__decide_post";
   draftAccountPlan: "draft_account_plan_desk_accounts__account_id__plan_draft_post";
@@ -152,6 +153,20 @@ export interface DeskOperations {
   };
     output: ApiResponse_DeskPayload_;
   };
+  /**
+   * POST /desk/cards
+   * Create Desk Card
+   * tier: write · scope: deals:write
+   */
+  create_desk_card_desk_cards_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DeskCardCreateRequest;
+  };
+    output: ApiResponse_DeskCardResult_;
+  };
   /**
    * POST /desk/accounts/{account_id}/plan
    * Create Or Replan Account Plan
@@ -1273,7 +1288,7 @@ export interface DeskOperations {
   };
 }
 
-// 40 schemas referenced above (the same as G8Contract.<Name>).
+// 47 schemas referenced above (the same as G8Contract.<Name>).
 
 /**
  * Persist the approved steps as a NEW plan version.
@@ -1388,6 +1403,11 @@ export interface ApiResponse_DeskBatch_ {
   pagination?: PaginationMeta | null;
 }
 
+export interface ApiResponse_DeskCardResult_ {
+  data: DeskCardResult;
+  pagination?: PaginationMeta | null;
+}
+
 export interface ApiResponse_DeskDecisionListResponse_ {
   data: DeskDecisionListResponse;
   pagination?: PaginationMeta | null;
@@ -1537,6 +1557,82 @@ export interface DeskBatchStartRequest {
   tz_offset?: number;
 }
 
+export interface DeskCardContext {
+  /** Bullets under what we know. Empty ones are dropped. */
+  facts?: Array<string>;
+  /** The columns the card was built from, shown as chips. */
+  fields?: Record<string, string>;
+  persona?: string | null;
+  /** The one-line reason, shown at the top of the card. */
+  why?: string | null;
+}
+
+export interface DeskCardCreateRequest {
+  /** The contact's company, when it is not the contact's own. */
+  account_id?: number | null;
+  /** email, linkedin or call. */
+  channel: string;
+  /** The contact the touch is for. */
+  contact_id: number;
+  context?: DeskCardContext | null;
+  draft?: DeskCardDraft | null;
+  /** When the touch is due. It orders the queue and never hides the card. */
+  due_at?: string | null;
+  /** Your own key for this touch. Posting it again updates the unsent card. Keys are kept apart by `origin.kind`; with no `origin.kind` the key must be unique across the org. */
+  external_key?: string | null;
+  list_id?: number | null;
+  origin?: DeskCardOrigin | null;
+  /** Whose desk: a team member's email, id or user id. */
+  owner_id: string;
+  /** low, normal, high or urgent. */
+  priority?: string;
+  sender?: DeskCardSender | null;
+  /** The touch number in the list's cadence. */
+  touch?: number | null;
+}
+
+/**
+ * Shaped by the channel. email: subject, body. linkedin: kind (connect or
+ * message), message, a connect note at most 300 characters. call:
+ * talking_points, questions, handoff_line.
+ */
+export interface DeskCardDraft {
+  body?: string | null;
+  handoff_line?: string | null;
+  kind?: string | null;
+  /** A connect note is at most 300 characters. */
+  message?: string | null;
+  questions?: Array<string>;
+  subject?: string | null;
+  talking_points?: Array<string>;
+}
+
+export interface DeskCardOrigin {
+  /** Who planned it, e.g. "list_plan" or "workflow". */
+  kind?: string | null;
+  mapping?: string | null;
+}
+
+export interface DeskCardResult {
+  card_id: string;
+  due_at?: string | null;
+  note?: string | null;
+  /** "queued" until the rep acts on it. */
+  status?: string | null;
+  /** True when this body updated a card already on the desk. */
+  updated?: boolean;
+  url?: string | null;
+}
+
+export interface DeskCardSender {
+  /** Not used: LinkedIn sends from the rep's own connected account. */
+  linkedin_seat_id?: string | null;
+  /** Email address the card sends from. Checked against the rep's send rights when the rep sends. */
+  mailbox?: string | null;
+  /** Not used: email sends from `mailbox`, else the rep's own mailbox. */
+  mailbox_id?: string | null;
+}
+
 /** One card in the queue: something the desk thinks a rep should do next. */
 export interface DeskDecision {
   created_at?: string | null;

package/docs/api/desk.md

@@ -2,7 +2,7 @@
 
 # `g8.api.desk`: Desk
 
-71 operations (38 read, 15 write, 10 billable, 8 external).
+72 operations (38 read, 16 write, 10 billable, 8 external).
 
 No hand-written client covers this area. Call it through `g8.api.desk.*` as shown below, or by operationId with `g8.api.call(operationId, input)`.
 
@@ -26,6 +26,7 @@ Exact TypeScript types for every operation on this page, and every schema they u
 | [`askDesk`](#op-askdesk) | `POST /api/v1/desk/ask` | billable | `deals:run` | Ask Desk |
 | [`checkCommitteePlay`](#op-checkcommitteeplay) | `GET /api/v1/desk/accounts/{account_id}/committee/plays/{action_id}/check` | read | `deals:read` | Check Committee Play |
 | [`checkDeskPlanStageSweep`](#op-checkdeskplanstagesweep) | `GET /api/v1/desk/org-settings/plan-stages/check` | read | `deals:read` | Check Desk Plan Stage Sweep |
+| [`createDeskCard`](#op-createdeskcard) | `POST /api/v1/desk/cards` | write | `deals:write` | Create Desk Card |
 | [`createOrReplanAccountPlan`](#op-createorreplanaccountplan) | `POST /api/v1/desk/accounts/{account_id}/plan` | write | `deals:write` | Create Or Replan Account Plan |
 | [`decideDeskPlayApproval`](#op-decidedeskplayapproval) | `POST /api/v1/desk/plays/approvals/{execution_id}/decide` | external | `deals:run` | Decide Desk Play Approval |
 | [`draftAccountPlan`](#op-draftaccountplan) | `POST /api/v1/desk/accounts/{account_id}/plan/draft` | billable | `deals:run` | Draft Account Plan |
@@ -256,6 +257,81 @@ const result = await g8.api.desk.checkDeskPlanStageSweep();
 
 ---
 
+<a id="op-createdeskcard"></a>
+
+### `g8.api.desk.createDeskCard(input)`
+
+**Create Desk Card**
+
+- HTTP: `POST /api/v1/desk/cards`
+- operationId: `create_desk_card_desk_cards_post` (also callable as `g8.api.call("create_desk_card_desk_cards_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `deals:write`
+
+Put one planned touch on a rep's desk, with its why, facts, fields and draft.
+
+201 when the card is made. The same touch posted again (same
+`external_key`, else the same `list_id` + `contact_id` + `touch`, else the
+same rep, contact, channel and due day) while the card is unsent answers
+200 with the same `card_id` and `updated: true`. An `external_key` is
+kept apart per `origin.kind`, so two integrations may both use "1"; a
+body with no `origin.kind` shares one namespace with every other such
+caller in the org, so its key must be unique across the org. Once the rep has sent or
+decided it, a re-post makes a new card. A card the desk will not make is a
+4xx whose `detail.reason` says why. A personal key may name only its own
+holder (403 `owner_not_self`); an org key may name any active rep.
+The key must be allowed to see the contact (and the account when one is
+named, else the contact's own company), checked the way the contacts and deals routes check a record id
+from a body; one it may not see is 403 `contact_not_allowed` /
+`account_not_allowed` and no card is made.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `DeskCardCreateRequest` | yes | Request body; fields below. |
+
+Body fields (`DeskCardCreateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.channel` | `string` | yes | email, linkedin or call. min length 1, max length 32 |
+| `body.contact_id` | `integer` | yes | The contact the touch is for. max 9223372036854776000, > 0 |
+| `body.owner_id` | `string` | yes | Whose desk: a team member's email, id or user id. min length 1, max length 320 |
+| `body.account_id` | `integer \| null` | no | The contact's company, when it is not the contact's own. max 9223372036854776000, > 0 |
+| `body.context` | `DeskCardContext \| null` | no |  |
+| `body.draft` | `DeskCardDraft \| null` | no |  |
+| `body.due_at` | `string (date-time) \| null` | no | When the touch is due. It orders the queue and never hides the card. |
+| `body.external_key` | `string \| null` | no | Your own key for this touch. Posting it again updates the unsent card. Keys are kept apart by `origin.kind`; with no `origin.kind` the key must be unique across the org. max length 200 |
+| `body.list_id` | `integer \| null` | no | max 9223372036854776000, > 0 |
+| `body.origin` | `DeskCardOrigin \| null` | no |  |
+| `body.priority` | `string` | no | low, normal, high or urgent. default `"normal"`, max length 16 |
+| `body.sender` | `DeskCardSender \| null` | no |  |
+| `body.touch` | `integer \| null` | no | The touch number in the list's cadence. min 1, max 1000 |
+
+**Returns** `ApiResponse_DeskCardResult_`: the envelope `{ data: DeskCardResult, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`DeskCardResult` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `card_id` | `string` | yes |  |
+| `due_at` | `string \| null` | no |  |
+| `note` | `string \| null` | no |  |
+| `status` | `string \| null` | no | "queued" until the rep acts on it. |
+| `updated` | `boolean` | no | True when this body updated a card already on the desk. default `false` |
+| `url` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.desk.createDeskCard({ body: { channel: "example", contact_id: 1, owner_id: "id" } });
+```
+
+---
+
 <a id="op-createorreplanaccountplan"></a>
 
 ### `g8.api.desk.createOrReplanAccountPlan(input)`
@@ -2976,6 +3052,52 @@ A contact to put on the buying committee.
 | `contact_id` | `integer` | yes |  |
 | `role` | `string \| null` | no | Their part in the decision, e.g. "champion". |
 
+<a id="type-deskcardcontext"></a>
+
+### `DeskCardContext`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `facts` | `Array<string>` | no | Bullets under what we know. Empty ones are dropped. max items 20 |
+| `fields` | `Record<string, string>` | no | The columns the card was built from, shown as chips. |
+| `persona` | `string \| null` | no | max length 200 |
+| `why` | `string \| null` | no | The one-line reason, shown at the top of the card. max length 1000 |
+
+<a id="type-deskcarddraft"></a>
+
+### `DeskCardDraft`
+
+Shaped by the channel. email: subject, body. linkedin: kind (connect or message), message, a connect note at most 300 characters. call: talking_points, questions, handoff_line.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `string \| null` | no | max length 20000 |
+| `handoff_line` | `string \| null` | no | max length 1000 |
+| `kind` | `string \| null` | no | max length 32 |
+| `message` | `string \| null` | no | A connect note is at most 300 characters. max length 8000 |
+| `questions` | `Array<string>` | no | max items 20 |
+| `subject` | `string \| null` | no | max length 300 |
+| `talking_points` | `Array<string>` | no | max items 20 |
+
+<a id="type-deskcardorigin"></a>
+
+### `DeskCardOrigin`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `kind` | `string \| null` | no | Who planned it, e.g. "list_plan" or "workflow". max length 100 |
+| `mapping` | `string \| null` | no | max length 300 |
+
+<a id="type-deskcardsender"></a>
+
+### `DeskCardSender`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `linkedin_seat_id` | `string \| null` | no | Not used: LinkedIn sends from the rep's own connected account. max length 200 |
+| `mailbox` | `string \| null` | no | Email address the card sends from. Checked against the rep's send rights when the rep sends. max length 320 |
+| `mailbox_id` | `string \| null` | no | Not used: email sends from `mailbox`, else the rep's own mailbox. max length 200 |
+
 <a id="type-deskdecision"></a>
 
 ### `DeskDecision`

package/docs/api/inbox.d.ts

@@ -618,11 +618,19 @@ export interface InboxThreadResponse {
   /** Contact snapshot: name, email, company */
   contact?: Record<string, unknown> | null;
   created_at?: string | null;
+  /** SMS: your number the thread runs on; the default `from_address` for an SMS reply. */
+  from_number?: string | null;
   id: string;
+  /** LinkedIn: the sending account; the default `from_address` for a LinkedIn reply. */
+  linkedin_account_id?: number | null;
+  /** Email: the connected mailbox this thread belongs to. A reply goes out from it by default, so pass it as `from_address` (or omit `from_address`) on POST /inbox/{id}/send. */
+  mailbox?: string | null;
   messages?: Array<InboxMessageItem>;
   status?: string | null;
   subject?: string | null;
   tags?: Array<Record<string, unknown>>;
+  /** SMS: the contact's number; the default `to` for an SMS reply. */
+  to_number?: string | null;
   updated_at?: string | null;
 }
 
@@ -662,11 +670,11 @@ export interface SendRequest {
   body: string;
   /** Channel to send through: email, sms, or linkedin */
   channel: InboxChannel;
-  /** Sender address (mailbox email, phone number, or LinkedIn account ID) */
+  /** Sender (mailbox email, your phone number, or numeric LinkedIn account ID). Omit it to send from the thread's own mailbox / number / LinkedIn account (the thread's `mailbox`, `from_number` or `linkedin_account_id`). You still need permission to send as that sender. */
   from_address?: string | null;
   /** Email subject (optional, for email channel) */
   subject?: string | null;
-  /** Recipient override (email address, phone number, or LinkedIn ID) */
+  /** Recipient override (email address or phone number). Omit it to reply to the thread's contact: the contact's email (else the last inbound sender) for email, the thread's contact number for SMS. Not used for LinkedIn. */
   to?: string | null;
 }
 

package/docs/api/inbox.md

@@ -359,10 +359,14 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `assignees` | `Array<Record<string, unknown>>` | no |  |
 | `contact` | `Record<string, unknown> \| null` | no | Contact snapshot: name, email, company |
 | `created_at` | `string \| null` | no |  |
+| `from_number` | `string \| null` | no | SMS: your number the thread runs on; the default `from_address` for an SMS reply. |
+| `linkedin_account_id` | `integer \| null` | no | LinkedIn: the sending account; the default `from_address` for a LinkedIn reply. |
+| `mailbox` | `string \| null` | no | Email: the connected mailbox this thread belongs to. A reply goes out from it by default, so pass it as `from_address` (or omit `from_address`) on POST /inbox/{id}/send. |
 | `messages` | `Array<InboxMessageItem>` | no |  |
 | `status` | `string \| null` | no |  |
 | `subject` | `string \| null` | no |  |
 | `tags` | `Array<Record<string, unknown>>` | no |  |
+| `to_number` | `string \| null` | no | SMS: the contact's number; the default `to` for an SMS reply. |
 | `updated_at` | `string \| null` | no |  |
 
 **Example**
@@ -543,10 +547,14 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `assignees` | `Array<Record<string, unknown>>` | no |  |
 | `contact` | `Record<string, unknown> \| null` | no | Contact snapshot: name, email, company |
 | `created_at` | `string \| null` | no |  |
+| `from_number` | `string \| null` | no | SMS: your number the thread runs on; the default `from_address` for an SMS reply. |
+| `linkedin_account_id` | `integer \| null` | no | LinkedIn: the sending account; the default `from_address` for a LinkedIn reply. |
+| `mailbox` | `string \| null` | no | Email: the connected mailbox this thread belongs to. A reply goes out from it by default, so pass it as `from_address` (or omit `from_address`) on POST /inbox/{id}/send. |
 | `messages` | `Array<InboxMessageItem>` | no |  |
 | `status` | `string \| null` | no |  |
 | `subject` | `string \| null` | no |  |
 | `tags` | `Array<Record<string, unknown>>` | no |  |
+| `to_number` | `string \| null` | no | SMS: the contact's number; the default `to` for an SMS reply. |
 | `updated_at` | `string \| null` | no |  |
 
 **Example**
@@ -915,9 +923,9 @@ Body fields (`SendRequest`):
 |---|---|---|---|
 | `body.body` | `string` | yes | Message body to send |
 | `body.channel` | `InboxChannel` | yes | Channel to send through: email, sms, or linkedin |
-| `body.from_address` | `string \| null` | no | Sender address (mailbox email, phone number, or LinkedIn account ID) |
+| `body.from_address` | `string \| null` | no | Sender (mailbox email, your phone number, or numeric LinkedIn account ID). Omit it to send from the thread's own mailbox / number / LinkedIn account (the thread's `mailbox`, `from_number` or `linkedin_account_id`). You still need permission to send as that sender. |
 | `body.subject` | `string \| null` | no | Email subject (optional, for email channel) |
-| `body.to` | `string \| null` | no | Recipient override (email address, phone number, or LinkedIn ID) |
+| `body.to` | `string \| null` | no | Recipient override (email address or phone number). Omit it to reply to the thread's contact: the contact's email (else the last inbound sender) for email, the thread's contact number for SMS. Not used for LinkedIn. |
 
 **Returns** `ApiResponse_SendResponse_`: the envelope `{ data: SendResponse, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
 

package/docs/api/seo.d.ts

@@ -627,6 +627,7 @@ export interface SeoAudit {
   created_at?: string | null;
   credits_charged?: number | null;
   domain: string;
+  enable_javascript?: boolean;
   failure_reason?: string | null;
   id: string;
   max_pages: number;
@@ -640,6 +641,7 @@ export interface SeoAudit {
 /** Mirrors `AuditIssueDTO`. */
 export interface SeoAuditIssue {
   affected_count: number;
+  affected_total?: number;
   affected_urls?: Array<Record<string, unknown>>;
   issue_type: string;
   severity: string;
@@ -765,11 +767,20 @@ export interface SeoEndOfDay {
 /** Mirrors `KeywordRow`. */
 export interface SeoKeywordRow {
   competition?: number;
-  cpc?: number;
+  cpc?: number | null;
+  cpc_high?: number | null;
   intent?: string | null;
+  intents?: Array<string>;
   keyword: string;
   keyword_difficulty?: number | null;
+  parent_topic?: string | null;
+  parent_topic_volume?: number | null;
+  results_count?: number | null;
   search_volume?: number;
+  search_volume_avg?: number | null;
+  serp_features?: Array<string>;
+  trend?: Array<number>;
+  volume_spike?: boolean;
 }
 
 export interface SeoMover {
@@ -885,7 +896,9 @@ export interface SeoSetupItem {
  * thing the credit reservation is sized from.
  */
 export interface SeoStartAuditRequest {
+  allow_subdomains?: boolean;
   domain: string;
+  enable_javascript?: boolean;
   max_pages?: number;
 }
 
@@ -990,6 +1003,7 @@ export interface SeoTrackedDomainMetrics {
   organic_keywords?: number | null;
   referring_domains?: number | null;
   top3_positions?: number | null;
+  traffic_basis?: string | null;
 }
 
 /**
@@ -1005,6 +1019,7 @@ export interface SeoTrackedDomains {
   pages_cap: number;
   pages_max_credits: number;
   refresh_credits: number;
+  research_credits?: number;
 }
 
 /** Mirrors `TrackedKeywordDTO`. */
@@ -1017,7 +1032,10 @@ export interface SeoTrackedKeyword {
   language_code: string;
   latest_checked_at?: string | null;
   latest_rank?: number | null;
+  latest_serp_depth?: number | null;
   latest_serp_url?: string | null;
   location_code: number;
   search_volume?: number | null;
+  serp_features?: Array<string>;
+  tags?: Array<string>;
 }

package/docs/api/seo.md

@@ -229,6 +229,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `completed_at` | `string (date-time) \| null` | no |  |
 | `created_at` | `string (date-time) \| null` | no |  |
 | `credits_charged` | `integer \| null` | no |  |
+| `enable_javascript` | `boolean` | no | default `false` |
 | `failure_reason` | `string \| null` | no |  |
 | `onpage_score` | `number \| null` | no |  |
 | `pages_crawled` | `integer \| null` | no |  |
@@ -636,6 +637,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `completed_at` | `string (date-time) \| null` | no |  |
 | `created_at` | `string (date-time) \| null` | no |  |
 | `credits_charged` | `integer \| null` | no |  |
+| `enable_javascript` | `boolean` | no | default `false` |
 | `failure_reason` | `string \| null` | no |  |
 | `onpage_score` | `number \| null` | no |  |
 | `pages_crawled` | `integer \| null` | no |  |
@@ -832,6 +834,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `pages_cap` | `integer` | yes |  |
 | `pages_max_credits` | `integer` | yes |  |
 | `refresh_credits` | `integer` | yes |  |
+| `research_credits` | `integer` | no | default `1` |
 
 **Example**
 
@@ -880,8 +883,11 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `created_at` | `string (date-time) \| null` | no |  |
 | `latest_checked_at` | `string (date-time) \| null` | no |  |
 | `latest_rank` | `integer \| null` | no |  |
+| `latest_serp_depth` | `integer \| null` | no |  |
 | `latest_serp_url` | `string \| null` | no |  |
 | `search_volume` | `integer \| null` | no |  |
+| `serp_features` | `Array<string>` | no | default `[]` |
+| `tags` | `Array<string>` | no | default `[]` |
 
 **Example**
 
@@ -1046,8 +1052,11 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `created_at` | `string (date-time) \| null` | no |  |
 | `latest_checked_at` | `string (date-time) \| null` | no |  |
 | `latest_rank` | `integer \| null` | no |  |
+| `latest_serp_depth` | `integer \| null` | no |  |
 | `latest_serp_url` | `string \| null` | no |  |
 | `search_volume` | `integer \| null` | no |  |
+| `serp_features` | `Array<string>` | no | default `[]` |
+| `tags` | `Array<string>` | no | default `[]` |
 
 **Example**
 
@@ -1090,6 +1099,8 @@ Body fields (`SeoStartAuditRequest`):
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `body.domain` | `string` | yes | min length 3, max length 255 |
+| `body.allow_subdomains` | `boolean` | no | default `false` |
+| `body.enable_javascript` | `boolean` | no | default `false` |
 | `body.max_pages` | `integer` | no | default `500`, min 10, max 500 |
 
 **Returns** `ApiResponse_SeoAudit_`: the envelope `{ data: SeoAudit, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -1108,6 +1119,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `completed_at` | `string (date-time) \| null` | no |  |
 | `created_at` | `string (date-time) \| null` | no |  |
 | `credits_charged` | `integer \| null` | no |  |
+| `enable_javascript` | `boolean` | no | default `false` |
 | `failure_reason` | `string \| null` | no |  |
 | `onpage_score` | `number \| null` | no |  |
 | `pages_crawled` | `integer \| null` | no |  |
@@ -1179,6 +1191,7 @@ Mirrors `AuditIssueDTO`.
 | `affected_count` | `integer` | yes |  |
 | `issue_type` | `string` | yes |  |
 | `severity` | `string` | yes |  |
+| `affected_total` | `integer` | no | default `0` |
 | `affected_urls` | `Array<Record<string, unknown>>` | no | default `[]` |
 
 <a id="type-seoauditstate"></a>
@@ -1247,10 +1260,19 @@ Mirrors `KeywordRow`.
 |---|---|---|---|
 | `keyword` | `string` | yes |  |
 | `competition` | `number` | no | default `0` |
-| `cpc` | `number` | no | default `0` |
+| `cpc` | `number \| null` | no |  |
+| `cpc_high` | `number \| null` | no |  |
 | `intent` | `string \| null` | no |  |
+| `intents` | `Array<string>` | no | default `[]` |
 | `keyword_difficulty` | `integer \| null` | no |  |
+| `parent_topic` | `string \| null` | no |  |
+| `parent_topic_volume` | `integer \| null` | no |  |
+| `results_count` | `integer \| null` | no |  |
 | `search_volume` | `integer` | no | default `0` |
+| `search_volume_avg` | `integer \| null` | no |  |
+| `serp_features` | `Array<string>` | no | default `[]` |
+| `trend` | `Array<integer>` | no | default `[]` |
+| `volume_spike` | `boolean` | no | default `false` |
 
 <a id="type-seomover"></a>
 
@@ -1372,3 +1394,4 @@ Mirrors `TrackedDomainMetricsDTO`.
 | `organic_keywords` | `integer \| null` | no |  |
 | `referring_domains` | `number \| null` | no |  |
 | `top3_positions` | `integer \| null` | no |  |
+| `traffic_basis` | `string \| null` | no |  |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graph8/sdk",
-  "version": "0.362.0",
+  "version": "0.370.0",
   "description": "graph8 SDK - CRM, enrichment, sequences, campaigns, and tracking for B2B",
   "license": "MIT",
   "author": "graph8 <support@graph8.com> (https://graph8.com)",
@@ -49,6 +49,11 @@
       "import": "./dist/react.mjs",
       "require": "./dist/react.js"
     },
+    "./errors": {
+      "types": "./dist/errors.d.ts",
+      "import": "./dist/errors.mjs",
+      "require": "./dist/errors.js"
+    },
     "./ui": {
       "types": "./dist/ui/index.d.ts",
       "import": "./dist/ui/index.mjs",
@@ -63,6 +68,11 @@
     "./ui/theme.css": "./styles/theme.css",
     "./ui/styles.css": "./styles/styles.css"
   },
+  "sideEffects": [
+    "*.css",
+    "./dist/*.js",
+    "./dist/*.mjs"
+  ],
   "files": [
     "dist",
     "blocks",
@@ -73,8 +83,9 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsup && npm run build:ui && npm run build:types && npm run docs:agents",
+    "build": "node scripts/clean-dist.mjs && tsup && npm run build:ui && npm run build:types && npm run docs:agents",
     "test": "vitest run",
+    "validate:blocks": "vite-node --script scripts/blocks/validate.ts",
     "dev": "tsup --watch",
     "prepublishOnly": "npm run build",
     "generate": "node scripts/generate-from-contract.mjs",
@@ -83,6 +94,9 @@
     "build:types": "node scripts/emit-module-types.mjs",
     "docs:agents": "vite-node scripts/agent-docs/cli.ts",
     "e2e:create": "node scripts/e2e-create.mjs",
+    "e2e:flows": "node scripts/e2e-flows.mjs",
+    "mock:graph8": "node scripts/mock-graph8/server.mjs",
+    "mock:graph8:coverage": "node scripts/mock-graph8/coverage.mjs",
     "generate:ui": "node scripts/sync-ui.mjs",
     "generate:ui:check": "node scripts/sync-ui.mjs --check",
     "build:ui": "tsup --config tsup.ui.config.ts && node scripts/postbuild-ui.mjs && node scripts/build-ui-css.mjs"