@graph8/sdk 0.362.0 → 0.373.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.362.0";
+export declare const SDK_VERSION = "0.373.0";
 /** Value of the `X-G8-Client` header every SDK request carries (I-13). */
-export declare const SDK_CLIENT_ID = "js-sdk/0.362.0";
+export declare const SDK_CLIENT_ID = "js-sdk/0.373.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: **3315 Developer API
+inbox, meetings, workflows and more. This SDK reaches all of it: **3316 Developer API
 operations** in 145 areas.
 
 ## 1. The short version
@@ -93,7 +93,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 3315 operations |
+| Coverage | 289 methods, reaching 258 operations | all 3316 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) |
@@ -142,7 +142,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), `dataPipelines` (5), `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` (42), `openSearch` (4), `ops` (5), `orgGovernance` (17), `orgVideos` (6), `organizationSettings` (22), `phoneNumbers` (16), `processLists` (6), `profile` (14), `programmaticPages` (15), `providerDomains` (34), `providerUsage` (5), `public` (1), `publicCopilot` (1), `publicSignals` (1), `publicVisitors` (2), `quotes` (56), `radar` (42), `radarReports` (8), `recordRoles` (4), `reports` (7), `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` (22), `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), `workspaceBackup` (7).
+`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), `dataPipelines` (5), `deals` (48), `deliverability` (17), `desk` (72), `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` (42), `openSearch` (4), `ops` (5), `orgGovernance` (17), `orgVideos` (6), `organizationSettings` (22), `phoneNumbers` (16), `processLists` (6), `profile` (14), `programmaticPages` (15), `providerDomains` (34), `providerUsage` (5), `public` (1), `publicCopilot` (1), `publicSignals` (1), `publicVisitors` (2), `quotes` (56), `radar` (42), `radarReports` (8), `recordRoles` (4), `reports` (7), `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` (22), `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), `workspaceBackup` (7).
 
 ## 5. How to find the right call
 
@@ -198,7 +198,7 @@ Every operation carries a tier:
 | Tier | What it means | Count |
 |---|---|---|
 | `read` | reads data; safe to call and to retry | 1540 |
-| `write` | creates or changes records; the SDK sends an Idempotency-Key and retries transient failures | 836 |
+| `write` | creates or changes records; the SDK sends an Idempotency-Key and retries transient failures | 837 |
 | `destructive` | deletes or archives data; confirm with a human before calling | 305 |
 | `billable` | spends credits; the SDK never blindly retries it; confirm cost before bulk use | 383 |
 | `external` | reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first | 251 |
@@ -783,6 +783,17 @@ node_modules/@graph8/sdk/
   to decide which screens need a confirmation (`billable`, `external`, `destructive`) and which key to
   create. Where `defaults` says `askHuman: true`, ask the person before using the default.
 - **Search the catalog** with `grep -h '"summary"' node_modules/@graph8/sdk/blocks/*/block.json`.
+- **To build an app, start here**: `npx @graph8/sdk create --blocks <ids> <dir>` (for example
+  `--blocks crm,deals,inbox --title "Acme CRM"`; `create custom --blocks ...` is the same). Any product, not only
+  a named stack: pick the features, get a Next.js app with each block's finished screens as routes plus a sidebar
+  (grouped, with icons), `/` opening the analytics screen if you asked for it else the first screen, and the
+  `dependsOn` closure installed (asking for deals also gives you crm's screens; `--no-deps-screens` to skip them,
+  `--with-deps-screens` to add plain pages for dependencies with no Screen). `npx @graph8/sdk list` shows which blocks
+  have Screens. Later, `npx @graph8/sdk add <block>` inside that app adds the new block's routes and nav entries too
+  (idempotent; a page you edited is kept). In an app made from a named stack (`create apollo`, `starter`, ...) `add` leaves
+  routes and `lib/nav.ts` alone unless you pass `--routes`. A block's `block.json` may carry `screens: [{ component, path, label,
+  icon?, group?, description?, order? }]`; without it, each component named `*Screen` becomes a route
+  (`ContactsScreen` -> `/contacts`).
 - **Start a whole app with one command**: `npx @graph8/sdk create <stack> <dir>` scaffolds a Next.js App Router +
   TypeScript + Tailwind v4 app, installs the stack's blocks (the same code as `add`), puts every screen of
   the stack in a sidebar with one route each, and installs dependencies (`--no-install`, `--dry-run`,

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 3315 operations across 145 namespaces (1540 read, 836 write, 305 destructive, 383 billable, 251 external).
+`g8.api` is generated from the published OpenAPI contract, so it covers all 3316 operations across 145 namespaces (1540 read, 837 write, 305 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).
@@ -61,7 +61,7 @@
 | `g8.api.dataPipelines` | Data pipelines | 5 | none | [dataPipelines.md](dataPipelines.md) | [dataPipelines.d.ts](dataPipelines.d.ts) |
 | `g8.api.deals` | Deals | 48 | 8 | [deals.md](deals.md) | [deals.d.ts](deals.d.ts) |
 | `g8.api.deliverability` | Deliverability | 17 | none | [deliverability.md](deliverability.md) | [deliverability.d.ts](deliverability.d.ts) |
-| `g8.api.desk` | Desk | 71 | none | [desk.md](desk.md) | [desk.d.ts](desk.d.ts) |
+| `g8.api.desk` | Desk | 72 | none | [desk.md](desk.md) | [desk.d.ts](desk.d.ts) |
 | `g8.api.dialer` | Dialer | 46 | none | [dialer.md](dialer.md) | [dialer.d.ts](dialer.d.ts) |
 | `g8.api.dialerAnalytics` | Dialer Analytics | 6 | none | [dialerAnalytics.md](dialerAnalytics.md) | [dialerAnalytics.d.ts](dialerAnalytics.d.ts) |
 | `g8.api.documents` | Documents | 35 | none | [documents.md](documents.md) | [documents.d.ts](documents.d.ts) |

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
+   * Put one planned outreach touch (an email, LinkedIn or call step for one contact) on a rep's desk with its why, facts and draft. The rep edits and sends it; nothing sends by itself. owner_id must be the caller's own email unless the key is an org or machine key: a personal key or an OAuth connection is a person and gets 403 owner_not_self for anyone else. Posting the same external_key again updates the open card instead of adding a second one. Needs deals:write and a key allowed to see the contact
+   * 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. With a personal key or an OAuth connection this must be the caller's own email (the key is a person; anyone else is 403 owner_not_self). Only an org or machine key may name another rep. */
+  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` | Put one planned outreach touch (an email, LinkedIn or call step for one contact) on a rep's desk with its why, facts an… |
 | [`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)`
+
+**Put one planned outreach touch (an email, LinkedIn or call step for one contact) on a rep's desk with its why, facts and draft. The rep edits and sends it; nothing sends by itself. owner_id must be t…**
+
+- 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. With a personal key or an OAuth connection this must be the caller's own email (the key is a person; anyone else is 403 owner_not_self). Only an org or machine key may name another rep. 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 |  |