@dench.com/cli 3.5.6-staging.344 → 3.6.0-staging.356

package/lib/command-registry.ts

@@ -29,6 +29,7 @@ export type CustomOperation = {
     | "commandsList"
     | "chatSpawn"
     | "chatFollow"
+    | "campaignBuilder"
     | "cronDelete"
     | "cronRunNow"
     | "connectionsList"
@@ -133,6 +134,219 @@ function local(reason: string): LocalOnlyOperation {
 }
 
 const rawApiOperations = [
+  op({
+    id: "campaigns.drafts.create",
+    group: "campaigns",
+    summary:
+      "Create an idempotent empty campaign draft with the caller's available sender pools. Does not launch or send.",
+    cli: "dench campaign draft",
+    method: "POST",
+    path: "/campaigns/drafts",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "mutation",
+      "functions/outreachSignalCampaigns:createPlainCampaign",
+    ),
+  }),
+  op({
+    id: "campaigns.audience.search",
+    group: "campaigns",
+    summary:
+      "Search people by filters without adding CRM records or campaign recipients. Search credits apply; this is not a free provider preview.",
+    cli: "dench campaign search",
+    method: "POST",
+    path: "/campaigns/audience/search",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("action", "functions/outreachAudienceNode:search"),
+  }),
+  op({
+    id: "campaigns.people.addFromSearch",
+    group: "campaigns",
+    summary:
+      "Search and add up to 50 people to an existing campaign. New identities become Leads. Search credits apply; use nextPageToken for another page.",
+    cli: "dench campaign add --search",
+    method: "POST",
+    path: "/campaigns/{sequenceId}/people/search",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("action", "functions/outreachAudienceNode:addFromSearch"),
+  }),
+  op({
+    id: "campaigns.people.addBatch",
+    group: "campaigns",
+    summary:
+      "Add up to 50 selected recipients without another search. Deduplicates, applies suppression, and preserves the campaign's launch state.",
+    cli: "dench campaign add --people-file",
+    method: "POST",
+    path: "/campaigns/{sequenceId}/people/batch",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/outreachSequences:addEnrollments"),
+  }),
+  op({
+    id: "campaigns.sources.get",
+    group: "campaigns",
+    summary: "Read a campaign's saved signal source, targeting and schedule.",
+    cli: "dench campaign sources get",
+    method: "GET",
+    path: "/campaigns/{sequenceId}/sources",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/outreachLeadSources:getForSequence"),
+  }),
+  op({
+    id: "campaigns.sources.signals",
+    group: "campaigns",
+    summary:
+      "Read signal choices, suggested terms and current source configuration.",
+    cli: "dench campaign sources signals",
+    method: "GET",
+    path: "/campaigns/{sequenceId}/sources/signals",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/outreachLeadSources:signalsOverview"),
+  }),
+  op({
+    id: "campaigns.sources.update",
+    group: "campaigns",
+    summary:
+      "Update source cadence, pause/resume, targeting, signals or terms. Active sources may perform billable future work.",
+    cli: "dench campaign sources set",
+    method: "PATCH",
+    path: "/campaigns/{sequenceId}/sources",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/outreachLeadSources:update"),
+  }),
+  op({
+    id: "campaigns.sources.preview",
+    group: "campaigns",
+    summary:
+      "Preview a signal source using its current audience. Provider credits may apply; does not enroll people.",
+    cli: "dench campaign sources preview",
+    method: "POST",
+    path: "/campaigns/{sequenceId}/sources/preview",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "action",
+      "functions/outreachLeadSourcesNode:previewSignal",
+    ),
+  }),
+  op({
+    id: "campaigns.builder.profile",
+    group: "campaigns",
+    summary: "Read the company profile and suggested campaign audience.",
+    cli: "dench campaign builder profile",
+    method: "GET",
+    path: "/campaigns/builder/profile",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/outreachSignalCampaigns:getProfile"),
+  }),
+  op({
+    id: "campaigns.builder.save",
+    group: "campaigns",
+    summary:
+      "Save a signal campaign's audience, signals and terms idempotently. Does not start a build.",
+    cli: "dench campaign builder save",
+    method: "POST",
+    path: "/campaigns/builder/drafts",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "mutation",
+      "functions/outreachSignalCampaigns:upsertDraft",
+    ),
+  }),
+  op({
+    id: "campaigns.builder.get",
+    group: "campaigns",
+    summary: "Read signal build progress, preview people, messages and errors.",
+    cli: "dench campaign builder get",
+    method: "GET",
+    path: "/campaigns/builder/drafts/{draftId}",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/outreachSignalCampaigns:getDraft"),
+  }),
+  op({
+    id: "campaigns.builder.build",
+    group: "campaigns",
+    summary:
+      "Start the same billable signal/audience/message build used by the UI; poll the draft for progress.",
+    cli: "dench campaign builder build",
+    method: "POST",
+    path: "/campaigns/builder/drafts/{draftId}/build",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: custom("campaignBuilder", "bearer"),
+  }),
+  op({
+    id: "campaigns.builder.create",
+    group: "campaigns",
+    summary:
+      "Create a campaign from a reviewed signal draft. Does not launch the campaign.",
+    cli: "dench campaign builder create",
+    method: "POST",
+    path: "/campaigns/builder/drafts/{draftId}/create",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/outreachSignalCampaigns:create"),
+  }),
+  op({
+    id: "campaigns.builder.opener",
+    group: "campaigns",
+    summary:
+      "Edit or reset one preview person's opening line before creating the campaign.",
+    cli: "dench campaign builder opener",
+    method: "PUT",
+    path: "/campaigns/builder/drafts/{draftId}/people/{leadId}/opener",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "mutation",
+      "functions/outreachSignalCampaigns:updateLeadOpener",
+    ),
+  }),
+  op({
+    id: "campaigns.builder.autofill",
+    group: "campaigns",
+    summary:
+      "Turn an audience description into targeting filters. AI credits apply.",
+    cli: "dench campaign builder autofill",
+    method: "POST",
+    path: "/campaigns/builder/autofill",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: custom("campaignBuilder", "bearer"),
+  }),
+  op({
+    id: "campaigns.builder.terms",
+    group: "campaigns",
+    summary:
+      "Suggest signal terms for the selected audience. AI credits apply.",
+    cli: "dench campaign builder terms",
+    method: "POST",
+    path: "/campaigns/builder/terms",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: custom("campaignBuilder", "bearer"),
+  }),
+  op({
+    id: "campaigns.builder.estimate",
+    group: "campaigns",
+    summary:
+      "Estimate audience or weekly signal volume using the UI's cached estimator. Provider credits may apply.",
+    cli: "dench campaign builder estimate",
+    method: "POST",
+    path: "/campaigns/builder/estimate",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: custom("campaignBuilder", "bearer"),
+  }),
   op({
     id: "commands.list",
     group: "meta",
@@ -3516,6 +3730,18 @@ const rawApiOperations = [
     responseSchema: anyResponse,
     backend: convex("query", "functions/linkedinAccounts:listSenderAccounts"),
   }),
+  op({
+    id: "campaigns.accounts.email",
+    group: "campaigns",
+    summary:
+      "Discover the mailboxes the acting workspace member can send campaign email from: ids for emailMailboxAccountIds, status, warm-up state and when it is done, the daily cold-email cap and what is left today. Never returns provider credentials.",
+    cli: "dench campaign accounts",
+    method: "GET",
+    path: "/campaigns/accounts/email",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/emailMailboxAccounts:listAccounts"),
+  }),
   op({
     id: "campaigns.list",
     group: "campaigns",
@@ -3539,6 +3765,21 @@ const rawApiOperations = [
     responseSchema: anyResponse,
     backend: convex("mutation", "functions/outreachSequences:createSequence"),
   }),
+  op({
+    id: "campaigns.duplicate",
+    group: "campaigns",
+    summary:
+      'Copy a campaign into a new draft named "<name> copy": the same steps, schedule, sender pools and personalized lines, its lead source paused, and no people. To reach more than 300 people, duplicate and add the next page of the search to the copy.',
+    cli: "dench campaign duplicate",
+    method: "POST",
+    path: "/campaigns/{sequenceId}/duplicate",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "mutation",
+      "functions/outreachSequences:duplicateSequence",
+    ),
+  }),
   op({
     id: "campaigns.get",
     group: "campaigns",
@@ -3578,6 +3819,21 @@ const rawApiOperations = [
     responseSchema: anyResponse,
     backend: convex("query", "functions/outreachSequences:getSequenceLive"),
   }),
+  op({
+    id: "campaigns.pipeline",
+    group: "campaigns",
+    summary:
+      "Where a campaign's people sit in the workspace's lead pipeline right now: each lead Status in order with how many enrolled leads are at it, and how many have no lead or a status outside the pipeline.",
+    cli: "dench campaign pipeline",
+    method: "GET",
+    path: "/campaigns/{sequenceId}/pipeline",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "query",
+      "functions/outreachSequences:getSequenceLeadStatusCounts",
+    ),
+  }),
   op({
     id: "campaigns.update",
     group: "campaigns",
@@ -3594,7 +3850,7 @@ const rawApiOperations = [
     id: "campaigns.steps.replace",
     group: "campaigns",
     summary:
-      "Replace every step of a draft campaign (email, wait, LinkedIn visit, connection request, message). Configure sender pools on the campaign; step sender ids are legacy-only.",
+      "Replace every step of a draft campaign (email, wait, LinkedIn visit, connection request, message, post reaction, InMail). Steps are checked first: a field the step type would drop, missing text or {TOKEN} single braces are rejected, not saved. Configure sender pools on the campaign; step sender ids are legacy-only.",
     cli: "dench campaign steps set",
     method: "PUT",
     path: "/campaigns/{sequenceId}/steps",
@@ -3602,6 +3858,102 @@ const rawApiOperations = [
     responseSchema: anyResponse,
     backend: convex("mutation", "functions/outreachSequences:replaceSteps"),
   }),
+  op({
+    id: "campaigns.steps.update",
+    group: "campaigns",
+    summary:
+      "Edit the text, waits and conditions of a launched (or paused) campaign's steps in place. Each step keeps its id, type and place; pass the stepId and the updatedAt you read, and only the fields you change. Messages already sent or being prepared keep their text; drafts use campaigns.steps.replace.",
+    cli: "dench campaign steps edit",
+    method: "PATCH",
+    path: "/campaigns/{sequenceId}/steps",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/outreachSequences:updateSteps"),
+  }),
+  op({
+    id: "campaigns.personalization.get",
+    group: "campaigns",
+    summary:
+      "Read a campaign's personalized lines (written for each person): their {{keys}} for steps, instructions and fallbacks, how many people have them, and the cost per person.",
+    cli: "dench campaign personalize get",
+    method: "GET",
+    path: "/campaigns/{sequenceId}/personalization",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/outreachPersonalization:getStatus"),
+  }),
+  op({
+    id: "campaigns.personalization.set",
+    group: "campaigns",
+    summary:
+      "Define up to 5 personalized lines (each used as {{key}} in steps) and what you sell. Saving starts writing missing lines for up to 100 people, about 3 cents a person; for more it returns needsConfirm and writes nothing until campaigns.personalization.write is confirmed.",
+    cli: "dench campaign personalize set",
+    method: "PUT",
+    path: "/campaigns/{sequenceId}/personalization",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "mutation",
+      "functions/outreachPersonalization:setTemplate",
+    ),
+  }),
+  op({
+    id: "campaigns.personalization.clear",
+    group: "campaigns",
+    summary:
+      "Turn off a campaign's personalized lines and cancel the ones not yet written. Refused while a step still uses one of the {{keys}}.",
+    cli: "dench campaign personalize clear",
+    method: "DELETE",
+    path: "/campaigns/{sequenceId}/personalization",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "mutation",
+      "functions/outreachPersonalization:setTemplate",
+    ),
+  }),
+  op({
+    id: "campaigns.personalization.write",
+    group: "campaigns",
+    summary:
+      "Write personalized lines for the people missing them (mode missing) or rewrite everyone's (mode all). Rewriting everyone or more than 100 people returns needsConfirm and the estimate until called with confirmed: true.",
+    cli: "dench campaign personalize write",
+    method: "POST",
+    path: "/campaigns/{sequenceId}/personalization/write",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/outreachPersonalization:backfill"),
+  }),
+  op({
+    id: "campaigns.personalization.edit",
+    group: "campaigns",
+    summary:
+      "Set one person's personalized line by hand; an empty value undoes the edit. Braces are removed and text past the line's length is cut.",
+    cli: "dench campaign personalize edit",
+    method: "PUT",
+    path: "/campaigns/people/{enrollmentId}/personalization",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "mutation",
+      "functions/outreachPersonalization:updateAiVariable",
+    ),
+  }),
+  op({
+    id: "campaigns.personalization.rewrite",
+    group: "campaigns",
+    summary:
+      "Write a fresh personalized line for one person: one key, or all of their lines when key is left out. About 3 cents.",
+    cli: "dench campaign personalize rewrite",
+    method: "POST",
+    path: "/campaigns/people/{enrollmentId}/personalization/rewrite",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "mutation",
+      "functions/outreachPersonalization:rewriteForEnrollment",
+    ),
+  }),
   op({
     id: "campaigns.people.addFromCrm",
     group: "campaigns",
@@ -3625,12 +3977,24 @@ const rawApiOperations = [
     responseSchema: anyResponse,
     backend: convex("mutation", "functions/outreachSequences:addEnrollment"),
   }),
+  op({
+    id: "campaigns.preview",
+    group: "campaigns",
+    summary:
+      "Show the message one person gets at one email or LinkedIn step, with their fields and personalized lines filled in: subject, body, sender, recipient, merge fields still missing, warnings, and why the step would be skipped. Nothing is sent, prepared or charged.",
+    cli: "dench campaign preview",
+    method: "GET",
+    path: "/campaigns/{sequenceId}/preview",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/outreachMessagePreview:preview"),
+  }),
   op({
     id: "campaigns.launch.preview",
     group: "campaigns",
     summary:
-      "Launch readiness: blockers grouped by problem, warnings, and the fingerprint `launch` requires.",
-    cli: "dench campaign launch",
+      "Launch readiness without launching: blockers grouped by problem, warnings, and the fingerprint `launch` requires.",
+    cli: "dench campaign launch --check",
     method: "GET",
     path: "/campaigns/{sequenceId}/launch",
     requestSchema: anyObject,
@@ -3674,8 +4038,10 @@ const rawApiOperations = [
   op({
     id: "campaigns.archive",
     group: "campaigns",
-    summary: "Archive a campaign and stop everyone still in flight.",
+    summary:
+      "Archive a campaign and stop everyone still in flight. This is the app's Delete: campaigns are never erased, and their people, leads and activity stay.",
     cli: "dench campaign archive",
+    aliases: ["dench campaign delete"],
     method: "POST",
     path: "/campaigns/{sequenceId}/archive",
     requestSchema: anyObject,
@@ -3717,6 +4083,123 @@ const rawApiOperations = [
     responseSchema: anyResponse,
     backend: convex("mutation", "functions/outreachSequences:resumeEnrollment"),
   }),
+  op({
+    id: "campaigns.people.setEmail",
+    group: "campaigns",
+    summary:
+      "Give a person in a draft campaign a new or corrected email address; their linked CRM record gets it too. Only before launch; another person in the campaign can't share it.",
+    cli: "dench campaign person set --email",
+    method: "PUT",
+    path: "/campaigns/people/{enrollmentId}/email",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "mutation",
+      "functions/outreachSequences:updateEnrollmentEmail",
+    ),
+  }),
+  op({
+    id: "campaigns.people.setLinkedin",
+    group: "campaigns",
+    summary:
+      "Give a person in a draft campaign a new or corrected LinkedIn profile URL; their linked CRM record gets it too. Only before launch.",
+    cli: "dench campaign person set --linkedin-url",
+    method: "PUT",
+    path: "/campaigns/people/{enrollmentId}/linkedin",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "mutation",
+      "functions/outreachSequences:updateEnrollmentLinkedin",
+    ),
+  }),
+  op({
+    id: "campaigns.people.setField",
+    group: "campaigns",
+    summary:
+      "Fill or fix one {{merge field}} for a person in a draft campaign, e.g. a missing Company that blocks launch; a matching column on their CRM record is updated too. Only before launch; written personalized lines are not merge fields and can't be set here.",
+    cli: "dench campaign person set --field",
+    method: "PUT",
+    path: "/campaigns/people/{enrollmentId}/fields",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "mutation",
+      "functions/outreachSequences:updateEnrollmentMergeField",
+    ),
+  }),
+  op({
+    id: "campaigns.people.resumeAll",
+    group: "campaigns",
+    summary:
+      "Resume every paused person in an active campaign at once, e.g. after a sending account is reconnected. Returns how many were resumed.",
+    cli: "dench campaign resume-person --all",
+    method: "POST",
+    path: "/campaigns/{sequenceId}/people/resume",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "mutation",
+      "functions/outreachSequences:resumePausedEnrollments",
+    ),
+  }),
+  op({
+    id: "campaigns.people.sync",
+    group: "campaigns",
+    summary:
+      "Fill each unfinished person's empty email, LinkedIn URL, name and merge fields from their linked CRM record, e.g. after enriching the records. Never overwrites a value the campaign already has; returns how many people changed.",
+    cli: "dench campaign sync",
+    method: "POST",
+    path: "/campaigns/{sequenceId}/people/sync",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "mutation",
+      "functions/outreachSequences:syncEnrollmentsFromRecords",
+    ),
+  }),
+  op({
+    id: "campaigns.people.forRecord",
+    group: "campaigns",
+    summary:
+      "The campaigns a CRM record (a person or a lead) is in, newest first, with the person's status in each and the accounts that send to them.",
+    cli: "dench campaign where",
+    method: "GET",
+    path: "/campaigns/by-record/{entryId}",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "query",
+      "functions/outreachSequences:listEnrollmentsForEntry",
+    ),
+  }),
+  op({
+    id: "campaigns.people.timeline",
+    group: "campaigns",
+    summary:
+      "Everything a campaign did for one person, step by step: what was sent (subject and text), whether it was opened or clicked, what was skipped and why, waits, failures and retries.",
+    cli: "dench campaign person show",
+    method: "GET",
+    path: "/campaigns/people/{enrollmentId}/timeline",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/outreachSequences:timeline"),
+  }),
+  op({
+    id: "campaigns.people.remove",
+    group: "campaigns",
+    summary:
+      "Remove a person who was never contacted from a draft campaign. Frees their place in the 300-person cap and keeps the draft launchable; stop anyone already contacted instead.",
+    cli: "dench campaign remove",
+    method: "DELETE",
+    path: "/campaigns/people/{enrollmentId}",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "mutation",
+      "functions/outreachSequences:removeDraftEnrollment",
+    ),
+  }),
 
   // Routines.
   op({
@@ -4142,8 +4625,8 @@ const rawApiOperations = [
     id: "integrations.list",
     group: "gateway",
     summary:
-      "List every connected integration — Composio apps plus the Gmail, " +
-      "Outlook, Calendar, LinkedIn and Slack connections Dench brokers " +
+      "List every connected integration — connected apps plus the Gmail, " +
+      "Outlook, Calendar, LinkedIn and Slack connections Dench provides " +
       "itself (Slack rows report source: dench).",
     cli: "dench integrations",
     method: "GET",
@@ -4315,7 +4798,7 @@ const rawApiOperations = [
     group: "gateway",
     summary:
       "Create a tool OAuth connection link. Slack is in-house, never " +
-      "Composio: for toolkit slack the CLI prints the first-party install " +
+      "a third-party connection: for toolkit slack the CLI prints the first-party install " +
       "URL (/api/slack/install?slug=<workspace>, org admin) instead of " +
       "calling this endpoint.",
     cli: "dench tool connect",
@@ -4344,7 +4827,7 @@ const rawApiOperations = [
       "with Block Kit blocks/buttons, SLACK_FETCH_HISTORY, " +
       "SLACK_LIST_CHANNELS, …) run through Dench's in-house Slack app " +
       "install — any channel in the connected workspace — and are always " +
-      "preferred over Composio Slack.",
+      "preferred over any third-party Slack connection.",
     cli: "dench tool run",
     method: "POST",
     path: "/tools/run",

package/lib/connection-source.ts

@@ -0,0 +1,10 @@
+export type ConnectionSource = "app" | "dench";
+
+export function connectionSource(
+  value: unknown,
+  fallback: ConnectionSource,
+): ConnectionSource {
+  if (value === "app" || value === "composio") return "app";
+  if (value === "dench" || value === "unipile") return "dench";
+  return fallback;
+}

package/lib/enrichment-gateway.ts

@@ -53,6 +53,15 @@ export type SearchFilterItem =
 
 export type SearchRangeFilter = { min?: number; max?: number };
 
+export type SearchBilling = {
+  estimatedCents: number;
+  chargedCents: number;
+};
+
+export type SearchResponse = Record<string, unknown> & {
+  billing?: SearchBilling;
+};
+
 export type SearchPeopleBody = {
   /** Canonical gateway fields. locations is the PERSON; companyHeadquarters is the employer. */
   linkedinUrl?: string;
@@ -159,6 +168,7 @@ export type SearchSignalsBody = {
   headcountRanges?: string[];
   excludeDomains?: string[];
   excludeCompanies?: string[];
+  includeCompanies?: string[];
   postedAfter: string;
   limit?: number;
   terms?: string[];
@@ -196,7 +206,11 @@ export type SearchSignalsResponse = {
   signals: SignalRow[];
   creditsCharged: number;
   volume?: { term: string; count: number; saturated?: true }[];
-  metadata?: { warnings?: string[] };
+  metadata?: {
+    warnings?: string[];
+    checked?: number;
+    misses?: { title: number; location: number; company: number };
+  };
 };
 
 /**
@@ -1541,7 +1555,7 @@ export function buildPeopleSearchRequest(
 export async function searchPeople(
   body: SearchPeopleBody,
   options: EnrichmentGatewayOptions = {},
-): Promise<Record<string, unknown>> {
+): Promise<SearchResponse> {
   return callGatewayJson("/v1/enrichment/people/search", {
     method: "POST",
     body: buildPeopleSearchRequest(body),
@@ -1552,7 +1566,7 @@ export async function searchPeople(
 export async function searchCompanies(
   body: SearchCompaniesBody,
   options: EnrichmentGatewayOptions = {},
-): Promise<Record<string, unknown>> {
+): Promise<SearchResponse> {
   const payload: Record<string, unknown> = {
     preferCache: body.preferCache ?? true,
   };
@@ -1616,6 +1630,8 @@ export async function searchSignals(
   if (body.excludeDomains?.length) payload.excludeDomains = body.excludeDomains;
   if (body.excludeCompanies?.length)
     payload.excludeCompanies = body.excludeCompanies;
+  if (body.includeCompanies?.length)
+    payload.includeCompanies = body.includeCompanies;
   if (body.limit !== undefined) payload.limit = body.limit;
   if (body.terms?.length) payload.terms = body.terms;
   if (body.recency) payload.recency = body.recency;
@@ -1653,6 +1669,7 @@ export type SignalBuyerBody = {
   companyDomain: string;
   titles?: string[];
   withEmail?: boolean;
+  limit?: number;
 };
 
 export type SignalBuyer = {
@@ -1665,6 +1682,7 @@ export type SignalBuyer = {
 
 export type SignalBuyerResponse = {
   buyer: SignalBuyer | null;
+  buyers?: SignalBuyer[];
   reveal?: "found" | "not_found" | "failed";
 };
 
@@ -1687,6 +1705,7 @@ export async function findSignalBuyer(
   };
   if (body.titles?.length) payload.titles = body.titles;
   if (body.withEmail !== undefined) payload.withEmail = body.withEmail;
+  if (body.limit !== undefined) payload.limit = body.limit;
   return (await callGatewayJson("/v1/enrichment/signals/buyer", {
     method: "POST",
     body: payload,