@graph8/sdk 0.303.0 → 0.357.0

package/dist/ui/primitives/tooltip.mjs

@@ -0,0 +1,57 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import * as TooltipPrimitive from "@radix-ui/react-tooltip";
+import { cn } from "../lib/utils.mjs";
+function TooltipProvider({
+  delayDuration = 0,
+  ...props
+}) {
+  return /* @__PURE__ */ jsx(
+    TooltipPrimitive.Provider,
+    {
+      "data-slot": "tooltip-provider",
+      delayDuration,
+      ...props
+    }
+  );
+}
+function Tooltip({
+  ...props
+}) {
+  return /* @__PURE__ */ jsx(TooltipProvider, { children: /* @__PURE__ */ jsx(TooltipPrimitive.Root, { "data-slot": "tooltip", ...props }) });
+}
+function TooltipTrigger({
+  ...props
+}) {
+  return /* @__PURE__ */ jsx(TooltipPrimitive.Trigger, { "data-slot": "tooltip-trigger", ...props });
+}
+function TooltipContent({
+  className,
+  sideOffset = 0,
+  children,
+  ...props
+}) {
+  return /* @__PURE__ */ jsx(TooltipPrimitive.Portal, { children: /* @__PURE__ */ jsxs(
+    TooltipPrimitive.Content,
+    {
+      "data-slot": "tooltip-content",
+      sideOffset,
+      className: cn(
+        "bg-primary text-primary-foreground shadow-md animate-in fade-in-0 zoom-in-95 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 w-fit origin-(--radix-tooltip-content-transform-origin) rounded-md px-3 py-1.5 text-xs text-balance",
+        className
+      ),
+      ...props,
+      children: [
+        children,
+        /* @__PURE__ */ jsx(TooltipPrimitive.Arrow, { className: "bg-primary fill-primary z-50 size-2.5 translate-y-[calc(-50%_-_2px)] rotate-45 rounded-[2px]" })
+      ]
+    }
+  ) });
+}
+export {
+  Tooltip,
+  TooltipContent,
+  TooltipProvider,
+  TooltipTrigger
+};
+//# sourceMappingURL=tooltip.mjs.map

