@graph8/sdk 0.308.1 → 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: **3286 Developer API
-operations** in 142 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 3286 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), `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).
+`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 | 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 |
+| `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 3286 operations across 142 namespaces (1524 read, 825 write, 303 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).
@@ -105,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 | 41 | 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) |
@@ -124,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) |
@@ -138,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) |
@@ -164,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

@@ -371,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

@@ -556,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

@@ -2025,6 +2025,7 @@ 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 |
@@ -2175,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 |
@@ -2338,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 |
@@ -2499,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 |
@@ -3292,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/objects.d.ts

@@ -1,7 +1,7 @@
 /* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
 
 /**
- * Types for `g8.api.objects` (Objects): 41 operations.
+ * Types for `g8.api.objects` (Objects): 42 operations.
  *
  * For reading. In code, import from the package instead:
  *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
@@ -54,6 +54,7 @@ export interface ObjectsMembers {
   updateObjectRecord: "update_object_record_objects__object_slug__records__record_id__patch";
   updateObjectView: "update_object_view_objects__object_slug__views__view_id__put";
   upsertObjectRecord: "upsert_object_record_objects__object_slug__records_upsert_post";
+  validateFormula: "validate_formula_objects__object_slug__attributes_formula_validate_post";
 }
 
 /** Input and output of every `g8.api.objects` operation, keyed by operationId. */
@@ -790,15 +791,37 @@ export interface ObjectsOperations {
   };
     output: ApiResponse_ObjectRecordResponse_;
   };
+  /**
+   * POST /objects/{object_slug}/attributes/formula/validate
+   * Validate Formula
+   * tier: read · scope: objects:read
+   */
+  validate_formula_objects__object_slug__attributes_formula_validate_post: {
+    input: {
+    path: {
+      object_slug: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: FormulaValidateRequest;
+  };
+    output: ApiResponse_FormulaValidateResponse_;
+  };
 }
 
-// 84 schemas referenced above (the same as G8Contract.<Name>).
+// 89 schemas referenced above (the same as G8Contract.<Name>).
 
 export interface ApiResponse_AttributeDefinitionResponse_ {
   data: AttributeDefinitionResponse;
   pagination?: PaginationMeta | null;
 }
 
+export interface ApiResponse_FormulaValidateResponse_ {
+  data: FormulaValidateResponse;
+  pagination?: PaginationMeta | null;
+}
+
 export interface ApiResponse_NoneType_ {
   data: null;
   pagination?: PaginationMeta | null;
@@ -922,6 +945,7 @@ export interface ApiResponse_list_SavedViewResponse__ {
 /** Configuration for specific attribute types. */
 export interface AttributeConfig {
   currency_code?: string | null;
+  formula?: FormulaInput | null;
   max_value?: number | null;
   options?: Array<Record<string, unknown>> | null;
   referenced_object?: string | null;
@@ -975,7 +999,7 @@ export interface AttributeDefinitionResponse {
 }
 
 /** Valid attribute types for the Custom Objects type system. */
-export type AttributeType = "text" | "number" | "currency" | "date" | "timestamp" | "checkbox" | "select" | "status" | "email_address" | "phone_number" | "domain" | "location" | "personal_name" | "record_reference" | "rating" | "actor_reference";
+export type AttributeType = "text" | "number" | "currency" | "date" | "timestamp" | "checkbox" | "select" | "status" | "email_address" | "phone_number" | "domain" | "location" | "personal_name" | "record_reference" | "rating" | "actor_reference" | "formula";
 
 export interface AttributeUpdateRequest {
   config?: AttributeConfig | null;
@@ -1018,6 +1042,41 @@ export interface AttributeUpdateRequest {
  */
 export type EntityType = "custom_objects" | "contacts" | "companies" | "deals" | "leads" | "lists" | "contacts_view" | "companies_view" | "list_contacts" | "list_companies" | "search_people" | "search_companies" | "abm_companies" | "enrichment_workbench" | "enrichment_workbenches";
 
+/**
+ * Guided-builder input for a computed field (CRM-06): only the typed JSON expression. The result type,
+ * currency, dependencies, input closure and rollup flag are computed and stored server side at save time --
+ * never accepted from a client. A rollup is a ``rollup`` node (the whole expression, or nested).
+ */
+export interface FormulaInput {
+  expression: Record<string, unknown>;
+}
+
+/** Dry-run check of a typed formula expression. Nothing is persisted or locked. */
+export interface FormulaValidateRequest {
+  /** Slug of the computed field being EDITED (checked against its own place in the dependency graph); omit for a new one. */
+  attribute_slug?: string | null;
+  /** The typed JSON expression (a node tree; a rollup is a `rollup` node). */
+  expression: Record<string, unknown>;
+  /** Evaluate the expression against this record's current values. */
+  preview_record_id?: string | null;
+}
+
+export interface FormulaValidateResponse {
+  currency_code?: string | null;
+  depends_on?: Array<Record<string, unknown>>;
+  /** Field-level problems (`reason` is a stable code). */
+  errors?: Array<Record<string, unknown>>;
+  /** Why the preview record could not be evaluated (a code, never a value). */
+  preview_error?: string | null;
+  /** With a preview record: one entry per rollup in the expression, counted over the records the caller may read. */
+  preview_rollups?: Array<PreviewRollup>;
+  preview_value?: unknown;
+  referenced_object_slugs?: Array<string>;
+  /** number, currency, text, checkbox, date or timestamp. */
+  result_type?: string | null;
+  valid: boolean;
+}
+
 export interface ImportPage {
   limit?: number;
   offset?: number;
@@ -1280,6 +1339,14 @@ export interface PaginationMeta {
   total_is_lower_bound?: boolean | null;
 }
 
+/** How many linked records one rollup of a previewed expression counted. */
+export interface PreviewRollup {
+  /** Linked records the rollup counted for the preview record (the ones its filters keep). */
+  matched_count: number;
+  /** Where the rollup sits in the expression: `$` is the root, `$.left`, `$.args[1]`, `$.then_branch`. */
+  node_path: string;
+}
+
 /**
  * Bulk-update body: exactly one scope (explicit ids or a filtered set),
  * plus the values to apply to every record in that scope.
@@ -1321,7 +1388,7 @@ export interface RecordBulkUpdateResponse {
 /** Filter parameters for listing records. */
 export interface RecordFilter {
   attribute_slug: string;
-  operator: "eq" | "ne" | "gt" | "gte" | "lt" | "lte" | "contains" | "starts_with" | "is_null" | "is_not_null";
+  operator: "eq" | "ne" | "gt" | "gte" | "lt" | "lte" | "contains" | "starts_with" | "in" | "is_null" | "is_not_null";
   value?: unknown | null;
 }
 
@@ -1390,7 +1457,7 @@ export interface RecordMergeResponse {
 }
 
 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;