@dench.com/cli 2.7.11-staging.102 → 2.8.1-staging.110

package/crm.ts

@@ -49,9 +49,6 @@ import {
   getRequiredFieldsForApolloPath,
 } from "./lib/crm-enrichment";
 import {
-  type AviatoEnrichCompanyBody,
-  type AviatoEnrichPersonBody,
-  aviatoEnrichCompany,
   aviatoEnrichPerson,
   type EnrichCompanyBody,
   EnrichmentGatewayError,
@@ -61,14 +58,6 @@ import {
   enrichPerson,
 } from "./lib/enrichment-gateway";
 
-// Contact-info fields that Aviato does not return.
-const CONTACT_REQUIRED_FIELDS = ["phone", "email", "personal_email"] as const;
-type ContactRequiredField = (typeof CONTACT_REQUIRED_FIELDS)[number];
-
-function isContactField(field: string): field is ContactRequiredField {
-  return (CONTACT_REQUIRED_FIELDS as readonly string[]).includes(field);
-}
-
 type JsonRecord = Record<string, unknown>;
 
 const CRM_BATCH_CHUNK_SIZE = 200;
@@ -2892,8 +2881,6 @@ type CrmEntryForEnrichment = {
   fields: Record<string, unknown>;
 };
 
-type CliEnrichmentProvider = "fullenrich" | "aviato";
-
 type EnrichmentTarget = {
   category: EnrichmentCategory;
   column: EnrichmentColumnDef;
@@ -2905,7 +2892,6 @@ type CellEnrichmentArgs = {
   objectName: string;
   entryId: string;
   fieldName: string;
-  provider?: CliEnrichmentProvider;
   category?: EnrichmentCategory;
   inputFieldName?: string;
   apolloPath?: string;
@@ -2925,16 +2911,6 @@ function parseCategoryFlag(
   throw new CrmCliError("--category must be people or company");
 }
 
-function parseProviderFlag(
-  value: string | undefined,
-): CliEnrichmentProvider | undefined {
-  if (value === undefined) return undefined;
-  if (value === "fullenrich" || value === "aviato") return value;
-  throw new CrmCliError(
-    `--provider must be fullenrich or aviato; received "${value}"`,
-  );
-}
-
 function parsePositiveInt(
   flag: string,
   value: string | undefined,
@@ -3107,21 +3083,19 @@ async function resolveEnrichmentTarget(
  * chat-turn `enrich_person` / `enrich_company` / `enrich_person_basic` /
  * `enrich_company_basic` tools do — pass every structured identifier the
  * row has (email, firstName, lastName, linkedinUrl, domain, …) and let the
- * shared gateway client (`enrichPerson`, `enrichCompany`,
- * `aviatoEnrichPerson`, `aviatoEnrichCompany`) validate + dispatch.
+ * shared gateway client (`enrichPerson`, `enrichCompany`) validate +
+ * dispatch. The gateway owns the waterfall; the CLI never names a vendor.
  *
  * The previous implementation collapsed the entry to a single
  * `--input-field` value and called `enrichPersonByIdentifier`, which
- * threw away the rest of the row and made FullEnrich fail with
+ * threw away the rest of the row and made enrichment fail with
  * `missing_people_identifier` whenever the input field was just an
  * Email (no first/last name reached the gateway, so the validator
- * rejected the request before any provider was called).
+ * rejected the request before any lookup ran).
  */
 async function callEnrichmentGatewayForEntry(args: {
   target: EnrichmentTarget;
   entry: CrmEntryForEnrichment;
-  /** Explicit provider override. Defaults: people=fullenrich, company=aviato. */
-  provider?: CliEnrichmentProvider;
   gateway?: Pick<EnrichmentGatewayOptions, "apiKey" | "baseUrl">;
 }): Promise<Record<string, unknown>> {
   const { entry, target } = args;
@@ -3134,43 +3108,27 @@ async function callEnrichmentGatewayForEntry(args: {
     );
   }
   const isCompany = target.category === "company";
-  const resolvedProvider =
-    args.provider ?? (isCompany ? "aviato" : "fullenrich");
-
-  if (resolvedProvider === "aviato") {
-    // Aviato does not return phone or email — surface a clear error
-    // before we waste a gateway round-trip.
-    const contactFields = target.requiredFields.filter(isContactField);
-    if (contactFields.length > 0) {
-      throw new CrmCliError(
-        `Aviato does not return phone or email; use --provider fullenrich for contact fields (${contactFields.join(", ")}).`,
-      );
-    }
-    if (isCompany) {
-      return aviatoEnrichCompany(
-        buildAviatoCompanyBodyFromEntry(entry),
-        args.gateway,
-      );
-    }
-    return aviatoEnrichPerson(
-      buildAviatoPersonBodyFromEntry(entry),
-      args.gateway,
-    );
-  }
-
-  // FullEnrich path. Mirrors `enrichPersonStep` / `enrichCompanyStep` in
-  // src/workflows/enrichment-steps.ts: build a structured body, hand it
-  // to the same shared gateway client.
   if (isCompany) {
     return enrichCompany(
       buildCompanyBodyFromEntry(entry, target.requiredFields),
       args.gateway,
     );
   }
-  return enrichPerson(
-    buildPersonBodyFromEntry(entry, target.requiredFields),
-    args.gateway,
-  );
+  const personBody = buildPersonBodyFromEntry(entry, target.requiredFields);
+  // Contact cells stay on /person/contact. A LinkedIn URL for a profile
+  // field (name, title, headline) uses /person so the gateway waterfall
+  // can fill graph data without a contact job.
+  const isContactField = Boolean(target.column.enrichFields?.length);
+  if (!isContactField && personBody.linkedinUrl) {
+    return aviatoEnrichPerson(
+      {
+        linkedinUrl: personBody.linkedinUrl,
+        email: personBody.email,
+      },
+      args.gateway,
+    );
+  }
+  return enrichPerson(personBody, args.gateway);
 }
 
 // ── Body builders ────────────────────────────────────────────────────────
@@ -3275,24 +3233,6 @@ export function buildCompanyBodyFromEntry(
   };
 }
 
-export function buildAviatoPersonBodyFromEntry(
-  entry: CrmEntryForEnrichment,
-): AviatoEnrichPersonBody {
-  return {
-    linkedinUrl: readEntryField(entry, PEOPLE_LINKEDIN_FIELDS),
-    email: readEntryField(entry, PEOPLE_EMAIL_FIELDS),
-  };
-}
-
-export function buildAviatoCompanyBodyFromEntry(
-  entry: CrmEntryForEnrichment,
-): AviatoEnrichCompanyBody {
-  return {
-    website: readEntryField(entry, COMPANY_WEBSITE_FIELDS),
-    linkedinUrl: readEntryField(entry, COMPANY_LINKEDIN_FIELDS),
-  };
-}
-
 async function enrichOneEntry(
   ctx: CrmCliContext,
   args: Omit<CellEnrichmentArgs, "entryId"> & {
@@ -3305,7 +3245,6 @@ async function enrichOneEntry(
     const payload = await callEnrichmentGatewayForEntry({
       target: args.target,
       entry: args.entry,
-      provider: args.provider,
       gateway: ctx.enrichmentGateway,
     });
     value = extractEnrichmentValue(payload, args.target.column);
@@ -3341,7 +3280,7 @@ async function enrichOneEntry(
       entryId: args.entry.id,
       fieldName: args.fieldName,
       value,
-      provider: args.provider ?? "gateway",
+      provider: "gateway",
       overwrite: args.overwrite,
     },
   )) as Record<string, unknown>;
@@ -3458,7 +3397,6 @@ async function runPeopleCommand(ctx: CrmCliContext): Promise<void> {
     }
     case "enrich": {
       const entryId = shift(ctx.args, "person entry id");
-      const provider = parseProviderFlag(getFlag(ctx.args, "--provider"));
       const fieldName = getFlag(ctx.args, "--field") ?? "LinkedIn URL";
       const inputFieldName = getFlag(ctx.args, "--input-field");
       const overwrite = hasFlag(ctx.args, "--overwrite");
@@ -3469,7 +3407,6 @@ async function runPeopleCommand(ctx: CrmCliContext): Promise<void> {
           objectName: "people",
           entryId,
           fieldName,
-          provider,
           category: "people",
           inputFieldName,
           overwrite,
@@ -3523,7 +3460,6 @@ async function runCompaniesCommand(ctx: CrmCliContext): Promise<void> {
     }
     case "enrich": {
       const entryId = shift(ctx.args, "company entry id");
-      const provider = parseProviderFlag(getFlag(ctx.args, "--provider"));
       const fieldName = getFlag(ctx.args, "--field") ?? "Company Name";
       const inputFieldName = getFlag(ctx.args, "--input-field") ?? "Domain";
       const overwrite = hasFlag(ctx.args, "--overwrite");
@@ -3534,7 +3470,6 @@ async function runCompaniesCommand(ctx: CrmCliContext): Promise<void> {
           objectName: "company",
           entryId,
           fieldName,
-          provider,
           category: "company",
           inputFieldName,
           overwrite,
@@ -3556,7 +3491,6 @@ async function runEnrichCommand(ctx: CrmCliContext): Promise<void> {
       const objectName = shift(ctx.args, "object name");
       const entryId = shift(ctx.args, "entry id");
       const fieldName = shift(ctx.args, "field name");
-      const provider = parseProviderFlag(getFlag(ctx.args, "--provider"));
       const inputFieldName = getFlag(ctx.args, "--input-field");
       const category = parseCategoryFlag(getFlag(ctx.args, "--category"));
       const apolloPath = getFlag(ctx.args, "--apollo-path");
@@ -3568,7 +3502,6 @@ async function runEnrichCommand(ctx: CrmCliContext): Promise<void> {
           objectName,
           entryId,
           fieldName,
-          provider,
           category,
           inputFieldName,
           apolloPath,
@@ -3581,7 +3514,6 @@ async function runEnrichCommand(ctx: CrmCliContext): Promise<void> {
       const objectName = shift(ctx.args, "object name");
       const fieldName = getFlag(ctx.args, "--field");
       const missingOnly = !hasFlag(ctx.args, "--all");
-      const provider = parseProviderFlag(getFlag(ctx.args, "--provider"));
       const inputFieldName = getFlag(ctx.args, "--input-field");
       const category = parseCategoryFlag(getFlag(ctx.args, "--category"));
       const apolloPath = getFlag(ctx.args, "--apollo-path");
@@ -3590,7 +3522,7 @@ async function runEnrichCommand(ctx: CrmCliContext): Promise<void> {
       assertNoUnknownFlags(ctx.args, "crm enrich object");
       if (!fieldName) {
         throw new CrmCliError(
-          "dench crm enrich object <name> --field <field> [--input-field <field>] [--category people|company] [--apollo-path <path>] [--limit N] [--provider ...] [--all] [--overwrite]",
+          "dench crm enrich object <name> --field <field> [--input-field <field>] [--category people|company] [--apollo-path <path>] [--limit N] [--all] [--overwrite]",
         );
       }
       out(
@@ -3598,7 +3530,6 @@ async function runEnrichCommand(ctx: CrmCliContext): Promise<void> {
         await enrichObjectThroughGateway(ctx, {
           objectName,
           fieldName,
-          provider,
           category,
           inputFieldName,
           apolloPath,

package/dench.ts

@@ -471,6 +471,12 @@ Usage:
   dench memory search "query" [--limit 8] [--json]
   dench memory save <key> "text" [--kind fact|decision|preference|goal|tool_note|other] [--tags a,b] [--sensitivity normal|broad|sensitive] [--scope user|org] [--json]
   dench artifacts [--limit 25] [--json]
+  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] [--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]
@@ -737,9 +743,37 @@ function artifactsHelp() {
 
 Usage:
   dench artifacts [--limit 25] [--json]
+  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 suggested-work [--json]
 
-Artifacts are durable outputs for human or agent review.
+\`list\` / \`show\` / \`import\` operate on find results. Bare \`dench artifacts\`
+lists agent suggested-work artifacts.
+`);
+}
+
+function leadsHelp() {
+  console.log(`Dench leads
+
+Usage:
+  dench leads find --titles "VP Sales" --locations "San Francisco" [--company-domain acme.com] [--keywords fintech] [--limit 500] [--page-token <token>] [--json]
+`);
+}
+
+function companiesHelp() {
+  console.log(`Dench companies
+
+Usage:
+  dench companies find --name "Acme" [--domain acme.com] [--keywords fintech] [--industries SaaS] [--locations "San Francisco"] [--limit 500] [--page-token <token>] [--json]
+`);
+}
+
+function jobsHelp() {
+  console.log(`Dench jobs
+
+Usage:
+  dench jobs find --titles "Account Executive" --locations "San Francisco" [--company-domain acme.com] [--keywords remote] [--limit 500] [--page-token <token>] [--json]
 `);
 }
 
@@ -2528,6 +2562,7 @@ function stripRuntimeFlags(args: string[]) {
     "--prod",
     "--staging",
     "--use-dev-env",
+    "--json",
   ]);
   const valueFlags = new Set(["--convex-url", "--host", "--backend"]);
   const stripped: string[] = [];
@@ -2559,12 +2594,50 @@ function requireAuthenticatedRuntime(
   throw loginRequiredError(command);
 }
 
+async function resolveFindCommandAuth(command: string) {
+  const runtime = await getRuntime();
+  if (runtime.mode === "dev") {
+    const gatewayAuth = await resolveGatewayCommandAuth(
+      runtime,
+      `${command} find`,
+    );
+    return {
+      convex: runtime.client,
+      sessionToken: encodeDevCrmSessionToken(runtime.workspaceArgs),
+      enrichmentGateway: {
+        apiKey: gatewayAuth.bearerToken,
+        baseUrl: gatewayAuth.gatewayBaseUrl,
+      },
+    };
+  }
+  const authedRuntime = requireAuthenticatedRuntime(runtime, command);
+  const gatewayAuth = await resolveGatewayCommandAuth(
+    authedRuntime,
+    `${command} find`,
+  );
+  return {
+    convex: authedRuntime.client,
+    sessionToken: authedRuntime.sessionToken,
+    enrichmentGateway: {
+      apiKey: gatewayAuth.bearerToken,
+      baseUrl: gatewayAuth.gatewayBaseUrl,
+    },
+  };
+}
+
 type GatewayCommandAuth = {
   bearerToken: string;
   gatewayBaseUrl?: string;
   gatewayHeaders?: Record<string, string>;
 };
 
+function envGatewayBaseUrlOverride(): string | undefined {
+  const explicit =
+    process.env.DENCH_GATEWAY_URL?.trim() || process.env.GATEWAY_URL?.trim();
+  if (!explicit) return undefined;
+  return explicit.replace(/\/+$/, "").replace(/\/v1$/, "");
+}
+
 function gatewayBaseUrlForCli(value: unknown): string | undefined {
   if (typeof value !== "string") return undefined;
   const trimmed = value.trim().replace(/\/+$/, "");
@@ -2632,7 +2705,10 @@ async function resolveGatewayCommandAuth(
   command: string,
 ): Promise<GatewayCommandAuth> {
   if (runtime.mode === "apiKey") {
-    return { bearerToken: runtime.sessionToken };
+    return {
+      bearerToken: runtime.sessionToken,
+      gatewayBaseUrl: envGatewayBaseUrlOverride(),
+    };
   }
 
   if (runtime.mode === "session") {
@@ -2658,7 +2734,8 @@ async function resolveGatewayCommandAuth(
     }
     return {
       bearerToken: gatewayKey,
-      gatewayBaseUrl: gatewayBaseUrlForCli(body.gatewayBaseUrl),
+      gatewayBaseUrl:
+        envGatewayBaseUrlOverride() ?? gatewayBaseUrlForCli(body.gatewayBaseUrl),
       gatewayHeaders:
         body.gatewayHeaders &&
         typeof body.gatewayHeaders === "object" &&
@@ -2669,7 +2746,12 @@ async function resolveGatewayCommandAuth(
   }
 
   const envApiKey = process.env.DENCH_API_KEY?.trim();
-  if (envApiKey) return { bearerToken: envApiKey };
+  if (envApiKey) {
+    return {
+      bearerToken: envApiKey,
+      gatewayBaseUrl: envGatewayBaseUrlOverride(),
+    };
+  }
   throw loginRequiredError(command);
 }
 
@@ -4169,6 +4251,21 @@ async function main() {
     return;
   }
 
+  if (command === "leads" && (subcommand === "help" || hasFlag("--help"))) {
+    leadsHelp();
+    return;
+  }
+
+  if (command === "companies" && (subcommand === "help" || hasFlag("--help"))) {
+    companiesHelp();
+    return;
+  }
+
+  if (command === "jobs" && (subcommand === "help" || hasFlag("--help"))) {
+    jobsHelp();
+    return;
+  }
+
   if (command === "status" && hasFlag("--help")) {
     statusHelp();
     return;
@@ -4249,6 +4346,53 @@ async function main() {
     return;
   }
 
+  if (command === "leads") {
+    const { runLeadsCommand, assertLeadsFindArgs } = await import("./leads");
+    const leadArgs = stripRuntimeFlags(args.slice(args.indexOf("leads") + 1));
+    assertLeadsFindArgs(leadArgs);
+    const auth = await resolveFindCommandAuth("dench leads");
+    await runLeadsCommand({
+      convex: auth.convex,
+      args: leadArgs,
+      jsonOutput: json,
+      sessionToken: auth.sessionToken,
+      enrichmentGateway: auth.enrichmentGateway,
+    });
+    return;
+  }
+
+  if (command === "companies") {
+    const { runCompaniesCommand, assertCompaniesFindArgs } = await import("./leads");
+    const companyArgs = stripRuntimeFlags(
+      args.slice(args.indexOf("companies") + 1),
+    );
+    assertCompaniesFindArgs(companyArgs);
+    const auth = await resolveFindCommandAuth("dench companies");
+    await runCompaniesCommand({
+      convex: auth.convex,
+      args: companyArgs,
+      jsonOutput: json,
+      sessionToken: auth.sessionToken,
+      enrichmentGateway: auth.enrichmentGateway,
+    });
+    return;
+  }
+
+  if (command === "jobs") {
+    const { runJobsCommand, assertJobsFindArgs } = await import("./leads");
+    const jobArgs = stripRuntimeFlags(args.slice(args.indexOf("jobs") + 1));
+    assertJobsFindArgs(jobArgs);
+    const auth = await resolveFindCommandAuth("dench jobs");
+    await runJobsCommand({
+      convex: auth.convex,
+      args: jobArgs,
+      jsonOutput: json,
+      sessionToken: auth.sessionToken,
+      enrichmentGateway: auth.enrichmentGateway,
+    });
+    return;
+  }
+
   if (command === "members") {
     // Top-level convenience surface for the same Convex query that
     // `dench crm members list` calls. Lives here (rather than only
@@ -4830,6 +4974,23 @@ async function main() {
   }
 
   if (command === "artifacts") {
+    const runtime = await getRuntime();
+    const artifactArgs = stripRuntimeFlags(
+      args.slice(args.indexOf("artifacts") + 1),
+    );
+    if (
+      runtime.mode === "session" ||
+      runtime.mode === "apiKey"
+    ) {
+      const { runWorkspaceArtifactsCommand } = await import("./leads");
+      const handled = await runWorkspaceArtifactsCommand({
+        convex: runtime.client,
+        args: artifactArgs,
+        jsonOutput: json,
+        sessionToken: runtime.sessionToken,
+      });
+      if (handled) return;
+    }
     print(await listArtifacts(runtime, parseNumberOption("--limit")));
     return;
   }

package/lib/api-schemas.ts

@@ -949,15 +949,30 @@ 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();
 
 const enrichedPeopleResponse = z
   .object({
-    source: z.enum(["fullenrich", "cache"]),
+    source: z.enum(["live", "cache"]),
     people: z
       .array(
         z
@@ -985,7 +1000,7 @@ const enrichedPeopleResponse = z
 
 const enrichedCompaniesResponse = z
   .object({
-    source: z.enum(["fullenrich", "cache"]),
+    source: z.enum(["live", "cache"]),
     companies: z
       .array(
         z
@@ -1187,8 +1202,12 @@ const peopleSearch = z.object({
   locations: z.array(z.string()).max(50).optional(),
   headcountRanges: z.array(z.string()).max(20).optional(),
   exactMatch: z.boolean().optional(),
-  limit: z.number().int().positive().max(100).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(),
 });
 
@@ -1197,11 +1216,52 @@ const companySearch = z.object({
   name: z.string().optional(),
   linkedinUrl: z.string().optional(),
   exactMatch: z.boolean().optional(),
-  limit: z.number().int().positive().max(100).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(),
 });
 
+const jobsSearch = z.object({
+  titles: z.array(z.string()).max(50).optional(),
+  locations: z.array(z.string()).max(50).optional(),
+  companyDomain: z.string().optional(),
+  companyName: z.string().optional(),
+  companyLinkedinUrl: z.string().optional(),
+  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(),
+});
+
+const jobsSearchResponse = z
+  .object({
+    source: z.enum(["live", "cache"]),
+    jobs: z
+      .array(
+        z
+          .object({
+            title: z.string().optional(),
+            company: z.string().optional(),
+            location: z.string().optional(),
+            url: z.string().optional(),
+            workplaceType: z.string().optional(),
+            postedAt: z.string().optional(),
+          })
+          .passthrough(),
+      )
+      .describe("Job postings in the canonical job_posting shape."),
+    metadata: enrichmentMetadata,
+  })
+  .passthrough();
+
 // ---------------------------------------------------------------------------
 // Request schemas keyed by operation id
 // ---------------------------------------------------------------------------
@@ -1764,12 +1824,10 @@ export const requestSchemas: Record<string, ZodTypeAny> = {
     objectName: z.string(),
     entryId: z.string(),
     fieldName: z.string(),
-    provider: z.string().optional().describe("Defaults to auto."),
   }),
   "crm.enrich.object": z.object({
     objectName: z.string(),
     fieldName: z.string(),
-    provider: z.string().optional(),
     missingOnly: z
       .boolean()
       .optional()
@@ -1777,6 +1835,31 @@ export const requestSchemas: Record<string, ZodTypeAny> = {
   }),
   "crm.people.search": peopleSearch,
   "crm.companies.search": companySearch,
+  "enrichment.jobs.search": jobsSearch,
+  "enrichment.search.preview": z
+    .object({
+      kind: z.enum(["people", "companies", "jobs"]).optional(),
+    })
+    .passthrough(),
+  "enrichment.person": z
+    .object({
+      linkedinURL: z.string().optional(),
+      linkedinID: z.string().optional(),
+      email: z.string().optional(),
+    })
+    .passthrough(),
+  "enrichment.company": z
+    .object({
+      website: z.string().optional(),
+      linkedinURL: z.string().optional(),
+      linkedinID: z.string().optional(),
+    })
+    .passthrough(),
+  "enrichment.person.contact": z
+    .object({
+      contacts: z.array(z.record(z.string(), z.unknown())).min(1),
+    })
+    .passthrough(),
 
   // Email (sender identities, raw sends, templates, campaigns)
   "email.identity.verify": z.object({
@@ -2485,15 +2568,31 @@ export const responseSchemas: Record<string, ZodTypeAny> = {
   }),
   "crm.enrich.cell": z.object({
     enqueued: z.boolean(),
-    provider: z.string(),
     hint: z.string(),
   }),
   "crm.enrich.object": z.object({
     enqueued: z.number().describe("Number of cells queued for enrichment."),
-    provider: z.string(),
   }),
   "crm.people.search": enrichedPeopleResponse,
   "crm.companies.search": enrichedCompaniesResponse,
+  "enrichment.jobs.search": jobsSearchResponse,
+  "enrichment.search.preview": z.object({
+    count: z.number(),
+    source: z.enum(["live", "cache"]).optional(),
+  }),
+  "enrichment.person": z
+    .object({
+      source: z.enum(["live", "cache"]),
+      data: z.unknown().nullable(),
+    })
+    .passthrough(),
+  "enrichment.company": z
+    .object({
+      source: z.enum(["live", "cache"]),
+      data: z.unknown().nullable(),
+    })
+    .passthrough(),
+  "enrichment.person.contact": z.object({}).passthrough(),
 
   // Email
   "email.identity.verify": z
@@ -3007,6 +3106,19 @@ export const requestExamples: Record<string, unknown> = {
     limit: 10,
   },
   "crm.companies.search": { domain: "example.com" },
+  "enrichment.jobs.search": {
+    titles: ["Account Executive"],
+    locations: ["San Francisco"],
+    limit: 50,
+  },
+  "enrichment.search.preview": { kind: "people", titles: ["VP Sales"] },
+  "enrichment.person": {
+    linkedinURL: "https://www.linkedin.com/in/janedoe",
+  },
+  "enrichment.company": { website: "acme.com" },
+  "enrichment.person.contact": {
+    contacts: [{ linkedinUrl: "https://www.linkedin.com/in/janedoe" }],
+  },
   "email.identity.verify": { type: "email", identity: "founder@example.com" },
   "email.identity.create": {
     type: "domain",
@@ -3624,12 +3736,11 @@ export const responseExamples: Record<string, unknown> = {
   },
   "crm.enrich.cell": {
     enqueued: true,
-    provider: "auto",
-    hint: "Enrichment queued; the cell fills in once the provider responds.",
+    hint: "Enrichment queued; the cell fills in once search responds.",
   },
-  "crm.enrich.object": { enqueued: 37, provider: "auto" },
+  "crm.enrich.object": { enqueued: 37 },
   "crm.people.search": {
-    source: "fullenrich",
+    source: "live",
     people: [
       {
         fullName: "Jane Doe",
@@ -3646,7 +3757,7 @@ export const responseExamples: Record<string, unknown> = {
     metadata: { total: 1, offset: 0 },
   },
   "crm.companies.search": {
-    source: "fullenrich",
+    source: "live",
     companies: [
       {
         name: "Acme",
@@ -3660,6 +3771,28 @@ export const responseExamples: Record<string, unknown> = {
     creditsCharged: 1,
     metadata: { total: 1, offset: 0 },
   },
+  "enrichment.jobs.search": {
+    source: "live",
+    jobs: [
+      {
+        title: "Account Executive",
+        company: "Acme",
+        location: "San Francisco",
+        url: "https://example.com/jobs/ae",
+        workplaceType: "hybrid",
+      },
+    ],
+  },
+  "enrichment.search.preview": { count: 247, source: "live" },
+  "enrichment.person": {
+    source: "live",
+    data: { fullName: "Jane Doe", linkedinID: "janedoe" },
+  },
+  "enrichment.company": {
+    source: "live",
+    data: { name: "Acme", website: "acme.com" },
+  },
+  "enrichment.person.contact": { enrichmentId: "job_123", status: "queued" },
   "email.identity.verify": {
     ok: true,
     identity: "example.com",

package/lib/command-registry.ts

@@ -1360,7 +1360,7 @@ const rawApiOperations = [
     summary: "Search for people through the enrichment gateway.",
     cli: "dench crm people search",
     method: "POST",
-    path: "/crm/people/search",
+    path: "/enrichment/people/search",
     requestSchema: anyObject,
     responseSchema: anyResponse,
     backend: gateway("POST", "/enrichment/people/search"),
@@ -1371,11 +1371,77 @@ const rawApiOperations = [
     summary: "Search for companies through the enrichment gateway.",
     cli: "dench crm companies search",
     method: "POST",
-    path: "/crm/companies/search",
+    path: "/enrichment/company/search",
     requestSchema: anyObject,
     responseSchema: anyResponse,
     backend: gateway("POST", "/enrichment/company/search"),
   }),
+  op({
+    id: "enrichment.companies.search",
+    group: "crm",
+    summary: "Search companies through Dench find.",
+    cli: "dench companies find",
+    method: "POST",
+    path: "/enrichment/company/search",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: gateway("POST", "/enrichment/company/search"),
+  }),
+  op({
+    id: "enrichment.jobs.search",
+    group: "crm",
+    summary: "Search job postings through Dench find.",
+    cli: "dench jobs find",
+    method: "POST",
+    path: "/enrichment/jobs/search",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: gateway("POST", "/enrichment/jobs/search"),
+  }),
+  op({
+    id: "enrichment.person",
+    group: "crm",
+    summary: "Look up one person profile.",
+    cli: "dench crm enrich cell",
+    method: "POST",
+    path: "/enrichment/person",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: gateway("POST", "/enrichment/person"),
+  }),
+  op({
+    id: "enrichment.company",
+    group: "crm",
+    summary: "Look up one company profile.",
+    cli: "dench crm enrich cell",
+    method: "POST",
+    path: "/enrichment/company",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: gateway("POST", "/enrichment/company"),
+  }),
+  op({
+    id: "enrichment.person.contact",
+    group: "crm",
+    summary: "Look up verified emails and phones for people.",
+    cli: "dench crm enrich cell",
+    method: "POST",
+    path: "/enrichment/person/contact",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: gateway("POST", "/enrichment/person/contact"),
+  }),
+  op({
+    id: "enrichment.search.preview",
+    group: "crm",
+    summary: "Preview how many records a find would return.",
+    cli: "dench leads find --limit 1",
+    method: "POST",
+    path: "/enrichment/search/preview",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: gateway("POST", "/enrichment/search/preview"),
+  }),
   op({
     id: "crm.templates.list",
     group: "crm",

package/lib/crm-enrichment.ts

@@ -27,6 +27,10 @@ export type EnrichmentFieldType =
   | "tags"
   | "action";
 
+/** Contact lookups the gateway can run for a column (person/contact only).
+ *  Mirrors `EnrichField` in src/lib/workspace/enrichment-columns.ts. */
+export type EnrichField = "work_emails" | "personal_emails" | "phones";
+
 export type EnrichmentColumnDef = {
   label: string;
   key: string;
@@ -40,6 +44,9 @@ export type EnrichmentColumnDef = {
   requiredFields: string[];
   /** Additional dot-paths to try when apolloPath does not resolve. */
   extractionFallbacks?: string[];
+  /** Contact enrich_fields to request — present only on contact columns
+   *  (email / phone), which must stay on the /person/contact lane. */
+  enrichFields?: EnrichField[];
 };
 
 export type EnrichmentInputKind = "email" | "linkedin" | "domain";
@@ -82,6 +89,7 @@ export const PEOPLE_ENRICHMENT_COLUMNS: readonly EnrichmentColumnDef[] = [
     apolloPath: "person.email",
     requiredFields: ["email"],
     extractionFallbacks: ["email"],
+    enrichFields: ["work_emails"],
   },
   {
     label: "Headline",
@@ -114,6 +122,7 @@ export const PEOPLE_ENRICHMENT_COLUMNS: readonly EnrichmentColumnDef[] = [
     apolloPath: "person.contact.phone_numbers.0.sanitized_number",
     requiredFields: ["phone"],
     extractionFallbacks: ["phone", "person.phone"],
+    enrichFields: ["phones"],
   },
   {
     label: "Title",

package/lib/enrichment-gateway.ts

@@ -46,15 +46,81 @@ export type ReverseEmailBody = {
   email: string;
 };
 
+/** One list-filter entry: plain include string or `{value, exclude, exactMatch}`. */
+export type SearchFilterItem =
+  | string
+  | { value: string; exclude?: boolean; exactMatch?: boolean };
+
+export type SearchRangeFilter = { min?: number; max?: number };
+
 export type SearchPeopleBody = {
   personTitles?: string[];
   personLocations?: string[];
+  personSeniorities?: string[];
+  personFunctions?: string[];
   organizationDomains?: string[];
   organizationLocations?: string[];
+  organizationIndustries?: string[];
   organizationNumEmployeesRanges?: string[];
   qKeywords?: string;
+  keywords?: string;
   page?: number;
   perPage?: number;
+  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[];
+  pastTitles?: SearchFilterItem[];
+  personNames?: SearchFilterItem[];
+  seniorities?: SearchFilterItem[];
+  jobFunctions?: SearchFilterItem[];
+  subFunctions?: SearchFilterItem[];
+  industries?: SearchFilterItem[];
+  locations?: SearchFilterItem[];
+  headcountRanges?: SearchFilterItem[];
+  companyNames?: SearchFilterItem[];
+  pastCompanyNames?: SearchFilterItem[];
+  companyDomains?: SearchFilterItem[];
+  companyHeadquarters?: SearchFilterItem[];
+  companyTypes?: SearchFilterItem[];
+  universities?: SearchFilterItem[];
+  skills?: SearchFilterItem[];
+  languages?: SearchFilterItem[];
+  yearsInRole?: SearchRangeFilter;
+  yearsAtCompany?: SearchRangeFilter;
+  daysSinceJobChange?: SearchRangeFilter;
+  foundedYears?: SearchRangeFilter;
+};
+
+export type SearchCompaniesBody = {
+  domain?: string;
+  name?: string;
+  linkedinUrl?: string;
+  industries?: string[];
+  locations?: string[];
+  headcountRanges?: string[];
+  keywords?: string;
+  limit?: number;
+  offset?: number;
+  /** Opaque token from a previous response's `metadata.nextPageToken`. */
+  pageToken?: string;
+};
+
+export type SearchJobsBody = {
+  titles?: string[];
+  locations?: string[];
+  companyDomain?: string;
+  companyName?: string;
+  companyLinkedinUrl?: string;
+  keywords?: string;
+  postedAfter?: string;
+  limit?: number;
+  /** Opaque token from a previous response's `metadata.nextPageToken`. */
+  pageToken?: string;
 };
 
 export type EnrichmentGatewayOptions = {
@@ -1031,7 +1097,7 @@ export async function enrichCompany(
 }
 
 // ---------------------------------------------------------------------------
-// aviatoEnrichPerson — calls POST /v1/enrichment/aviato/person (synchronous)
+// Person profile — POST /v1/enrichment/person (synchronous waterfall)
 // ---------------------------------------------------------------------------
 
 export type AviatoEnrichPersonBody = {
@@ -1064,7 +1130,7 @@ export async function aviatoEnrichPerson(
     linkedinUrl || linkedinID || linkedinNumID || linkedinEntityId || email;
   if (!hasIdentifier) {
     throw new EnrichmentGatewayError(
-      "Aviato person enrichment requires at least one identifier: linkedinUrl, linkedinID, linkedinNumID, linkedinEntityId, or email.",
+      "Person enrichment requires at least one identifier: linkedinUrl, linkedinID, linkedinNumID, linkedinEntityId, or email.",
       { code: "empty_identifier" },
     );
   }
@@ -1088,7 +1154,7 @@ export async function aviatoEnrichPerson(
   if (body.preview !== undefined && !(body.preview && emailOnly))
     requestBody.preview = body.preview;
 
-  const raw = await callGatewayJson("/v1/enrichment/aviato/person", {
+  const raw = await callGatewayJson("/v1/enrichment/person", {
     method: "POST",
     body: requestBody,
     options,
@@ -1110,7 +1176,6 @@ export async function aviatoEnrichPerson(
 
   return {
     _meta: {
-      provider: "aviato",
       cacheHit: resp.billing?.cache_hit ?? false,
       chargedCents: resp.billing?.charged_cents ?? 0,
     },
@@ -1119,7 +1184,7 @@ export async function aviatoEnrichPerson(
 }
 
 // ---------------------------------------------------------------------------
-// aviatoEnrichCompany — calls POST /v1/enrichment/aviato/company (synchronous)
+// Company profile — POST /v1/enrichment/company (synchronous waterfall)
 // ---------------------------------------------------------------------------
 
 export async function aviatoEnrichCompany(
@@ -1130,7 +1195,7 @@ export async function aviatoEnrichCompany(
     body.website || body.linkedinUrl || body.linkedinID || body.linkedinNumID;
   if (!hasIdentifier) {
     throw new EnrichmentGatewayError(
-      "Aviato company enrichment requires at least one identifier: website, linkedinUrl, linkedinID, or linkedinNumID.",
+      "Company enrichment requires at least one identifier: website, linkedinUrl, linkedinID, or linkedinNumID.",
       { code: "empty_identifier" },
     );
   }
@@ -1142,7 +1207,7 @@ export async function aviatoEnrichCompany(
   if (body.linkedinNumID) requestBody.linkedinNumID = body.linkedinNumID.trim();
   if (body.preview !== undefined) requestBody.preview = body.preview;
 
-  const raw = await callGatewayJson("/v1/enrichment/aviato/company", {
+  const raw = await callGatewayJson("/v1/enrichment/company", {
     method: "POST",
     body: requestBody,
     options,
@@ -1164,7 +1229,6 @@ export async function aviatoEnrichCompany(
 
   return {
     _meta: {
-      provider: "aviato",
       cacheHit: resp.billing?.cache_hit ?? false,
       chargedCents: resp.billing?.charged_cents ?? 0,
     },
@@ -1184,29 +1248,80 @@ export async function searchPeople(
   // `locations`, `headcountRanges`, `titles`, `companyDomain`, etc.
   const payload: Record<string, unknown> = { preferCache: true };
 
-  if (body.personTitles?.length) payload.titles = body.personTitles;
+  const mergeItems = (
+    legacy: string[] | undefined,
+    rich: SearchFilterItem[] | undefined,
+  ): SearchFilterItem[] => {
+    const legacyItems = (legacy ?? [])
+      .map((s) => s.trim())
+      .filter(Boolean) as SearchFilterItem[];
+    return [...legacyItems, ...(rich ?? [])];
+  };
+
+  const titles = mergeItems(body.personTitles, body.titles);
+  if (titles.length > 0) payload.titles = titles;
 
-  const locations = [
-    ...(body.personLocations ?? []),
-    ...(body.organizationLocations ?? []),
-  ]
-    .map((s) => s.trim())
-    .filter(Boolean);
+  const locations = mergeItems(
+    [...(body.personLocations ?? []), ...(body.organizationLocations ?? [])],
+    body.locations,
+  );
   if (locations.length > 0) payload.locations = locations;
 
   if (body.organizationDomains && body.organizationDomains.length > 0) {
     payload.companyDomain = body.organizationDomains[0];
   }
 
-  const headcountRanges = (body.organizationNumEmployeesRanges ?? [])
-    .map((s) => s.trim())
-    .filter(Boolean);
-  if (headcountRanges.length > 0) {
-    payload.headcountRanges = headcountRanges;
+  const headcountRanges = mergeItems(
+    body.organizationNumEmployeesRanges,
+    body.headcountRanges,
+  );
+  if (headcountRanges.length > 0) payload.headcountRanges = headcountRanges;
+
+  const seniorities = mergeItems(body.personSeniorities, body.seniorities);
+  if (seniorities.length > 0) payload.seniorities = seniorities;
+  const jobFunctions = mergeItems(body.personFunctions, body.jobFunctions);
+  if (jobFunctions.length > 0) payload.jobFunctions = jobFunctions;
+  const industries = mergeItems(body.organizationIndustries, body.industries);
+  if (industries.length > 0) payload.industries = industries;
+
+  // Rich list filters with no legacy alias — pass straight through.
+  const listPassthrough = [
+    "pastTitles",
+    "personNames",
+    "subFunctions",
+    "companyNames",
+    "pastCompanyNames",
+    "companyDomains",
+    "companyHeadquarters",
+    "companyTypes",
+    "universities",
+    "skills",
+    "languages",
+  ] as const;
+  for (const key of listPassthrough) {
+    const items = body[key];
+    if (items?.length) payload[key] = items;
+  }
+  const rangePassthrough = [
+    "yearsInRole",
+    "yearsAtCompany",
+    "daysSinceJobChange",
+    "foundedYears",
+  ] as const;
+  for (const key of rangePassthrough) {
+    const range = body[key];
+    if (range && (range.min !== undefined || range.max !== undefined)) {
+      payload[key] = range;
+    }
   }
 
-  if (body.qKeywords) payload.keywords = body.qKeywords;
-  if (body.perPage !== undefined) payload.limit = body.perPage;
+  const keywords = body.keywords ?? body.qKeywords;
+  if (keywords) payload.keywords = keywords;
+  if (body.limit !== undefined) payload.limit = body.limit;
+  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",
@@ -1215,6 +1330,51 @@ export async function searchPeople(
   });
 }
 
+export async function searchCompanies(
+  body: SearchCompaniesBody,
+  options: EnrichmentGatewayOptions = {},
+): Promise<Record<string, unknown>> {
+  const payload: Record<string, unknown> = { preferCache: true };
+  if (body.domain) payload.domain = body.domain;
+  if (body.name) payload.name = body.name;
+  if (body.linkedinUrl) payload.linkedinUrl = body.linkedinUrl;
+  if (body.industries?.length) payload.industries = body.industries;
+  if (body.locations?.length) payload.locations = body.locations;
+  if (body.headcountRanges?.length)
+    payload.headcountRanges = body.headcountRanges;
+  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,
+    options,
+  });
+}
+
+export async function searchJobs(
+  body: SearchJobsBody,
+  options: EnrichmentGatewayOptions = {},
+): Promise<Record<string, unknown>> {
+  const payload: Record<string, unknown> = {};
+  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.companyName) payload.companyName = body.companyName;
+  if (body.companyLinkedinUrl)
+    payload.companyLinkedinUrl = body.companyLinkedinUrl;
+  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,
+    options,
+  });
+}
+
 /**
  * Number of Exa candidates to pull when resolving ONE person for enrichment.
  *
@@ -1355,7 +1515,8 @@ async function buildGatewayError(
   if (
     response.status === 401 ||
     code === "invalid_api_key" ||
-    code === "unauthorized"
+    code === "unauthorized" ||
+    code === "aviato_unauthorized"
   ) {
     return new EnrichmentGatewayError(
       upstreamMessage ?? "Unauthorized gateway request",
@@ -1368,12 +1529,6 @@ async function buildGatewayError(
       { status: response.status, code: "forbidden" },
     );
   }
-  if (code === "aviato_unauthorized") {
-    return new EnrichmentGatewayError(
-      upstreamMessage ?? "Aviato provider unauthorized",
-      { status: response.status || 401, code: "aviato_unauthorized" },
-    );
-  }
   if (response.status === 503 || code === "provider_unavailable") {
     return new EnrichmentGatewayError("Gateway providers unavailable", {
       status: response.status,

package/package.json

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