@dench.com/cli 2.8.1-staging.110 → 2.8.3-staging.117

package/lib/api-schemas.ts

@@ -1187,27 +1187,136 @@ const composioToolRun = z.object({
   account: z.string().optional(),
 });
 
+/**
+ * One list-filter entry: a plain string includes the value; the object
+ * form supports per-value `exclude` / `exactMatch`.
+ */
+const searchFilterItem = z.union([
+  z.string(),
+  z.object({
+    value: z.string(),
+    exclude: z.boolean().optional(),
+    exactMatch: z.boolean().optional(),
+  }),
+]);
+
+const FILTER_OPTIONS_NOTE =
+  "Accepted values: see `dench leads filters` or https://dench.com/references/find-filter-options.json.";
+
+const searchRange = z.object({
+  min: z.number().int().nonnegative().optional(),
+  max: z.number().int().nonnegative().optional(),
+});
+
 const peopleSearch = z.object({
   linkedinUrl: z.string().optional(),
   fullName: z.string().optional(),
   firstName: z.string().optional(),
   lastName: z.string().optional(),
-  keywords: z.string().optional(),
+  keywords: z
+    .string()
+    .optional()
+    .describe(`Free-text query, e.g. "fintech, AI". ${FILTER_OPTIONS_NOTE}`),
   companyDomain: z.string().optional(),
   companyName: z.string().optional(),
-  titles: z.array(z.string()).max(50).optional(),
-  seniorities: z.array(z.string()).max(20).optional(),
-  jobFunctions: z.array(z.string()).max(20).optional(),
-  industries: z.array(z.string()).max(50).optional(),
-  locations: z.array(z.string()).max(50).optional(),
-  headcountRanges: z.array(z.string()).max(20).optional(),
+  titles: z
+    .array(searchFilterItem)
+    .max(50)
+    .optional()
+    .describe(`Current job titles (free text). ${FILTER_OPTIONS_NOTE}`),
+  pastTitles: z
+    .array(searchFilterItem)
+    .max(50)
+    .optional()
+    .describe("Past job titles (free text)."),
+  personNames: z.array(searchFilterItem).max(20).optional(),
+  seniorities: z
+    .array(searchFilterItem)
+    .max(20)
+    .optional()
+    .describe(
+      "Exact enum: Owner, Founder, C-level, Partner, VP, Head, Director, Manager, Senior.",
+    ),
+  jobFunctions: z
+    .array(searchFilterItem)
+    .max(20)
+    .optional()
+    .describe(
+      `Exact enum, e.g. Sales, Marketing, Software. ${FILTER_OPTIONS_NOTE}`,
+    ),
+  subFunctions: z
+    .array(searchFilterItem)
+    .max(50)
+    .optional()
+    .describe(
+      `Exact enum, e.g. SDR/BDR, Demand Generation. ${FILTER_OPTIONS_NOTE}`,
+    ),
+  industries: z
+    .array(searchFilterItem)
+    .max(50)
+    .optional()
+    .describe(`Exact enum, e.g. Software Development. ${FILTER_OPTIONS_NOTE}`),
+  locations: z
+    .array(searchFilterItem)
+    .max(50)
+    .optional()
+    .describe(
+      `Person locations — cities, states, countries, or metros (free text). ${FILTER_OPTIONS_NOTE}`,
+    ),
+  headcountRanges: z
+    .array(searchFilterItem)
+    .max(20)
+    .optional()
+    .describe(
+      "Exact buckets: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+.",
+    ),
+  companyNames: z.array(searchFilterItem).max(50).optional(),
+  pastCompanyNames: z.array(searchFilterItem).max(50).optional(),
+  companyDomains: z.array(searchFilterItem).max(50).optional(),
+  companyHeadquarters: z
+    .array(searchFilterItem)
+    .max(50)
+    .optional()
+    .describe(
+      `Company HQ locations — cities, states, countries, or metros (free text). ${FILTER_OPTIONS_NOTE}`,
+    ),
+  companyTypes: z
+    .array(searchFilterItem)
+    .max(10)
+    .optional()
+    .describe(
+      "Exact enum: Partnership, Nonprofit, Educational, Privately Held, Public Company, Self-Owned, Self-Employed, Government Agency.",
+    ),
+  universities: z
+    .array(searchFilterItem)
+    .max(50)
+    .optional()
+    .describe(`Universities attended (free text). ${FILTER_OPTIONS_NOTE}`),
+  skills: z
+    .array(searchFilterItem)
+    .max(50)
+    .optional()
+    .describe(`Profile skills (free text). ${FILTER_OPTIONS_NOTE}`),
+  languages: z
+    .array(searchFilterItem)
+    .max(20)
+    .optional()
+    .describe(`Spoken languages, e.g. English, German. ${FILTER_OPTIONS_NOTE}`),
+  yearsInRole: searchRange.optional(),
+  yearsAtCompany: searchRange.optional(),
+  daysSinceJobChange: searchRange.optional(),
+  foundedYears: searchRange
+    .optional()
+    .describe("Company founded-year range, e.g. {min: 2015, max: 2024}."),
   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."),
+    .describe(
+      "Opaque token from a previous response's metadata.nextPageToken.",
+    ),
   preferCache: z.boolean().optional(),
 });
 