package/dist/ui/primitives/tooltip.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/ui/primitives/tooltip.tsx"],"sourcesContent":["/*\n * @graph8/sdk/ui — GENERATED FROM frontend/components/ui/tooltip.tsx. DO NOT EDIT.\n *\n * Edit the app source, then run: npm run generate:ui --prefix sdk/js\n * Hand edits are overwritten and will fail sdk/js/tests/ui/drift.test.ts.\n */\n\"use client\"\n\nimport * as React from \"react\"\nimport * as TooltipPrimitive from \"@radix-ui/react-tooltip\"\n\nimport { cn } from \"../lib/utils\"\n\nfunction TooltipProvider({\n  delayDuration = 0,\n  ...props\n}: React.ComponentProps<typeof TooltipPrimitive.Provider>) {\n  return (\n    <TooltipPrimitive.Provider\n      data-slot=\"tooltip-provider\"\n      delayDuration={delayDuration}\n      {...props}\n    />\n  )\n}\n\nfunction Tooltip({\n  ...props\n}: React.ComponentProps<typeof TooltipPrimitive.Root>) {\n  return (\n    <TooltipProvider>\n      <TooltipPrimitive.Root data-slot=\"tooltip\" {...props} />\n    </TooltipProvider>\n  )\n}\n\nfunction TooltipTrigger({\n  ...props\n}: React.ComponentProps<typeof TooltipPrimitive.Trigger>) {\n  return <TooltipPrimitive.Trigger data-slot=\"tooltip-trigger\" {...props} />\n}\n\nfunction TooltipContent({\n  className,\n  sideOffset = 0,\n  children,\n  ...props\n}: React.ComponentProps<typeof TooltipPrimitive.Content>) {\n  return (\n    <TooltipPrimitive.Portal>\n      <TooltipPrimitive.Content\n        data-slot=\"tooltip-content\"\n        sideOffset={sideOffset}\n        className={cn(\n          \"bg-primary text-primary-foreground shadow-md animate-in fade-in-0 zoom-in-95 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 w-fit origin-(--radix-tooltip-content-transform-origin) rounded-md px-3 py-1.5 text-xs text-balance\",\n          className\n        )}\n        {...props}\n      >\n        {children}\n        <TooltipPrimitive.Arrow className=\"bg-primary fill-primary z-50 size-2.5 translate-y-[calc(-50%_-_2px)] rotate-45 rounded-[2px]\" />\n      </TooltipPrimitive.Content>\n    </TooltipPrimitive.Portal>\n  )\n}\n\nexport { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider }\n"],"mappings":";AAkBI,cAgCE,YAhCF;AATJ,YAAY,sBAAsB;AAElC,SAAS,UAAU;AAEnB,SAAS,gBAAgB;AAAA,EACvB,gBAAgB;AAAA,EAChB,GAAG;AACL,GAA2D;AACzD,SACE;AAAA,IAAC,iBAAiB;AAAA,IAAjB;AAAA,MACC,aAAU;AAAA,MACV;AAAA,MACC,GAAG;AAAA;AAAA,EACN;AAEJ;AAEA,SAAS,QAAQ;AAAA,EACf,GAAG;AACL,GAAuD;AACrD,SACE,oBAAC,mBACC,8BAAC,iBAAiB,MAAjB,EAAsB,aAAU,WAAW,GAAG,OAAO,GACxD;AAEJ;AAEA,SAAS,eAAe;AAAA,EACtB,GAAG;AACL,GAA0D;AACxD,SAAO,oBAAC,iBAAiB,SAAjB,EAAyB,aAAU,mBAAmB,GAAG,OAAO;AAC1E;AAEA,SAAS,eAAe;AAAA,EACtB;AAAA,EACA,aAAa;AAAA,EACb;AAAA,EACA,GAAG;AACL,GAA0D;AACxD,SACE,oBAAC,iBAAiB,QAAjB,EACC;AAAA,IAAC,iBAAiB;AAAA,IAAjB;AAAA,MACC,aAAU;AAAA,MACV;AAAA,MACA,WAAW;AAAA,QACT;AAAA,QACA;AAAA,MACF;AAAA,MACC,GAAG;AAAA,MAEH;AAAA;AAAA,QACD,oBAAC,iBAAiB,OAAjB,EAAuB,WAAU,gGAA+F;AAAA;AAAA;AAAA,EACnI,GACF;AAEJ;","names":[]}

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: **3264 Developer API
-operations** in 141 areas.
+inbox, meetings, workflows and more. This SDK reaches all of it: **3315 Developer API
+operations** in 145 areas.
 
 ## 1. The short version
 
@@ -47,6 +47,7 @@ node_modules/@graph8/sdk/
   docs/api/<ns>.d.ts     that area's exact TypeScript types, self-contained (small: read it)
   dist/types/<module>.d.ts  one hand-written client's types, e.g. dist/types/contacts.d.ts
   dist/index.d.ts        the bundled types the compiler uses (large: search it, do not read it whole)
