@graph8/sdk 0.302.0 → 0.308.1

package/dist/types/version.d.ts

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

package/docs/agents.md

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

package/docs/api/README.md

@@ -2,7 +2,7 @@
 
 # `g8.api`: every Developer API operation
 
-`g8.api` is generated from the published OpenAPI contract, so it covers all 3258 operations across 141 namespaces (1513 read, 811 write, 300 destructive, 383 billable, 251 external).
+`g8.api` is generated from the published OpenAPI contract, so it covers all 3286 operations across 142 namespaces (1524 read, 825 write, 303 destructive, 383 billable, 251 external).
 
 - Found a REST path in a curl example or the web docs? Look it up in [by-path.md](by-path.md).
 - Prefer a hand-written method where one exists: [../sdk-clients.md](../sdk-clients.md).
@@ -58,6 +58,7 @@
 | `g8.api.copilot` | Copilot | 39 | none | [copilot.md](copilot.md) | [copilot.d.ts](copilot.d.ts) |
 | `g8.api.crmSyncs` | CRM Syncs | 6 | none | [crmSyncs.md](crmSyncs.md) | [crmSyncs.d.ts](crmSyncs.d.ts) |
 | `g8.api.customerSuccess` | Customer success | 19 | none | [customerSuccess.md](customerSuccess.md) | [customerSuccess.d.ts](customerSuccess.d.ts) |
+| `g8.api.dataPipelines` | Data pipelines | 5 | none | [dataPipelines.md](dataPipelines.md) | [dataPipelines.d.ts](dataPipelines.d.ts) |
 | `g8.api.deals` | Deals | 48 | 8 | [deals.md](deals.md) | [deals.d.ts](deals.d.ts) |
 | `g8.api.deliverability` | Deliverability | 17 | none | [deliverability.md](deliverability.md) | [deliverability.d.ts](deliverability.d.ts) |
 | `g8.api.desk` | Desk | 71 | none | [desk.md](desk.md) | [desk.d.ts](desk.d.ts) |
@@ -104,7 +105,7 @@
 | `g8.api.newsletter` | Newsletter | 61 | 15 | [newsletter.md](newsletter.md) | [newsletter.d.ts](newsletter.d.ts) |
 | `g8.api.notes` | Notes | 19 | 8 | [notes.md](notes.md) | [notes.d.ts](notes.d.ts) |
 | `g8.api.notifications` | Notifications | 2 | none | [notifications.md](notifications.md) | [notifications.d.ts](notifications.d.ts) |
-| `g8.api.objects` | Objects | 18 | 18 | [objects.md](objects.md) | [objects.d.ts](objects.d.ts) |
+| `g8.api.objects` | Objects | 41 | 18 | [objects.md](objects.md) | [objects.d.ts](objects.d.ts) |
 | `g8.api.openSearch` | OpenSearch | 4 | none | [openSearch.md](openSearch.md) | [openSearch.d.ts](openSearch.d.ts) |
 | `g8.api.ops` | Ops (internal, cross-tenant, read-only) | 5 | none | [ops.md](ops.md) | [ops.d.ts](ops.d.ts) |
 | `g8.api.orgGovernance` | Org Governance | 17 | none | [orgGovernance.md](orgGovernance.md) | [orgGovernance.d.ts](orgGovernance.d.ts) |

package/docs/api/appObjects.d.ts

@@ -284,6 +284,8 @@ export interface AttributeDefinitionResponse {
   sort_order?: number;
   /** Customer-facing field label, distinct from its stable API slug. */
   title: string;
+  /** Role ids that may see this field; null means every role. Owners and admins always see every field. A field hidden from the caller is absent from every response. Set it with PATCH on this attribute. */
+  visible_to_role_ids?: Array<string> | null;
 }
 
 /** One custom object type in the caller's workspace. */

package/docs/api/appObjects.md

@@ -319,6 +319,7 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `is_system` | `boolean` | no | Whether this field is protected as a system attribute. default `false` |
 | `is_unique` | `boolean` | no | No two active records may hold the same value for this attribute. A collision is rejected with `409 duplicate_active_value`. default `false` |
 | `sort_order` | `integer` | no | Configured display order; equal values are ordered by API slug. default `0` |
+| `visible_to_role_ids` | `Array<string> \| null` | no | Role ids that may see this field; null means every role. Owners and admins always see every field. A field hidden from the caller is absent from every response. Set it with PATCH on this attribute. |
 
 **Example**
 

