@dench.com/cli 2.8.0-staging.107 → 2.8.1-staging.110

package/dench.ts

@@ -474,9 +474,9 @@ Usage:
   dench artifacts list [--limit 25] [--json]
   dench artifacts show <id> [--json]
   dench artifacts import <id> --to lead|company|job_posting [--view "Q3 outbound"] [--pin] [--json]
-  dench leads find --titles "VP Sales" [--locations "San Francisco"] [--limit 500] [--json]
-  dench companies find --name "Acme" [--domain acme.com] [--keywords fintech] [--limit 500] [--json]
-  dench jobs find --titles "Account Executive" [--locations "San Francisco"] [--limit 500] [--json]
+  dench leads find --titles "VP Sales" [--locations "San Francisco"] [--limit 500] [--page-token <token>] [--json]
+  dench companies find --name "Acme" [--domain acme.com] [--keywords fintech] [--limit 500] [--page-token <token>] [--json]
+  dench jobs find --titles "Account Executive" [--locations "San Francisco"] [--limit 500] [--page-token <token>] [--json]
   dench suggested-work [--json]
   dench approval request "message" [--json]
   dench approval approve <approvalId> [--evidence "User said yes in chat"] [--json]
@@ -757,7 +757,7 @@ function leadsHelp() {
   console.log(`Dench leads
 
 Usage:
-  dench leads find --titles "VP Sales" --locations "San Francisco" [--company-domain acme.com] [--keywords fintech] [--limit 500] [--json]
+  dench leads find --titles "VP Sales" --locations "San Francisco" [--company-domain acme.com] [--keywords fintech] [--limit 500] [--page-token <token>] [--json]
 `);
 }
 
@@ -765,7 +765,7 @@ function companiesHelp() {
   console.log(`Dench companies
 
 Usage:
-  dench companies find --name "Acme" [--domain acme.com] [--keywords fintech] [--industries SaaS] [--locations "San Francisco"] [--limit 500] [--json]
+  dench companies find --name "Acme" [--domain acme.com] [--keywords fintech] [--industries SaaS] [--locations "San Francisco"] [--limit 500] [--page-token <token>] [--json]
 `);
 }
 
@@ -773,7 +773,7 @@ function jobsHelp() {
   console.log(`Dench jobs
 
 Usage:
-  dench jobs find --titles "Account Executive" --locations "San Francisco" [--company-domain acme.com] [--keywords remote] [--limit 500] [--json]
+  dench jobs find --titles "Account Executive" --locations "San Francisco" [--company-domain acme.com] [--keywords remote] [--limit 500] [--page-token <token>] [--json]
 `);
 }
 

package/lib/api-schemas.ts

@@ -949,8 +949,23 @@ const toolRunResponse = z
 
 const enrichmentMetadata = z
   .object({
-    total: z.number().optional(),
+    total: z
+      .number()
+      .optional()
+      .describe(
+        "Total matches for the search. Stable across pages; absent when only an estimate exists.",
+      ),
+    totalIsEstimate: z
+      .boolean()
+      .optional()
+      .describe("True when the total is a lower bound rather than exact."),
     offset: z.number().optional(),
+    nextPageToken: z
+      .string()
+      .optional()
+      .describe(
+        "Opaque token for the next page. Pass it back as pageToken; absent on the last page.",
+      ),
   })
   .passthrough()
   .optional();
@@ -1189,6 +1204,10 @@ const peopleSearch = z.object({
   exactMatch: z.boolean().optional(),
   limit: z.number().int().positive().max(5000).optional(),
   offset: z.number().int().nonnegative().optional(),
+  pageToken: z
+    .string()
+    .optional()
+    .describe("Opaque token from a previous response's metadata.nextPageToken."),
   preferCache: z.boolean().optional(),
 });
 
@@ -1199,6 +1218,10 @@ const companySearch = z.object({
   exactMatch: z.boolean().optional(),
   limit: z.number().int().positive().max(5000).optional(),
   offset: z.number().int().nonnegative().optional(),
+  pageToken: z
+    .string()
+    .optional()
+    .describe("Opaque token from a previous response's metadata.nextPageToken."),
   preferCache: z.boolean().optional(),
 });
 
@@ -1211,6 +1234,10 @@ const jobsSearch = z.object({
   keywords: z.string().optional(),
   postedAfter: z.string().optional(),
   limit: z.number().int().positive().max(5000).optional(),
+  pageToken: z
+    .string()
+    .optional()
+    .describe("Opaque token from a previous response's metadata.nextPageToken."),
   preferCache: z.boolean().optional(),
 });
 
@@ -1231,6 +1258,7 @@ const jobsSearchResponse = z
           .passthrough(),
       )
       .describe("Job postings in the canonical job_posting shape."),
+    metadata: enrichmentMetadata,
   })
   .passthrough();
 

package/lib/enrichment-gateway.ts

@@ -69,6 +69,8 @@ export type SearchPeopleBody = {
   limit?: number;
   offset?: number;
   searchAfter?: unknown;
+  /** Opaque token from a previous response's `metadata.nextPageToken`. */
+  pageToken?: string;
   // Rich filters, gateway-named. Merged with the legacy person*/organization*
   // aliases above; entries may carry per-value exclude / exactMatch.
   titles?: SearchFilterItem[];
@@ -104,6 +106,8 @@ export type SearchCompaniesBody = {
   keywords?: string;
   limit?: number;
   offset?: number;
+  /** Opaque token from a previous response's `metadata.nextPageToken`. */
+  pageToken?: string;
 };
 
 export type SearchJobsBody = {
@@ -115,6 +119,8 @@ export type SearchJobsBody = {
   keywords?: string;
   postedAfter?: string;
   limit?: number;
+  /** Opaque token from a previous response's `metadata.nextPageToken`. */
+  pageToken?: string;
 };
 
 export type EnrichmentGatewayOptions = {
@@ -1315,6 +1321,7 @@ export async function searchPeople(
   else if (body.perPage !== undefined) payload.limit = body.perPage;
   if (body.offset !== undefined) payload.offset = body.offset;
   if (body.searchAfter !== undefined) payload.searchAfter = body.searchAfter;
+  if (body.pageToken) payload.pageToken = body.pageToken;
 
   return callGatewayJson("/v1/enrichment/people/search", {
     method: "POST",
@@ -1338,6 +1345,7 @@ export async function searchCompanies(
   if (body.keywords) payload.keywords = body.keywords;
   if (body.limit !== undefined) payload.limit = body.limit;
   if (body.offset !== undefined) payload.offset = body.offset;
+  if (body.pageToken) payload.pageToken = body.pageToken;
   return callGatewayJson("/v1/enrichment/company/search", {
     method: "POST",
     body: payload,
@@ -1359,6 +1367,7 @@ export async function searchJobs(
   if (body.keywords) payload.keywords = body.keywords;
   if (body.postedAfter) payload.postedAfter = body.postedAfter;
   if (body.limit !== undefined) payload.limit = body.limit;
+  if (body.pageToken) payload.pageToken = body.pageToken;
   return callGatewayJson("/v1/enrichment/jobs/search", {
     method: "POST",
     body: payload,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dench.com/cli",
-  "version": "2.8.0-staging.107",
+  "version": "2.8.1-staging.110",
   "description": "Dench agent workspace CLI.",
   "type": "module",
   "bin": {