+  blocks/ stacks/        editable UI blocks to copy into an app (section 13)
 ```
 
 Search the docs directly. Some good searches:
@@ -92,7 +93,7 @@ g8.init({ apiKey: process.env.G8_API_KEY! });
 | | Hand-written clients | `g8.api` (generated) |
 |---|---|---|
 | Example | `g8.contacts.upsert({ list_id, work_email })` | `g8.api.assertUpsert.assertContact({ body: { list_id, work_email } })` |
-| Coverage | 289 methods, reaching 258 operations | all 3264 operations |
+| Coverage | 289 methods, reaching 258 operations | all 3315 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 +142,7 @@ Hand-written modules:
 | [`g8.webhooks`](sdk-clients.md#g8-webhooks) | 1 | API key |
 | [`g8.workflows`](sdk-clients.md#g8-workflows) | 21 | API key |
 
-`g8.api` namespaces (operation counts): `accounts` (16), `adCampaigns` (19), `adCreatives` (40), `agency` (24), `agent` (8), `agents` (65), `aiInbox` (79), `analytics` (51), `apiKeys` (6), `appDeployments` (7), `appDomains` (5), `appLogs` (2), `appObjects` (10), `appPages` (16), `appPlatformTokens` (3), `appointments` (92), `apps` (22), `assertUpsert` (6), `audienceSyncs` (8), `brandKit` (30), `bugReports` (7), `calendarInvites` (3), `campaignWorkflows` (5), `campaigns` (29), `channels` (5), `cliCampaigns` (6), `cliPipelines` (12), `clickHouse` (2), `companies` (50), `companyIntelligence` (14), `contacts` (70), `content` (41), `contentGridSkills` (6), `copilot` (39), `crmSyncs` (6), `customerSuccess` (19), `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` (24), `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` (42), `openSearch` (4), `ops` (5), `orgGovernance` (17), `orgVideos` (6), `organizationSettings` (22), `phoneNumbers` (16), `processLists` (6), `profile` (14), `programmaticPages` (15), `providerDomains` (34), `providerUsage` (5), `public` (1), `publicCopilot` (1), `publicSignals` (1), `publicVisitors` (2), `quotes` (56), `radar` (42), `radarReports` (8), `recordRoles` (4), `reports` (7), `repos` (4), `research` (13), `revenue` (14), `revenueAnalytics` (6), `revenueLifecycle` (5), `revenueRecords` (15), `roles` (21), `salesCoach` (37), `sandbox` (9), `scans` (2), `scheduleBuy` (9), `scraping` (10), `sdrAnalytics` (5), `search` (19), `seo` (22), `sequenceLifecycle` (8), `sequences` (71), `settings` (18), `signals` (56), `signatures` (24), `skills` (12), `snippet` (3), `socialPublishing` (22), `studioDocuments` (9), `support` (1), `suppressions` (6), `surveys` (21), `tasks` (25), `teamMembers` (21), `teams` (35), `usage` (9), `visitors` (26), `voice` (187), `webAnalytics` (38), `webChat` (46), `webhooks` (8), `websiteEditor` (12), `work` (59), `workbench` (107), `workflows` (59), `workspaceBackup` (7).
 
 ## 5. How to find the right call
 
@@ -196,9 +197,9 @@ Every operation carries a tier:
 
 | Tier | What it means | Count |
 |---|---|---|
-| `read` | reads data; safe to call and to retry | 1515 |
-| `write` | creates or changes records; the SDK sends an Idempotency-Key and retries transient failures | 814 |
-| `destructive` | deletes or archives data; confirm with a human before calling | 301 |
+| `read` | reads data; safe to call and to retry | 1540 |
+| `write` | creates or changes records; the SDK sends an Idempotency-Key and retries transient failures | 836 |
+| `destructive` | deletes or archives data; confirm with a human before calling | 305 |
 | `billable` | spends credits; the SDK never blindly retries it; confirm cost before bulk use | 383 |
 | `external` | reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first | 251 |
 
@@ -342,34 +343,37 @@ if (contacts.length > 0) {
 
 ### Prospect in the graph8 index, then save the people you want
 
-Building a list of new prospects. `enrich.search` queries graph8's contact index (not your CRM) and can spend credits depending on the plan, so keep pages small and confirm the cost with a human before bulk runs. Results are plain records: write the ones you keep into a list with `contacts.upsert`.
+Building a list of new prospects. `search.contacts` queries graph8's contact index (not your CRM). It needs an active subscription and does not spend credits, but contact details come back LOCKED: a field whose value exists reads `"***"` and is named in `locked_fields`. Never import a search row directly. Save the matches into a list with `search.saveContacts`, which reveals them as real CRM contacts, then read the list. Enrich or enroll from the list afterwards.
 
 ```ts
 import { g8 } from "@graph8/sdk";
 
 g8.init({ apiKey: process.env.G8_API_KEY! });
 