package/docs/api/by-path.md

@@ -876,6 +876,11 @@ Every Developer API route, sorted by path, with the SDK call that reaches it. Th
 | PATCH | `/api/v1/customer-success/transcripts/{transcript_id}/archive` | [`g8.api.customerSuccess.archiveTranscript`](customerSuccess.md#op-archivetranscript) | destructive |
 | PATCH | `/api/v1/customer-success/transcripts/{transcript_id}/link` | [`g8.api.customerSuccess.linkTranscriptToAccount`](customerSuccess.md#op-linktranscripttoaccount) | write |
 | PATCH | `/api/v1/customer-success/transcripts/{transcript_id}/unarchive` | [`g8.api.customerSuccess.unarchiveTranscript`](customerSuccess.md#op-unarchivetranscript) | write |
+| GET | `/api/v1/data-pipelines/destinations` | [`g8.api.dataPipelines.listDestinations`](dataPipelines.md#op-listdestinations) | read |
+| GET | `/api/v1/data-pipelines/functions` | [`g8.api.dataPipelines.listFunctions`](dataPipelines.md#op-listfunctions) | read |
+| GET | `/api/v1/data-pipelines/streams/{stream_id}/events` | [`g8.api.dataPipelines.listStreamEvents`](dataPipelines.md#op-liststreamevents) | read |
+| GET | `/api/v1/data-pipelines/syncs` | [`g8.api.dataPipelines.listSyncs`](dataPipelines.md#op-listsyncs) | read |
+| GET | `/api/v1/data-pipelines/syncs/{sync_id}/tasks` | [`g8.api.dataPipelines.listSyncTasks`](dataPipelines.md#op-listsynctasks) | read |
 | GET | `/api/v1/deals` | [`g8.api.deals.listDeals`](deals.md#op-listdeals) or `g8.deals.list()` | read |
 | POST | `/api/v1/deals` | [`g8.api.deals.createDeal`](deals.md#op-createdeal) or `g8.deals.create()` | write |
 | GET | `/api/v1/deals/analytics` | [`g8.api.deals.getDealAnalytics`](deals.md#op-getdealanalytics) | read |
@@ -2022,15 +2027,38 @@ Every Developer API route, sorted by path, with the SDK call that reaches it. Th
 | POST | `/api/v1/objects/{object_slug}/attributes` | [`g8.api.objects.createAttribute`](objects.md#op-createattribute) or `g8.objects.createAttribute()` | write |
 | DELETE | `/api/v1/objects/{object_slug}/attributes/{attr_slug}` | [`g8.api.objects.archiveAttribute`](objects.md#op-archiveattribute) or `g8.objects.archiveAttribute()` | destructive |
 | PATCH | `/api/v1/objects/{object_slug}/attributes/{attr_slug}` | [`g8.api.objects.updateAttribute`](objects.md#op-updateattribute) or `g8.objects.updateAttribute()` | write |
+| POST | `/api/v1/objects/{object_slug}/exports` | [`g8.api.objects.exportObjectRecords`](objects.md#op-exportobjectrecords) | write |
+| GET | `/api/v1/objects/{object_slug}/imports/csv/drafts` | [`g8.api.objects.listObjectCsvImports`](objects.md#op-listobjectcsvimports) | read |
+| POST | `/api/v1/objects/{object_slug}/imports/csv/drafts` | [`g8.api.objects.createObjectCsvImport`](objects.md#op-createobjectcsvimport) | write |
+| DELETE | `/api/v1/objects/{object_slug}/imports/csv/drafts/{draft_id}` | [`g8.api.objects.deleteObjectCsvImport`](objects.md#op-deleteobjectcsvimport) | destructive |
+| GET | `/api/v1/objects/{object_slug}/imports/csv/drafts/{draft_id}` | [`g8.api.objects.getObjectCsvImport`](objects.md#op-getobjectcsvimport) | read |
+| PUT | `/api/v1/objects/{object_slug}/imports/csv/drafts/{draft_id}` | [`g8.api.objects.updateObjectCsvImport`](objects.md#op-updateobjectcsvimport) | write |
+| POST | `/api/v1/objects/{object_slug}/imports/csv/drafts/{draft_id}/commit` | [`g8.api.objects.commitObjectCsvImport`](objects.md#op-commitobjectcsvimport) | write |
+| GET | `/api/v1/objects/{object_slug}/imports/csv/drafts/{draft_id}/errors` | [`g8.api.objects.downloadObjectCsvImportErrors`](objects.md#op-downloadobjectcsvimporterrors) | read |
+| POST | `/api/v1/objects/{object_slug}/imports/csv/drafts/{draft_id}/preview` | [`g8.api.objects.previewObjectCsvImport`](objects.md#op-previewobjectcsvimport) | write |
+| POST | `/api/v1/objects/{object_slug}/imports/csv/inspect` | [`g8.api.objects.inspectObjectCsvImport`](objects.md#op-inspectobjectcsvimport) | write |
 | GET | `/api/v1/objects/{object_slug}/records` | [`g8.api.objects.listObjectRecords`](objects.md#op-listobjectrecords) or `g8.objects.listRecords()` | read |
 | POST | `/api/v1/objects/{object_slug}/records` | [`g8.api.objects.createObjectRecord`](objects.md#op-createobjectrecord) or `g8.objects.createRecord()` | write |
+| PATCH | `/api/v1/objects/{object_slug}/records/bulk` | [`g8.api.objects.bulkUpdateObjectRecords`](objects.md#op-bulkupdateobjectrecords) | write |
+| POST | `/api/v1/objects/{object_slug}/records/merge` | [`g8.api.objects.mergeObjectRecords`](objects.md#op-mergeobjectrecords) | write |
 | POST | `/api/v1/objects/{object_slug}/records/upsert` | [`g8.api.objects.upsertObjectRecord`](objects.md#op-upsertobjectrecord) or `g8.objects.upsertRecord()` | write |
 | DELETE | `/api/v1/objects/{object_slug}/records/{record_id}` | [`g8.api.objects.archiveObjectRecord`](objects.md#op-archiveobjectrecord) or `g8.objects.archiveRecord()` | destructive |
 | GET | `/api/v1/objects/{object_slug}/records/{record_id}` | [`g8.api.objects.getObjectRecord`](objects.md#op-getobjectrecord) or `g8.objects.getRecord()` | read |
 | PATCH | `/api/v1/objects/{object_slug}/records/{record_id}` | [`g8.api.objects.updateObjectRecord`](objects.md#op-updateobjectrecord) or `g8.objects.updateRecord()` | write |
 | GET | `/api/v1/objects/{object_slug}/records/{record_id}/changes` | [`g8.api.objects.getObjectRecordChanges`](objects.md#op-getobjectrecordchanges) or `g8.objects.changes()` | read |
 | GET | `/api/v1/objects/{object_slug}/records/{record_id}/history` | [`g8.api.objects.getObjectRecordHistory`](objects.md#op-getobjectrecordhistory) or `g8.objects.history()` | read |
+| GET | `/api/v1/objects/{object_slug}/records/{record_id}/relationships` | [`g8.api.objects.getObjectRelationships`](objects.md#op-getobjectrelationships) | read |
+| POST | `/api/v1/objects/{object_slug}/records/{record_id}/relationships` | [`g8.api.objects.createObjectRelationship`](objects.md#op-createobjectrelationship) | write |
+| DELETE | `/api/v1/objects/{object_slug}/records/{record_id}/relationships/{relationship_id}` | [`g8.api.objects.deleteObjectRelationship`](objects.md#op-deleteobjectrelationship) | destructive |
 | POST | `/api/v1/objects/{object_slug}/records/{record_id}/restore` | [`g8.api.objects.restoreObjectRecord`](objects.md#op-restoreobjectrecord) or `g8.objects.restoreRecord()` | write |
+| GET | `/api/v1/objects/{object_slug}/relationships` | [`g8.api.objects.getObjectRelationshipDefinitions`](objects.md#op-getobjectrelationshipdefinitions) | read |
+| GET | `/api/v1/objects/{object_slug}/views` | [`g8.api.objects.listObjectViews`](objects.md#op-listobjectviews) | read |
+| POST | `/api/v1/objects/{object_slug}/views` | [`g8.api.objects.createObjectView`](objects.md#op-createobjectview) | write |
+| POST | `/api/v1/objects/{object_slug}/views/board/groups` | [`g8.api.objects.queryObjectBoardGroups`](objects.md#op-queryobjectboardgroups) | write |
+| POST | `/api/v1/objects/{object_slug}/views/board/records` | [`g8.api.objects.queryObjectBoardRecords`](objects.md#op-queryobjectboardrecords) | write |
+| PUT | `/api/v1/objects/{object_slug}/views/default` | [`g8.api.objects.setDefaultObjectView`](objects.md#op-setdefaultobjectview) | write |
+| DELETE | `/api/v1/objects/{object_slug}/views/{view_id}` | [`g8.api.objects.deleteObjectView`](objects.md#op-deleteobjectview) | destructive |
+| PUT | `/api/v1/objects/{object_slug}/views/{view_id}` | [`g8.api.objects.updateObjectView`](objects.md#op-updateobjectview) | write |
 | POST | `/api/v1/opensearch/aggregate` | [`g8.api.openSearch.opensearchAggregate`](openSearch.md#op-opensearchaggregate) | write |
 | POST | `/api/v1/opensearch/count` | [`g8.api.openSearch.opensearchCount`](openSearch.md#op-opensearchcount) | write |
 | POST | `/api/v1/opensearch/resolve` | [`g8.api.openSearch.opensearchResolve`](openSearch.md#op-opensearchresolve) | write |

package/docs/api/dataPipelines.d.ts

@@ -0,0 +1,149 @@
+/* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
+
+/**
+ * Types for `g8.api.dataPipelines` (Data pipelines): 5 operations.
+ *
+ * For reading. In code, import from the package instead:
+ *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
+ *   type In = ApiInput<"list_destinations_data_pipelines_destinations_get">;
+ *
+ * Reference with examples: dataPipelines.md
+ */
+/* eslint-disable */
+
+/** `g8.api.dataPipelines.<member>` -> the operationId it calls. */
+export interface DataPipelinesMembers {
+  listDestinations: "list_destinations_data_pipelines_destinations_get";
+  listFunctions: "list_functions_data_pipelines_functions_get";
+  listStreamEvents: "list_stream_events_data_pipelines_streams__stream_id__events_get";
+  listSyncTasks: "list_sync_tasks_data_pipelines_syncs__sync_id__tasks_get";
+  listSyncs: "list_syncs_data_pipelines_syncs_get";
+}
+
+/** Input and output of every `g8.api.dataPipelines` operation, keyed by operationId. */
+export interface DataPipelinesOperations {
+  /**
+   * GET /data-pipelines/destinations
+   * List Destinations
+   * tier: read · scope: integrations:read
+   */
+  list_destinations_data_pipelines_destinations_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DataPipelineItems_;
+  };
+  /**
+   * GET /data-pipelines/functions
+   * List Functions
+   * tier: read · scope: integrations:read
+   */
+  list_functions_data_pipelines_functions_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DataPipelineItems_;
+  };
+  /**
+   * GET /data-pipelines/streams/{stream_id}/events
+   * List Stream Events
+   * tier: read · scope: integrations:read
+   */
+  list_stream_events_data_pipelines_streams__stream_id__events_get: {
+    input: {
+    path: {
+      /** Stream id (from GET /streams). */
+      stream_id: string;
+    };
+    query?: {
+      /** Newest events to return, 1-200. */
+      limit?: number;
+      /** Only events at or after (ISO 8601). */
+      start?: string | null;
+      /** Only events before (ISO 8601). */
+      end?: string | null;
+      /** Only entries at this log level (e.g. error = rejected events). */
+      levels?: ("error" | "warn" | "info" | "debug") | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DataPipelineItems_;
+  };
+  /**
+   * GET /data-pipelines/syncs/{sync_id}/tasks
+   * List Sync Tasks
+   * tier: read · scope: integrations:read
+   */
+  list_sync_tasks_data_pipelines_syncs__sync_id__tasks_get: {
+    input: {
+    path: {
+      /** Sync id (from GET /data-pipelines/syncs). */
+      sync_id: string;
+    };
+    query?: {
+      /** Only runs in this status (e.g. SUCCESS, FAILED, RUNNING). */
+      status?: string | null;
+      /** Only runs started at or after (ISO 8601). */
+      started_after?: string | null;
+      /** Only runs started before (ISO 8601). */
+      started_before?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DataPipelineItems_;
+  };
+  /**
+   * GET /data-pipelines/syncs
+   * List Syncs
+   * tier: read · scope: integrations:read
+   */
+  list_syncs_data_pipelines_syncs_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_DataPipelineItems_;
+  };
+}
+
+// 3 schemas referenced above (the same as G8Contract.<Name>).
+
+export interface ApiResponse_DataPipelineItems_ {
+  data: DataPipelineItems;
+  pagination?: PaginationMeta | null;
+}
+
+/** A list of data-pipeline objects or log entries. */
+export interface DataPipelineItems {
+  items?: Array<Record<string, unknown>>;
+  total?: number;
+  [key: string]: unknown;
+}
+
+export interface PaginationMeta {
+  /** Whether there are more pages */
+  has_next: boolean;
+  /** Items per page */
+  limit: number;
+  /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
+  next_cursor?: string | null;
+  /** Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order. */
+  notes?: Array<string> | null;
+  /** Current page number (1-indexed) */
+  page: number;
+  /** Total number of items */
+  total: number;
+  /** Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search. */
+  total_available?: number | null;
+  /** Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search. */
+  total_is_lower_bound?: boolean | null;
+}

package/docs/api/dataPipelines.md

@@ -0,0 +1,232 @@
+<!-- Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. -->
+
+# `g8.api.dataPipelines`: Data pipelines
+
+5 operations (5 read).
+
+No hand-written client covers this area. Call it through `g8.api.dataPipelines.*` as shown below, or by operationId with `g8.api.call(operationId, input)`.
+
+Every example below assumes this setup (server-side, API key):
+
+```ts
+import { g8 } from "@graph8/sdk";
+
+g8.init({ apiKey: process.env.G8_API_KEY! });
+```
+
+Example values are placeholders that match each field's type. Only required fields are shown. Every example is type-checked against the SDK in CI.
+
+Exact TypeScript types for every operation on this page, and every schema they use: [dataPipelines.d.ts](dataPipelines.d.ts).
+
+## Operations
+
+| Call | HTTP | Tier | Scope | Summary |
+|---|---|---|---|---|
+| [`listDestinations`](#op-listdestinations) | `GET /api/v1/data-pipelines/destinations` | read | `integrations:read` | List Destinations |
+| [`listFunctions`](#op-listfunctions) | `GET /api/v1/data-pipelines/functions` | read | `integrations:read` | List Functions |
+| [`listStreamEvents`](#op-liststreamevents) | `GET /api/v1/data-pipelines/streams/{stream_id}/events` | read | `integrations:read` | List Stream Events |
+| [`listSyncTasks`](#op-listsynctasks) | `GET /api/v1/data-pipelines/syncs/{sync_id}/tasks` | read | `integrations:read` | List Sync Tasks |
+| [`listSyncs`](#op-listsyncs) | `GET /api/v1/data-pipelines/syncs` | read | `integrations:read` | List Syncs |
+
+---
+
+<a id="op-listdestinations"></a>
+
+### `g8.api.dataPipelines.listDestinations(input?)`
+
+**List Destinations**
+
+- HTTP: `GET /api/v1/data-pipelines/destinations`
+- operationId: `list_destinations_data_pipelines_destinations_get` (also callable as `g8.api.call("list_destinations_data_pipelines_destinations_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `integrations:read`
+
+List the organization's data destinations (warehouses, webhooks, ad/CRM targets).
+
+Same list as Data > Connections > Destinations. Secrets (passwords, keys,
+service-account JSON, tokens) are never returned: each one reads `__SET__`.
+
+**Input**: none.
+
+**Returns** `ApiResponse_DataPipelineItems_`: the envelope `{ data: DataPipelineItems, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`DataPipelineItems` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<Record<string, unknown>>` | no |  |
+| `total` | `integer` | no | default `0` |
+
+**Example**
+
+```ts
+const result = await g8.api.dataPipelines.listDestinations();
+```
+
+---
+
+<a id="op-listfunctions"></a>
+
+### `g8.api.dataPipelines.listFunctions(input?)`
+
+**List Functions**
+
+- HTTP: `GET /api/v1/data-pipelines/functions`
+- operationId: `list_functions_data_pipelines_functions_get` (also callable as `g8.api.call("list_functions_data_pipelines_functions_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `integrations:read`
+
+List the organization's event functions (transformations run on a sync).
+
+Same list as Data > Connections > Functions. Function environment secrets
+read `__SET__`.
+
+**Input**: none.
+
+**Returns** `ApiResponse_DataPipelineItems_`: the envelope `{ data: DataPipelineItems, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`DataPipelineItems` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<Record<string, unknown>>` | no |  |
+| `total` | `integer` | no | default `0` |
+
+**Example**
+
+```ts
+const result = await g8.api.dataPipelines.listFunctions();
+```
+
+---
+
+<a id="op-liststreamevents"></a>
+
+### `g8.api.dataPipelines.listStreamEvents(input)`
+
+**List Stream Events**
+
+- HTTP: `GET /api/v1/data-pipelines/streams/{stream_id}/events`
+- operationId: `list_stream_events_data_pipelines_streams__stream_id__events_get` (also callable as `g8.api.call("list_stream_events_data_pipelines_streams__stream_id__events_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `integrations:read`
+
+Live events: the latest events a tracking stream received, newest first.
+
+Same feed as Data > Connections > Live events. Use it to check a snippet
+install (are page views arriving from the right site?) or to see rejected
+events (`levels=error`). The sender's IP address and HTTP headers are
+dropped from every entry. 404 when the stream is not in this organization.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.stream_id` | `string` | yes | Stream id (from GET /streams). |
+| `query.limit` | `integer` | no | Newest events to return, 1-200. default `50` |
+| `query.start` | `string \| null` | no | Only events at or after (ISO 8601). |
+| `query.end` | `string \| null` | no | Only events before (ISO 8601). |
+| `query.levels` | `"error" \| "warn" \| "info" \| "debug" \| null` | no | Only entries at this log level (e.g. error = rejected events). |
+
+**Returns** `ApiResponse_DataPipelineItems_`: the envelope `{ data: DataPipelineItems, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`DataPipelineItems` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<Record<string, unknown>>` | no |  |
+| `total` | `integer` | no | default `0` |
+
+**Example**
+
+```ts
+const result = await g8.api.dataPipelines.listStreamEvents({ path: { stream_id: "id" } });
+```
+
+---
+
+<a id="op-listsynctasks"></a>
+
+### `g8.api.dataPipelines.listSyncTasks(input)`
+
+**List Sync Tasks**
+
+- HTTP: `GET /api/v1/data-pipelines/syncs/{sync_id}/tasks`
+- operationId: `list_sync_tasks_data_pipelines_syncs__sync_id__tasks_get` (also callable as `g8.api.call("list_sync_tasks_data_pipelines_syncs__sync_id__tasks_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `integrations:read`
+
+A sync's run history: when each run started, its status and any error.
+
+Connector (service) syncs only; a stream-to-destination sync streams events
+continuously and has no runs. 404 when the sync is not in this organization.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.sync_id` | `string` | yes | Sync id (from GET /data-pipelines/syncs). |
+| `query.status` | `string \| null` | no | Only runs in this status (e.g. SUCCESS, FAILED, RUNNING). |
+| `query.started_after` | `string \| null` | no | Only runs started at or after (ISO 8601). |
+| `query.started_before` | `string \| null` | no | Only runs started before (ISO 8601). |
+
+**Returns** `ApiResponse_DataPipelineItems_`: the envelope `{ data: DataPipelineItems, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`DataPipelineItems` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<Record<string, unknown>>` | no |  |
+| `total` | `integer` | no | default `0` |
+
+**Example**
+
+```ts
+const result = await g8.api.dataPipelines.listSyncTasks({ path: { sync_id: "id" } });
+```
+
+---
+
+<a id="op-listsyncs"></a>
+
+### `g8.api.dataPipelines.listSyncs(input?)`
+
+**List Syncs**
+
+- HTTP: `GET /api/v1/data-pipelines/syncs`
+- operationId: `list_syncs_data_pipelines_syncs_get` (also callable as `g8.api.call("list_syncs_data_pipelines_syncs_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `integrations:read`
+
+List the organization's syncs: each one connects a stream or connector to a destination.
+
+Same list as Data > Connections > Syncs. Each item carries `fromId`
+(stream or connector id), `toId` (destination id) and its settings. Per-sync
+function secrets read `__SET__`. Run history: GET /data-pipelines/syncs/{sync_id}/tasks.
+
+**Input**: none.
+
+**Returns** `ApiResponse_DataPipelineItems_`: the envelope `{ data: DataPipelineItems, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`DataPipelineItems` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<Record<string, unknown>>` | no |  |
+| `total` | `integer` | no | default `0` |
+
+**Example**
+
+```ts
+const result = await g8.api.dataPipelines.listSyncs();
+```

package/docs/api/forms.d.ts

@@ -837,14 +837,24 @@ export interface FormOverview {
   activation_health?: string | null;
   capture_health?: string | null;
   delivery_health?: string | null;
+  /** Where leads go: 'route' (tracked delivery route), 'legacy_mapping' (older list mapping; delivered, but processed/failed stay 0 because it writes no receipts) or null (nowhere). */
+  delivery_source?: string | null;
+  /** Plain-language delivery problem, e.g. captured leads with no destination. */
+  delivery_warning?: string | null;
+  /** The destination list: {list_id, route_version, source, list_name?}; null when none. */
+  destination?: Record<string, unknown> | null;
   display_name?: string | null;
   form_key: string;
   identity_state?: string | null;
   last_destination_verified_at?: string | null;
+  /** When a submission of this form was last processed for delivery. */
+  last_processed_at?: string | null;
   metrics?: Record<string, unknown>;
   owner_id?: string | null;
   placement_count?: number;
   recommended_action?: string | null;
+  /** What is missing for someone to own this form's leads: [{code, message}], e.g. owner_missing. */
+  setup_hints?: Array<Record<string, unknown>>;
   source_id: string;
   technical_form_id?: string | null;
 }
@@ -961,8 +971,14 @@ export interface FormSubmissionsSearchRequest {
 
 /** One lead-capture form as returned by the list/search endpoint. */
 export interface FormSummary {
+  /** 'failing' when at least one submission failed delivery; null otherwise. */
+  delivery_health?: string | null;
+  /** Where this form's leads are delivered: 'route' (a tracked delivery route), 'legacy_mapping' (an older list mapping, delivered but not tracked per submission) or 'none' (nowhere). Same value the overview reports. */
+  delivery_source?: string | null;
   /** Human-friendly name for the form. */
   display_name?: string | null;
+  /** Submissions whose delivery failed or was only partly delivered (same count as the overview). */
+  failed_submissions?: number | null;
   /** Alias for id; the addressable key for detail lookups. */
   form_key?: string | null;
   /** The form's HTML tag id (or the id-less group key). */

package/docs/api/forms.md

@@ -400,13 +400,18 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `activation_health` | `string \| null` | no |  |
 | `capture_health` | `string \| null` | no |  |
 | `delivery_health` | `string \| null` | no |  |
+| `delivery_source` | `string \| null` | no | Where leads go: 'route' (tracked delivery route), 'legacy_mapping' (older list mapping; delivered, but processed/failed stay 0 because it writes no receipts) or null (nowhere). |
+| `delivery_warning` | `string \| null` | no | Plain-language delivery problem, e.g. captured leads with no destination. |
+| `destination` | `Record<string, unknown> \| null` | no | The destination list: {list_id, route_version, source, list_name?}; null when none. |
 | `display_name` | `string \| null` | no |  |
 | `identity_state` | `string \| null` | no |  |
 | `last_destination_verified_at` | `string (date-time) \| null` | no |  |
+| `last_processed_at` | `string (date-time) \| null` | no | When a submission of this form was last processed for delivery. |
 | `metrics` | `Record<string, unknown>` | no |  |
 | `owner_id` | `string \| null` | no |  |
 | `placement_count` | `integer` | no | default `0` |
 | `recommended_action` | `string \| null` | no |  |
+| `setup_hints` | `Array<Record<string, unknown>>` | no | What is missing for someone to own this form's leads: [{code, message}], e.g. owner_missing. |
 | `technical_form_id` | `string \| null` | no |  |
 
 **Example**
@@ -1532,7 +1537,10 @@ One lead-capture form as returned by the list/search endpoint.
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `id` | `string` | yes | The form's HTML tag id (or the id-less group key). |
+| `delivery_health` | `string \| null` | no | 'failing' when at least one submission failed delivery; null otherwise. |
+| `delivery_source` | `string \| null` | no | Where this form's leads are delivered: 'route' (a tracked delivery route), 'legacy_mapping' (an older list mapping, delivered but not tracked per submission) or 'none' (nowhere). Same value the overview reports. |
 | `display_name` | `string \| null` | no | Human-friendly name for the form. |
+| `failed_submissions` | `integer \| null` | no | Submissions whose delivery failed or was only partly delivered (same count as the overview). |
 | `form_key` | `string \| null` | no | Alias for id; the addressable key for detail lookups. |
 | `latest_submitted_at` | `string (date-time) \| null` | no | Most recent submission timestamp. |
 | `page_url` | `string \| null` | no | URL of a page where the form was submitted. |