@dench.com/cli 3.5.3-staging.333 → 3.5.5-staging.342

package/app-sdk.d.ts

@@ -1941,7 +1941,7 @@ export interface ApiRequests {
       onlyIf?: "always" | "connected" | "not_connected";
       /** Legacy LinkedIn step sender. Pool campaigns use the campaign's linkedinAccountIds instead. */
       linkedinAccountId?: string;
-      /** linkedin_connection: the invite note (optional); linkedin_message: the message (up to 3000 chars). */
+      /** linkedin_connection: the invite note (optional, up to 300 chars; sent without it if LinkedIn refuses the note); linkedin_message: the message (up to 3000 chars). */
       linkedinMessageBody?: string;
       /** linkedin_message: what to do when the invite is still pending. */
       linkedinMessageMode?: "skip_if_not_connected" | "wait_until_connected";
@@ -4862,7 +4862,7 @@ export interface ApiResponses {
       onlyIf?: "always" | "connected" | "not_connected";
       /** Legacy LinkedIn step sender. Pool campaigns use the campaign's linkedinAccountIds instead. */
       linkedinAccountId?: string;
-      /** linkedin_connection: the invite note (optional); linkedin_message: the message (up to 3000 chars). */
+      /** linkedin_connection: the invite note (optional, up to 300 chars; sent without it if LinkedIn refuses the note); linkedin_message: the message (up to 3000 chars). */
       linkedinMessageBody?: string;
       /** linkedin_message: what to do when the invite is still pending. */
       linkedinMessageMode?: "skip_if_not_connected" | "wait_until_connected";

package/campaign.ts

@@ -1342,7 +1342,7 @@ async function runGet(ctx: CampaignCliContext): Promise<void> {
     );
   }
   lines.push(
-    `  Replied     ${a.replied ?? 0}  (${pct(a.replyRate)} of enrolled)`,
+    `  Replied     ${a.replied ?? 0}  (${pct(a.replyRate)} of contacted)`,
   );
   lines.push(
     `  Done        finished ${a.finished ?? 0} · stopped ${a.stopped ?? 0} · failed ${a.failed ?? 0}`,

package/crm.ts

@@ -4654,10 +4654,10 @@ Sidebar (progressive disclosure — Library + home Pinned strip; layout is WORKS
       and a row inside a group is pulled out to the top level. This
       does NOT add a home-level tab. Nav ids come from 'sidebar list'
       — e.g. 'crm-object:task', 'crm-view:task:Due%20today',
-      'crm-people', 'group:abc123'. To-Do(s), Automations, Inbox,
-      Meetings, Outreach, and Library are fixed home-level tabs, not
-      Library rows. ADMIN-ONLY: the Library order is shared by every
-      member.
+      'crm-people', 'group:abc123'. To-Do(s), Automations, Meetings,
+      Outreach (with Inbox inside it), and Library are fixed home-level
+      tabs, not Library rows. ADMIN-ONLY: the Library order is shared by
+      every member.
   dench crm sidebar group create <name>
       New named group (e.g. "Hiring") at the bottom of the Library.
       Open to any member; prints the group id.
@@ -4670,8 +4670,8 @@ Sidebar (progressive disclosure — Library + home Pinned strip; layout is WORKS
       Move a row out of its group, back to the top level.
   dench crm sidebar pin <nav-id> | unpin <nav-id>
       Pin/unpin a Library row — or a whole group (group id) — on the
-      home Pinned strip (under To-Do(s)/Automations/Inbox/Meetings/
-      Outreach/Library). This is "add a tab on the left". A pin is a
+      home Pinned strip (under To-Do(s)/Automations/Meetings/Outreach/
+      Library). This is "add a tab on the left". A pin is a
       shared shortcut, not a Library move; open to any member.
 
 Fields (columns):

package/lib/api-schemas.ts

@@ -449,7 +449,7 @@ const campaignStepInput = z
       .string()
       .optional()
       .describe(
-        "linkedin_connection: the invite note (optional); linkedin_message: the message (up to 3000 chars).",
+        "linkedin_connection: the invite note (optional, up to 300 chars; sent without it if LinkedIn refuses the note); linkedin_message: the message (up to 3000 chars).",
       ),
     linkedinMessageMode: z
       .enum(["skip_if_not_connected", "wait_until_connected"])

package/lib/enrichment-gateway.ts

@@ -143,6 +143,62 @@ export type SearchJobsBody = {
   pageToken?: string;
 };
 
+export type SignalKind =
+  | "post_engagement"
+  | "keyword"
+  | "hiring"
+  | "funding"
+  | "launch"
+  | "new_leader";
+
+export type SearchSignalsBody = {
+  signal: SignalKind;
+  titles?: string[];
+  market?: string;
+  locations?: string[];
+  headcountRanges?: string[];
+  excludeDomains?: string[];
+  excludeCompanies?: string[];
+  postedAfter: string;
+  limit?: number;
+  terms?: string[];
+  recency?: "week" | "month";
+  mode?: "search" | "volume";
+};
+
+export type SignalRow = {
+  signal: SignalKind;
+  companyName: string;
+  companyDomain: string;
+  companyLinkedinUrl?: string;
+  headline: string;
+  occurredAt?: string;
+  detail: {
+    jobTitles?: string[];
+    jobCount?: number;
+    jobUrl?: string;
+    role?: string;
+    roundType?: string;
+    amount?: string;
+    product?: string;
+    sourceUrl?: string;
+    personName?: string;
+    personTitle?: string;
+    personLinkedinUrl?: string;
+    term?: string;
+    postUrl?: string;
+    postText?: string;
+    engagement?: "reaction" | "comment" | "post";
+  };
+};
+
+export type SearchSignalsResponse = {
+  signals: SignalRow[];
+  creditsCharged: number;
+  volume?: { term: string; count: number; saturated?: true }[];
+  metadata?: { warnings?: string[] };
+};
+
 /**
  * FullEnrich hard cases run 40–120s end to end; a 90s budget produced
  * spurious "No data returned" failures for jobs that later completed (and
@@ -256,6 +312,7 @@ export type ApolloPersonEnvelope = {
     email?: string;
     work_email?: string;
     personal_email?: string;
+    photo_url?: string;
     linkedin_url?: string;
     title?: string;
     headline?: string;
@@ -276,6 +333,7 @@ export type ApolloPersonEnvelope = {
 };
 
 type EnrichedPersonUpsertLike = {
+  avatarUrl?: string;
   searchMatch?: {
     derivedFields: string[];
     basis: "current_title" | "employment_title";
@@ -316,6 +374,7 @@ function shapePersonToApolloEnvelope(
       email: workEmail ?? anyEmail,
       work_email: workEmail,
       personal_email: personalEmail,
+      photo_url: u.avatarUrl,
       linkedin_url: u.linkedinID
         ? `https://www.linkedin.com/in/${u.linkedinID}`
         : undefined,
@@ -1541,6 +1600,125 @@ export async function searchJobs(
   });
 }
 
+export async function searchSignals(
+  body: SearchSignalsBody,
+  options: EnrichmentGatewayOptions = {},
+): Promise<SearchSignalsResponse> {
+  const payload: Record<string, unknown> = {
+    signal: body.signal,
+    postedAfter: body.postedAfter,
+  };
+  if (body.titles?.length) payload.titles = body.titles;
+  if (body.locations?.length) payload.locations = body.locations;
+  if (body.market) payload.market = body.market;
+  if (body.headcountRanges?.length)
+    payload.headcountRanges = body.headcountRanges;
+  if (body.excludeDomains?.length) payload.excludeDomains = body.excludeDomains;
+  if (body.excludeCompanies?.length)
+    payload.excludeCompanies = body.excludeCompanies;
+  if (body.limit !== undefined) payload.limit = body.limit;
+  if (body.terms?.length) payload.terms = body.terms;
+  if (body.recency) payload.recency = body.recency;
+  if (body.mode) payload.mode = body.mode;
+  return (await callGatewayJson("/v1/enrichment/signals/search", {
+    method: "POST",
+    body: payload,
+    options: {
+      ...options,
+      signal: withTimeout(
+        options.signal,
+        body.mode === "volume"
+          ? SIGNAL_GATEWAY_TIMEOUTS_MS.volume
+          : SIGNAL_GATEWAY_TIMEOUTS_MS.search,
+      ),
+    },
+  })) as SearchSignalsResponse;
+}
+
+export const SIGNAL_GATEWAY_TIMEOUTS_MS = {
+  search: 140_000,
+  volume: 75_000,
+  buyer: 75_000,
+  reveal: 75_000,
+} as const;
+
+function withTimeout(signal: AbortSignal | undefined, ms: number): AbortSignal {
+  const timeout = AbortSignal.timeout(ms);
+  return signal && typeof AbortSignal.any === "function"
+    ? AbortSignal.any([signal, timeout])
+    : (signal ?? timeout);
+}
+
+export type SignalBuyerBody = {
+  companyDomain: string;
+  titles?: string[];
+  withEmail?: boolean;
+};
+
+export type SignalBuyer = {
+  name: string;
+  firstName?: string;
+  title?: string;
+  linkedinUrl?: string;
+  email?: string;
+};
+
+export type SignalBuyerResponse = {
+  buyer: SignalBuyer | null;
+  reveal?: "found" | "not_found" | "failed";
+};
+
+export type SignalPersonRevealBody = {
+  companyDomain: string;
+  person: {
+    name: string;
+    linkedinUrl: string;
+    title?: string;
+    firstName?: string;
+  };
+};
+
+export async function findSignalBuyer(
+  body: SignalBuyerBody,
+  options: EnrichmentGatewayOptions = {},
+): Promise<SignalBuyerResponse> {
+  const payload: Record<string, unknown> = {
+    companyDomain: body.companyDomain,
+  };
+  if (body.titles?.length) payload.titles = body.titles;
+  if (body.withEmail !== undefined) payload.withEmail = body.withEmail;
+  return (await callGatewayJson("/v1/enrichment/signals/buyer", {
+    method: "POST",
+    body: payload,
+    options: {
+      ...options,
+      signal: withTimeout(options.signal, SIGNAL_GATEWAY_TIMEOUTS_MS.buyer),
+    },
+  })) as SignalBuyerResponse;
+}
+
+export async function revealSignalPersonEmail(
+  body: SignalPersonRevealBody,
+  options: EnrichmentGatewayOptions = {},
+): Promise<SignalBuyerResponse> {
+  return (await callGatewayJson("/v1/enrichment/signals/buyer", {
+    method: "POST",
+    body: {
+      companyDomain: body.companyDomain,
+      person: {
+        name: body.person.name,
+        linkedinUrl: body.person.linkedinUrl,
+        ...(body.person.title ? { title: body.person.title } : {}),
+        ...(body.person.firstName ? { firstName: body.person.firstName } : {}),
+      },
+    },
+    options: {
+      ...options,
+      signal: withTimeout(options.signal, SIGNAL_GATEWAY_TIMEOUTS_MS.reveal),
+    },
+  })) as SignalBuyerResponse;
+}
+
 /**
  * Number of Exa candidates to pull when resolving ONE person for enrichment.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dench.com/cli",
-  "version": "3.5.3-staging.333",
+  "version": "3.5.5-staging.342",
   "description": "Dench agent workspace CLI.",
   "type": "module",
   "bin": {