-const results = await g8.enrich.search(
-  [
-    { field: "seniority_level", operator: "any_of", value: ["VP", "Director"] },
-    { field: "company_industry", operator: "contains", value: ["SaaS"] },
-  ],
-  1, // page
-  25, // page size
-);
-console.log(`${results.total} matches; showing ${results.contacts.length}`);
-
-const list = await g8.lists.create("Q4 SaaS VPs", "contacts");
-for (const person of results.contacts) {
-  const email = typeof person.work_email === "string" ? person.work_email : undefined;
-  if (!email) continue;
-  await g8.contacts.upsert({
-    list_id: list.id,
-    work_email: email,
-    first_name: typeof person.first_name === "string" ? person.first_name : undefined,
-    last_name: typeof person.last_name === "string" ? person.last_name : undefined,
-  });
+const filters = [
+  { field: "seniority_level", operator: "any_of" as const, value: ["VP", "Director"] },
+  { field: "company_industry", operator: "contains" as const, value: ["SaaS"] },
+];
+
+// 1. Preview: free, masked. Use it to check the filters and the size before saving.
+const preview = await g8.search.contacts({ filters, limit: 25 });
+console.log(`${preview.pagination?.total ?? preview.data.length} matches`);
+const withEmail = preview.data.filter((p) => p.locked_fields?.includes("work_email")).length;
+console.log(`${withEmail} of the first ${preview.data.length} have a (locked) work email`);
+
+// 2. Save: creates a list and reveals the contacts into your CRM. Confirm the size with a human first.
+const saved = await g8.search.saveContacts({ filters, list_title: "Q4 SaaS VPs", max_results: 100 });
+
+// 3. The save runs in the background and fills the list in batches: a first non-empty read can be partial.
+//    Read until the total stops changing (or reaches the cap), then use the list.
+let page = await g8.lists.contacts(saved.list_id, 1, 50);
+for (let attempt = 0, previous = -1; attempt < 20 && page.total < 100; attempt++) {
+  if (page.total > 0 && page.total === previous) break;
+  previous = page.total;
+  await new Promise((resolve) => setTimeout(resolve, 3000));
+  page = await g8.lists.contacts(saved.list_id, 1, 50);
 }
+for (const contact of page.data) console.log(contact.id, contact.work_email);
 ```
 
 <a id="recipe-enrich"></a>
@@ -726,7 +730,10 @@ setTimeout(stop, 60_000);
   `full_name`, `personal_emails`, `company`, ...) in bulk, use `g8.contacts.listDetailed(filters)` or
   `g8.contacts.getMany(ids)` (100 per request), not a `get()` per contact.
 - **The CRM and the data index are different things.** `g8.contacts.*` reads YOUR workspace;
-  `g8.enrich.search` searches graph8's 700M-person index, which can spend credits depending on the plan.
+  `g8.search.contacts` (and the older `g8.enrich.search`) searches graph8's 700M-person index. It needs an
+  active subscription and does not spend credits, but contact details come back **locked**: a value that
+  exists reads `"***"` and is named in `locked_fields`. Never import a search row. Save matches with
+  `g8.search.saveContacts` (that reveals them as CRM contacts), then read the list; enrich after that.
 - **Ids have types.** Contact and list ids are numbers; deal, task, note, sequence and campaign ids are
   strings. The types enforce this, so read them.
 - **Parameter names differ per endpoint** (`limit` vs `take` vs `page_size`). Take them from the types or
@@ -747,3 +754,39 @@ setTimeout(stop, 60_000);
 - **REST**: `https://be.graph8.com/api/v1/...` with `Authorization: Bearer <api key>`. Every route is in
   [api/by-path.md](api/by-path.md).
 - **Web docs**: https://docs.graph8.com (index for agents: https://docs.graph8.com/llms.txt).
+
+## 13. Blocks and stacks
+
+For a whole screen or app (a contacts table, a sequence builder, an inbox) do not hand-write every
+component: this package ships **blocks**, editable source you copy into the customer's Next.js app.
+
+```
+node_modules/@graph8/sdk/
+  blocks/block.schema.json    the block.json format (blocks/block.types.ts is the same as TypeScript)
+  blocks/_foundation/         block "foundation": hooks, browser client, API proxy route, shared components
+  blocks/<id>/block.json      manifest: summary, operations, per-component tiers, scopes, prerequisites, defaults
+  blocks/<id>/README.md       the flow: what happens in what order, which ids pass where
+  blocks/<id>/components/     React components, copied into the app and then yours to edit
+  blocks/<id>/hooks/          data hooks
+  blocks/<id>/recipes/        server-side SDK recipes
+  stacks/<id>.json            a named, ordered set of blocks plus the navigation between their screens
+```
+
+- **Blocks are copied, not imported.** After copying, the code belongs to the app: change it freely.
+  Read a block's `README.md` and `block.json` before copying it.
+- **Every block depends on `foundation`.** Its browser client calls the app's own `/api/g8/...` route,
+  which adds the server-side API key. Never put an API key in client code. The route refuses to run
+  until its `authorize` and `allowedPrefixes` are set (it is as powerful as the key), so ask the person how
+  their app knows who is signed in.
+- **`block.json` is derived from the API contract and checked in CI**: `operations` are real operation ids,
+  each component's `tiers` are the tiers of its operations, `scopes` is the key scopes they need. Use them
+  to decide which screens need a confirmation (`billable`, `external`, `destructive`) and which key to
+  create. Where `defaults` says `askHuman: true`, ask the person before using the default.
+- **Search the catalog** with `grep -h '"summary"' node_modules/@graph8/sdk/blocks/*/block.json`.
+- **Start a whole app with one command**: `npx @graph8/sdk create <stack> <dir>` scaffolds a Next.js App Router +
+  TypeScript + Tailwind v4 app, installs the stack's blocks (the same code as `add`), puts every screen of
+  the stack in a sidebar with one route each, and installs dependencies (`--no-install`, `--dry-run`,
+  `--package-manager`, `--force`). Then set `G8_API_KEY` in `.env.local` and run
+  `npx @graph8/sdk doctor --stack <id>`. `stacks/<id>.json` has `status`: only `available` stacks (every block
+  shipped) can be created; a `planned` stack is refused with the list of missing blocks. `starter` is an
+  empty app (foundation only) you grow with `add`. Run `npx @graph8/sdk list` for the stacks and their status.

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 3264 operations across 141 namespaces (1515 read, 814 write, 301 destructive, 383 billable, 251 external).
+`g8.api` is generated from the published OpenAPI contract, so it covers all 3315 operations across 145 namespaces (1540 read, 836 write, 305 destructive, 383 billable, 251 external).
 
 - 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,13 +105,14 @@
 | `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 | 24 | 18 | [objects.md](objects.md) | [objects.d.ts](objects.d.ts) |
+| `g8.api.objects` | Objects | 42 | 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) |
 | `g8.api.orgVideos` | Org Videos | 6 | none | [orgVideos.md](orgVideos.md) | [orgVideos.d.ts](orgVideos.d.ts) |
 | `g8.api.organizationSettings` | Organization Settings | 22 | none | [organizationSettings.md](organizationSettings.md) | [organizationSettings.d.ts](organizationSettings.d.ts) |
 | `g8.api.phoneNumbers` | Phone Numbers | 16 | none | [phoneNumbers.md](phoneNumbers.md) | [phoneNumbers.d.ts](phoneNumbers.d.ts) |
+| `g8.api.processLists` | Process Lists | 6 | none | [processLists.md](processLists.md) | [processLists.d.ts](processLists.d.ts) |
 | `g8.api.profile` | Profile | 14 | none | [profile.md](profile.md) | [profile.d.ts](profile.d.ts) |
 | `g8.api.programmaticPages` | Programmatic Pages | 15 | none | [programmaticPages.md](programmaticPages.md) | [programmaticPages.d.ts](programmaticPages.d.ts) |
 | `g8.api.providerDomains` | Provider Domains | 34 | none | [providerDomains.md](providerDomains.md) | [providerDomains.d.ts](providerDomains.d.ts) |
@@ -123,6 +125,7 @@
 | `g8.api.radar` | Radar | 42 | none | [radar.md](radar.md) | [radar.d.ts](radar.d.ts) |
 | `g8.api.radarReports` | Radar Reports | 8 | none | [radarReports.md](radarReports.md) | [radarReports.d.ts](radarReports.d.ts) |
 | `g8.api.recordRoles` | Record Roles | 4 | none | [recordRoles.md](recordRoles.md) | [recordRoles.d.ts](recordRoles.d.ts) |
+| `g8.api.reports` | Reports | 7 | none | [reports.md](reports.md) | [reports.d.ts](reports.d.ts) |
 | `g8.api.repos` | Repos | 4 | none | [repos.md](repos.md) | [repos.d.ts](repos.d.ts) |
 | `g8.api.research` | Research | 13 | none | [research.md](research.md) | [research.d.ts](research.d.ts) |
 | `g8.api.revenue` | Revenue | 14 | none | [revenue.md](revenue.md) | [revenue.d.ts](revenue.d.ts) |
@@ -137,7 +140,7 @@
 | `g8.api.scraping` | Scraping | 10 | none | [scraping.md](scraping.md) | [scraping.d.ts](scraping.d.ts) |
 | `g8.api.sdrAnalytics` | SDR Analytics | 5 | none | [sdrAnalytics.md](sdrAnalytics.md) | [sdrAnalytics.d.ts](sdrAnalytics.d.ts) |
 | `g8.api.search` | Search | 19 | 4 | [search.md](search.md) | [search.d.ts](search.d.ts) |
-| `g8.api.seo` | SEO | 14 | none | [seo.md](seo.md) | [seo.d.ts](seo.d.ts) |
+| `g8.api.seo` | SEO | 22 | none | [seo.md](seo.md) | [seo.d.ts](seo.d.ts) |
 | `g8.api.sequenceLifecycle` | Sequence Lifecycle | 8 | 6 | [sequenceLifecycle.md](sequenceLifecycle.md) | [sequenceLifecycle.d.ts](sequenceLifecycle.d.ts) |
 | `g8.api.sequences` | Sequences | 71 | 6 | [sequences.md](sequences.md) | [sequences.d.ts](sequences.d.ts) |
 | `g8.api.settings` | Settings | 18 | none | [settings.md](settings.md) | [settings.d.ts](settings.d.ts) |
@@ -163,3 +166,4 @@
 | `g8.api.work` | Work | 59 | none | [work.md](work.md) | [work.d.ts](work.d.ts) |
 | `g8.api.workbench` | Workbench | 107 | none | [workbench.md](workbench.md) | [workbench.d.ts](workbench.d.ts) |
 | `g8.api.workflows` | Workflows | 59 | 21 | [workflows.md](workflows.md) | [workflows.d.ts](workflows.d.ts) |
+| `g8.api.workspaceBackup` | Workspace backup | 7 | none | [workspaceBackup.md](workspaceBackup.md) | [workspaceBackup.d.ts](workspaceBackup.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. */
@@ -369,7 +371,7 @@ export interface RecordHistoryResponse {
 }
 
 export interface RecordMutationEntry {
-  action: "created" | "updated" | "archived" | "restored";
+  action: "created" | "updated" | "archived" | "restored" | "recalculated";
   actor_id: string | null;
   actor_type: "user" | "api" | "app" | "integration" | "system";
   app_id?: string | null;

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**
 
@@ -555,7 +556,7 @@ One generation of one attribute's value. Values are TEMPORAL rather than mutable
 
 | Field | Type | Required | Description |
 |---|---|---|---|
-| `action` | `"created" \| "updated" \| "archived" \| "restored"` | yes |  |
+| `action` | `"created" \| "updated" \| "archived" \| "restored" \| "recalculated"` | yes |  |
 | `actor_id` | `string \| null` | yes |  |
 | `actor_type` | `"user" \| "api" \| "app" \| "integration" \| "system"` | yes |  |
 | `changes` | `Record<string, RecordMutationValueChange>` | yes |  |

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 |
@@ -2020,8 +2025,19 @@ Every Developer API route, sorted by path, with the SDK call that reaches it. Th
 | PATCH | `/api/v1/objects/{object_slug}` | [`g8.api.objects.updateObject`](objects.md#op-updateobject) or `g8.objects.update()` | write |
 | GET | `/api/v1/objects/{object_slug}/attributes` | [`g8.api.objects.listObjectAttributes`](objects.md#op-listobjectattributes) or `g8.objects.listAttributes()` | read |
 | POST | `/api/v1/objects/{object_slug}/attributes` | [`g8.api.objects.createAttribute`](objects.md#op-createattribute) or `g8.objects.createAttribute()` | write |
+| POST | `/api/v1/objects/{object_slug}/attributes/formula/validate` | [`g8.api.objects.validateFormula`](objects.md#op-validateformula) | read |
 | 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 |
@@ -2037,6 +2053,13 @@ Every Developer API route, sorted by path, with the SDK call that reaches it. Th
 | 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 |
@@ -2153,6 +2176,12 @@ Every Developer API route, sorted by path, with the SDK call that reaches it. Th
 | POST | `/api/v1/placement/tests` | [`g8.api.mailboxes.createPlacementTest`](mailboxes.md#op-createplacementtest) | billable |
 | POST | `/api/v1/placement/tests/estimate` | [`g8.api.mailboxes.estimatePlacementTestCost`](mailboxes.md#op-estimateplacementtestcost) | read |
 | GET | `/api/v1/placement/tests/{test_id}` | [`g8.api.mailboxes.getPlacementTest`](mailboxes.md#op-getplacementtest) | read |
+| GET | `/api/v1/process-lists` | [`g8.api.processLists.listProcessListsApi`](processLists.md#op-listprocesslistsapi) | read |
+| POST | `/api/v1/process-lists` | [`g8.api.processLists.createProcessListApi`](processLists.md#op-createprocesslistapi) | write |
+| DELETE | `/api/v1/process-lists/{slug}` | [`g8.api.processLists.archiveProcessListApi`](processLists.md#op-archiveprocesslistapi) | destructive |
+| GET | `/api/v1/process-lists/{slug}` | [`g8.api.processLists.getProcessListApi`](processLists.md#op-getprocesslistapi) | read |
+| PATCH | `/api/v1/process-lists/{slug}` | [`g8.api.processLists.updateProcessListApi`](processLists.md#op-updateprocesslistapi) | write |
+| POST | `/api/v1/process-lists/{slug}/entries` | [`g8.api.processLists.createProcessListEntryApi`](processLists.md#op-createprocesslistentryapi) | write |
 | POST | `/api/v1/profile/avatar` | [`g8.api.profile.uploadProfileAvatar`](profile.md#op-uploadprofileavatar) | write |
 | GET | `/api/v1/profile/deal-automations` | [`g8.api.profile.getDealAutomations`](profile.md#op-getdealautomations) | read |
 | PUT | `/api/v1/profile/deal-automations` | [`g8.api.profile.updateDealAutomations`](profile.md#op-updatedealautomations) | write |
@@ -2316,6 +2345,13 @@ Every Developer API route, sorted by path, with the SDK call that reaches it. Th
 | DELETE | `/api/v1/records/{entity_type}/{entity_id}/role-assignments/{role_slot}` | [`g8.api.recordRoles.clearRecordRole`](recordRoles.md#op-clearrecordrole) | destructive |
 | GET | `/api/v1/records/{entity_type}/{entity_id}/role-history` | [`g8.api.recordRoles.getRecordRoleHistory`](recordRoles.md#op-getrecordrolehistory) | read |
 | GET | `/api/v1/records/{entity_type}/{entity_id}/role-slots` | [`g8.api.recordRoles.getRecordRoleSlots`](recordRoles.md#op-getrecordroleslots) | read |
+| GET | `/api/v1/reports` | [`g8.api.reports.listObjectReportsApi`](reports.md#op-listobjectreportsapi) | read |
+| POST | `/api/v1/reports` | [`g8.api.reports.createObjectReportApi`](reports.md#op-createobjectreportapi) | write |
+| POST | `/api/v1/reports/preview` | [`g8.api.reports.previewObjectReportApi`](reports.md#op-previewobjectreportapi) | write |
+| DELETE | `/api/v1/reports/{report_id}` | [`g8.api.reports.archiveObjectReportApi`](reports.md#op-archiveobjectreportapi) | destructive |
+| GET | `/api/v1/reports/{report_id}` | [`g8.api.reports.getObjectReportApi`](reports.md#op-getobjectreportapi) | read |
+| PATCH | `/api/v1/reports/{report_id}` | [`g8.api.reports.updateObjectReportApi`](reports.md#op-updateobjectreportapi) | write |
+| POST | `/api/v1/reports/{report_id}/execute` | [`g8.api.reports.executeObjectReportApi`](reports.md#op-executeobjectreportapi) | write |
 | GET | `/api/v1/repos` | [`g8.api.repos.listRepos`](repos.md#op-listrepos) | read |
 | POST | `/api/v1/repos` | [`g8.api.repos.connectRepo`](repos.md#op-connectrepo) | write |
 | DELETE | `/api/v1/repos/{repo_id}` | [`g8.api.repos.deleteRepo`](repos.md#op-deleterepo) | destructive |
@@ -2477,11 +2513,19 @@ Every Developer API route, sorted by path, with the SDK call that reaches it. Th
 | GET | `/api/v1/seo/domains/tracked/{domain}/pages` | [`g8.api.seo.listSeoDomainPages`](seo.md#op-listseodomainpages) | read |
 | GET | `/api/v1/seo/domains/{domain}/backlinks` | [`g8.api.seo.getSeoDomainBacklinks`](seo.md#op-getseodomainbacklinks) | billable |
 | GET | `/api/v1/seo/domains/{domain}/overview` | [`g8.api.seo.getSeoDomainOverview`](seo.md#op-getseodomainoverview) | billable |
+| GET | `/api/v1/seo/fixes` | [`g8.api.seo.listSeoFixes`](seo.md#op-listseofixes) | read |
+| GET | `/api/v1/seo/fixes/agent-handoff` | [`g8.api.seo.getSeoAgentHandoff`](seo.md#op-getseoagenthandoff) | read |
+| POST | `/api/v1/seo/fixes/{fix_id}/claim` | [`g8.api.seo.claimSeoFix`](seo.md#op-claimseofix) | write |
+| POST | `/api/v1/seo/fixes/{fix_id}/complete` | [`g8.api.seo.completeSeoFix`](seo.md#op-completeseofix) | write |
+| GET | `/api/v1/seo/fixes/{fix_id}/pack` | [`g8.api.seo.getSeoFixPack`](seo.md#op-getseofixpack) | read |
 | POST | `/api/v1/seo/keywords/research` | [`g8.api.seo.researchSeoKeywords`](seo.md#op-researchseokeywords) | billable |
+| GET | `/api/v1/seo/pages/360` | [`g8.api.seo.listSeoPages360`](seo.md#op-listseopages360) | read |
+| GET | `/api/v1/seo/pages/360/detail` | [`g8.api.seo.getSeoPage360`](seo.md#op-getseopage360) | read |
 | GET | `/api/v1/seo/rank-tracking` | [`g8.api.seo.listSeoTrackedKeywords`](seo.md#op-listseotrackedkeywords) | read |
 | POST | `/api/v1/seo/rank-tracking/keywords` | [`g8.api.seo.saveSeoTrackedKeywords`](seo.md#op-saveseotrackedkeywords) | write |
 | POST | `/api/v1/seo/rank-tracking/keywords/remove` | [`g8.api.seo.removeSeoTrackedKeywords`](seo.md#op-removeseotrackedkeywords) | write |
 | GET | `/api/v1/seo/rank-tracking/{keyword_id}/history` | [`g8.api.seo.getSeoRankHistory`](seo.md#op-getseorankhistory) | read |
+| GET | `/api/v1/seo/today` | [`g8.api.seo.getSeoToday`](seo.md#op-getseotoday) | read |
 | GET | `/api/v1/sequence-jobs/{job_id}` | [`g8.api.sequences.getSequenceJob`](sequences.md#op-getsequencejob) | read |
 | GET | `/api/v1/sequencer/agents/textual` | [`g8.api.sequences.listSequencerTextualAgents`](sequences.md#op-listsequencertextualagents) | read |
 | GET | `/api/v1/sequencer/agents/voice` | [`g8.api.sequences.listSequencerVoiceAgents`](sequences.md#op-listsequencervoiceagents) | read |
@@ -3270,3 +3314,10 @@ Every Developer API route, sorted by path, with the SDK call that reaches it. Th
 | GET | `/api/v1/workflows/{action_id}/runs/recent` | [`g8.api.workflows.listRecentWorkflowRuns`](workflows.md#op-listrecentworkflowruns) | read |
 | POST | `/api/v1/workflows/{action_id}/trigger-reset` | [`g8.api.workflows.resetTriggerCursor`](workflows.md#op-resettriggercursor) or `g8.workflows.resetTrigger()` | external |
 | GET | `/api/v1/workflows/{action_id}/trigger-status` | [`g8.api.workflows.getTriggerStatus`](workflows.md#op-gettriggerstatus) or `g8.workflows.getTriggerStatus()` | read |
+| GET | `/api/v1/workspace/backup` | [`g8.api.workspaceBackup.listWorkspaceBackupsApi`](workspaceBackup.md#op-listworkspacebackupsapi) | read |
+| POST | `/api/v1/workspace/backup` | [`g8.api.workspaceBackup.createWorkspaceBackupApi`](workspaceBackup.md#op-createworkspacebackupapi) | write |
+| GET | `/api/v1/workspace/backup/{backup_id}` | [`g8.api.workspaceBackup.getWorkspaceBackupApi`](workspaceBackup.md#op-getworkspacebackupapi) | read |
+| GET | `/api/v1/workspace/backup/{backup_id}/download` | [`g8.api.workspaceBackup.downloadWorkspaceBackupApi`](workspaceBackup.md#op-downloadworkspacebackupapi) | read |
+| GET | `/api/v1/workspace/restore` | [`g8.api.workspaceBackup.listWorkspaceRestoresApi`](workspaceBackup.md#op-listworkspacerestoresapi) | read |
+| POST | `/api/v1/workspace/restore` | [`g8.api.workspaceBackup.createWorkspaceRestoreApi`](workspaceBackup.md#op-createworkspacerestoreapi) | write |
+| GET | `/api/v1/workspace/restore/{restore_id}` | [`g8.api.workspaceBackup.getWorkspaceRestoreApi`](workspaceBackup.md#op-getworkspacerestoreapi) | read |

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;
+}