@graph8/sdk 0.251.0 → 0.262.0

package/docs/sdk-clients.md

@@ -0,0 +1,4339 @@
+<!-- Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. -->
+
+# Hand-written clients
+
+The ergonomic layer: 289 hand-written methods on `g8`. They unwrap the `data` envelope, accept friendlier arguments, and document the gotchas of their endpoint. Use one when it exists; fall back to `g8.api.*` ([api/README.md](api/README.md)) for everything else.
+
+Signatures are exactly what your editor shows. Each method links to the REST operation it calls.
+
+## Modules
+
+| Module | Methods | Credential |
+|---|---|---|
+| `g8` (init, tracking, identity) | 5 | write key (browser-safe) |
+| [`g8.agency`](#g8-agency) | 2 | API key (server-side) |
+| [`g8.appPlatform`](#g8-appplatform) | 19 | API key (server-side) |
+| [`g8.apps`](#g8-apps) | 7 | API key (server-side) |
+| [`g8.audiences`](#g8-audiences) | 8 | API key (server-side) |
+| [`g8.calendar`](#g8-calendar) | 5 | write key (browser-safe) |
+| [`g8.campaigns`](#g8-campaigns) | 4 | API key (server-side) |
+| [`g8.chat`](#g8-chat) | 5 | write key (browser-safe) |
+| [`g8.companies`](#g8-companies) | 8 | API key (server-side) |
+| [`g8.contacts`](#g8-contacts) | 10 | API key (server-side) |
+| [`g8.copilot`](#g8-copilot) | 5 | write key (browser-safe) |
+| [`g8.deals`](#g8-deals) | 8 | API key (server-side) |
+| [`g8.enrich`](#g8-enrich) | 4 | API key (server-side) |
+| [`g8.fields`](#g8-fields) | 5 | API key (server-side) |
+| [`g8.forms`](#g8-forms) | 1 | write key (browser-safe) |
+| [`g8.inbox`](#g8-inbox) | 6 | API key (server-side) |
+| [`g8.intent`](#g8-intent) | 13 | API key (server-side) |
+| [`g8.lists`](#g8-lists) | 6 | API key (server-side) |
+| [`g8.mailboxes`](#g8-mailboxes) | 7 | API key (server-side) |
+| [`g8.marketplace`](#g8-marketplace) | 5 | API key (server-side) |
+| [`g8.meetings`](#g8-meetings) | 2 | API key (server-side) |
+| [`g8.newsletter`](#g8-newsletter) | 15 | API key (server-side) |
+| [`g8.notes`](#g8-notes) | 8 | API key (server-side) |
+| [`g8.objects`](#g8-objects) | 18 | API key (server-side) |
+| [`g8.pipelines`](#g8-pipelines) | 12 | API key (server-side) |
+| [`g8.quotes`](#g8-quotes) | 12 | API key (server-side) |
+| [`g8.search`](#g8-search) | 4 | API key (server-side) |
+| [`g8.sequences`](#g8-sequences) | 13 | API key (server-side) |
+| [`g8.signals`](#g8-signals) | 2 | write key (browser-safe) |
+| [`g8.skills`](#g8-skills) | 14 | API key (server-side) |
+| [`g8.snippet`](#g8-snippet) | 1 | API key (server-side) |
+| [`g8.studio`](#g8-studio) | 11 | API key (server-side) |
+| [`g8.tasks`](#g8-tasks) | 5 | API key (server-side) |
+| [`g8.visitors`](#g8-visitors) | 3 | write key (browser-safe) |
+| [`g8.voice`](#g8-voice) | 14 | API key (server-side) |
+| [`g8.webhooks`](#g8-webhooks) | 1 | API key (server-side) |
+| [`g8.workflows`](#g8-workflows) | 21 | API key (server-side) |
+
+---
+
+<a id="g8"></a>
+
+## `g8`
+
+Types: `dist/types/core.d.ts`
+
+<a id="g8-identify"></a>
+
+### `g8.identify`
+
+```ts
+g8.identify: (userId: string, properties?: IdentifyProperties) => void
+```
+
+Identify a user with properties.
+
+- Source: `src/core.ts`
+
+<a id="g8-init"></a>
+
+### `g8.init`
+
+```ts
+g8.init: (config: G8Config) => void
+```
+
+Initialize the graph8 SDK. Must be called before any other method. Safe to call on the server (SSR) - becomes a no-op for tracking.
+
+- Source: `src/core.ts`
+
+<a id="g8-page"></a>
+
+### `g8.page`
+
+```ts
+g8.page: (properties?: TrackProperties) => void
+```
+
+Track a page view.
+
+- Source: `src/core.ts`
+
+<a id="g8-reset"></a>
+
+### `g8.reset`
+
+```ts
+g8.reset: () => void
+```
+
+Clear user identity (on logout).
+
+- Source: `src/core.ts`
+
+<a id="g8-track"></a>
+
+### `g8.track`
+
+```ts
+g8.track: (event: string, properties?: TrackProperties) => void
+```
+
+Track a custom event.
+
+- Source: `src/core.ts`
+
+---
+
+<a id="g8-agency"></a>
+
+## `g8.agency`
+
+Types: `dist/types/agency.d.ts`
+
+<a id="g8-agency-clients"></a>
+
+### `g8.agency.clients`
+
+```ts
+g8.agency.clients: () => Promise<{ data: AgencyClient[]; }>
+```
+
+List the client orgs this agency key may target via `X-Target-Org-Id`.
+
+- Calls `GET /api/v1/agency/clients` ([`g8.api.agency.listAgencyClients`](api/agency.md#op-listagencyclients), tier `read`, scope `account:read`)
+
+- Source: `src/agency.ts`
+
+<a id="g8-agency-me"></a>
+
+### `g8.agency.me`
+
+```ts
+g8.agency.me: () => Promise<AgencyInfo>
+```
+
+Describe the agency credential: agency org + authorized client count.
+
+- Calls `GET /api/v1/agency/me` ([`g8.api.agency.getAgencyMe`](api/agency.md#op-getagencyme), tier `read`, scope `account:read`)
+
+- Source: `src/agency.ts`
+
+---
+
+<a id="g8-appplatform"></a>
+
+## `g8.appPlatform`
+
+Types: `dist/types/appPlatform.d.ts`
+
+<a id="g8-appplatform-activedeployment"></a>
+
+### `g8.appPlatform.activeDeployment`
+
+```ts
+g8.appPlatform.activeDeployment: (appId: string) => Promise<Deployment | null>
+```
+
+The deployment currently serving traffic, or `null`. `null` is a real answer with a 200, not a 404: "this app has never shipped" is information, while a 404 would read as "no such app".
+
+- Calls `GET /api/v1/apps/{app_id}/deployments/active` ([`g8.api.appDeployments.getActiveDeployment`](api/appDeployments.md#op-getactivedeployment), tier `read`, scope `apps:read`)
+
+- Source: `src/appPlatform.ts`
+
+<a id="g8-appplatform-claimdomain"></a>
+
+### `g8.appPlatform.claimDomain`
+
+```ts
+g8.appPlatform.claimDomain: (appId: string, hostname: string) => Promise<DomainVerificationInstructions>
+```
+
+Claim a hostname and get the TXT record that proves you own it. Returns `201`, and the domain is NESTED at `data.domain` -- this is the one route on the surface whose payload is not the record itself. Hostnames are globally unique, so a host another app holds is refused.
+
+- Calls `POST /api/v1/apps/{app_id}/domains` ([`g8.api.appDomains.claimAppDomain`](api/appDomains.md#op-claimappdomain), tier `write`, scope `apps:write`)
+
+- Source: `src/appPlatform.ts`
+
+<a id="g8-appplatform-clearsource"></a>
+
+### `g8.appPlatform.clearSource`
+
+```ts
+g8.appPlatform.clearSource: (appId: string) => Promise<Record<string, unknown>>
+```
+
+Unbind the source. Returns the full app with every source field null.
+
+- Calls `DELETE /api/v1/apps/{app_id}/source` ([`g8.api.apps.clearAppSource`](api/apps.md#op-clearappsource), tier `destructive`, scope `apps:delete`)
+
+- Source: `src/appPlatform.ts`
+
+<a id="g8-appplatform-deletesecret"></a>
+
+### `g8.appPlatform.deleteSecret`
+
+```ts
+g8.appPlatform.deleteSecret: (appId: string, secretKey: string) => Promise<{ secret_key: string; removed: boolean; }>
+```
+
+Undeclare a secret. A key the app never declared is a 404, so a typo is never reported as a successful removal.
+
+- Calls `DELETE /api/v1/apps/{app_id}/secrets/{secret_key}` ([`g8.api.apps.deleteAppSecret`](api/apps.md#op-deleteappsecret), tier `destructive`, scope `apps:delete`)
+
+- Source: `src/appPlatform.ts`
+
+<a id="g8-appplatform-deploy"></a>
+
+### `g8.appPlatform.deploy`
+
+```ts
+g8.appPlatform.deploy: (appId: string, params: CreateDeploymentParams) => Promise<Deployment>
+```
+
+Queue a deployment. Returns `201` with `status: "queued"` -- nothing builds as a side effect of this call; the build controller picks it up. NOT idempotent: two identical calls create two deployments.
+
+- Calls `POST /api/v1/apps/{app_id}/deployments` ([`g8.api.appDeployments.createAppDeployment`](api/appDeployments.md#op-createappdeployment), tier `write`, scope `apps:write`)
+
+- Source: `src/appPlatform.ts`
+
+<a id="g8-appplatform-deploymentlogs"></a>
+
+### `g8.appPlatform.deploymentLogs`
+
+```ts
+g8.appPlatform.deploymentLogs: (appId: string, deploymentId: string, tailLines?: number) => Promise<AppLogs>
+```
+
+Why a build failed. Returns every step of the build pod in the order Kubernetes runs them; a step that has not started yet is omitted rather than returned empty. An empty `containers` list is not an error -- build pods are reaped an hour after they finish, so logs for an older deployment are genuinely gone. `last_error_sanitized` on the deployment is what survives. `503` means graph8 could not reach the cluster, which is deliberately different from an empty `200`: one means we could not look, the other means your build produced no output.
+
+- Calls `GET /api/v1/apps/{app_id}/deployments/{deployment_id}/logs` ([`g8.api.appLogs.getDeploymentLogs`](api/appLogs.md#op-getdeploymentlogs), tier `read`, scope `apps:read`)
+
+- Source: `src/appPlatform.ts`
+
+<a id="g8-appplatform-getdeployment"></a>
+
+### `g8.appPlatform.getDeployment`
+
+```ts
+g8.appPlatform.getDeployment: (appId: string, deploymentId: string) => Promise<Deployment>
+```
+
+Fetch one deployment. The polling endpoint for a build loop.
+
+- Calls `GET /api/v1/apps/{app_id}/deployments/{deployment_id}` ([`g8.api.appDeployments.getDeployment`](api/appDeployments.md#op-getdeployment), tier `read`, scope `apps:read`)
+
+- Source: `src/appPlatform.ts`
+
+<a id="g8-appplatform-listdeployments"></a>
+
+### `g8.appPlatform.listDeployments`
+
+```ts
+g8.appPlatform.listDeployments: (appId: string) => Promise<{ data: Deployment[]; }>
+```
+
+Every deployment for this app, newest first. Never 404s for an app with none.
+
+- Calls `GET /api/v1/apps/{app_id}/deployments` ([`g8.api.appDeployments.listAppDeployments`](api/appDeployments.md#op-listappdeployments), tier `read`, scope `apps:read`)
+
+- Source: `src/appPlatform.ts`
+
+<a id="g8-appplatform-listdomains"></a>
+
+### `g8.appPlatform.listDomains`
+
+```ts
+g8.appPlatform.listDomains: (appId: string) => Promise<{ data: AppDomain[]; }>
+```
+
+Every hostname claimed for this app, whatever its verification state.
+
+- Calls `GET /api/v1/apps/{app_id}/domains` ([`g8.api.appDomains.listAppDomains`](api/appDomains.md#op-listappdomains), tier `read`, scope `apps:read`)
+
+- Source: `src/appPlatform.ts`
+
+<a id="g8-appplatform-listschemaversions"></a>
+
+### `g8.appPlatform.listSchemaVersions`
+
+```ts
+g8.appPlatform.listSchemaVersions: (appId: string) => Promise<{ data: SchemaVersion[]; }>
+```
+
+Every schema version this app has published. Empty array, never 404.
+
+- Calls `GET /api/v1/apps/{app_id}/schema-versions` ([`g8.api.apps.listAppSchemaVersions`](api/apps.md#op-listappschemaversions), tier `read`, scope `apps:read`)
+
+- Source: `src/appPlatform.ts`
+
+<a id="g8-appplatform-listsecrets"></a>
+
+### `g8.appPlatform.listSecrets`
+
+```ts
+g8.appPlatform.listSecrets: (appId: string) => Promise<{ data: AppSecretMetadata[]; }>
+```
+
+Which secrets this app declares, and when each was last rotated. NEVER returns a value. graph8 stores a POINTER into your secret manager and has no column for the secret itself.
+
+- Calls `GET /api/v1/apps/{app_id}/secrets` ([`g8.api.apps.listAppSecrets`](api/apps.md#op-listappsecrets), tier `read`, scope `apps:read`)
+
+- Source: `src/appPlatform.ts`
+
+<a id="g8-appplatform-logs"></a>
+
+### `g8.appPlatform.logs`
+
+```ts
+g8.appPlatform.logs: (appId: string, tailLines?: number) => Promise<AppLogs>
+```
+
+What the running app is printing. The app's own pods only -- the per-app egress proxy shares the namespace and is deliberately excluded. Empty until a deployment reaches `deployed`.
+
+- Calls `GET /api/v1/apps/{app_id}/logs` ([`g8.api.appLogs.getAppLogs`](api/appLogs.md#op-getapplogs), tier `read`, scope `apps:read`)
+
+- Source: `src/appPlatform.ts`
+
+<a id="g8-appplatform-promote"></a>
+
+### `g8.appPlatform.promote`
+
+```ts
+g8.appPlatform.promote: (appId: string, deploymentId: string, imageDigest: string) => Promise<Deployment>
+```
+
+Promote a built deployment to serve traffic. Anything it displaces moves to `rolled_back` in the same transaction, so there is never a moment with two live deployments. `409` when the state machine forbids it -- a deployment cannot become `deployed` without having been built, and a `failed` one cannot be revived. A retry is a new deployment, not a resurrection.
+
+- Calls `POST /api/v1/apps/{app_id}/deployments/{deployment_id}/promote` ([`g8.api.appDeployments.promoteDeployment`](api/appDeployments.md#op-promotedeployment), tier `write`, scope `apps:write`)
+
+- Source: `src/appPlatform.ts`
+
+<a id="g8-appplatform-publishschemaversion"></a>
+
+### `g8.appPlatform.publishSchemaVersion`
+
+```ts
+g8.appPlatform.publishSchemaVersion: (appId: string, objects: unknown[]) => Promise<{ version: SchemaVersion; }>
+```
+
+Publish a custom-object schema version. Returns `201`. Takes only the `objects` list, not a whole `graph8.app.yaml`: the rest of that file is app metadata the control plane already holds, and accepting it here would create a second place for it to disagree.
+
+- Calls `POST /api/v1/apps/{app_id}/schema-versions` ([`g8.api.apps.publishAppSchemaVersion`](api/apps.md#op-publishappschemaversion), tier `write`, scope `apps:write`)
+
+- Source: `src/appPlatform.ts`
+
+<a id="g8-appplatform-putsecret"></a>
+
+### `g8.appPlatform.putSecret`
+
+```ts
+g8.appPlatform.putSecret: (appId: string, secretKey: string, providerRef?: string) => Promise<AppSecretMetadata>
+```
+
+Declare a secret, or rotate the pointer to it. `providerRef` is a REFERENCE, and the server rejects anything that looks like a credential -- a value starting `bearer `, `sk-`, `ghp_`, `xox` and friends is a 422. That refusal is the feature: it catches the mistake of pasting the secret where its address belongs.
+
+- Calls `PUT /api/v1/apps/{app_id}/secrets/{secret_key}` ([`g8.api.apps.putAppSecret`](api/apps.md#op-putappsecret), tier `write`, scope `apps:write`)
+
+- Source: `src/appPlatform.ts`
+
+<a id="g8-appplatform-releasedomain"></a>
+
+### `g8.appPlatform.releaseDomain`
+
+```ts
+g8.appPlatform.releaseDomain: (appId: string, hostname: string) => Promise<{ hostname: string; released: boolean; }>
+```
+
+Release a claimed hostname. A HARD delete. Hostnames are globally unique, so a row left behind in any status keeps the host burned for every other builder. Releasing one you already released is a `404`, because after the first call the claim genuinely does not exist. Returns the NORMALIZED hostname, which may differ from what you passed.
+
+- Calls `DELETE /api/v1/apps/{app_id}/domains/{hostname}` ([`g8.api.appDomains.releaseAppDomain`](api/appDomains.md#op-releaseappdomain), tier `destructive`, scope `apps:delete`)
+
+- Source: `src/appPlatform.ts`
+
+<a id="g8-appplatform-rollback"></a>
+
+### `g8.appPlatform.rollback`
+
+```ts
+g8.appPlatform.rollback: (appId: string, deploymentId: string) => Promise<Deployment>
+```
+
+Roll back a deployment that is currently serving. Only a `deployed` one may be.
+
+- Calls `POST /api/v1/apps/{app_id}/deployments/{deployment_id}/rollback` ([`g8.api.appDeployments.rollbackDeployment`](api/appDeployments.md#op-rollbackdeployment), tier `write`, scope `apps:write`)
+
+- Source: `src/appPlatform.ts`
+
+<a id="g8-appplatform-setsource"></a>
+
+### `g8.appPlatform.setSource`
+
+```ts
+g8.appPlatform.setSource: (appId: string, params: AppSourceParams) => Promise<Record<string, unknown>>
+```
+
+Bind the repository an app builds from. `repo_url` must be fetchable -- `https://`, `ssh://` or `git@`, with no whitespace. A `file://` or bare path is refused with 422, because a build that can read the builder's filesystem is a build that can read ours. `credential_ref` is a POINTER into your secret manager, not a token.
+
+- Calls `PUT /api/v1/apps/{app_id}/source` ([`g8.api.apps.setAppSource`](api/apps.md#op-setappsource), tier `write`, scope `apps:write`)
+
+- Source: `src/appPlatform.ts`
+
+<a id="g8-appplatform-verifydomain"></a>
+
+### `g8.appPlatform.verifyDomain`
+
+```ts
+g8.appPlatform.verifyDomain: (appId: string, hostname: string) => Promise<AppDomain>
+```
+
+Check DNS for the TXT record and advance the domain to `verified`. Idempotent: verifying an already-verified domain re-checks and stays verified, so it is safe to re-run after a DNS change. Send no body -- the record in DNS is the payload.
+
+- Calls `POST /api/v1/apps/{app_id}/domains/{hostname}/verify` ([`g8.api.appDomains.verifyAppDomain`](api/appDomains.md#op-verifyappdomain), tier `write`, scope `apps:write`)
+
+- Source: `src/appPlatform.ts`
+
+---
+
+<a id="g8-apps"></a>
+
+## `g8.apps`
+
+Types: `dist/types/apps.d.ts`
+
+<a id="g8-apps-create"></a>
+
+### `g8.apps.create`
+
+```ts
+g8.apps.create: (params: AppCreateParams) => Promise<App>
+```
+
+Create an app. It starts in `draft` and serves no traffic until published. Throws `G8Error` (409) when the slug is already taken in your org.
+
+- Calls `POST /api/v1/apps` ([`g8.api.apps.createApp`](api/apps.md#op-createapp), tier `write`, scope `apps:write`)
+
+- Source: `src/apps.ts`
+
+<a id="g8-apps-get"></a>
+
+### `g8.apps.get`
+
+```ts
+g8.apps.get: (appId: string) => Promise<App>
+```
+
+Fetch one of your apps. Throws `G8Error` (404) if it is not yours.
+
+- Calls `GET /api/v1/apps/{app_id}` ([`g8.api.apps.getApp`](api/apps.md#op-getapp), tier `read`, scope `apps:read`)
+
+- Source: `src/apps.ts`
+
+<a id="g8-apps-getlimit"></a>
+
+### `g8.apps.getLimit`
+
+```ts
+g8.apps.getLimit: (appId: string) => Promise<AppLimit | null>
+```
+
+This app's hard credit cap, or `null` when it is uncapped. `null` is the real answer, not an empty object: there is no "unlimited" sentinel, so an accidental zero can never read as "no limit".
+
+- Calls `GET /api/v1/apps/{app_id}/limit` ([`g8.api.apps.getAppLimit`](api/apps.md#op-getapplimit), tier `read`, scope `apps:read`)
+
+- Source: `src/apps.ts`
+
+<a id="g8-apps-list"></a>
+
+### `g8.apps.list`
+
+```ts
+g8.apps.list: () => Promise<{ data: App[]; }>
+```
+
+List your organization's apps, newest first.
+
+- Calls `GET /api/v1/apps` ([`g8.api.apps.listApps`](api/apps.md#op-listapps), tier `read`, scope `apps:read`)
+
+- Source: `src/apps.ts`
+
+<a id="g8-apps-listinstalls"></a>
+
+### `g8.apps.listInstalls`
+
+```ts
+g8.apps.listInstalls: (appId: string) => Promise<{ data: AppInstallation[]; }>
+```
+
+The client organizations that installed this app, and their consent state. Includes `pending` and `revoked` installs — if your app cannot reach a tenant, this is where you see why.
+
+- Calls `GET /api/v1/apps/{app_id}/installs` ([`g8.api.apps.listAppInstalls`](api/apps.md#op-listappinstalls), tier `read`, scope `apps:read`)
+
+- Source: `src/apps.ts`
+
+<a id="g8-apps-setstatus"></a>
+
+### `g8.apps.setStatus`
+
+```ts
+g8.apps.setStatus: (appId: string, status: Exclude<AppStatus, "suspended">) => Promise<App>
+```
+
+Move an app through its lifecycle: `draft` → `published` → `archived`. `suspended` is excluded from the parameter type on purpose: it is the platform's kill switch for an abusive app, the backend refuses it with a 403, and a builder who could set it could also unset it.
+
+- Calls `POST /api/v1/apps/{app_id}/status` ([`g8.api.apps.setAppStatus`](api/apps.md#op-setappstatus), tier `write`, scope `apps:write`)
+
+- Source: `src/apps.ts`
+
+<a id="g8-apps-usage"></a>
+
+### `g8.apps.usage`
+
+```ts
+g8.apps.usage: (appId: string, period?: string) => Promise<AppUsageSummary>
+```
+
+Credits this app consumed in a calendar month, broken down per client org. Defaults to the current month. A month with no usage returns zeroes, not a 404 — "nothing happened" is an answer.
+
+- Calls `GET /api/v1/apps/{app_id}/usage` ([`g8.api.apps.getAppUsage`](api/apps.md#op-getappusage), tier `read`, scope `apps:read`)
+
+- Source: `src/apps.ts`
+
+---
+
+<a id="g8-audiences"></a>
+
+## `g8.audiences`
+
+Types: `dist/types/audiences.d.ts`
+
+<a id="g8-audiences-create"></a>
+
+### `g8.audiences.create`
+
+```ts
+g8.audiences.create: (params: AudienceSyncCreateParams) => Promise<AudienceSync>
+```
+
+Create a new audience sync to an ad platform.
+
+- Calls `POST /api/v1/audience-syncs` ([`g8.api.audienceSyncs.createAudienceSync`](api/audienceSyncs.md#op-createaudiencesync), tier `external`, scope `integrations:run`)
+
+- Source: `src/audiences.ts`
+
+<a id="g8-audiences-delete"></a>
+
+### `g8.audiences.delete`
+
+```ts
+g8.audiences.delete: (configId: number) => Promise<{ data: Record<string, unknown>; }>
+```
+
+Delete an audience sync.
+
+- Calls `DELETE /api/v1/audience-syncs/{config_id}` ([`g8.api.audienceSyncs.deleteAudienceSync`](api/audienceSyncs.md#op-deleteaudiencesync), tier `destructive`, scope `integrations:delete`)
+
+- Source: `src/audiences.ts`
+
+<a id="g8-audiences-errors"></a>
+
+### `g8.audiences.errors`
+
+```ts
+g8.audiences.errors: (configId: number) => Promise<{ data: AudienceSyncError[]; }>
+```
+
+List recent sync errors for a config.
+
+- Calls `GET /api/v1/audience-syncs/{config_id}/errors` ([`g8.api.audienceSyncs.listSyncErrors`](api/audienceSyncs.md#op-listsyncerrors), tier `read`, scope `integrations:read`)
+
+- Source: `src/audiences.ts`
+
+<a id="g8-audiences-get"></a>
+
+### `g8.audiences.get`
+
+```ts
+g8.audiences.get: (configId: number) => Promise<AudienceSync>
+```
+
+Get a single audience sync by ID.
+
+- Calls `GET /api/v1/audience-syncs/{config_id}` ([`g8.api.audienceSyncs.getAudienceSync`](api/audienceSyncs.md#op-getaudiencesync), tier `read`, scope `integrations:read`)
+
+- Source: `src/audiences.ts`
+
+<a id="g8-audiences-list"></a>
+
+### `g8.audiences.list`
+
+```ts
+g8.audiences.list: () => Promise<{ data: AudienceSync[]; }>
+```
+
+List all audience syncs for the organization.
+
+- Calls `GET /api/v1/audience-syncs` ([`g8.api.audienceSyncs.listAudienceSyncs`](api/audienceSyncs.md#op-listaudiencesyncs), tier `read`, scope `integrations:read`)
+
+- Source: `src/audiences.ts`
+
+<a id="g8-audiences-runs"></a>
+
+### `g8.audiences.runs`
+
+```ts
+g8.audiences.runs: (configId: number) => Promise<{ data: AudienceSyncRun[]; }>
+```
+
+List recent sync runs for a config (most recent first).
+
+- Calls `GET /api/v1/audience-syncs/{config_id}/runs` ([`g8.api.audienceSyncs.listSyncRuns`](api/audienceSyncs.md#op-listsyncruns), tier `billable`, scope `integrations:run`)
+
+- Source: `src/audiences.ts`
+
+<a id="g8-audiences-trigger"></a>
+
+### `g8.audiences.trigger`
+
+```ts
+g8.audiences.trigger: (configId: number) => Promise<{ data: Record<string, unknown>; }>
+```
+
+Trigger an immediate sync run for a config.
+
+- Calls `POST /api/v1/audience-syncs/{config_id}/trigger` ([`g8.api.audienceSyncs.triggerAudienceSync`](api/audienceSyncs.md#op-triggeraudiencesync), tier `external`, scope `integrations:run`)
+
+- Source: `src/audiences.ts`
+
+<a id="g8-audiences-update"></a>
+
+### `g8.audiences.update`
+
+```ts
+g8.audiences.update: (configId: number, fields: AudienceSyncUpdateParams) => Promise<AudienceSync>
+```
+
+Update an audience sync (partial).
+
+- Calls `PATCH /api/v1/audience-syncs/{config_id}` ([`g8.api.audienceSyncs.updateAudienceSync`](api/audienceSyncs.md#op-updateaudiencesync), tier `external`, scope `integrations:run`)
+
+- Source: `src/audiences.ts`
+
+---
+
+<a id="g8-calendar"></a>
+
+## `g8.calendar`
+
+Types: `dist/types/calendar.d.ts`
+
+<a id="g8-calendar-book"></a>
+
+### `g8.calendar.book`
+
+```ts
+g8.calendar.book: (request: BookingRequest) => Promise<Booking | null>
+```
+
+Book a meeting programmatically.
+
+- Calls `POST /appointments/public/bookings` (outside the `/api/v1` contract)
+
+- Source: `src/calendar.ts`
+
+<a id="g8-calendar-embed"></a>
+
+### `g8.calendar.embed`
+
+```ts
+g8.calendar.embed: (selector: string, config: CalendarConfig) => void
+```
+
+Embed booking widget inline in a container element.
+
+- Source: `src/calendar.ts`
+
+<a id="g8-calendar-on"></a>
+
+### `g8.calendar.on`
+
+```ts
+g8.calendar.on: (event: CalendarEvent, callback: CalendarCallback) => void
+```
+
+Listen for calendar events.
+
+- Source: `src/calendar.ts`
+
+<a id="g8-calendar-show"></a>
+
+### `g8.calendar.show`
+
+```ts
+g8.calendar.show: (config: CalendarConfig) => void
+```
+
+Show a booking modal overlay.
+
+- Source: `src/calendar.ts`
+
+<a id="g8-calendar-slots"></a>
+
+### `g8.calendar.slots`
+
+```ts
+g8.calendar.slots: (username: string, eventSlug: string, range: { start: string; end: string; }) => Promise<TimeSlot[]>
+```
+
+Get available time slots for an event type.
+
+- Calls `GET /appointments/public/slots` (outside the `/api/v1` contract)
+
+- Source: `src/calendar.ts`
+
+---
+
+<a id="g8-campaigns"></a>
+
+## `g8.campaigns`
+
+Types: `dist/types/campaigns.d.ts`
+
+<a id="g8-campaigns-create"></a>
+
+### `g8.campaigns.create`
+
+```ts
+g8.campaigns.create: (config: CampaignCreateConfig) => Promise<Campaign>
+```
+
+- Calls `POST /api/v1/campaigns` ([`g8.api.gtmCampaigns.createCampaign`](api/gtmCampaigns.md#op-createcampaign), tier `external`, scope `campaigns:run`)
+
+- Source: `src/campaigns.ts`
+
+<a id="g8-campaigns-get"></a>
+
+### `g8.campaigns.get`
+
+```ts
+g8.campaigns.get: (campaignId: string) => Promise<Campaign>
+```
+
+- Calls `GET /api/v1/campaigns/{campaign_id}` ([`g8.api.gtmCampaigns.getCampaign`](api/gtmCampaigns.md#op-getcampaign), tier `read`, scope `campaigns:read`)
+
+- Source: `src/campaigns.ts`
+
+<a id="g8-campaigns-launch"></a>
+
+### `g8.campaigns.launch`
+
+```ts
+g8.campaigns.launch: (campaignId: string) => Promise<CampaignLaunchResult>
+```
+
+- Calls `POST /api/v1/campaigns/{campaign_id}/launch` ([`g8.api.gtmCampaigns.launchCampaign`](api/gtmCampaigns.md#op-launchcampaign), tier `external`, scope `campaigns:launch`)
+
+- Source: `src/campaigns.ts`
+
+<a id="g8-campaigns-list"></a>
+
+### `g8.campaigns.list`
+
+```ts
+g8.campaigns.list: (page?: number, limit?: number) => Promise<Campaign[]>
+```
+
+- Calls `GET /api/v1/campaigns` ([`g8.api.gtmCampaigns.listCampaigns`](api/gtmCampaigns.md#op-listcampaigns), tier `read`, scope `campaigns:read`)
+
+- Source: `src/campaigns.ts`
+
+---
+
+<a id="g8-chat"></a>
+
+## `g8.chat`
+
+Types: `dist/types/chat.d.ts`
+
+<a id="g8-chat-close"></a>
+
+### `g8.chat.close`
+
+```ts
+g8.chat.close: () => void
+```
+
+Close the chat widget.
+
+- Source: `src/chat.ts`
+
+<a id="g8-chat-configure"></a>
+
+### `g8.chat.configure`
+
+```ts
+g8.chat.configure: (config: Partial<ChatConfig>) => void
+```
+
+Configure the chat appearance.
+
+- Source: `src/chat.ts`
+
+<a id="g8-chat-on"></a>
+
+### `g8.chat.on`
+
+```ts
+g8.chat.on: (event: ChatEvent, callback: ChatCallback) => void
+```
+
+Listen for chat events.
+
+- Source: `src/chat.ts`
+
+<a id="g8-chat-open"></a>
+
+### `g8.chat.open`
+
+```ts
+g8.chat.open: (config?: ChatConfig) => void
+```
+
+Open the chat widget.
+
+- Source: `src/chat.ts`
+
+<a id="g8-chat-send"></a>
+
+### `g8.chat.send`
+
+```ts
+g8.chat.send: (message: string) => void
+```
+
+Send a message.
+
+- Source: `src/chat.ts`
+
+---
+
+<a id="g8-companies"></a>
+
+## `g8.companies`
+
+Types: `dist/types/companies.d.ts`
+
+<a id="g8-companies-contacts"></a>
+
+### `g8.companies.contacts`
+
+```ts
+g8.companies.contacts: (companyId: number, limit?: number, offset?: number) => Promise<{ data: CompanyContact[]; total: number; }>
+```
+
+Get contacts belonging to a company.
+
+- Calls `GET /api/v1/companies/{company_id}/contacts` ([`g8.api.companies.getCompanyContacts`](api/companies.md#op-getcompanycontacts), tier `read`, scope `companies:read`)
+
+- Source: `src/companies.ts`
+
+<a id="g8-companies-create"></a>
+
+### `g8.companies.create`
+
+```ts
+g8.companies.create: (params: CompanyCreateParams) => Promise<CompanyCreateResult>
+```
+
+Create a company. `domain` is required and drives dedup — an existing company with the same domain is reused (`merged: true`) rather than duplicated. Routes to the same handler the in-app "add company" flow uses.
+
+- Calls `POST /api/v1/companies` ([`g8.api.companies.createCompany`](api/companies.md#op-createcompany), tier `write`, scope `companies:write`)
+
+- Source: `src/companies.ts`
+
+<a id="g8-companies-createcolumn"></a>
+
+### `g8.companies.createColumn`
+
+```ts
+g8.companies.createColumn: (params: CompanyColumnCreateParams) => Promise<CompanyColumn>
+```
+
+Create a custom company column. Global if list_id is omitted, list-scoped otherwise.
+
+- Calls `POST /api/v1/companies/columns/create` ([`g8.api.companies.createCompanyColumn`](api/companies.md#op-createcompanycolumn), tier `write`, scope `companies:write`)
+
+- Source: `src/companies.ts`
+
+<a id="g8-companies-delete"></a>
+
+### `g8.companies.delete`
+
+```ts
+g8.companies.delete: (companyId: number) => Promise<{ deleted: boolean; }>
+```
+
+Delete a company (soft-delete).
+
+- Calls `DELETE /api/v1/companies/{company_id}` ([`g8.api.companies.deleteCompany`](api/companies.md#op-deletecompany), tier `destructive`, scope `companies:delete`)
+
+- Source: `src/companies.ts`
+
+<a id="g8-companies-get"></a>
+
+### `g8.companies.get`
+
+```ts
+g8.companies.get: (companyId: number) => Promise<Company>
+```
+
+Get a single company by ID.
+
+- Calls `GET /api/v1/companies/{company_id}` ([`g8.api.companies.getCompany`](api/companies.md#op-getcompany), tier `read`, scope `companies:read`)
+
+- Source: `src/companies.ts`
+
+<a id="g8-companies-list"></a>
+
+### `g8.companies.list`
+
+```ts
+g8.companies.list: (params?: CompanyListParams) => Promise<{ data: Company[]; total: number; }>
+```
+
+List companies with optional filters.
+
+- Calls `GET /api/v1/companies` ([`g8.api.companies.listCompanies`](api/companies.md#op-listcompanies), tier `read`, scope `companies:read`)
+
+- Source: `src/companies.ts`
+
+<a id="g8-companies-listcolumns"></a>
+
+### `g8.companies.listColumns`
+
+```ts
+g8.companies.listColumns: (listId?: number) => Promise<{ data: CompanyColumn[]; }>
+```
+
+List custom company columns. Pass listId to include list-specific columns.
+
+- Calls `GET /api/v1/companies/columns` ([`g8.api.companies.listCompanyColumns`](api/companies.md#op-listcompanycolumns), tier `read`, scope `companies:read`)
+
+- Source: `src/companies.ts`
+
+<a id="g8-companies-update"></a>
+
+### `g8.companies.update`
+
+```ts
+g8.companies.update: (companyId: number, fields: CompanyUpdateParams) => Promise<{ updated: number; }>
+```
+
+Update a company (partial).
+
+- Calls `PATCH /api/v1/companies/{company_id}` ([`g8.api.companies.updateCompany`](api/companies.md#op-updatecompany), tier `write`, scope `companies:write`)
+
+- Source: `src/companies.ts`
+
+---
+
+<a id="g8-contacts"></a>
+
+## `g8.contacts`
+
+Types: `dist/types/contacts.d.ts`
+
+<a id="g8-contacts-create"></a>
+
+### `g8.contacts.create`
+
+```ts
+g8.contacts.create: (contact: ContactCreateParams, idempotencyKey?: string) => Promise<Contact>
+```
+
+Create a new contact. Pass `idempotencyKey` to make a retry safe — the same key returns the first result instead of creating a duplicate (A6). Create-only: if a contact with the same work_email / linkedin_url exists, this throws a 409 `G8Error` whose `detail.hint` / `detail.upsert` name the create-or-update route. When the contact may already exist, use `upsert()`.
+
+- Calls `POST /api/v1/contacts` ([`g8.api.contacts.createContacts`](api/contacts.md#op-createcontacts), tier `write`, scope `contacts:write`)
+
+- Source: `src/contacts.ts`
+
+<a id="g8-contacts-createcolumn"></a>
+
+### `g8.contacts.createColumn`
+
+```ts
+g8.contacts.createColumn: (params: ContactColumnCreateParams) => Promise<ContactColumn>
+```
+
+Create a custom contact column. Global if list_id is omitted, list-scoped otherwise.
+
+- Calls `POST /api/v1/contacts/columns/create` ([`g8.api.contacts.createContactColumn`](api/contacts.md#op-createcontactcolumn), tier `write`, scope `contacts:write`)
+
+- Source: `src/contacts.ts`
+
+<a id="g8-contacts-delete"></a>
+
+### `g8.contacts.delete`
+
+```ts
+g8.contacts.delete: (contactId: number) => Promise<{ deleted: boolean; }>
+```
+
+Delete a contact (soft-delete).
+
+- Calls `DELETE /api/v1/contacts/{contact_id}` ([`g8.api.contacts.deleteContact`](api/contacts.md#op-deletecontact), tier `destructive`, scope `contacts:delete`)
+
+- Source: `src/contacts.ts`
+
+<a id="g8-contacts-get"></a>
+
+### `g8.contacts.get`
+
+```ts
+g8.contacts.get: (contactId: number) => Promise<Contact>
+```
+
+Get a single contact by ID.
+
+- Calls `GET /api/v1/contacts/{contact_id}` ([`g8.api.contacts.getContact`](api/contacts.md#op-getcontact), tier `read`, scope `contacts:read`)
+
+- Source: `src/contacts.ts`
+
+<a id="g8-contacts-getmany"></a>
+
+### `g8.contacts.getMany`
+
+```ts
+g8.contacts.getMany: (contactIds: number[], options?: { includeCustomFields?: boolean; }) => Promise<ContactBulkGetItem[]>
+```
+
+Full records for many contacts (`POST /api/v1/contacts/bulk-get`), in input order. Any number of ids: they are sent 100 per request, so 1,000 ids cost 10 requests instead of 1,000 `get()` calls. Missing or out-of-scope ids come back `found: false` rather than throwing. Duplicate ids are read once.
+
+- Source: `src/contacts.ts`
+
+<a id="g8-contacts-list"></a>
+
+### `g8.contacts.list`
+
+```ts
+g8.contacts.list: (params?: ContactListParams) => Promise<{ data: Contact[]; total: number; }>
+```
+
+List contacts with optional filters.
+
+- Calls `GET /api/v1/contacts` ([`g8.api.contacts.listContacts`](api/contacts.md#op-listcontacts), tier `read`, scope `contacts:read`)
+
+- Source: `src/contacts.ts`
+
+<a id="g8-contacts-listcolumns"></a>
+
+### `g8.contacts.listColumns`
+
+```ts
+g8.contacts.listColumns: (listId?: number) => Promise<{ data: ContactColumn[]; }>
+```
+
+List custom contact columns. Pass listId to include list-specific columns.
+
+- Calls `GET /api/v1/contacts/columns` ([`g8.api.contacts.listContactColumns`](api/contacts.md#op-listcontactcolumns), tier `read`, scope `contacts:read`)
+
+- Source: `src/contacts.ts`
+
+<a id="g8-contacts-listdetailed"></a>
+
+### `g8.contacts.listDetailed`
+
+```ts
+g8.contacts.listDetailed: (params?: ContactListParams, options?: { includeCustomFields?: boolean; }) => Promise<{ data: ContactDetail[]; total: number; missing: number[]; }>
+```
+
+One page of `list()`, with every contact's FULL record (`created_at`, `updated_at`, `full_name`, `personal_emails`, `company`, ...). `list()` returns a leaner shape. Costs one `list()` request plus one `getMany()` request per 100 contacts on the page. `missing` holds ids that were listed but could not be read (for example deleted in between).
+
+- Calls `GET /api/v1/contacts` ([`g8.api.contacts.listContacts`](api/contacts.md#op-listcontacts), tier `read`, scope `contacts:read`)
+
+- Source: `src/contacts.ts`
+
+<a id="g8-contacts-update"></a>
+
+### `g8.contacts.update`
+
+```ts
+g8.contacts.update: (contactId: number, fields: ContactUpdateParams) => Promise<{ updated: number; }>
+```
+
+Update a contact (partial).
+
+- Calls `PATCH /api/v1/contacts/{contact_id}` ([`g8.api.contacts.updateContact`](api/contacts.md#op-updatecontact), tier `write`, scope `contacts:write`)
+
+- Source: `src/contacts.ts`
+
+<a id="g8-contacts-upsert"></a>
+
+### `g8.contacts.upsert`
+
+```ts
+g8.contacts.upsert: (contact: ContactUpsertParams) => Promise<ContactUpsertResult>
+```
+
+Create or update a contact in one idempotent call (`PUT /contacts/assert`). Matches by `work_email`, then `linkedin_url`. Prefer this over `create()` when the contact may already exist: `create()` returns a 409 for a duplicate, while `upsert()` updates it. Safe to retry. The server answers 400 (a `G8Error`) when neither `work_email` nor `linkedin_url` is given.
+
+- Calls `PUT /api/v1/contacts/assert` ([`g8.api.assertUpsert.assertContact`](api/assertUpsert.md#op-assertcontact), tier `write`, scope `contacts:write`)
+
+- Source: `src/contacts.ts`
+
+---
+
+<a id="g8-copilot"></a>
+
+## `g8.copilot`
+
+Types: `dist/types/copilot.d.ts`
+
+<a id="g8-copilot-ask"></a>
+
+### `g8.copilot.ask`
+
+```ts
+g8.copilot.ask: (message: string) => Promise<string>
+```
+
+Send a message to the copilot programmatically.
+
+- Calls `POST /api/v1/public/copilot/chat` ([`g8.api.publicCopilot.publicCopilotChat`](api/publicCopilot.md#op-publiccopilotchat), tier `write`)
+
+- Source: `src/copilot.ts`
+
+<a id="g8-copilot-close"></a>
+
+### `g8.copilot.close`
+
+```ts
+g8.copilot.close: () => void
+```
+
+Close the copilot widget.
+
+- Source: `src/copilot.ts`
+
+<a id="g8-copilot-on"></a>
+
+### `g8.copilot.on`
+
+```ts
+g8.copilot.on: (event: CopilotEvent, callback: CopilotCallback) => void
+```
+
+Listen for copilot events.
+
+- Source: `src/copilot.ts`
+
+<a id="g8-copilot-open"></a>
+
+### `g8.copilot.open`
+
+```ts
+g8.copilot.open: (config?: CopilotConfig) => void
+```
+
+Open the copilot widget.
+
+- Source: `src/copilot.ts`
+
+<a id="g8-copilot-registeraction"></a>
+
+### `g8.copilot.registerAction`
+
+```ts
+g8.copilot.registerAction: (name: string, handler: ActionHandler) => void
+```
+
+Register a custom action the copilot can trigger.
+
+- Source: `src/copilot.ts`
+
+---
+
+<a id="g8-deals"></a>
+
+## `g8.deals`
+
+Types: `dist/types/deals.d.ts`
+
+<a id="g8-deals-create"></a>
+
+### `g8.deals.create`
+
+```ts
+g8.deals.create: (deal: DealCreateParams) => Promise<Deal>
+```
+
+Create a new deal.
+
+- Calls `POST /api/v1/deals` ([`g8.api.deals.createDeal`](api/deals.md#op-createdeal), tier `write`, scope `deals:write`)
+
+- Source: `src/deals.ts`
+
+<a id="g8-deals-delete"></a>
+
+### `g8.deals.delete`
+
+```ts
+g8.deals.delete: (dealId: string) => Promise<{ data: { deleted: boolean; }; }>
+```
+
+Delete a deal.
+
+- Calls `DELETE /api/v1/deals/{deal_id}` ([`g8.api.deals.deleteDeal`](api/deals.md#op-deletedeal), tier `destructive`, scope `deals:delete`)
+
+- Source: `src/deals.ts`
+
+<a id="g8-deals-forcompany"></a>
+
+### `g8.deals.forCompany`
+
+```ts
+g8.deals.forCompany: (companyId: number) => Promise<{ data: ContactDeal[]; }>
+```
+
+Get all deals associated with a company.
+
+- Calls `GET /api/v1/companies/{company_id}/deals` ([`g8.api.deals.getCompanyDeals`](api/deals.md#op-getcompanydeals), tier `read`, scope `deals:read`)
+
+- Source: `src/deals.ts`
+
+<a id="g8-deals-forcontact"></a>
+
+### `g8.deals.forContact`
+
+```ts
+g8.deals.forContact: (contactId: number) => Promise<{ data: ContactDeal[]; }>
+```
+
+Get all deals associated with a contact.
+
+- Calls `GET /api/v1/contacts/{contact_id}/deals` ([`g8.api.deals.getContactDeals`](api/deals.md#op-getcontactdeals), tier `read`, scope `deals:read`)
+
+- Source: `src/deals.ts`
+
+<a id="g8-deals-get"></a>
+
+### `g8.deals.get`
+
+```ts
+g8.deals.get: (dealId: string) => Promise<Deal>
+```
+
+Get a single deal by ID.
+
+- Calls `GET /api/v1/deals/{deal_id}` ([`g8.api.deals.getDeal`](api/deals.md#op-getdeal), tier `read`, scope `deals:read`)
+
+- Source: `src/deals.ts`
+
+<a id="g8-deals-list"></a>
+
+### `g8.deals.list`
+
+```ts
+g8.deals.list: (params?: DealListParams) => Promise<{ data: Deal[]; pagination?: PaginationMeta; }>
+```
+
+List deals org-wide with optional filters and pagination.
+
+- Calls `GET /api/v1/deals` ([`g8.api.deals.listDeals`](api/deals.md#op-listdeals), tier `read`, scope `deals:read`)
+
+- Source: `src/deals.ts`
+
+<a id="g8-deals-pipelines"></a>
+
+### `g8.deals.pipelines`
+
+```ts
+g8.deals.pipelines: () => Promise<{ data: Pipeline[]; }>
+```
+
+List all deal pipelines and their stages.
+
+- Calls `GET /api/v1/deals/pipelines` ([`g8.api.deals.listPipelines`](api/deals.md#op-listpipelines), tier `read`, scope `deals:read`)
+
+- Source: `src/deals.ts`
+
+<a id="g8-deals-update"></a>
+
+### `g8.deals.update`
+
+```ts
+g8.deals.update: (dealId: string, fields: DealUpdateParams) => Promise<Deal>
+```
+
+Update a deal (partial).
+
+- Calls `PATCH /api/v1/deals/{deal_id}` ([`g8.api.deals.updateDeal`](api/deals.md#op-updatedeal), tier `write`, scope `deals:write`)
+
+- Source: `src/deals.ts`
+
+---
+
+<a id="g8-enrich"></a>
+
+## `g8.enrich`
+
+Types: `dist/types/enrich.d.ts`
+
+<a id="g8-enrich-company"></a>
+
+### `g8.enrich.company`
+
+```ts
+g8.enrich.company: (params: { domain?: string; name?: string; }) => Promise<CompanyEnrichment>
+```
+
+Look up a company by domain or name. Costs 1 credit.
+
+- Calls `POST /api/v1/enrichment/lookup/company` ([`g8.api.enrichment.lookupCompany`](api/enrichment.md#op-lookupcompany), tier `billable`, scope `enrichment:run`)
+
+- Source: `src/enrich.ts`
+
+<a id="g8-enrich-person"></a>
+
+### `g8.enrich.person`
+
+```ts
+g8.enrich.person: (params: { email?: string; linkedin_url?: string; first_name?: string; last_name?: string; company_domain?: string; }) => Promise<PersonEnrichment>
+```
+
+Look up a person by email, LinkedIn, or name + company. Costs 1 credit.
+
+- Calls `POST /api/v1/enrichment/lookup/person` ([`g8.api.enrichment.lookupPerson`](api/enrichment.md#op-lookupperson), tier `billable`, scope `enrichment:run`)
+
+- Source: `src/enrich.ts`
+
+<a id="g8-enrich-search"></a>
+
+### `g8.enrich.search`
+
+```ts
+g8.enrich.search: (filters: SearchFilter[], page?: number, limit?: number) => Promise<SearchResults>
+```
+
+Search 700M+ contacts with filters. Credits charged per result.
+
+- Calls `POST /api/v1/search/contacts` ([`g8.api.search.searchContacts`](api/search.md#op-searchcontacts), tier `billable`, scope `search:run`)
+
+- Source: `src/enrich.ts`
+
+<a id="g8-enrich-verifyemail"></a>
+
+### `g8.enrich.verifyEmail`
+
+```ts
+g8.enrich.verifyEmail: (email: string) => Promise<EmailVerification>
+```
+
+Verify an email address. Costs 1 credit.
+
+- Calls `POST /api/v1/enrichment/verify-email` ([`g8.api.enrichment.verifyEmail`](api/enrichment.md#op-verifyemail), tier `billable`, scope `enrichment:run`)
+
+- Source: `src/enrich.ts`
+
+---
+
+<a id="g8-fields"></a>
+
+## `g8.fields`
+
+Types: `dist/types/fields.d.ts`
+
+<a id="g8-fields-create"></a>
+
+### `g8.fields.create`
+
+```ts
+g8.fields.create: (params: FieldCreateParams) => Promise<CreatedField>
+```
+
+Create a custom field on contacts (default) or companies.
+
+- Calls `POST /api/v1/fields` ([`g8.api.fields.createField`](api/fields.md#op-createfield), tier `write`, scope `fields:write`)
+
+- Source: `src/fields.ts`
+
+<a id="g8-fields-delete"></a>
+
+### `g8.fields.delete`
+
+```ts
+g8.fields.delete: (columnId: number, params?: FieldDeleteParams) => Promise<{ data: { column_id: number; deleted: boolean; }; }>
+```
+
+Delete a custom field (soft-delete). Pass list_id to scope-guard against cross-list deletion.
+
+- Calls `DELETE /api/v1/fields/{column_id}` ([`g8.api.fields.deleteField`](api/fields.md#op-deletefield), tier `destructive`, scope `fields:delete`)
+
+- Source: `src/fields.ts`
+
+<a id="g8-fields-listcompanyfields"></a>
+
+### `g8.fields.listCompanyFields`
+
+```ts
+g8.fields.listCompanyFields: (listId?: number) => Promise<{ data: Field[]; }>
+```
+
+List company fields (base + custom). Pass listId to include list-specific custom fields.
+
+- Calls `GET /api/v1/fields/companies` ([`g8.api.fields.listCompanyFields`](api/fields.md#op-listcompanyfields), tier `read`, scope `fields:read`)
+
+- Source: `src/fields.ts`
+
+<a id="g8-fields-listcontactfields"></a>
+
+### `g8.fields.listContactFields`
+
+```ts
+g8.fields.listContactFields: (listId?: number) => Promise<{ data: Field[]; }>
+```
+
+List contact fields (base + custom). Pass listId to include list-specific custom fields.
+
+- Calls `GET /api/v1/fields` ([`g8.api.fields.listContactFields`](api/fields.md#op-listcontactfields), tier `read`, scope `fields:read`)
+
+- Source: `src/fields.ts`
+
+<a id="g8-fields-setvalue"></a>
+
+### `g8.fields.setValue`
+
+```ts
+g8.fields.setValue: (columnId: number, params: SetFieldValueParams) => Promise<{ data: { column_id: number; record_id: number; updated: boolean; }; }>
+```
+
+Set a custom field value on a single contact or company row. Pass value=null to clear.
+
+- Calls `PATCH /api/v1/fields/{column_id}/values` ([`g8.api.fields.setFieldValue`](api/fields.md#op-setfieldvalue), tier `write`, scope `fields:write`)
+
+- Source: `src/fields.ts`
+
+---
+
+<a id="g8-forms"></a>
+
+## `g8.forms`
+
+Types: `dist/types/forms.d.ts`
+
+<a id="g8-forms-lookup"></a>
+
+### `g8.forms.lookup`
+
+```ts
+g8.forms.lookup: (email: string) => Promise<EnrichLookupResult>
+```
+
+Look up known fields for an email address. Use this in progressive forms: after the user enters their email, check what graph8 already knows and only show missing fields.
+
+- Calls `POST /api/v1/public/enrich/lookup` ([`g8.api.public.publicEnrichLookup`](api/public.md#op-publicenrichlookup), tier `billable`)
+
+- Source: `src/forms.ts`
+
+---
+
+<a id="g8-inbox"></a>
+
+## `g8.inbox`
+
+Types: `dist/types/inbox.d.ts`
+
+<a id="g8-inbox-assign"></a>
+
+### `g8.inbox.assign`
+
+```ts
+g8.inbox.assign: (replyId: string, assigneeEmail: string, channel?: InboxChannel) => Promise<InboxAssignResult>
+```
+
+Assign a user to an inbox thread.
+
+- Calls `POST /api/v1/inbox/{reply_id}/assign` ([`g8.api.inbox.assignReply`](api/inbox.md#op-assignreply), tier `external`, scope `inbox:run`)
+
+- Source: `src/inbox.ts`
+
+<a id="g8-inbox-draft"></a>
+
+### `g8.inbox.draft`
+
+```ts
+g8.inbox.draft: (replyId: string, channel?: InboxChannel) => Promise<InboxDraft>
+```
+
+Generate an AI draft reply for a thread. Charges credits — server returns 402 if balance is insufficient.
+
+- Calls `GET /api/v1/inbox/{reply_id}/draft` ([`g8.api.inbox.getDraft`](api/inbox.md#op-getdraft), tier `read`, scope `inbox:read`)
+
+- Source: `src/inbox.ts`
+
+<a id="g8-inbox-get"></a>
+
+### `g8.inbox.get`
+
+```ts
+g8.inbox.get: (replyId: string, channel?: InboxChannel) => Promise<InboxThread>
+```
+
+Get a single inbox thread. Defaults to email channel.
+
+- Calls `GET /api/v1/inbox/{reply_id}` ([`g8.api.inbox.getReply`](api/inbox.md#op-getreply), tier `read`, scope `inbox:read`)
+
+- Source: `src/inbox.ts`
+
+<a id="g8-inbox-list"></a>
+
+### `g8.inbox.list`
+
+```ts
+g8.inbox.list: (params?: InboxListParams) => Promise<{ data: InboxThread[]; }>
+```
+
+List inbox threads across email, SMS, and LinkedIn.
+
+- Calls `GET /api/v1/inbox` ([`g8.api.inbox.listInbox`](api/inbox.md#op-listinbox), tier `read`, scope `inbox:read`)
+
+- Source: `src/inbox.ts`
+
+<a id="g8-inbox-send"></a>
+
+### `g8.inbox.send`
+
+```ts
+g8.inbox.send: (replyId: string, payload: InboxSendParams) => Promise<InboxSendResult>
+```
+
+Send a reply through email, SMS, or LinkedIn.
+
+- Calls `POST /api/v1/inbox/{reply_id}/send` ([`g8.api.inbox.sendReply`](api/inbox.md#op-sendreply), tier `external`, scope `inbox:run`)
+
+- Source: `src/inbox.ts`
+
+<a id="g8-inbox-tag"></a>
+
+### `g8.inbox.tag`
+
+```ts
+g8.inbox.tag: (replyId: string, tagIds: string[], channel?: InboxChannel) => Promise<InboxTagResult>
+```
+
+Attach tag IDs to an inbox thread.
+
+- Calls `POST /api/v1/inbox/{reply_id}/tag` ([`g8.api.inbox.tagReply`](api/inbox.md#op-tagreply), tier `external`, scope `inbox:run`)
+
+- Source: `src/inbox.ts`
+
+---
+
+<a id="g8-intent"></a>
+
+## `g8.intent`
+
+Types: `dist/types/intent.d.ts`
+
+<a id="g8-intent-createfromdomain"></a>
+
+### `g8.intent.createFromDomain`
+
+```ts
+g8.intent.createFromDomain: (domain: string) => Promise<{ data: IntentKeyword; }>
+```
+
+Create a keyword group from a domain (auto-tracks all pages).
+
+- Calls `POST /api/v1/intent/keywords/create-from-domain` ([`g8.api.intent.keywordsCreateFromDomain`](api/intent.md#op-keywordscreatefromdomain), tier `billable`, scope `intent:run`)
+
+- Source: `src/intent.ts`
+
+<a id="g8-intent-deletekeyword"></a>
+
+### `g8.intent.deleteKeyword`
+
+```ts
+g8.intent.deleteKeyword: (keywordId: string) => Promise<{ data: { deleted: boolean; }; }>
+```
+
+Stop tracking a keyword (irreversible — historical data is retained).
+
+- Calls `DELETE /api/v1/intent/keywords/{keyword_id}` ([`g8.api.intent.keywordsDelete`](api/intent.md#op-keywordsdelete), tier `destructive`, scope `intent:delete`)
+
+- Source: `src/intent.ts`
+
+<a id="g8-intent-keywordcompanies"></a>
+
+### `g8.intent.keywordCompanies`
+
+```ts
+g8.intent.keywordCompanies: (keywordId: string, params?: { limit?: number; date_from?: string; date_to?: string; }) => Promise<{ data: IntentCompany[]; }>
+```
+
+Companies showing interest in a tracked keyword.
+
+- Calls `POST /api/v1/intent/keywords/{keyword_id}/companies` ([`g8.api.intent.keywordCompanies`](api/intent.md#op-keywordcompanies), tier `billable`, scope `intent:run`)
+
+- Source: `src/intent.ts`
+
+<a id="g8-intent-keywordcontacts"></a>
+
+### `g8.intent.keywordContacts`
+
+```ts
+g8.intent.keywordContacts: (keywordId: string, params?: { limit?: number; date_from?: string; date_to?: string; }) => Promise<{ data: IntentContact[]; }>
+```
+
+Contacts showing interest in a tracked keyword.
+
+- Calls `POST /api/v1/intent/keywords/{keyword_id}/contacts` ([`g8.api.intent.keywordContacts`](api/intent.md#op-keywordcontacts), tier `billable`, scope `intent:run`)
+
+- Source: `src/intent.ts`
+
+<a id="g8-intent-keywordurls"></a>
+
+### `g8.intent.keywordUrls`
+
+```ts
+g8.intent.keywordUrls: (keywordId: string, params?: { limit?: number; }) => Promise<{ data: IntentPage[]; }>
+```
+
+URLs associated with a keyword (pages visitors landed on while interested).
+
+- Calls `POST /api/v1/intent/keywords/{keyword_id}/urls` ([`g8.api.intent.keywordUrls`](api/intent.md#op-keywordurls), tier `billable`, scope `intent:run`)
+
+- Source: `src/intent.ts`
+
+<a id="g8-intent-listkeywords"></a>
+
+### `g8.intent.listKeywords`
+
+```ts
+g8.intent.listKeywords: (params?: { page?: number; limit?: number; search?: string; }) => Promise<{ data: IntentKeyword[]; }>
+```
+
+List tracked keywords with optional pagination.
+
+- Calls `POST /api/v1/intent/keywords/list` ([`g8.api.intent.keywordsList`](api/intent.md#op-keywordslist), tier `billable`, scope `intent:run`)
+
+- Source: `src/intent.ts`
+
+<a id="g8-intent-pagecontacts"></a>
+
+### `g8.intent.pageContacts`
+
+```ts
+g8.intent.pageContacts: (pageUrl: string, params?: { limit?: number; }) => Promise<{ data: IntentContact[]; }>
+```
+
+Get contacts who visited a specific page URL.
+
+- Calls `POST /api/v1/intent/pages/contacts` ([`g8.api.intent.pagesContacts`](api/intent.md#op-pagescontacts), tier `billable`, scope `intent:run`)
+
+- Source: `src/intent.ts`
+
+<a id="g8-intent-pagevisitorcounts"></a>
+
+### `g8.intent.pageVisitorCounts`
+
+```ts
+g8.intent.pageVisitorCounts: (urls: string[]) => Promise<{ data: Array<{ url: string; visitor_count: number; }>; }>
+```
+
+Visitor count aggregates by page (pass an array of URLs).
+
+- Calls `POST /api/v1/intent/pages/visitor-counts` ([`g8.api.intent.pagesVisitorCounts`](api/intent.md#op-pagesvisitorcounts), tier `billable`, scope `intent:run`)
+
+- Source: `src/intent.ts`
+
+<a id="g8-intent-pagevisitors"></a>
+
+### `g8.intent.pageVisitors`
+
+```ts
+g8.intent.pageVisitors: (pageUrl: string, params?: { limit?: number; date_from?: string; date_to?: string; }) => Promise<{ data: IntentVisitor[]; }>
+```
+
+Get visitor records for a specific page URL.
+
+- Calls `POST /api/v1/intent/pages/visitors` ([`g8.api.intent.pagesVisitors`](api/intent.md#op-pagesvisitors), tier `billable`, scope `intent:run`)
+
+- Source: `src/intent.ts`
+
+<a id="g8-intent-pagesbydomain"></a>
+
+### `g8.intent.pagesByDomain`
+
+```ts
+g8.intent.pagesByDomain: (domain: string, params?: { limit?: number; }) => Promise<{ data: IntentPage[]; }>
+```
+
+Pages tracked on a specific domain.
+
+- Calls `POST /api/v1/intent/pages-by-domain` ([`g8.api.intent.pagesByDomain`](api/intent.md#op-pagesbydomain), tier `billable`, scope `intent:run`)
+
+- Source: `src/intent.ts`
+
+<a id="g8-intent-searchpages"></a>
+
+### `g8.intent.searchPages`
+
+```ts
+g8.intent.searchPages: (query: string, params?: { limit?: number; }) => Promise<{ data: IntentPage[]; }>
+```
+
+Search tracked pages by URL fragment or keyword.
+
+- Calls `POST /api/v1/intent/pages/search` ([`g8.api.intent.pagesSearch`](api/intent.md#op-pagessearch), tier `billable`, scope `intent:run`)
+
+- Source: `src/intent.ts`
+
+<a id="g8-intent-stats"></a>
+
+### `g8.intent.stats`
+
+```ts
+g8.intent.stats: () => Promise<{ data: IntentStats; }>
+```
+
+Org-level intent stats (totals over the last 30 days).
+
+- Calls `GET /api/v1/intent/stats` ([`g8.api.intent.intentStats`](api/intent.md#op-intentstats), tier `read`, scope `intent:read`)
+
+- Source: `src/intent.ts`
+
+<a id="g8-intent-urlcompanies"></a>
+
+### `g8.intent.urlCompanies`
+
+```ts
+g8.intent.urlCompanies: (url: string, params?: { limit?: number; days?: number; date_from?: string; date_to?: string; }) => Promise<IntentUrlCompaniesResponse>
+```
+
+Find companies whose users visited a specific URL (intent search). Previously posted to the bare-host `/intent-search/url-companies`, bypassing the shared `post()` helper. That route is JWT-only, so this method could never actually work with an API key. It now goes through `/api/v1/intent/url-companies` like the rest of the intent surface (g8 issue #16536). Returns a bare aggregate, NOT the `{ data }` envelope — the previous `{ data: IntentCompany[] }` signature never matched what the API sends. `date_from` / `date_to` are accepted for backwards compatibility but have never been read by this endpoint; use `days` to set the lookback window.
+
+- Calls `POST /api/v1/intent/url-companies` ([`g8.api.intent.urlCompanies`](api/intent.md#op-urlcompanies), tier `read`, scope `intent:read`)
+
+- Source: `src/intent.ts`
+
+---
+
+<a id="g8-lists"></a>
+
+## `g8.lists`
+
+Types: `dist/types/lists.d.ts`
+
+<a id="g8-lists-addcontacts"></a>
+
+### `g8.lists.addContacts`
+
+```ts
+g8.lists.addContacts: (listId: number, contactIds: number[]) => Promise<{ added: number; }>
+```
+
+Add contacts to a list.
+
+- Calls `POST /api/v1/lists/{list_id}/contacts` ([`g8.api.lists.addContactsToList`](api/lists.md#op-addcontactstolist), tier `write`, scope `lists:write`)
+
+- Source: `src/lists.ts`
+
+<a id="g8-lists-contacts"></a>
+
+### `g8.lists.contacts`
+
+```ts
+g8.lists.contacts: (listId: number, page?: number, limit?: number) => Promise<{ data: ListContact[]; total: number; }>
+```
+
+Get contacts in a list.
+
+- Calls `GET /api/v1/lists/{list_id}/contacts` ([`g8.api.lists.getListContacts`](api/lists.md#op-getlistcontacts), tier `read`, scope `lists:read`)
+
+- Source: `src/lists.ts`
+
+<a id="g8-lists-create"></a>
+
+### `g8.lists.create`
+
+```ts
+g8.lists.create: (title: string, type?: "contacts" | "companies") => Promise<ContactList>
+```
+
+Create a new list.
+
+- Calls `POST /api/v1/lists` ([`g8.api.lists.createList`](api/lists.md#op-createlist), tier `write`, scope `lists:write`)
+
+- Source: `src/lists.ts`
+
+<a id="g8-lists-delete"></a>
+
+### `g8.lists.delete`
+
+```ts
+g8.lists.delete: (listId: number) => Promise<{ deleted: boolean; }>
+```
+
+Delete a list (soft-delete).
+
+- Calls `DELETE /api/v1/lists/{list_id}` ([`g8.api.lists.deleteList`](api/lists.md#op-deletelist), tier `destructive`, scope `lists:delete`)
+
+- Source: `src/lists.ts`
+
+<a id="g8-lists-list"></a>
+
+### `g8.lists.list`
+
+```ts
+g8.lists.list: (page?: number, limit?: number) => Promise<{ data: ContactList[]; total: number; }>
+```
+
+List all lists.
+
+- Calls `GET /api/v1/lists` ([`g8.api.lists.listLists`](api/lists.md#op-listlists), tier `read`, scope `lists:read`)
+
+- Source: `src/lists.ts`
+
+<a id="g8-lists-removecontacts"></a>
+
+### `g8.lists.removeContacts`
+
+```ts
+g8.lists.removeContacts: (listId: number, contactIds: number[]) => Promise<{ removed: number; }>
+```
+
+Remove contacts from a list.
+
+- Calls `DELETE /api/v1/lists/{list_id}/contacts` ([`g8.api.lists.removeContactsFromList`](api/lists.md#op-removecontactsfromlist), tier `destructive`, scope `lists:delete`)
+
+- Source: `src/lists.ts`
+
+---
+
+<a id="g8-mailboxes"></a>
+
+## `g8.mailboxes`
+
+Types: `dist/types/mailboxes.d.ts`
+
+<a id="g8-mailboxes-create"></a>
+
+### `g8.mailboxes.create`
+
+```ts
+g8.mailboxes.create: (params: MailboxCreateParams) => Promise<Mailbox>
+```
+
+Connect an existing mailbox over IMAP/SMTP.
+
+- Calls `POST /api/v1/mailboxes` ([`g8.api.mailboxes.createMailbox`](api/mailboxes.md#op-createmailbox), tier `write`, scope `campaigns:write`)
+
+- Source: `src/mailboxes.ts`
+
+<a id="g8-mailboxes-delete"></a>
+
+### `g8.mailboxes.delete`
+
+```ts
+g8.mailboxes.delete: (mailboxId: number) => Promise<MailboxDeleteResult>
+```
+
+Delete a mailbox. Sequences already referencing it stop being able to send from it.
+
+- Calls `DELETE /api/v1/mailboxes/{mailbox_id}` ([`g8.api.mailboxes.deleteMailbox`](api/mailboxes.md#op-deletemailbox), tier `destructive`, scope `campaigns:delete`)
+
+- Source: `src/mailboxes.ts`
+
+<a id="g8-mailboxes-get"></a>
+
+### `g8.mailboxes.get`
+
+```ts
+g8.mailboxes.get: (mailboxId: number) => Promise<Mailbox>
+```
+
+Get a single mailbox by id. Credentials are never included.
+
+- Calls `GET /api/v1/mailboxes/{mailbox_id}` ([`g8.api.mailboxes.getMailbox`](api/mailboxes.md#op-getmailbox), tier `read`, scope `campaigns:read`)
+
+- Source: `src/mailboxes.ts`
+
+<a id="g8-mailboxes-list"></a>
+
+### `g8.mailboxes.list`
+
+```ts
+g8.mailboxes.list: (params?: MailboxListParams) => Promise<{ data: MailboxListItem[]; }>
+```
+
+List sending mailboxes in the org.
+
+- Calls `GET /api/v1/mailboxes` ([`g8.api.gtmContext.listMailboxes`](api/gtmContext.md#op-listmailboxes), tier `read`, scope `campaigns:read`)
+
+- Source: `src/mailboxes.ts`
+
+<a id="g8-mailboxes-testconnection"></a>
+
+### `g8.mailboxes.testConnection`
+
+```ts
+g8.mailboxes.testConnection: (mailboxId: number, params?: MailboxTestConnectionParams) => Promise<MailboxTestConnectionResult>
+```
+
+Verify a mailbox's IMAP/SMTP credentials and refresh its connection status. Call with no params (or `{}`) to test what is stored; supply overrides to test candidate values without saving them.
+
+- Calls `POST /api/v1/mailboxes/{mailbox_id}/test-connection` ([`g8.api.mailboxes.testMailboxConnection`](api/mailboxes.md#op-testmailboxconnection), tier `write`, scope `campaigns:write`)
+
+- Source: `src/mailboxes.ts`
+
+<a id="g8-mailboxes-update"></a>
+
+### `g8.mailboxes.update`
+
+```ts
+g8.mailboxes.update: (mailboxId: number, params: MailboxUpdateParams) => Promise<Mailbox>
+```
+
+Update a mailbox. Only supplied fields change; omitted fields are untouched.
+
+- Calls `PATCH /api/v1/mailboxes/{mailbox_id}` ([`g8.api.mailboxes.updateMailbox`](api/mailboxes.md#op-updatemailbox), tier `write`, scope `campaigns:write`)
+
+- Source: `src/mailboxes.ts`
+
+<a id="g8-mailboxes-warmup"></a>
+
+### `g8.mailboxes.warmup`
+
+```ts
+g8.mailboxes.warmup: (mailboxId: number) => Promise<MailboxWarmupAnalytics>
+```
+
+Get live warmup analytics for a single mailbox (a provider HTTP round-trip, ~300-800ms).
+
+- Calls `GET /api/v1/mailboxes/{mailbox_id}/warmup` ([`g8.api.gtmContext.getMailboxWarmupAnalytics`](api/gtmContext.md#op-getmailboxwarmupanalytics), tier `read`, scope `campaigns:read`)
+
+- Source: `src/mailboxes.ts`
+
+---
+
+<a id="g8-marketplace"></a>
+
+## `g8.marketplace`
+
+Types: `dist/types/marketplace.d.ts`
+
+<a id="g8-marketplace-acceptoffer"></a>
+
+### `g8.marketplace.acceptOffer`
+
+```ts
+g8.marketplace.acceptOffer: (hiringId: string) => Promise<Record<string, unknown>>
+```
+
+Accept a pending hire offer (by hiring id).
+
+- Calls `POST /api/v1/marketplace/me/offers/{hiring_id}/accept` ([`g8.api.marketplace.acceptMyOffer`](api/marketplace.md#op-acceptmyoffer), tier `billable`, scope `marketplace:run`)
+
+- Source: `src/marketplace.ts`
+
+<a id="g8-marketplace-hirings"></a>
+
+### `g8.marketplace.hirings`
+
+```ts
+g8.marketplace.hirings: () => Promise<{ hirings: MarketplaceHiring[]; count: number; }>
+```
+
+Your active hiring contracts.
+
+- Calls `GET /api/v1/marketplace/me/hirings` ([`g8.api.marketplace.listMyMarketplaceHirings`](api/marketplace.md#op-listmymarketplacehirings), tier `read`, scope `marketplace:read`)
+
+- Source: `src/marketplace.ts`
+
+<a id="g8-marketplace-offers"></a>
+
+### `g8.marketplace.offers`
+
+```ts
+g8.marketplace.offers: () => Promise<{ offers: MarketplaceOffer[]; count: number; }>
+```
+
+Pending hire offers you can accept or reject.
+
+- Calls `GET /api/v1/marketplace/me/offers` ([`g8.api.marketplace.listMyMarketplaceOffers`](api/marketplace.md#op-listmymarketplaceoffers), tier `read`, scope `marketplace:read`)
+
+- Source: `src/marketplace.ts`
+
+<a id="g8-marketplace-profile"></a>
+
+### `g8.marketplace.profile`
+
+```ts
+g8.marketplace.profile: () => Promise<MarketplaceProfile>
+```
+
+Your own marketplace SDR profile.
+
+- Calls `GET /api/v1/marketplace/me/profile` ([`g8.api.marketplace.getMyMarketplaceProfile`](api/marketplace.md#op-getmymarketplaceprofile), tier `read`, scope `marketplace:read`)
+
+- Source: `src/marketplace.ts`
+
+<a id="g8-marketplace-rejectoffer"></a>
+
+### `g8.marketplace.rejectOffer`
+
+```ts
+g8.marketplace.rejectOffer: (hiringId: string) => Promise<Record<string, unknown>>
+```
+
+Reject a pending hire offer (by hiring id).
+
+- Calls `POST /api/v1/marketplace/me/offers/{hiring_id}/reject` ([`g8.api.marketplace.rejectMyOffer`](api/marketplace.md#op-rejectmyoffer), tier `billable`, scope `marketplace:run`)
+
+- Source: `src/marketplace.ts`
+
+---
+
+<a id="g8-meetings"></a>
+
+## `g8.meetings`
+
+Types: `dist/types/meetings.d.ts`
+
+<a id="g8-meetings-get"></a>
+
+### `g8.meetings.get`
+
+```ts
+g8.meetings.get: (meetingId: string) => Promise<MeetingDetail>
+```
+
+Get full meeting detail including transcript + AI analysis (transcript available 1-5 min after meeting ends).
+
+- Calls `GET /api/v1/inbox/meetings/{meeting_id}` ([`g8.api.meetings.getMeeting`](api/meetings.md#op-getmeeting), tier `read`, scope `meetings:read`)
+
+- Source: `src/meetings.ts`
+
+<a id="g8-meetings-list"></a>
+
+### `g8.meetings.list`
+
+```ts
+g8.meetings.list: (params?: MeetingListParams) => Promise<{ data: MeetingSummary[]; pagination?: { page: number; limit: number; total: number; has_next: boolean; }; }>
+```
+
+List meetings with optional filters. Returns summary rows without transcript / analysis.
+
+- Calls `GET /api/v1/inbox/meetings` ([`g8.api.meetings.listMeetings`](api/meetings.md#op-listmeetings), tier `read`, scope `meetings:read`)
+
+- Source: `src/meetings.ts`
+
+---
+
+<a id="g8-newsletter"></a>
+
+## `g8.newsletter`
+
+Types: `dist/types/newsletter.d.ts`
+
+<a id="g8-newsletter-addsubscriber"></a>
+
+### `g8.newsletter.addSubscriber`
+
+```ts
+g8.newsletter.addSubscriber: (newsletterId: string, email: string, opts?: { first_name?: string; last_name?: string; }) => Promise<NewsletterSubscriber>
+```
+
+Add a subscriber to a newsletter. Mirrors `SubscriberAddRequest` (newsletter.py:77) — `email` required, `first_name`/`last_name` optional.
+
+- Calls `POST /api/v1/newsletters/{newsletter_id}/subscribers` ([`g8.api.newsletter.addSubscriber`](api/newsletter.md#op-addsubscriber), tier `external`, scope `newsletter:run`)
+
+- Source: `src/newsletter.ts`
+
+<a id="g8-newsletter-create"></a>
+
+### `g8.newsletter.create`
+
+```ts
+g8.newsletter.create: (params: NewsletterCreateParams) => Promise<Newsletter>
+```
+
+Create a newsletter. Mirrors `NewsletterCreateRequest` (newsletter.py:29).
+
+- Calls `POST /api/v1/newsletters` ([`g8.api.newsletter.createNewsletter`](api/newsletter.md#op-createnewsletter), tier `external`, scope `newsletter:run`)
+
+- Source: `src/newsletter.ts`
+
+<a id="g8-newsletter-createissue"></a>
+
+### `g8.newsletter.createIssue`
+
+```ts
+g8.newsletter.createIssue: (newsletterId: string, params: NewsletterIssueCreateParams) => Promise<NewsletterIssue>
+```
+
+Create an issue on a newsletter. Mirrors `IssueCreateRequest` (newsletter.py:42).
+
+- Calls `POST /api/v1/newsletters/{newsletter_id}/issues` ([`g8.api.newsletter.createIssue`](api/newsletter.md#op-createissue), tier `external`, scope `newsletter:run`)
+
+- Source: `src/newsletter.ts`
+
+<a id="g8-newsletter-duplicateissue"></a>
+
+### `g8.newsletter.duplicateIssue`
+
+```ts
+g8.newsletter.duplicateIssue: (newsletterId: string, issueId: string) => Promise<NewsletterIssue>
+```
+
+Duplicate an issue into a new draft.
+
+- Calls `POST /api/v1/newsletters/{newsletter_id}/issues/{issue_id}/duplicate` ([`g8.api.newsletter.duplicateIssue`](api/newsletter.md#op-duplicateissue), tier `external`, scope `newsletter:run`)
+
+- Source: `src/newsletter.ts`
+
+<a id="g8-newsletter-get"></a>
+
+### `g8.newsletter.get`
+
+```ts
+g8.newsletter.get: (newsletterId: string) => Promise<Newsletter>
+```
+
+Get a single newsletter.
+
+- Calls `GET /api/v1/newsletters/{newsletter_id}` ([`g8.api.newsletter.getNewsletter`](api/newsletter.md#op-getnewsletter), tier `read`, scope `newsletter:read`)
+
+- Source: `src/newsletter.ts`
+
+<a id="g8-newsletter-getissue"></a>
+
+### `g8.newsletter.getIssue`
+
+```ts
+g8.newsletter.getIssue: (newsletterId: string, issueId: string) => Promise<NewsletterIssue>
+```
+
+Get a single issue.
+
+- Calls `GET /api/v1/newsletters/{newsletter_id}/issues/{issue_id}` ([`g8.api.newsletter.getIssue`](api/newsletter.md#op-getissue), tier `read`, scope `newsletter:read`)
+
+- Source: `src/newsletter.ts`
+
+<a id="g8-newsletter-issuekpis"></a>
+
+### `g8.newsletter.issueKpis`
+
+```ts
+g8.newsletter.issueKpis: (newsletterId: string, issueId: string) => Promise<NewsletterIssueKpis>
+```
+
+Engagement KPIs for a sent issue.
+
+- Calls `GET /api/v1/newsletters/{newsletter_id}/issues/{issue_id}/analytics/kpis` ([`g8.api.newsletter.getIssueAnalyticsKpis`](api/newsletter.md#op-getissueanalyticskpis), tier `read`, scope `newsletter:read`)
+
+- Source: `src/newsletter.ts`
+
+<a id="g8-newsletter-list"></a>
+
+### `g8.newsletter.list`
+
+```ts
+g8.newsletter.list: (params?: NewsletterListParams) => Promise<{ data: Newsletter[]; }>
+```
+
+List newsletters for the org.
+
+- Calls `GET /api/v1/newsletters` ([`g8.api.newsletter.listNewsletters`](api/newsletter.md#op-listnewsletters), tier `read`, scope `newsletter:read`)
+
+- Source: `src/newsletter.ts`
+
+<a id="g8-newsletter-listissues"></a>
+
+### `g8.newsletter.listIssues`
+
+```ts
+g8.newsletter.listIssues: (newsletterId: string) => Promise<{ data: NewsletterIssue[]; }>
+```
+
+List issues of a newsletter.
+
+- Calls `GET /api/v1/newsletters/{newsletter_id}/issues` ([`g8.api.newsletter.listIssues`](api/newsletter.md#op-listissues), tier `read`, scope `newsletter:read`)
+
+- Source: `src/newsletter.ts`
+
+<a id="g8-newsletter-listsubscribers"></a>
+
+### `g8.newsletter.listSubscribers`
+
+```ts
+g8.newsletter.listSubscribers: (newsletterId: string, params?: NewsletterListParams) => Promise<{ data: NewsletterSubscriber[]; }>
+```
+
+List subscribers of a newsletter.
+
+- Calls `GET /api/v1/newsletters/{newsletter_id}/subscribers` ([`g8.api.newsletter.listSubscribers`](api/newsletter.md#op-listsubscribers), tier `read`, scope `newsletter:read`)
+
+- Source: `src/newsletter.ts`
+
+<a id="g8-newsletter-sendissue"></a>
+
+### `g8.newsletter.sendIssue`
+
+```ts
+g8.newsletter.sendIssue: (newsletterId: string, issueId: string, opts?: { idempotencyKey?: string; scheduled_at?: string; }) => Promise<{ data: unknown; }>
+```
+
+Send an issue to its subscribers. This sends real email — pass an `idempotencyKey` so a retry cannot double-send. `scheduled_at` mirrors `IssueSendRequest.scheduled_at` (newsletter.py:70); omitted (or left undefined) sends immediately, matching the DTO's own default. Note `idempotencyKey` is a transport header (`Idempotency-Key`), not a body field, so it is not part of the `IssueSendRequest` mirror.
+
+- Calls `POST /api/v1/newsletters/{newsletter_id}/issues/{issue_id}/send` ([`g8.api.newsletter.sendIssue`](api/newsletter.md#op-sendissue), tier `external`, scope `newsletter:run`)
+
+- Source: `src/newsletter.ts`
+
+<a id="g8-newsletter-sendtestemail"></a>
+
+### `g8.newsletter.sendTestEmail`
+
+```ts
+g8.newsletter.sendTestEmail: (newsletterId: string, issueId: string, testEmail: string) => Promise<{ data: unknown; }>
+```
+
+Send a test copy of an issue to a single address. Mirrors `IssueSendTestRequest` (newsletter.py:73): ONE required `test_email` string, not a `recipients` array — the previous shape here always 422'd against the real API.
+
+- Calls `POST /api/v1/newsletters/{newsletter_id}/issues/{issue_id}/send-test` ([`g8.api.newsletter.sendTestEmail`](api/newsletter.md#op-sendtestemail), tier `external`, scope `newsletter:run`)
+
+- Source: `src/newsletter.ts`
+
+<a id="g8-newsletter-templates"></a>
+
+### `g8.newsletter.templates`
+
+```ts
+g8.newsletter.templates: () => Promise<{ data: NewsletterTemplate[]; }>
+```
+
+List available newsletter templates.
+
+- Calls `GET /api/v1/newsletters/templates` ([`g8.api.newsletter.listTemplates`](api/newsletter.md#op-listtemplates), tier `read`, scope `newsletter:read`)
+
+- Source: `src/newsletter.ts`
+
+<a id="g8-newsletter-unsubscribe"></a>
+
+### `g8.newsletter.unsubscribe`
+
+```ts
+g8.newsletter.unsubscribe: (newsletterId: string, subscriberId: string) => Promise<{ data: unknown; }>
+```
+
+Unsubscribe a subscriber.
+
+- Calls `PATCH /api/v1/newsletters/{newsletter_id}/subscribers/{subscriber_id}/unsubscribe` ([`g8.api.newsletter.unsubscribeSubscriber`](api/newsletter.md#op-unsubscribesubscriber), tier `external`, scope `newsletter:run`)
+
+- Source: `src/newsletter.ts`
+
+<a id="g8-newsletter-updateissue"></a>
+
+### `g8.newsletter.updateIssue`
+
+```ts
+g8.newsletter.updateIssue: (newsletterId: string, issueId: string, params: NewsletterIssueUpdateParams) => Promise<NewsletterIssue>
+```
+
+Update fields on a draft issue. Partial — only the fields you pass are changed. Mirrors `IssueUpdateRequest` (newsletter.py:52), NOT `IssueCreateRequest`: every field is optional here even though the transport verb is PUT.
+
+- Calls `PUT /api/v1/newsletters/{newsletter_id}/issues/{issue_id}` ([`g8.api.newsletter.updateIssue`](api/newsletter.md#op-updateissue), tier `external`, scope `newsletter:run`)
+
+- Source: `src/newsletter.ts`
+
+---
+
+<a id="g8-notes"></a>
+
+## `g8.notes`
+
+Types: `dist/types/notes.d.ts`
+
+<a id="g8-notes-create"></a>
+
+### `g8.notes.create`
+
+```ts
+g8.notes.create: (contactId: number, content: string) => Promise<Note>
+```
+
+Create a note on a contact.
+
+- Calls `POST /api/v1/contacts/{contact_id}/notes` ([`g8.api.notes.createNote`](api/notes.md#op-createnote), tier `write`, scope `notes:write`)
+
+- Source: `src/notes.ts`
+
+<a id="g8-notes-createforcompany"></a>
+
+### `g8.notes.createForCompany`
+
+```ts
+g8.notes.createForCompany: (companyId: number, content: string) => Promise<Note>
+```
+
+Create a note on a company.
+
+- Calls `POST /api/v1/companies/{company_id}/notes` ([`g8.api.notes.createCompanyNote`](api/notes.md#op-createcompanynote), tier `write`, scope `notes:write`)
+
+- Source: `src/notes.ts`
+
+<a id="g8-notes-createfordeal"></a>
+
+### `g8.notes.createForDeal`
+
+```ts
+g8.notes.createForDeal: (dealId: string, content: string) => Promise<Note>
+```
+
+Create a note on a deal. `dealId` is a UUID string, not a number.
+
+- Calls `POST /api/v1/deals/{deal_id}/notes` ([`g8.api.notes.createDealNote`](api/notes.md#op-createdealnote), tier `write`, scope `notes:write`)
+
+- Source: `src/notes.ts`
+
+<a id="g8-notes-delete"></a>
+
+### `g8.notes.delete`
+
+```ts
+g8.notes.delete: (noteId: string) => Promise<{ data: { deleted: boolean; }; }>
+```
+
+Delete a note.
+
+- Calls `DELETE /api/v1/notes/{note_id}` ([`g8.api.notes.deleteNote`](api/notes.md#op-deletenote), tier `destructive`, scope `notes:delete`)
+
+- Source: `src/notes.ts`
+
+<a id="g8-notes-list"></a>
+
+### `g8.notes.list`
+
+```ts
+g8.notes.list: (contactId: number) => Promise<{ data: Note[]; }>
+```
+
+List all notes on a contact.
+
+- Calls `GET /api/v1/contacts/{contact_id}/notes` ([`g8.api.notes.listNotes`](api/notes.md#op-listnotes), tier `read`, scope `notes:read`)
+
+- Source: `src/notes.ts`
+
+<a id="g8-notes-listforcompany"></a>
+
+### `g8.notes.listForCompany`
+
+```ts
+g8.notes.listForCompany: (companyId: number) => Promise<{ data: Note[]; }>
+```
+
+List all notes on a company.
+
+- Calls `GET /api/v1/companies/{company_id}/notes` ([`g8.api.notes.listCompanyNotes`](api/notes.md#op-listcompanynotes), tier `read`, scope `notes:read`)
+
+- Source: `src/notes.ts`
+
+<a id="g8-notes-listfordeal"></a>
+
+### `g8.notes.listForDeal`
+
+```ts
+g8.notes.listForDeal: (dealId: string) => Promise<{ data: Note[]; }>
+```
+
+List all notes on a deal. `dealId` is a UUID string, not a number.
+
+- Calls `GET /api/v1/deals/{deal_id}/notes` ([`g8.api.notes.listDealNotes`](api/notes.md#op-listdealnotes), tier `read`, scope `notes:read`)
+
+- Source: `src/notes.ts`
+
+<a id="g8-notes-update"></a>
+
+### `g8.notes.update`
+
+```ts
+g8.notes.update: (noteId: string, content: string) => Promise<Note>
+```
+
+Update a note's content. Works for contact, company and deal notes.
+
+- Calls `PATCH /api/v1/notes/{note_id}` ([`g8.api.notes.updateNote`](api/notes.md#op-updatenote), tier `write`, scope `notes:write`)
+
+- Source: `src/notes.ts`
+
+---
+
+<a id="g8-objects"></a>
+
+## `g8.objects`
+
+Types: `dist/types/objects.d.ts`
+
+<a id="g8-objects-archive"></a>
+
+### `g8.objects.archive`
+
+```ts
+g8.objects.archive: (objectSlug: string) => Promise<CustomObject>
+```
+
+Archive the object without deleting records; restore with update({ is_archived: false }).
+
+- Calls `DELETE /api/v1/objects/{object_slug}` ([`g8.api.objects.archiveObject`](api/objects.md#op-archiveobject), tier `destructive`, scope `objects:manage`)
+
+- Source: `src/objects.ts`
+
+<a id="g8-objects-archiveattribute"></a>
+
+### `g8.objects.archiveAttribute`
+
+```ts
+g8.objects.archiveAttribute: (objectSlug: string, attributeSlug: string) => Promise<CustomObjectAttribute>
+```
+
+Archive without deleting values; restore with updateAttribute({ is_archived: false }).
+
+- Calls `DELETE /api/v1/objects/{object_slug}/attributes/{attr_slug}` ([`g8.api.objects.archiveAttribute`](api/objects.md#op-archiveattribute), tier `destructive`, scope `objects:manage`)
+
+- Source: `src/objects.ts`
+
+<a id="g8-objects-archiverecord"></a>
+
+### `g8.objects.archiveRecord`
+
+```ts
+g8.objects.archiveRecord: (objectSlug: string, recordId: string) => Promise<CustomObjectRecord>
+```
+
+Archive a record. It leaves listings, stays readable by id, and keeps its history and associations. Nothing is destroyed.
+
+- Calls `DELETE /api/v1/objects/{object_slug}/records/{record_id}` ([`g8.api.objects.archiveObjectRecord`](api/objects.md#op-archiveobjectrecord), tier `destructive`, scope `objects:delete`)
+
+- Source: `src/objects.ts`
+
+<a id="g8-objects-changes"></a>
+
+### `g8.objects.changes`
+
+```ts
+g8.objects.changes: (objectSlug: string, recordId: string, options?: { limit?: number; cursor?: string; }) => Promise<CustomObjectMutations>
+```
+
+Recorded custom-record or canonical contact/company mutations. Pass next_cursor to continue. Canonical history respects current access/privacy; archived records and older unrecorded writes are not reconstructed. Store unavailability returns 503.
+
+- Calls `GET /api/v1/objects/{object_slug}/records/{record_id}/changes` ([`g8.api.objects.getObjectRecordChanges`](api/objects.md#op-getobjectrecordchanges), tier `read`, scope `objects:read`)
+
+- Source: `src/objects.ts`
+
+<a id="g8-objects-create"></a>
+
+### `g8.objects.create`
+
+```ts
+g8.objects.create: (input: CreateCustomObject) => Promise<CustomObject>
+```
+
+Create a native custom object. Requires objects:manage and Admin access.
+
+- Calls `POST /api/v1/objects` ([`g8.api.objects.createObject`](api/objects.md#op-createobject), tier `write`, scope `objects:manage`)
+
+- Source: `src/objects.ts`
+
+<a id="g8-objects-createattribute"></a>
+
+### `g8.objects.createAttribute`
+
+```ts
+g8.objects.createAttribute: (objectSlug: string, input: CreateCustomObjectAttribute) => Promise<CustomObjectAttribute>
+```
+
+Create a field using the same schema rules as the customer UI.
+
+- Calls `POST /api/v1/objects/{object_slug}/attributes` ([`g8.api.objects.createAttribute`](api/objects.md#op-createattribute), tier `write`, scope `objects:manage`)
+
+- Source: `src/objects.ts`
+
+<a id="g8-objects-createrecord"></a>
+
+### `g8.objects.createRecord`
+
+```ts
+g8.objects.createRecord: (objectSlug: string, values: Record<string, unknown>) => Promise<CustomObjectRecord>
+```
+
+Create a record. Every field is validated against the object's attributes; an unknown one is a 422 listing every problem at once, and a collision on a unique attribute is a 409.
+
+- Calls `POST /api/v1/objects/{object_slug}/records` ([`g8.api.objects.createObjectRecord`](api/objects.md#op-createobjectrecord), tier `write`, scope `objects:write`)
+
+- Source: `src/objects.ts`
+
+<a id="g8-objects-get"></a>
+
+### `g8.objects.get`
+
+```ts
+g8.objects.get: (objectSlug: string) => Promise<CustomObject>
+```
+
+Fetch one object type by slug.
+
+- Calls `GET /api/v1/objects/{object_slug}` ([`g8.api.objects.getObject`](api/objects.md#op-getobject), tier `read`, scope `objects:read`)
+
+- Source: `src/objects.ts`
+
+<a id="g8-objects-getrecord"></a>
+
+### `g8.objects.getRecord`
+
+```ts
+g8.objects.getRecord: (objectSlug: string, recordId: string) => Promise<CustomObjectRecord>
+```
+
+Fetch one custom record, canonical contact/company, or deal by its stable graph8 ID. Deals retain their UUIDs and expose company, primary-contact and contact_ids references only when permitted. Generic deal mutations are not yet supported.
+
+- Calls `GET /api/v1/objects/{object_slug}/records/{record_id}` ([`g8.api.objects.getObjectRecord`](api/objects.md#op-getobjectrecord), tier `read`, scope `objects:read`)
+
+- Source: `src/objects.ts`
+
+<a id="g8-objects-history"></a>
+
+### `g8.objects.history`
+
+```ts
+g8.objects.history: (objectSlug: string, recordId: string, limit?: number) => Promise<CustomObjectHistory>
+```
+
+A record's value timeline, newest first. An entry whose `active_until` is null is the value currently in force.
+
+- Calls `GET /api/v1/objects/{object_slug}/records/{record_id}/history` ([`g8.api.objects.getObjectRecordHistory`](api/objects.md#op-getobjectrecordhistory), tier `read`, scope `objects:read`)
+
+- Source: `src/objects.ts`
+
+<a id="g8-objects-list"></a>
+
+### `g8.objects.list`
+
+```ts
+g8.objects.list: (params?: { include_archived?: boolean; }) => Promise<{ data: CustomObject[]; }>
+```
+
+List the custom object types in your workspace.
+
+- Calls `GET /api/v1/objects` ([`g8.api.objects.listObjects`](api/objects.md#op-listobjects), tier `read`, scope `objects:read`)
+
+- Source: `src/objects.ts`
+
+<a id="g8-objects-listattributes"></a>
+
+### `g8.objects.listAttributes`
+
+```ts
+g8.objects.listAttributes: (objectSlug: string, params?: { include_archived?: boolean; }) => Promise<{ data: CustomObjectAttribute[]; }>
+```
+
+The object's attributes — the schema its records must satisfy.
+
+- Calls `GET /api/v1/objects/{object_slug}/attributes` ([`g8.api.objects.listObjectAttributes`](api/objects.md#op-listobjectattributes), tier `read`, scope `objects:read`)
+
+- Source: `src/objects.ts`
+
+<a id="g8-objects-listrecords"></a>
+
+### `g8.objects.listRecords`
+
+```ts
+g8.objects.listRecords: (objectSlug: string, params?: ListRecordsParams) => Promise<{ data: CustomObjectRecord[]; pagination?: ObjectPagination; }>
+```
+
+Paginated custom records or canonical deals with current values and revisions. Deal totals and related references respect current record access.
+
+- Calls `GET /api/v1/objects/{object_slug}/records` ([`g8.api.objects.listObjectRecords`](api/objects.md#op-listobjectrecords), tier `read`, scope `objects:read`)
+
+- Source: `src/objects.ts`
+
+<a id="g8-objects-restorerecord"></a>
+
+### `g8.objects.restoreRecord`
+
+```ts
+g8.objects.restoreRecord: (objectSlug: string, recordId: string) => Promise<CustomObjectRecord>
+```
+
+Restore archived values under current constraints. Conflicts leave the record archived.
+
+- Calls `POST /api/v1/objects/{object_slug}/records/{record_id}/restore` ([`g8.api.objects.restoreObjectRecord`](api/objects.md#op-restoreobjectrecord), tier `write`, scope `objects:write`)
+
+- Source: `src/objects.ts`
+
+<a id="g8-objects-update"></a>
+
+### `g8.objects.update`
+
+```ts
+g8.objects.update: (objectSlug: string, input: UpdateCustomObject) => Promise<CustomObject>
+```
+
+Rename, archive or restore an object while preserving its slug and data.
+
+- Calls `PATCH /api/v1/objects/{object_slug}` ([`g8.api.objects.updateObject`](api/objects.md#op-updateobject), tier `write`, scope `objects:manage`)
+
+- Source: `src/objects.ts`
+
+<a id="g8-objects-updateattribute"></a>
+
+### `g8.objects.updateAttribute`
+
+```ts
+g8.objects.updateAttribute: (objectSlug: string, attributeSlug: string, input: UpdateCustomObjectAttribute) => Promise<CustomObjectAttribute>
+```
+
+Edit or restore a field; its type and slug are immutable.
+
+- Calls `PATCH /api/v1/objects/{object_slug}/attributes/{attr_slug}` ([`g8.api.objects.updateAttribute`](api/objects.md#op-updateattribute), tier `write`, scope `objects:manage`)
+
+- Source: `src/objects.ts`
+
+<a id="g8-objects-updaterecord"></a>
+
+### `g8.objects.updateRecord`
+
+```ts
+g8.objects.updateRecord: (objectSlug: string, recordId: string, values: Record<string, unknown>, options?: { expectedRevision?: number; appendValues?: Record<string, unknown[]>; removeValues?: Record<string, unknown[]>; }) => Promise<CustomObjectRecord>
+```
+
+Update a record. PARTIAL: only the attributes you send are touched, so required attributes you omit are left alone rather than reported missing. Sending an explicit `null` CLEARS that attribute. Custom values retain generations through `history`. Canonical contacts and companies require expectedRevision from a fresh read and expose recorded mutations through `changes`. They do not yet support appendValues/removeValues.
+
+- Calls `PATCH /api/v1/objects/{object_slug}/records/{record_id}` ([`g8.api.objects.updateObjectRecord`](api/objects.md#op-updateobjectrecord), tier `write`, scope `objects:write`)
+
+- Source: `src/objects.ts`
+
+<a id="g8-objects-upsertrecord"></a>
+
+### `g8.objects.upsertRecord`
+
+```ts
+g8.objects.upsertRecord: (objectSlug: string, matchingAttribute: string, values: Record<string, unknown>, options?: { expectedRevision?: number; }) => Promise<CustomObjectRecord>
+```
+
+Match a unique single-value key, creating or updating while preserving omitted fields.
+
+- Calls `POST /api/v1/objects/{object_slug}/records/upsert` ([`g8.api.objects.upsertObjectRecord`](api/objects.md#op-upsertobjectrecord), tier `write`, scope `objects:write`)
+
+- Source: `src/objects.ts`
+
+---
+
+<a id="g8-pipelines"></a>
+
+## `g8.pipelines`
+
+Types: `dist/types/pipelines.d.ts`
+
+<a id="g8-pipelines-create"></a>
+
+### `g8.pipelines.create`
+
+```ts
+g8.pipelines.create: (params: StagePipelineCreateParams) => Promise<StagePipeline>
+```
+
+Create a new pipeline. Defaults to a templated set of stages; pass blank=true for empty.
+
+- Calls `POST /api/v1/pipelines` ([`g8.api.cliPipelines.createPipeline`](api/cliPipelines.md#op-createpipeline), tier `write`, scope `campaigns:write`)
+
+- Source: `src/pipelines.ts`
+
+<a id="g8-pipelines-createstage"></a>
+
+### `g8.pipelines.createStage`
+
+```ts
+g8.pipelines.createStage: (pipelineId: string, stage: StageCreateParams) => Promise<StagePipelineStage>
+```
+
+Add a new stage to a pipeline.
+
+- Calls `POST /api/v1/pipelines/{pipeline_id}/stages` ([`g8.api.cliPipelines.createStage`](api/cliPipelines.md#op-createstage), tier `write`, scope `campaigns:write`)
+
+- Source: `src/pipelines.ts`
+
+<a id="g8-pipelines-delete"></a>
+
+### `g8.pipelines.delete`
+
+```ts
+g8.pipelines.delete: (pipelineId: string) => Promise<{ data: { deleted: boolean; }; }>
+```
+
+Delete a pipeline. Only allowed when no deals reference it.
+
+- Calls `DELETE /api/v1/pipelines/{pipeline_id}` ([`g8.api.cliPipelines.deletePipeline`](api/cliPipelines.md#op-deletepipeline), tier `destructive`, scope `campaigns:delete`)
+
+- Source: `src/pipelines.ts`
+
+<a id="g8-pipelines-deletestage"></a>
+
+### `g8.pipelines.deleteStage`
+
+```ts
+g8.pipelines.deleteStage: (pipelineId: string, stageId: string) => Promise<{ data: { deleted: boolean; }; }>
+```
+
+Delete a stage from a pipeline.
+
+- Calls `DELETE /api/v1/pipelines/{pipeline_id}/stages/{stage_id}` ([`g8.api.cliPipelines.deleteStage`](api/cliPipelines.md#op-deletestage), tier `destructive`, scope `campaigns:delete`)
+
+- Source: `src/pipelines.ts`
+
+<a id="g8-pipelines-evidencelibrary"></a>
+
+### `g8.pipelines.evidenceLibrary`
+
+```ts
+g8.pipelines.evidenceLibrary: () => Promise<{ data: EvidenceKey[]; }>
+```
+
+Get the canonical evidence-key library (used when defining stages).
+
+- Calls `GET /api/v1/pipelines/evidence-library` ([`g8.api.cliPipelines.listStageEvidenceLibrary`](api/cliPipelines.md#op-liststageevidencelibrary), tier `read`, scope `campaigns:read`)
+
+- Source: `src/pipelines.ts`
+
+<a id="g8-pipelines-fromsuggestion"></a>
+
+### `g8.pipelines.fromSuggestion`
+
+```ts
+g8.pipelines.fromSuggestion: (suggestionId: string, overrides?: Partial<{ name: string; target: string; }>) => Promise<StagePipeline>
+```
+
+Create a real pipeline from an AI suggestion (optionally with overrides).
+
+- Calls `POST /api/v1/pipelines/from-suggestion` ([`g8.api.cliPipelines.createPipelineFromSuggestion`](api/cliPipelines.md#op-createpipelinefromsuggestion), tier `write`, scope `campaigns:write`)
+
+- Source: `src/pipelines.ts`
+
+<a id="g8-pipelines-get"></a>
+
+### `g8.pipelines.get`
+
+```ts
+g8.pipelines.get: (pipelineId: string) => Promise<StagePipeline>
+```
+
+Get a single pipeline by ID.
+
+- Calls `GET /api/v1/pipelines/{pipeline_id}` ([`g8.api.cliPipelines.getPipeline`](api/cliPipelines.md#op-getpipeline), tier `read`, scope `campaigns:read`)
+
+- Source: `src/pipelines.ts`
+
+<a id="g8-pipelines-list"></a>
+
+### `g8.pipelines.list`
+
+```ts
+g8.pipelines.list: () => Promise<{ data: StagePipeline[]; }>
+```
+
+List all stage-checklist pipelines with stages, evidence, scripts.
+
+- Calls `GET /api/v1/pipelines` ([`g8.api.cliPipelines.listPipelines`](api/cliPipelines.md#op-listpipelines), tier `read`, scope `campaigns:read`)
+
+- Source: `src/pipelines.ts`
+
+<a id="g8-pipelines-reorderstages"></a>
+
+### `g8.pipelines.reorderStages`
+
+```ts
+g8.pipelines.reorderStages: (pipelineId: string, stageIds: string[]) => Promise<{ data: StagePipelineStage[]; }>
+```
+
+Reorder stages within a pipeline (pass full ordered list of stage IDs).
+
+- Calls `PUT /api/v1/pipelines/{pipeline_id}/stages/reorder` ([`g8.api.cliPipelines.reorderStages`](api/cliPipelines.md#op-reorderstages), tier `write`, scope `campaigns:write`)
+
+- Source: `src/pipelines.ts`
+
+<a id="g8-pipelines-suggest"></a>
+
+### `g8.pipelines.suggest`
+
+```ts
+g8.pipelines.suggest: () => Promise<{ data: PipelineSuggestion; }>
+```
+
+Get an AI-suggested pipeline based on org context (brand, ICP, messaging).
+
+- Calls `POST /api/v1/pipelines/suggest` ([`g8.api.cliPipelines.suggestPipeline`](api/cliPipelines.md#op-suggestpipeline), tier `billable`, scope `campaigns:run`)
+
+- Source: `src/pipelines.ts`
+
+<a id="g8-pipelines-update"></a>
+
+### `g8.pipelines.update`
+
+```ts
+g8.pipelines.update: (pipelineId: string, fields: StagePipelineUpdateParams) => Promise<StagePipeline>
+```
+
+Update pipeline metadata (name, target).
+
+- Calls `PUT /api/v1/pipelines/{pipeline_id}` ([`g8.api.cliPipelines.updatePipeline`](api/cliPipelines.md#op-updatepipeline), tier `write`, scope `campaigns:write`)
+
+- Source: `src/pipelines.ts`
+
+<a id="g8-pipelines-updatestage"></a>
+
+### `g8.pipelines.updateStage`
+
+```ts
+g8.pipelines.updateStage: (pipelineId: string, stageId: string, fields: StageUpdateParams) => Promise<StagePipelineStage>
+```
+
+Update a stage (evidence, scripts, position).
+
+- Calls `PUT /api/v1/pipelines/{pipeline_id}/stages/{stage_id}` ([`g8.api.cliPipelines.updateStage`](api/cliPipelines.md#op-updatestage), tier `write`, scope `campaigns:write`)
+
+- Source: `src/pipelines.ts`
+
+---
+
+<a id="g8-quotes"></a>
+
+## `g8.quotes`
+
+Types: `dist/types/quotes.d.ts`
+
+<a id="g8-quotes-create"></a>
+
+### `g8.quotes.create`
+
+```ts
+g8.quotes.create: (quote: QuoteCreateParams) => Promise<QuoteDetail>
+```
+
+Create a new quote from line items.
+
+- Calls `POST /api/v1/quotes` ([`g8.api.quotes.createQuote`](api/quotes.md#op-createquote), tier `external`, scope `quotes:run`)
+
+- Source: `src/quotes.ts`
+
+<a id="g8-quotes-delete"></a>
+
+### `g8.quotes.delete`
+
+```ts
+g8.quotes.delete: (quoteId: string) => Promise<{ data: { deleted: boolean; }; }>
+```
+
+Delete a draft quote (irreversible).
+
+- Calls `DELETE /api/v1/quotes/{quote_id}` ([`g8.api.quotes.deleteQuote`](api/quotes.md#op-deletequote), tier `destructive`, scope `quotes:delete`)
+
+- Source: `src/quotes.ts`
+
+<a id="g8-quotes-duplicate"></a>
+
+### `g8.quotes.duplicate`
+
+```ts
+g8.quotes.duplicate: (quoteId: string) => Promise<QuoteDetail>
+```
+
+Duplicate an existing quote (all line items copied into a new draft).
+
+- Calls `POST /api/v1/quotes/{quote_id}/duplicate` ([`g8.api.quotes.duplicateQuote`](api/quotes.md#op-duplicatequote), tier `external`, scope `quotes:run`)
+
+- Source: `src/quotes.ts`
+
+<a id="g8-quotes-editasdraft"></a>
+
+### `g8.quotes.editAsDraft`
+
+```ts
+g8.quotes.editAsDraft: (quoteId: string) => Promise<{ data: { id: string; status: string; }; }>
+```
+
+Convert a signed / sent quote back to editable draft state.
+
+- Calls `POST /api/v1/quotes/{quote_id}/edit-as-draft` ([`g8.api.quotes.editQuoteAsDraft`](api/quotes.md#op-editquoteasdraft), tier `external`, scope `quotes:run`)
+
+- Source: `src/quotes.ts`
+
+<a id="g8-quotes-forcompany"></a>
+
+### `g8.quotes.forCompany`
+
+```ts
+g8.quotes.forCompany: (companyId: number) => Promise<{ data: QuoteSummary[]; }>
+```
+
+Get all quotes associated with a company.
+
+- Calls `GET /api/v1/companies/{company_id}/quotes` ([`g8.api.quotes.getCompanyQuotes`](api/quotes.md#op-getcompanyquotes), tier `read`, scope `quotes:read`)
+
+- Source: `src/quotes.ts`
+
+<a id="g8-quotes-forcontact"></a>
+
+### `g8.quotes.forContact`
+
+```ts
+g8.quotes.forContact: (contactId: number) => Promise<{ data: QuoteSummary[]; }>
+```
+
+Get all quotes associated with a contact.
+
+- Calls `GET /api/v1/contacts/{contact_id}/quotes` ([`g8.api.quotes.getContactQuotes`](api/quotes.md#op-getcontactquotes), tier `read`, scope `quotes:read`)
+
+- Source: `src/quotes.ts`
+
+<a id="g8-quotes-get"></a>
+
+### `g8.quotes.get`
+
+```ts
+g8.quotes.get: (quoteId: string) => Promise<QuoteDetail>
+```
+
+Get full details for a single quote.
+
+- Calls `GET /api/v1/quotes/{quote_id}` ([`g8.api.quotes.getQuote`](api/quotes.md#op-getquote), tier `read`, scope `quotes:read`)
+
+- Source: `src/quotes.ts`
+
+<a id="g8-quotes-list"></a>
+
+### `g8.quotes.list`
+
+```ts
+g8.quotes.list: (params?: QuoteListParams) => Promise<{ data: QuoteSummary[]; pagination?: PaginationMeta; }>
+```
+
+List quotes org-wide with optional filters and pagination.
+
+- Calls `GET /api/v1/quotes` ([`g8.api.quotes.listQuotes`](api/quotes.md#op-listquotes), tier `read`, scope `quotes:read`)
+
+- Source: `src/quotes.ts`
+
+<a id="g8-quotes-products"></a>
+
+### `g8.quotes.products`
+
+```ts
+g8.quotes.products: () => Promise<{ data: QuotableProduct[]; }>
+```
+
+List products available for line items.
+
+- Calls `GET /api/v1/quotable-products` ([`g8.api.quotes.listQuotableProducts`](api/quotes.md#op-listquotableproducts), tier `read`, scope `quotes:read`)
+
+- Source: `src/quotes.ts`
+
+<a id="g8-quotes-send"></a>
+
+### `g8.quotes.send`
+
+```ts
+g8.quotes.send: (quoteId: string, params: QuoteSendParams) => Promise<QuoteDetail>
+```
+
+Send a quote to its recipient via email (with signature + optional payment link).
+
+- Calls `POST /api/v1/quotes/{quote_id}/send` ([`g8.api.quotes.sendQuote`](api/quotes.md#op-sendquote), tier `external`, scope `quotes:run`)
+
+- Source: `src/quotes.ts`
+
+<a id="g8-quotes-settings"></a>
+
+### `g8.quotes.settings`
+
+```ts
+g8.quotes.settings: () => Promise<QuoteSettings>
+```
+
+Get org-level quote settings (currency, tax rate, payment providers, logo).
+
+- Calls `GET /api/v1/quote-settings` ([`g8.api.quotes.getQuoteSettings`](api/quotes.md#op-getquotesettings), tier `read`, scope `quotes:read`)
+
+- Source: `src/quotes.ts`
+
+<a id="g8-quotes-update"></a>
+
+### `g8.quotes.update`
+
+```ts
+g8.quotes.update: (quoteId: string, fields: QuoteUpdateParams) => Promise<QuoteDetail>
+```
+
+Update a draft quote (line items, expiry, notes).
+
+- Calls `PUT /api/v1/quotes/{quote_id}` ([`g8.api.quotes.updateQuotePut`](api/quotes.md#op-updatequoteput), tier `external`, scope `quotes:run`)
+
+- Source: `src/quotes.ts`
+
+---
+
+<a id="g8-search"></a>
+
+## `g8.search`
+
+Types: `dist/types/search.d.ts`
+
+<a id="g8-search-companies"></a>
+
+### `g8.search.companies`
+
+```ts
+g8.search.companies: (params?: SearchParams) => Promise<{ data: SearchCompanyItem[]; }>
+```
+
+Search open-data companies by filter.
+
+- Calls `POST /api/v1/search/companies` ([`g8.api.search.searchCompanies`](api/search.md#op-searchcompanies), tier `billable`, scope `search:run`)
+
+- Source: `src/search.ts`
+
+<a id="g8-search-contacts"></a>
+
+### `g8.search.contacts`
+
+```ts
+g8.search.contacts: (params?: SearchParams) => Promise<{ data: SearchContactItem[]; }>
+```
+
+Search open-data contacts by filter.
+
+- Calls `POST /api/v1/search/contacts` ([`g8.api.search.searchContacts`](api/search.md#op-searchcontacts), tier `billable`, scope `search:run`)
+
+- Source: `src/search.ts`
+
+<a id="g8-search-savecompanies"></a>
+
+### `g8.search.saveCompanies`
+
+```ts
+g8.search.saveCompanies: (params: SearchSaveParams) => Promise<SearchSaveResult>
+```
+
+Search companies and save the matches into a new list.
+
+- Calls `POST /api/v1/search/companies/save` ([`g8.api.search.saveCompanySearch`](api/search.md#op-savecompanysearch), tier `billable`, scope `search:run`)
+
+- Source: `src/search.ts`
+
+<a id="g8-search-savecontacts"></a>
+
+### `g8.search.saveContacts`
+
+```ts
+g8.search.saveContacts: (params: SearchSaveParams) => Promise<SearchSaveResult>
+```
+
+Search contacts and save the matches into a new list.
+
+- Calls `POST /api/v1/search/contacts/save` ([`g8.api.search.saveContactSearch`](api/search.md#op-savecontactsearch), tier `billable`, scope `search:run`)
+
+- Source: `src/search.ts`
+
+---
+
+<a id="g8-sequences"></a>
+
+## `g8.sequences`
+
+Types: `dist/types/sequences.d.ts`
+
+<a id="g8-sequences-add"></a>
+
+### `g8.sequences.add`
+
+```ts
+g8.sequences.add: (config: AddToSequenceConfig, idempotencyKey?: string) => Promise<SequenceActionResult>
+```
+
+Add contacts to a sequence (V2 queuing). Live or drafted sequences only. Pass `idempotencyKey` to make a retry safe — the same key returns the first result instead of re-enrolling on a 5xx-then-success (A6).
+
+- Calls `POST /api/v1/sequences/{sequence_id}/contacts` ([`g8.api.sequences.addContactsToSequence`](api/sequences.md#op-addcontactstosequence), tier `external`, scope `sequences:run`)
+
+- Source: `src/sequences.ts`
+
+<a id="g8-sequences-analytics"></a>
+
+### `g8.sequences.analytics`
+
+```ts
+g8.sequences.analytics: (sequenceId: string) => Promise<SequenceAnalytics>
+```
+
+Comprehensive analytics for a sequence.
+
+- Calls `GET /api/v1/sequences/{sequence_id}/analytics` ([`g8.api.sequenceLifecycle.getSequenceAnalytics`](api/sequenceLifecycle.md#op-getsequenceanalytics), tier `read`, scope `sequences:read`)
+
+- Source: `src/sequences.ts`
+
+<a id="g8-sequences-contacts"></a>
+
+### `g8.sequences.contacts`
+
+```ts
+g8.sequences.contacts: (sequenceId: string, params?: SequenceContactsParams) => Promise<{ data: SequenceContactItem[]; pagination?: PaginationMeta; }>
+```
+
+List contacts enrolled in a sequence. Filter by state (e.g. "active", "replied").
+
+- Calls `GET /api/v1/sequences/{sequence_id}/contacts` ([`g8.api.sequences.listSequenceContacts`](api/sequences.md#op-listsequencecontacts), tier `read`, scope `sequences:read`)
+
+- Source: `src/sequences.ts`
+
+<a id="g8-sequences-create"></a>
+
+### `g8.sequences.create`
+
+```ts
+g8.sequences.create: (payload: SequenceCreateParams, idempotencyKey?: string) => Promise<SequenceCreateResult>
+```
+
+Create a new sequence with optional steps + channels. Pass `idempotencyKey` to make a retry safe — the same key returns the first result instead of creating a duplicate sequence on a 5xx-then-success (A6).
+
+- Calls `POST /api/v1/sequences` ([`g8.api.sequenceLifecycle.createSequence`](api/sequenceLifecycle.md#op-createsequence), tier `external`, scope `sequences:run`)
+
+- Source: `src/sequences.ts`
+
+<a id="g8-sequences-delete"></a>
+
+### `g8.sequences.delete`
+
+```ts
+g8.sequences.delete: (sequenceId: string) => Promise<SequenceActionResult>
+```
+
+Soft-delete (archive) a sequence.
+
+- Calls `DELETE /api/v1/sequences/{sequence_id}` ([`g8.api.sequenceLifecycle.deleteSequence`](api/sequenceLifecycle.md#op-deletesequence), tier `destructive`, scope `sequences:delete`)
+
+- Source: `src/sequences.ts`
+
+<a id="g8-sequences-get"></a>
+
+### `g8.sequences.get`
+
+```ts
+g8.sequences.get: (sequenceId: string) => Promise<SequenceDetail>
+```
+
+Get full sequence details by ID.
+
+- Calls `GET /api/v1/sequences/{sequence_id}` ([`g8.api.sequences.getSequence`](api/sequences.md#op-getsequence), tier `read`, scope `sequences:read`)
+
+- Source: `src/sequences.ts`
+
+<a id="g8-sequences-list"></a>
+
+### `g8.sequences.list`
+
+```ts
+g8.sequences.list: () => Promise<SequenceListItem[]>
+```
+
+List sequences with pagination + optional status filter.
+
+- Source: `src/sequences.ts`
+
+<a id="g8-sequences-pause"></a>
+
+### `g8.sequences.pause`
+
+```ts
+g8.sequences.pause: (sequenceId: string, idempotencyKey?: string) => Promise<SequenceActionResult>
+```
+
+Pause a live sequence. Pass `idempotencyKey` to make a retry safe — the same key won't double-apply on a 5xx-then-success (A6).
+
+- Calls `POST /api/v1/sequences/{sequence_id}/pause` ([`g8.api.sequences.pauseSequence`](api/sequences.md#op-pausesequence), tier `external`, scope `sequences:run`)
+
+- Source: `src/sequences.ts`
+
+<a id="g8-sequences-preview"></a>
+
+### `g8.sequences.preview`
+
+```ts
+g8.sequences.preview: (sequenceId: string) => Promise<SequencePreview>
+```
+
+Read-only sequence preview with all steps + channels (no enrollment).
+
+- Calls `GET /api/v1/sequences/{sequence_id}/preview` ([`g8.api.sequenceLifecycle.previewSequence`](api/sequenceLifecycle.md#op-previewsequence), tier `read`, scope `sequences:read`)
+
+- Source: `src/sequences.ts`
+
+<a id="g8-sequences-resume"></a>
+
+### `g8.sequences.resume`
+
+```ts
+g8.sequences.resume: (sequenceId: string, idempotencyKey?: string) => Promise<SequenceActionResult>
+```
+
+Resume a paused sequence. Pass `idempotencyKey` to make a retry safe — the same key won't double-apply on a 5xx-then-success (A6).
+
+- Calls `POST /api/v1/sequences/{sequence_id}/resume` ([`g8.api.sequences.resumeSequence`](api/sequences.md#op-resumesequence), tier `external`, scope `sequences:run`)
+
+- Source: `src/sequences.ts`
+
+<a id="g8-sequences-run"></a>
+
+### `g8.sequences.run`
+
+```ts
+g8.sequences.run: (sequenceId: string, idempotencyKey?: string) => Promise<SequenceActionResult>
+```
+
+Run/start a DRAFTED sequence (V2 orchestration). Pass `idempotencyKey` to make a retry safe — the same key won't re-trigger the run on a 5xx-then-success (A6).
+
+- Calls `POST /api/v1/sequences/{sequence_id}/run` ([`g8.api.sequences.runSequence`](api/sequences.md#op-runsequence), tier `external`, scope `sequences:run`)
+
+- Source: `src/sequences.ts`
+
+<a id="g8-sequences-update"></a>
+
+### `g8.sequences.update`
+
+```ts
+g8.sequences.update: (sequenceId: string, fields: SequenceUpdateParams) => Promise<SequenceActionResult>
+```
+
+Update sequence metadata. Rejected (409) if sequence is in a transitional status.
+
+- Calls `PATCH /api/v1/sequences/{sequence_id}` ([`g8.api.sequenceLifecycle.updateSequence`](api/sequenceLifecycle.md#op-updatesequence), tier `external`, scope `sequences:run`)
+
+- Source: `src/sequences.ts`
+
+<a id="g8-sequences-updatestep"></a>
+
+### `g8.sequences.updateStep`
+
+```ts
+g8.sequences.updateStep: (sequenceId: string, stepId: string, fields: SequenceStepUpdateParams) => Promise<SequenceActionResult>
+```
+
+Update a single step within a sequence.
+
+- Calls `PATCH /api/v1/sequences/{sequence_id}/steps/{step_id}` ([`g8.api.sequenceLifecycle.updateSequenceStep`](api/sequenceLifecycle.md#op-updatesequencestep), tier `external`, scope `sequences:run`)
+
+- Source: `src/sequences.ts`
+
+---
+
+<a id="g8-signals"></a>
+
+## `g8.signals`
+
+Types: `dist/types/signals.d.ts`
+
+<a id="g8-signals-company"></a>
+
+### `g8.signals.company`
+
+```ts
+g8.signals.company: (domain: string) => Promise<IntentSignals>
+```
+
+Get intent signals for a specific company domain. With an API key this throws a `G8Error` on any failure; a 403 means the key lacks the `intent:read` scope. With a write key only, a failure still resolves to an all-zeros result (legacy browser behaviour).
+
+- Calls `GET /api/v1/public/signals/company` ([`g8.api.publicSignals.publicSignalsCompany`](api/publicSignals.md#op-publicsignalscompany), tier `read`, scope `intent:read`)
+
+- Source: `src/signals.ts`
+
+<a id="g8-signals-stream"></a>
+
+### `g8.signals.stream`
+
+```ts
+g8.signals.stream: (domains: string[], callback: (signals: IntentSignals[]) => void) => () => void
+```
+
+Stream intent signals - calls callback every 30s with latest data. A failed poll is skipped. An auth failure (401/403) cannot fix itself by waiting, so it stops the stream and is logged once instead of polling a forbidden route every 30s forever.
+
+- Source: `src/signals.ts`
+
+---
+
+<a id="g8-skills"></a>
+
+## `g8.skills`
+
+Types: `dist/types/skills.d.ts`
+
+<a id="g8-skills-createapi"></a>
+
+### `g8.skills.createAPI`
+
+```ts
+g8.skills.createAPI: (params: SkillCreateAPIParams) => Promise<Skill>
+```
+
+Create an API skill (HTTP request wrapper).
+
+- Calls `POST /api/v1/skills` ([`g8.api.skills.createSkill`](api/skills.md#op-createskill), tier `write`, scope `workflows:write`)
+
+- Source: `src/skills.ts`
+
+<a id="g8-skills-createfromnode"></a>
+
+### `g8.skills.createFromNode`
+
+```ts
+g8.skills.createFromNode: (params: { title: string; description?: string; node_id: string; input_mapping?: Record<string, string>; output_mapping?: Record<string, string>; }) => Promise<Skill>
+```
+
+Lift a workflow node into a reusable skill.
+
+- Calls `POST /api/v1/skills/from-node` ([`g8.api.skills.createFromNode`](api/skills.md#op-createfromnode), tier `write`, scope `workflows:write`)
+
+- Source: `src/skills.ts`
+
+<a id="g8-skills-createfromtemplate"></a>
+
+### `g8.skills.createFromTemplate`
+
+```ts
+g8.skills.createFromTemplate: (params: { title: string; template_id: string; overrides?: Record<string, unknown>; }) => Promise<Skill>
+```
+
+Create a skill from a built-in template.
+
+- Calls `POST /api/v1/skills/from-template` ([`g8.api.skills.createFromTemplate`](api/skills.md#op-createfromtemplate), tier `write`, scope `workflows:write`)
+
+- Source: `src/skills.ts`
+
+<a id="g8-skills-createllm"></a>
+
+### `g8.skills.createLLM`
+
+```ts
+g8.skills.createLLM: (params: SkillCreateLLMParams) => Promise<Skill>
+```
+
+Create an LLM skill (prompt + model + schemas).
+
+- Calls `POST /api/v1/skills` ([`g8.api.skills.createSkill`](api/skills.md#op-createskill), tier `write`, scope `workflows:write`)
+
+- Source: `src/skills.ts`
+
+<a id="g8-skills-delete"></a>
+
+### `g8.skills.delete`
+
+```ts
+g8.skills.delete: (skillId: string) => Promise<{ data: { deleted: boolean; }; }>
+```
+
+Delete a skill (irreversible if in-use workflows exist).
+
+- Calls `DELETE /api/v1/skills/{action_id}` ([`g8.api.skills.deleteSkill`](api/skills.md#op-deleteskill), tier `destructive`, scope `workflows:delete`)
+
+- Source: `src/skills.ts`
+
+<a id="g8-skills-execute"></a>
+
+### `g8.skills.execute`
+
+```ts
+g8.skills.execute: (skillId: string, inputPayload: Record<string, unknown>) => Promise<{ data: { output: Record<string, unknown>; latency_ms: number; tokens?: number; error: string | null; }; }>
+```
+
+Execute a skill immediately with an input payload (test / preview).
+
+- Calls `POST /api/v1/skills/{action_id}/execute` ([`g8.api.skills.executeSkill`](api/skills.md#op-executeskill), tier `external`, scope `workflows:run`)
+
+- Source: `src/skills.ts`
+
+<a id="g8-skills-get"></a>
+
+### `g8.skills.get`
+
+```ts
+g8.skills.get: (skillId: string) => Promise<Skill>
+```
+
+Get a skill by ID.
+
+- Calls `GET /api/v1/skills/{action_id}` ([`g8.api.skills.getSkill`](api/skills.md#op-getskill), tier `read`, scope `workflows:read`)
+
+- Source: `src/skills.ts`
+
+<a id="g8-skills-getvariables"></a>
+
+### `g8.skills.getVariables`
+
+```ts
+g8.skills.getVariables: (skillId: string) => Promise<{ data: SkillInputField[]; }>
+```
+
+Get the variables required by a skill (extracted from prompt or body template).
+
+- Calls `GET /api/v1/skills/{action_id}/variables` ([`g8.api.skills.extractVariables`](api/skills.md#op-extractvariables), tier `read`, scope `workflows:read`)
+
+- Source: `src/skills.ts`
+
+<a id="g8-skills-list"></a>
+
+### `g8.skills.list`
+
+```ts
+g8.skills.list: (params?: SkillListParams) => Promise<{ data: Skill[]; }>
+```
+
+List skills.
+
+- Calls `GET /api/v1/skills` ([`g8.api.skills.listSkills`](api/skills.md#op-listskills), tier `read`, scope `workflows:read`)
+
+- Source: `src/skills.ts`
+
+<a id="g8-skills-listmodels"></a>
+
+### `g8.skills.listModels`
+
+```ts
+g8.skills.listModels: () => Promise<{ data: Array<{ id: string; label: string; provider: string; }>; }>
+```
+
+List available LLM models.
+
+- Calls `GET /api/v1/skills/models` ([`g8.api.skills.listModels`](api/skills.md#op-listmodels), tier `read`, scope `workflows:read`)
+
+- Source: `src/skills.ts`
+
+<a id="g8-skills-listtemplates"></a>
+
+### `g8.skills.listTemplates`
+
+```ts
+g8.skills.listTemplates: (params?: { type?: SkillType; }) => Promise<{ data: SkillTemplate[]; }>
+```
+
+List skill templates.
+
+- Calls `GET /api/v1/skills/templates` ([`g8.api.skills.listTemplates`](api/skills.md#op-listtemplates), tier `read`, scope `workflows:read`)
+
+- Source: `src/skills.ts`
+
+<a id="g8-skills-updateapi"></a>
+
+### `g8.skills.updateAPI`
+
+```ts
+g8.skills.updateAPI: (skillId: string, fields: SkillUpdateAPIParams) => Promise<Skill>
+```
+
+Update an API skill.
+
+- Calls `PUT /api/v1/skills/{action_id}` ([`g8.api.skills.updateSkill`](api/skills.md#op-updateskill), tier `write`, scope `workflows:write`)
+
+- Source: `src/skills.ts`
+
+<a id="g8-skills-updatellm"></a>
+
+### `g8.skills.updateLLM`
+
+```ts
+g8.skills.updateLLM: (skillId: string, fields: SkillUpdateLLMParams) => Promise<Skill>
+```
+
+Update an LLM skill.
+
+- Calls `PUT /api/v1/skills/{action_id}` ([`g8.api.skills.updateSkill`](api/skills.md#op-updateskill), tier `write`, scope `workflows:write`)
+
+- Source: `src/skills.ts`
+
+<a id="g8-skills-validate"></a>
+
+### `g8.skills.validate`
+
+```ts
+g8.skills.validate: (skill: Partial<Skill>) => Promise<{ data: { valid: boolean; errors: string[]; }; }>
+```
+
+Validate a skill definition (without saving).
+
+- Calls `POST /api/v1/skills/validate` ([`g8.api.skills.validateTemplate`](api/skills.md#op-validatetemplate), tier `write`, scope `workflows:write`)
+
+- Source: `src/skills.ts`
+
+---
+
+<a id="g8-snippet"></a>
+
+## `g8.snippet`
+
+Types: `dist/types/snippet.d.ts`
+
+<a id="g8-snippet-get"></a>
+
+### `g8.snippet.get`
+
+```ts
+g8.snippet.get: () => Promise<Snippet>
+```
+
+Get your org's tracking snippet (write key + React/script-tag embeds + config).
+
+- Calls `GET /api/v1/snippet` ([`g8.api.snippet.getOrgSnippet`](api/snippet.md#op-getorgsnippet), tier `read`, scope `integrations:read`)
+
+- Source: `src/snippet.ts`
+
+---
+
+<a id="g8-studio"></a>
+
+## `g8.studio`
+
+Types: `dist/types/studio.d.ts`
+
+<a id="g8-studio-archiveicp"></a>
+
+### `g8.studio.archiveIcp`
+
+```ts
+g8.studio.archiveIcp: (icpId: string) => Promise<{ data: ICP; }>
+```
+
+Archive an ICP (soft delete - sets status to "archived").
+
+- Calls `POST /api/v1/icps/{icp_id}/archive` ([`g8.api.gtmContext.archiveIcp`](api/gtmContext.md#op-archiveicp), tier `destructive`, scope `campaigns:delete`)
+
+- Source: `src/studio.ts`
+
+<a id="g8-studio-archivepersona"></a>
+
+### `g8.studio.archivePersona`
+
+```ts
+g8.studio.archivePersona: (personaId: string) => Promise<{ data: Persona; }>
+```
+
+Archive a persona (soft delete - sets status to "archived").
+
+- Calls `POST /api/v1/personas/{persona_id}/archive` ([`g8.api.gtmContext.archivePersona`](api/gtmContext.md#op-archivepersona), tier `destructive`, scope `campaigns:delete`)
+
+- Source: `src/studio.ts`
+
+<a id="g8-studio-createicp"></a>
+
+### `g8.studio.createIcp`
+
+```ts
+g8.studio.createIcp: (body: { name: string; website_url: string; description?: string; firmographics?: Record<string, unknown>; tech_stack?: Record<string, unknown>; buying_signals?: unknown[]; estimated_market_size?: number; }) => Promise<{ data: ICP; }>
+```
+
+Create an ICP manually (no AI scoring). Requires name + website_url.
+
+- Calls `POST /api/v1/icps` ([`g8.api.gtmContext.createIcp`](api/gtmContext.md#op-createicp), tier `write`, scope `campaigns:write`)
+
+- Source: `src/studio.ts`
+
+<a id="g8-studio-createpersona"></a>
+
+### `g8.studio.createPersona`
+
+```ts
+g8.studio.createPersona: (body: { title: string; website_url: string; priority?: number; confidence?: string; why_target?: string; key_signals?: unknown[]; expected_receptivity?: string; campaign_approach?: string; recommended_goal?: string; source?: string; }) => Promise<{ data: Persona; }>
+```
+
+Create a buyer persona manually (no AI generation). Requires title + website_url.
+
+- Calls `POST /api/v1/personas` ([`g8.api.gtmContext.createPersona`](api/gtmContext.md#op-createpersona), tier `write`, scope `campaigns:write`)
+
+- Source: `src/studio.ts`
+
+<a id="g8-studio-globalcontext"></a>
+
+### `g8.studio.globalContext`
+
+```ts
+g8.studio.globalContext: (params?: { category?: string; limit?: number; include_content?: boolean; }) => Promise<{ data: GlobalContextDocument[]; }>
+```
+
+Org-level Studio documents (brand_brief, value_props, messaging_house, etc.). `include_content` defaults to true server-side, so each document includes its `content` body unless you explicitly pass `include_content: false`.
+
+- Calls `GET /api/v1/global-context/documents` ([`g8.api.gtmContext.listGlobalContextDocuments`](api/gtmContext.md#op-listglobalcontextdocuments), tier `read`, scope `campaigns:read`)
+
+- Source: `src/studio.ts`
+
+<a id="g8-studio-icps"></a>
+
+### `g8.studio.icps`
+
+```ts
+g8.studio.icps: (params?: { status?: string; limit?: number; }) => Promise<{ data: ICP[]; }>
+```
+
+ICP definitions.
+
+- Calls `GET /api/v1/icps` ([`g8.api.gtmContext.listIcps`](api/gtmContext.md#op-listicps), tier `read`, scope `campaigns:read`)
+
+- Source: `src/studio.ts`
+
+<a id="g8-studio-intelligencedata"></a>
+
+### `g8.studio.intelligenceData`
+
+```ts
+g8.studio.intelligenceData: (params?: { source_type?: string; limit?: number; }) => Promise<{ data: IntelligenceData[]; }>
+```
+
+Intelligence data (website scrapes, enrichment, competitor research).
+
+- Calls `GET /api/v1/intelligence-data` ([`g8.api.gtmContext.listIntelligenceData`](api/gtmContext.md#op-listintelligencedata), tier `read`, scope `campaigns:read`)
+
+- Source: `src/studio.ts`
+
+<a id="g8-studio-personas"></a>
+
+### `g8.studio.personas`
+
+```ts
+g8.studio.personas: (params?: { status?: string; limit?: number; }) => Promise<{ data: Persona[]; }>
+```
+
+Buyer persona definitions.
+
+- Calls `GET /api/v1/personas` ([`g8.api.gtmContext.listPersonas`](api/gtmContext.md#op-listpersonas), tier `read`, scope `campaigns:read`)
+
+- Source: `src/studio.ts`
+
+<a id="g8-studio-researchreports"></a>
+
+### `g8.studio.researchReports`
+
+```ts
+g8.studio.researchReports: (params?: { category?: string; limit?: number; }) => Promise<{ data: ResearchReport[]; }>
+```
+
+AI research reports (buyer psychology, competitive teardown, GTM channel, etc.).
+
+- Calls `GET /api/v1/research-reports` ([`g8.api.gtmContext.listResearchReports`](api/gtmContext.md#op-listresearchreports), tier `read`, scope `campaigns:read`)
+
+- Source: `src/studio.ts`
+
+<a id="g8-studio-updateicp"></a>
+
+### `g8.studio.updateIcp`
+
+```ts
+g8.studio.updateIcp: (icpId: string, body: { name?: string; description?: string; firmographics?: Record<string, unknown>; tech_stack?: Record<string, unknown>; buying_signals?: unknown[]; estimated_market_size?: number; }) => Promise<{ data: ICP; }>
+```
+
+Update an ICP (partial - send only fields to change).
+
+- Calls `PATCH /api/v1/icps/{icp_id}` ([`g8.api.gtmContext.updateIcp`](api/gtmContext.md#op-updateicp), tier `write`, scope `campaigns:write`)
+
+- Source: `src/studio.ts`
+
+<a id="g8-studio-updatepersona"></a>
+
+### `g8.studio.updatePersona`
+
+```ts
+g8.studio.updatePersona: (personaId: string, body: { title?: string; priority?: number; confidence?: string; why_target?: string; key_signals?: unknown[]; expected_receptivity?: string; campaign_approach?: string; recommended_goal?: string; status?: string; }) => Promise<{ data: Persona; }>
+```
+
+Update a persona (partial). Passing status "archived" is equivalent to archivePersona.
+
+- Calls `PATCH /api/v1/personas/{persona_id}` ([`g8.api.gtmContext.updatePersona`](api/gtmContext.md#op-updatepersona), tier `write`, scope `campaigns:write`)
+
+- Source: `src/studio.ts`
+
+---
+
+<a id="g8-tasks"></a>
+
+## `g8.tasks`
+
+Types: `dist/types/tasks.d.ts`
+
+<a id="g8-tasks-create"></a>
+
+### `g8.tasks.create`
+
+```ts
+g8.tasks.create: (contactId: number, task: TaskCreateParams) => Promise<Task>
+```
+
+Create a task on a contact.
+
+- Calls `POST /api/v1/contacts/{contact_id}/tasks` ([`g8.api.tasks.createTask`](api/tasks.md#op-createtask), tier `write`, scope `tasks:write`)
+
+- Source: `src/tasks.ts`
+
+<a id="g8-tasks-delete"></a>
+
+### `g8.tasks.delete`
+
+```ts
+g8.tasks.delete: (taskId: string) => Promise<{ data: { deleted: boolean; }; }>
+```
+
+Delete a task.
+
+- Calls `DELETE /api/v1/tasks/{task_id}` ([`g8.api.tasks.deleteTask`](api/tasks.md#op-deletetask), tier `destructive`, scope `tasks:delete`)
+
+- Source: `src/tasks.ts`
+
+<a id="g8-tasks-list"></a>
+
+### `g8.tasks.list`
+
+```ts
+g8.tasks.list: (params?: TaskListParams) => Promise<{ data: Task[]; }>
+```
+
+List all tasks org-wide with optional filters.
+
+- Calls `GET /api/v1/tasks` ([`g8.api.tasks.listAllTasks`](api/tasks.md#op-listalltasks), tier `read`, scope `tasks:read`)
+
+- Source: `src/tasks.ts`
+
+<a id="g8-tasks-listforcontact"></a>
+
+### `g8.tasks.listForContact`
+
+```ts
+g8.tasks.listForContact: (contactId: number, status?: string) => Promise<{ data: Task[]; }>
+```
+
+List tasks on a single contact. Optional status filter ("open" | "completed").
+
+- Calls `GET /api/v1/contacts/{contact_id}/tasks` ([`g8.api.tasks.listContactTasks`](api/tasks.md#op-listcontacttasks), tier `read`, scope `tasks:read`)
+
+- Source: `src/tasks.ts`
+
+<a id="g8-tasks-update"></a>
+
+### `g8.tasks.update`
+
+```ts
+g8.tasks.update: (taskId: string, fields: TaskUpdateParams) => Promise<Task>
+```
+
+Update a task (partial).
+
+- Calls `PATCH /api/v1/tasks/{task_id}` ([`g8.api.tasks.updateTask`](api/tasks.md#op-updatetask), tier `write`, scope `tasks:write`)
+
+- Source: `src/tasks.ts`
+
+---
+
+<a id="g8-visitors"></a>
+
+## `g8.visitors`
+
+Types: `dist/types/visitors.d.ts`
+
+<a id="g8-visitors-identify"></a>
+
+### `g8.visitors.identify`
+
+```ts
+g8.visitors.identify: () => Promise<VisitorCompany>
+```
+
+Identify the current visitor's company from their IP address.
+
+- Calls `GET /api/v1/public/visitors/company` ([`g8.api.publicVisitors.publicVisitorCompany`](api/publicVisitors.md#op-publicvisitorcompany), tier `read`, scope `intent:read`)
+
+- Source: `src/visitors.ts`
+
+<a id="g8-visitors-onintent"></a>
+
+### `g8.visitors.onIntent`
+
+```ts
+g8.visitors.onIntent: (level: "low" | "medium" | "high", callback: IntentCallback) => () => void
+```
+
+Listen for visitors matching an intent level. Polls every 30 seconds.
+
+- Source: `src/visitors.ts`
+
+<a id="g8-visitors-score"></a>
+
+### `g8.visitors.score`
+
+```ts
+g8.visitors.score: () => Promise<VisitorScore>
+```
+
+Get engagement score for the current visitor.
+
+- Calls `GET /api/v1/public/visitors/score` ([`g8.api.publicVisitors.publicVisitorScore`](api/publicVisitors.md#op-publicvisitorscore), tier `read`, scope `intent:read`)
+
+- Source: `src/visitors.ts`
+
+---
+
+<a id="g8-voice"></a>
+
+## `g8.voice`
+
+Types: `dist/types/voice.d.ts`
+
+<a id="g8-voice-dialer-agents"></a>
+
+### `g8.voice.dialer.agents`
+
+```ts
+g8.voice.dialer.agents: (params?: DialerAgentsListParams) => Promise<DialerAgentsListResult>
+```
+
+List voice agents available for dialer sessions (capped at 100; no pagination).
+
+- Calls `GET /api/v1/voice/dialer/agents` ([`g8.api.voice.listDialerAgents`](api/voice.md#op-listdialeragents), tier `read`, scope `voice:read`)
+
+- Source: `src/voice.ts`
+
+<a id="g8-voice-dialer-callgrading"></a>
+
+### `g8.voice.dialer.callGrading`
+
+```ts
+g8.voice.dialer.callGrading: (roomName: string) => Promise<CallGradingResult>
+```
+
+AI grading for a single dialer call (returns "pending" while in progress).
+
+- Calls `GET /api/v1/voice/dialer/calls/{room_name}/grading` ([`g8.api.voice.getCallGrading`](api/voice.md#op-getcallgrading), tier `read`, scope `voice:read`)
+
+- Source: `src/voice.ts`
+
+<a id="g8-voice-dialer-calltranscript"></a>
+
+### `g8.voice.dialer.callTranscript`
+
+```ts
+g8.voice.dialer.callTranscript: (roomName: string) => Promise<{ data: { status: string; transcript: Array<{ speaker: string; text: string; timestamp: number; }>; }; }>
+```
+
+Fetch the full transcript for a single dialer call.
+
+- Calls `GET /api/v1/voice/dialer/calls/{room_name}/transcript` ([`g8.api.voice.getCallTranscript`](api/voice.md#op-getcalltranscript), tier `read`, scope `voice:read`)
+
+- Source: `src/voice.ts`
+
+<a id="g8-voice-dialer-createsession"></a>
+
+### `g8.voice.dialer.createSession`
+
+```ts
+g8.voice.dialer.createSession: (payload: DialerSessionCreateParams) => Promise<DialerSessionCreateResult>
+```
+
+Create a parallel-dialer session in PAUSED state. SDR opens UI to start dialing.
+
+- Calls `POST /api/v1/voice/dialer/sessions` ([`g8.api.voice.createDialerSession`](api/voice.md#op-createdialersession), tier `external`, scope `voice:run`)
+
+- Source: `src/voice.ts`
+
+<a id="g8-voice-dialer-listcalls"></a>
+
+### `g8.voice.dialer.listCalls`
+
+```ts
+g8.voice.dialer.listCalls: (params?: { contact_id?: number; user_email?: string; campaign_id?: string; date_from?: string; date_to?: string; limit?: number; page?: number; }) => Promise<{ data: Array<Record<string, unknown>>; pagination?: VoicePagination; }>
+```
+
+List dialer calls — pass `contact_id` or `user_email` to scope.
+
+- Calls `GET /api/v1/voice/dialer/calls` ([`g8.api.voice.listCallsForContact`](api/voice.md#op-listcallsforcontact), tier `read`, scope `voice:read`)
+
+- Source: `src/voice.ts`
+
+<a id="g8-voice-dialer-listcallsforcontact"></a>
+
+### `g8.voice.dialer.listCallsForContact`
+
+```ts
+g8.voice.dialer.listCallsForContact: (contactId: number, extra?: { limit?: number; }) => Promise<{ data: Array<Record<string, unknown>>; }>
+```
+
+Convenience: list calls for a single contact.
+
+- Calls `GET /api/v1/voice/dialer/calls` ([`g8.api.voice.listCallsForContact`](api/voice.md#op-listcallsforcontact), tier `read`, scope `voice:read`)
+
+- Source: `src/voice.ts`
+
+<a id="g8-voice-dialer-listcallsforsdr"></a>
+
+### `g8.voice.dialer.listCallsForSdr`
+
+```ts
+g8.voice.dialer.listCallsForSdr: (userEmail: string, extra?: { limit?: number; date_from?: string; date_to?: string; }) => Promise<{ data: Array<Record<string, unknown>>; }>
+```
+
+Convenience: list calls placed by a specific SDR.
+
+- Calls `GET /api/v1/voice/dialer/calls` ([`g8.api.voice.listCallsForContact`](api/voice.md#op-listcallsforcontact), tier `read`, scope `voice:read`)
+
+- Source: `src/voice.ts`
+
+<a id="g8-voice-dialer-listsessions"></a>
+
+### `g8.voice.dialer.listSessions`
+
+```ts
+g8.voice.dialer.listSessions: (params?: DialerSessionsListParams) => Promise<DialerSessionsListResult>
+```
+
+List parallel-dialer sessions with filters + pagination.
+
+- Calls `GET /api/v1/voice/dialer/sessions` ([`g8.api.voice.listDialerSessions`](api/voice.md#op-listdialersessions), tier `read`, scope `voice:read`)
+
+- Source: `src/voice.ts`
+
+<a id="g8-voice-dialer-missedcallbacks"></a>
+
+### `g8.voice.dialer.missedCallbacks`
+
+```ts
+g8.voice.dialer.missedCallbacks: (limit?: number) => Promise<MissedCallbacksResult>
+```
+
+List missed inbound callbacks with caller / contact info.
+
+- Calls `GET /api/v1/voice/dialer/missed-callbacks` ([`g8.api.voice.listMissedCallbacks`](api/voice.md#op-listmissedcallbacks), tier `read`, scope `voice:read`)
+
+- Source: `src/voice.ts`
+
+<a id="g8-voice-dialer-numbers"></a>
+
+### `g8.voice.dialer.numbers`
+
+```ts
+g8.voice.dialer.numbers: (userEmail?: string) => Promise<DialerNumbersListResult>
+```
+
+List dialer-eligible phone numbers with 7-day stats + daily limits.
+
+- Calls `GET /api/v1/voice/dialer/numbers` ([`g8.api.voice.listDialerNumbers`](api/voice.md#op-listdialernumbers), tier `read`, scope `voice:read`)
+
+- Source: `src/voice.ts`
+
+<a id="g8-voice-dialer-resumesession"></a>
+
+### `g8.voice.dialer.resumeSession`
+
+```ts
+g8.voice.dialer.resumeSession: (sessionId: string, maxContacts?: number) => Promise<DialerSessionResumeResult>
+```
+
+**Deprecated**: The server route is retired and answers 410 (it never dialed: it forwarded to a voice path that did not exist, and the LiveKit dialer it targeted has been removed). Resume with `g8.api.call("dial_next_batch_dialer_sessions__session_id__next_batch_post", { path: { session_id }, body: { resume_intent: true } })`; the rep must have the dialer open to take the calls.
+
+Resume a PAUSED dialer session.
+
+- Calls `POST /api/v1/voice/dialer/sessions/{session_id}/resume` ([`g8.api.voice.resumeDialerSession`](api/voice.md#op-resumedialersession), tier `external`, scope `voice:run`)
+
+- Source: `src/voice.ts`
+
+<a id="g8-voice-dialer-stats"></a>
+
+### `g8.voice.dialer.stats`
+
+```ts
+g8.voice.dialer.stats: (params?: DialerStatsParams) => Promise<DialerStatsResult>
+```
+
+Aggregated dialer analytics (daily breakdown or total).
+
+- Calls `GET /api/v1/voice/dialer/stats` ([`g8.api.voice.getDialerStats`](api/voice.md#op-getdialerstats), tier `read`, scope `voice:read`)
+
+- Source: `src/voice.ts`
+
+<a id="g8-voice-dialer-updatesessionstatus"></a>
+
+### `g8.voice.dialer.updateSessionStatus`
+
+```ts
+g8.voice.dialer.updateSessionStatus: (sessionId: string, status: DialerSessionStatus) => Promise<DialerSessionStatusUpdateResult>
+```
+
+Pause / resume / stop a dialer session via status flip.
+
+- Calls `PATCH /api/v1/voice/dialer/sessions/{session_id}/status` ([`g8.api.voice.updateDialerSessionStatus`](api/voice.md#op-updatedialersessionstatus), tier `external`, scope `voice:run`)
+
+- Source: `src/voice.ts`
+
+<a id="g8-voice-on"></a>
+
+### `g8.voice.on`
+
+```ts
+g8.voice.on: (event: VoiceEvent, callback: VoiceCallback) => void
+```
+
+Listen for voice events.
+
+- Source: `src/voice.ts`
+
+---
+
+<a id="g8-webhooks"></a>
+
+## `g8.webhooks`
+
+Types: `dist/types/webhooks.d.ts`
+
+<a id="g8-webhooks-constructevent"></a>
+
+### `g8.webhooks.constructEvent`
+
+```ts
+g8.webhooks.constructEvent: (payload: string, signature: string, timestamp: string | number, secret: string, opts?: ConstructEventOptions) => WebhookEventPayload
+```
+
+Verify an incoming webhook's HMAC signature and return the parsed event.
+
+- Source: `src/webhooks.ts`
+
+---
+
+<a id="g8-workflows"></a>
+
+## `g8.workflows`
+
+Types: `dist/types/workflows.d.ts`
+
+<a id="g8-workflows-create"></a>
+
+### `g8.workflows.create`
+
+```ts
+g8.workflows.create: (params: WorkflowCreateParams) => Promise<Workflow>
+```
+
+Create a new workflow.
+
+- Calls `POST /api/v1/workflows` ([`g8.api.workflows.createWorkflow`](api/workflows.md#op-createworkflow), tier `external`, scope `workflows:run`)
+
+- Source: `src/workflows.ts`
+
+<a id="g8-workflows-delete"></a>
+
+### `g8.workflows.delete`
+
+```ts
+g8.workflows.delete: (workflowId: string) => Promise<{ data: { deleted: boolean; }; }>
+```
+
+Delete a workflow.
+
+- Calls `DELETE /api/v1/workflows/{action_id}` ([`g8.api.workflows.deleteWorkflow`](api/workflows.md#op-deleteworkflow), tier `destructive`, scope `workflows:delete`)
+
+- Source: `src/workflows.ts`
+
+<a id="g8-workflows-execute"></a>
+
+### `g8.workflows.execute`
+
+```ts
+g8.workflows.execute: (workflowId: string, triggerPayload?: Record<string, unknown>) => Promise<WorkflowExecution>
+```
+
+Execute a workflow immediately with a trigger payload.
+
+- Calls `POST /api/v1/workflows/{action_id}/execute` ([`g8.api.workflows.executeWorkflow`](api/workflows.md#op-executeworkflow), tier `external`, scope `workflows:run`)
+
+- Source: `src/workflows.ts`
+
+<a id="g8-workflows-get"></a>
+
+### `g8.workflows.get`
+
+```ts
+g8.workflows.get: (workflowId: string) => Promise<Workflow>
+```
+
+Get full workflow definition (nodes, connections, trigger, execution state).
+
+- Calls `GET /api/v1/workflows/{action_id}` ([`g8.api.workflows.getWorkflow`](api/workflows.md#op-getworkflow), tier `read`, scope `workflows:read`)
+
+- Source: `src/workflows.ts`
+
+<a id="g8-workflows-getexecution"></a>
+
+### `g8.workflows.getExecution`
+
+```ts
+g8.workflows.getExecution: (executionId: string) => Promise<WorkflowExecution>
+```
+
+Get the status + outputs of a single execution.
+
+- Calls `GET /api/v1/workflows/executions/{execution_id}` ([`g8.api.workflows.getExecution`](api/workflows.md#op-getexecution), tier `read`, scope `workflows:read`)
+
+- Source: `src/workflows.ts`
+
+<a id="g8-workflows-gettriggerstatus"></a>
+
+### `g8.workflows.getTriggerStatus`
+
+```ts
+g8.workflows.getTriggerStatus: (workflowId: string) => Promise<{ data: { status: string; details: Record<string, unknown>; }; }>
+```
+
+Get the trigger status (e.g. schedule / webhook wiring) for a workflow.
+
+- Calls `GET /api/v1/workflows/{action_id}/trigger-status` ([`g8.api.workflows.getTriggerStatus`](api/workflows.md#op-gettriggerstatus), tier `read`, scope `workflows:read`)
+
+- Source: `src/workflows.ts`
+
+<a id="g8-workflows-list"></a>
+
+### `g8.workflows.list`
+
+```ts
+g8.workflows.list: (params?: WorkflowListParams) => Promise<{ data: Workflow[]; }>
+```
+
+List workflows org-wide.
+
+- Calls `GET /api/v1/workflows` ([`g8.api.workflows.listWorkflows`](api/workflows.md#op-listworkflows), tier `read`, scope `workflows:read`)
+
+- Source: `src/workflows.ts`
+
+<a id="g8-workflows-listdispositions"></a>
+
+### `g8.workflows.listDispositions`
+
+```ts
+g8.workflows.listDispositions: () => Promise<{ data: Array<{ id: string; label: string; }>; }>
+```
+
+Disposition options available to workflow nodes.
+
+- Calls `GET /api/v1/workflows/dispositions` ([`g8.api.workflows.listDispositions`](api/workflows.md#op-listdispositions), tier `read`, scope `workflows:read`)
+
+- Source: `src/workflows.ts`
+
+<a id="g8-workflows-listformfields"></a>
+
+### `g8.workflows.listFormFields`
+
+```ts
+g8.workflows.listFormFields: (formId: string) => Promise<{ data: Array<{ name: string; type: string; required: boolean; }>; }>
+```
+
+Form field definitions for a given form (used by form-trigger nodes).
+
+- Calls `GET /api/v1/workflows/forms/{form_id}/fields` ([`g8.api.workflows.describeFormFields`](api/workflows.md#op-describeformfields), tier `read`, scope `workflows:read`)
+
+- Source: `src/workflows.ts`
+
+<a id="g8-workflows-listmcpservers"></a>
+
+### `g8.workflows.listMcpServers`
+
+```ts
+g8.workflows.listMcpServers: () => Promise<{ data: Array<{ id: string; name: string; url: string; }>; }>
+```
+
+MCP servers available to workflow nodes.
+
+- Calls `GET /api/v1/workflows/mcp-servers` ([`g8.api.workflows.listMcpServers`](api/workflows.md#op-listmcpservers), tier `read`, scope `workflows:read`)
+
+- Source: `src/workflows.ts`
+
+<a id="g8-workflows-listroamgroups"></a>
+
+### `g8.workflows.listRoamGroups`
+
+```ts
+g8.workflows.listRoamGroups: () => Promise<{ data: Array<{ id: string; name: string; }>; }>
+```
+
+Roam groups available to workflow nodes.
+
+- Calls `GET /api/v1/workflows/integrations/roam/groups` ([`g8.api.workflows.listRoamGroups`](api/workflows.md#op-listroamgroups), tier `read`, scope `workflows:read`)
+
+- Source: `src/workflows.ts`
+
+<a id="g8-workflows-listroamusers"></a>
+
+### `g8.workflows.listRoamUsers`
+
+```ts
+g8.workflows.listRoamUsers: () => Promise<{ data: Array<{ id: string; name: string; email: string | null; }>; }>
+```
+
+Roam users available to workflow nodes.
+
+- Calls `GET /api/v1/workflows/integrations/roam/users` ([`g8.api.workflows.listRoamUsers`](api/workflows.md#op-listroamusers), tier `read`, scope `workflows:read`)
+
+- Source: `src/workflows.ts`
+
+<a id="g8-workflows-listslackchannels"></a>
+
+### `g8.workflows.listSlackChannels`
+
+```ts
+g8.workflows.listSlackChannels: () => Promise<{ data: Array<{ id: string; name: string; is_private: boolean; }>; }>
+```
+
+Slack channels available to workflow nodes.
+
+- Calls `GET /api/v1/workflows/integrations/slack/channels` ([`g8.api.workflows.listSlackChannels`](api/workflows.md#op-listslackchannels), tier `read`, scope `workflows:read`)
+
+- Source: `src/workflows.ts`
+
+<a id="g8-workflows-listslackusers"></a>
+
+### `g8.workflows.listSlackUsers`
+
+```ts
+g8.workflows.listSlackUsers: () => Promise<{ data: Array<{ id: string; name: string; email: string | null; }>; }>
+```
+
+Slack users available to workflow nodes.
+
+- Calls `GET /api/v1/workflows/integrations/slack/users` ([`g8.api.workflows.listSlackUsers`](api/workflows.md#op-listslackusers), tier `read`, scope `workflows:read`)
+
+- Source: `src/workflows.ts`
+
+<a id="g8-workflows-nodetypes"></a>
+
+### `g8.workflows.nodeTypes`
+
+```ts
+g8.workflows.nodeTypes: (params?: { type?: string; }) => Promise<{ data: NodeTypeSchema[]; }>
+```
+
+Catalog of available workflow node types with config + output schemas.
+
+- Calls `GET /api/v1/workflows/node-types/schema` ([`g8.api.workflows.getNodeTypesSchema`](api/workflows.md#op-getnodetypesschema), tier `read`, scope `workflows:read`)
+
+- Source: `src/workflows.ts`
+
+<a id="g8-workflows-pauseexecution"></a>
+
+### `g8.workflows.pauseExecution`
+
+```ts
+g8.workflows.pauseExecution: (executionId: string) => Promise<{ data: { paused: boolean; }; }>
+```
+
+Pause a running execution.
+
+- Calls `POST /api/v1/workflows/executions/{execution_id}/pause` ([`g8.api.workflows.pauseExecution`](api/workflows.md#op-pauseexecution), tier `external`, scope `workflows:run`)
+
+- Source: `src/workflows.ts`
+
+<a id="g8-workflows-resettrigger"></a>
+
+### `g8.workflows.resetTrigger`
+
+```ts
+g8.workflows.resetTrigger: (workflowId: string) => Promise<{ data: { reset: boolean; }; }>
+```
+
+Reset a workflow's trigger cursor / state.
+
+- Calls `POST /api/v1/workflows/{action_id}/trigger-reset` ([`g8.api.workflows.resetTriggerCursor`](api/workflows.md#op-resettriggercursor), tier `external`, scope `workflows:run`)
+
+- Source: `src/workflows.ts`
+
+<a id="g8-workflows-resumeexecution"></a>
+
+### `g8.workflows.resumeExecution`
+
+```ts
+g8.workflows.resumeExecution: (executionId: string) => Promise<{ data: { resumed: boolean; }; }>
+```
+
+Resume a paused execution.
+
+- Calls `POST /api/v1/workflows/executions/{execution_id}/resume` ([`g8.api.workflows.resumeExecution`](api/workflows.md#op-resumeexecution), tier `external`, scope `workflows:run`)
+
+- Source: `src/workflows.ts`
+
+<a id="g8-workflows-stopexecution"></a>
+
+### `g8.workflows.stopExecution`
+
+```ts
+g8.workflows.stopExecution: (executionId: string) => Promise<{ data: { stopped: boolean; }; }>
+```
+
+Stop an execution.
+
+- Calls `POST /api/v1/workflows/executions/{execution_id}/stop` ([`g8.api.workflows.stopExecution`](api/workflows.md#op-stopexecution), tier `external`, scope `workflows:run`)
+
+- Source: `src/workflows.ts`
+
+<a id="g8-workflows-update"></a>
+
+### `g8.workflows.update`
+
+```ts
+g8.workflows.update: (workflowId: string, fields: WorkflowUpdateParams) => Promise<Workflow>
+```
+
+Update a workflow. Pass the full `config` (nodes + connections) to edit the graph — node-level CRUD is performed client-side by mutating the config and submitting the updated record.
+
+- Calls `PUT /api/v1/workflows/{action_id}` ([`g8.api.workflows.updateWorkflow`](api/workflows.md#op-updateworkflow), tier `external`, scope `workflows:run`)
+
+- Source: `src/workflows.ts`
+
+<a id="g8-workflows-validate"></a>
+
+### `g8.workflows.validate`
+
+```ts
+g8.workflows.validate: (workflow: { config: WorkflowConfig; trigger_config?: Record<string, unknown>; }) => Promise<{ data: { valid: boolean; errors: Array<{ node_id?: string; field?: string; message: string; }>; }; }>
+```
+
+Validate a workflow definition (orphans, dangling connections, required fields).
+
+- Calls `POST /api/v1/workflows/validate` ([`g8.api.workflows.validateWorkflow`](api/workflows.md#op-validateworkflow), tier `external`, scope `workflows:run`)
+
+- Source: `src/workflows.ts`