@@ -1215,19 +1324,51 @@ const companySearch = z.object({
   domain: z.string().optional(),
   name: z.string().optional(),
   linkedinUrl: z.string().optional(),
+  keywords: z.string().optional(),
+  industries: z
+    .array(z.string())
+    .max(50)
+    .optional()
+    .describe(`Exact enum, e.g. Software Development. ${FILTER_OPTIONS_NOTE}`),
+  locations: z
+    .array(z.string())
+    .max(50)
+    .optional()
+    .describe(
+      `Cities, states, countries, or metros (free text). ${FILTER_OPTIONS_NOTE}`,
+    ),
+  headcountRanges: z
+    .array(z.string())
+    .max(20)
+    .optional()
+    .describe(
+      "Exact buckets: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+.",
+    ),
   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."),
+    .describe(
+      "Opaque token from a previous response's metadata.nextPageToken.",
+    ),
   preferCache: z.boolean().optional(),
 });
 
 const jobsSearch = z.object({
-  titles: z.array(z.string()).max(50).optional(),
-  locations: z.array(z.string()).max(50).optional(),
+  titles: z
+    .array(z.string())
+    .max(50)
+    .optional()
+    .describe(`Job titles (free text). ${FILTER_OPTIONS_NOTE}`),
+  locations: z
+    .array(z.string())
+    .max(50)
+    .optional()
+    .describe(
+      `Cities, states, countries, or metros (free text). ${FILTER_OPTIONS_NOTE}`,
+    ),
   companyDomain: z.string().optional(),
   companyName: z.string().optional(),
   companyLinkedinUrl: z.string().optional(),
@@ -1237,7 +1378,9 @@ const jobsSearch = z.object({
   pageToken: z
     .string()
     .optional()
-    .describe("Opaque token from a previous response's metadata.nextPageToken."),
+    .describe(
+      "Opaque token from a previous response's metadata.nextPageToken.",
+    ),
   preferCache: z.boolean().optional(),
 });
 
@@ -1450,7 +1593,7 @@ export const requestSchemas: Record<string, ZodTypeAny> = {
     icon: z
       .string()
       .optional()
-      .describe("Lucide icon name, e.g. users, target."),
+      .describe("Hugeicons (or legacy Lucide) icon name, e.g. user-multiple, target-01."),
   }),
   "crm.objects.update": z.object({
     name: z.string(),
@@ -3068,7 +3211,11 @@ export const requestExamples: Record<string, unknown> = {
   "web.brand": { input: { domain: "stripe.com" } },
   "web.sitemap": { input: { domain: "example.com", maxLinks: 1000 } },
   "web.crawl": {
-    input: { url: "https://example.com", maxPages: 15, useMainContentOnly: true },
+    input: {
+      url: "https://example.com",
+      maxPages: 15,
+      useMainContentOnly: true,
+    },
   },
   "web.screenshot": {
     input: { directUrl: "https://example.com", fullScreenshot: false },
@@ -3103,12 +3250,14 @@ export const requestExamples: Record<string, unknown> = {
   "crm.people.search": {
     titles: ["Head of Sales"],
     industries: ["SaaS"],
+    companyDomains: ["acme.com", "globex.com"],
     limit: 10,
   },
   "crm.companies.search": { domain: "example.com" },
   "enrichment.jobs.search": {
     titles: ["Account Executive"],
     locations: ["San Francisco"],
+    companyDomains: ["acme.com", "globex.com"],
     limit: 50,
   },
   "enrichment.search.preview": { kind: "people", titles: ["VP Sales"] },

package/lib/command-registry.ts

@@ -316,6 +316,81 @@ const rawApiOperations = [
     backend: convex("query", "functions/agentWorkspace:agentListArtifacts"),
   }),
 
+  // Lists (saved searches). Find results persist as named list artifacts;
+  // these ops give agents the same full management the sidebar has.
+  // CRM lists (saved views) are managed through the `crm.views.*` ops.
+  op({
+    id: "lists.list",
+    group: "lists",
+    summary:
+      "List saved searches (find-result lists) in the workspace, newest first.",
+    cli: "dench lists",
+    aliases: ["dench lists list"],
+    method: "GET",
+    path: "/lists",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/workspaceArtifacts:list"),
+  }),
+  op({
+    id: "lists.get",
+    group: "lists",
+    summary: "Get one saved search / list by artifact id.",
+    cli: "dench lists show",
+    method: "GET",
+    path: "/lists/{artifactId}",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/workspaceArtifacts:get"),
+  }),
+  op({
+    id: "lists.save",
+    group: "lists",
+    summary:
+      "Save find results as a named list (rows + filters become a workspace artifact).",
+    cli: 'dench leads find --save-as "Name"',
+    method: "POST",
+    path: "/lists",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("action", "functions/workspaceArtifacts:saveFind"),
+  }),
+  op({
+    id: "lists.update",
+    group: "lists",
+    summary:
+      "Update a saved list in place (title, filters, and/or replacement rows).",
+    cli: "dench lists update",
+    method: "PATCH",
+    path: "/lists/{artifactId}",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("action", "functions/workspaceArtifacts:updateFind"),
+  }),
+  op({
+    id: "lists.rename",
+    group: "lists",
+    summary: "Rename a saved search / list.",
+    cli: "dench lists rename",
+    method: "POST",
+    path: "/lists/{artifactId}/rename",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/workspaceArtifacts:rename"),
+  }),
+  op({
+    id: "lists.delete",
+    group: "lists",
+    summary:
+      "Delete a saved search / list, its exported CSV/JSONL files, and any linked watch.",
+    cli: "dench lists delete",
+    method: "DELETE",
+    path: "/lists/{artifactId}",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/workspaceArtifacts:remove"),
+  }),
+
   // Memory and approvals.
   op({
     id: "memory.search",
@@ -666,6 +741,18 @@ const rawApiOperations = [
     responseSchema: anyResponse,
     backend: convex("mutation", "functions/crm/objects:saveView"),
   }),
+  op({
+    id: "crm.views.rename",
+    group: "crm",
+    summary:
+      "Rename a saved view in place — keeps its filters, pins, and sidebar slot.",
+    cli: "dench crm views rename",
+    method: "POST",
+    path: "/crm/objects/{objectName}/views/{viewName}/rename",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/objects:renameView"),
+  }),
   op({
     id: "crm.views.delete",
     group: "crm",
@@ -1357,7 +1444,8 @@ const rawApiOperations = [
   op({
     id: "crm.people.search",
     group: "crm",
-    summary: "Search for people through the enrichment gateway.",
+    summary:
+      "Search for people through the enrichment gateway. `companyDomains` takes up to 1000 domains (e.g. a resolved company list; `dench leads find --company-list <id|view>` resolves one for you) — the gateway fans large lists out as sequential vendor-safe chunks behind one `nextPageToken` stream.",
     cli: "dench crm people search",
     method: "POST",
     path: "/enrichment/people/search",
@@ -1390,7 +1478,8 @@ const rawApiOperations = [
   op({
     id: "enrichment.jobs.search",
     group: "crm",
-    summary: "Search job postings through Dench find.",
+    summary:
+      "Search job postings through Dench find. `companyDomains` takes up to 1000 domains (chunked automatically); `dench jobs find --company-list <id|view>` resolves a saved company list into it.",
     cli: "dench jobs find",
     method: "POST",
     path: "/enrichment/jobs/search",
@@ -1442,6 +1531,20 @@ const rawApiOperations = [
     responseSchema: anyResponse,
     backend: gateway("POST", "/enrichment/search/preview"),
   }),
+  op({
+    id: "enrichment.filters.options",
+    group: "crm",
+    summary:
+      "List Lead Finder filter vocabularies: exact enum values (seniorities, functions, industries, headcount, company types, languages) and curated suggestions (titles, locations, company HQ, universities, skills, keywords).",
+    cli: "dench leads filters",
+    method: "GET",
+    path: "/local/enrichment/filter-options",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: local(
+      "Catalogs are bundled with the CLI. Over HTTPS, fetch https://dench.com/references/find-filter-options.json instead.",
+    ),
+  }),
   op({
     id: "crm.templates.list",
     group: "crm",

package/lib/crm-enrichment.ts

@@ -91,6 +91,22 @@ export const PEOPLE_ENRICHMENT_COLUMNS: readonly EnrichmentColumnDef[] = [
     extractionFallbacks: ["email"],
     enrichFields: ["work_emails"],
   },
+  {
+    label: "Work Email",
+    key: "person.work_email",
+    fieldType: "email",
+    apolloPath: "person.work_email",
+    requiredFields: ["work_email"],
+    enrichFields: ["work_emails"],
+  },
+  {
+    label: "Personal Email",
+    key: "person.personal_email",
+    fieldType: "email",
+    apolloPath: "person.personal_email",
+    requiredFields: ["personal_email"],
+    enrichFields: ["personal_emails"],
+  },
   {
     label: "Headline",
     key: "person.headline",
@@ -336,7 +352,14 @@ export function getRequiredFieldsForApolloPath(
   const column = getEnrichmentColumns(category).find(
     (candidate) => candidate.apolloPath === apolloPath,
   );
-  return column?.requiredFields ?? [];
+  if (column) return column.requiredFields;
+  if (category !== "people") return [];
+  if (apolloPath.includes("personal_email")) return ["personal_email"];
+  if (apolloPath.includes("phone")) return ["phone"];
+  if (apolloPath.includes("work_email") || /(^|\.)email$/.test(apolloPath)) {
+    return ["work_email"];
+  }
+  return [];
 }
 
 export function buildEnrichmentMeta(

package/lib/enrichment-gateway.ts

@@ -114,7 +114,11 @@ export type SearchJobsBody = {
   titles?: string[];
   locations?: string[];
   companyDomain?: string;
+  /** Multiple company domains (e.g. a resolved company list); the gateway
+   *  fans lists past ~50 domains out as sequential vendor-safe chunks. */
+  companyDomains?: string[];
   companyName?: string;
+  companyNames?: string[];
   companyLinkedinUrl?: string;
   keywords?: string;
   postedAfter?: string;
@@ -1361,7 +1365,9 @@ export async function searchJobs(
   if (body.titles?.length) payload.titles = body.titles;
   if (body.locations?.length) payload.locations = body.locations;
   if (body.companyDomain) payload.companyDomain = body.companyDomain;
+  if (body.companyDomains?.length) payload.companyDomains = body.companyDomains;
   if (body.companyName) payload.companyName = body.companyName;
+  if (body.companyNames?.length) payload.companyNames = body.companyNames;
   if (body.companyLinkedinUrl)
     payload.companyLinkedinUrl = body.companyLinkedinUrl;
   if (body.keywords) payload.keywords = body.keywords;