@dench.com/cli 3.8.2-staging.391 → 3.8.3-staging.398

package/app-sdk.d.ts

@@ -413,6 +413,8 @@ export interface ApiRequests {
     status?: "active" | "paused";
     cadence?: "daily" | "weekly" | "monthly";
     findMoreMatching?: boolean;
+    /** auto: new people a signal finds start the sequence on their own. manual: they wait for approval. */
+    approvalMode?: "auto" | "manual";
     targeting?: {
       titles: string[];
       locations: string[];
@@ -420,22 +422,45 @@ export interface ApiRequests {
       industries: string[];
       excludes: string[];
       companies?: string[];
+      companyTypes?: string[];
     };
     signal?: {
-      signal: "post_engagement" | "keyword" | "hiring" | "funding" | "launch" | "new_leader";
+      signal: "post_engagement" | "keyword" | "hiring" | "funding" | "launch" | "new_leader" | "voice_engagement" | "company_engagement" | "brand_engagement" | "lookalike";
       enabled: boolean;
     };
     terms?: {
-      signal: "post_engagement" | "keyword" | "hiring";
+      signal: "post_engagement" | "keyword" | "hiring" | "voice_engagement" | "company_engagement" | "brand_engagement";
       values: string[];
     };
   };
   /** Preview a signal source using its current audience. Provider credits may apply; does not enroll people. — `dench campaign sources preview` — POST /api/v1/campaigns/{sequenceId}/sources/preview */
   "campaigns.sources.preview": {
     sequenceId: string;
-    signal: "post_engagement" | "keyword" | "hiring" | "funding" | "launch" | "new_leader";
+    signal: "post_engagement" | "keyword" | "hiring" | "funding" | "launch" | "new_leader" | "voice_engagement" | "company_engagement" | "brand_engagement" | "lookalike";
     terms?: string[];
   };
+  /** Run a live campaign's signals now instead of waiting for the schedule (Run now). Provider credits apply; limited to 6 runs an hour. — `dench campaign sources run` — POST /api/v1/campaigns/{sequenceId}/sources/run */
+  "campaigns.sources.run": {
+    sequenceId: string;
+  };
+  /** Read the Sources tab: each signal's status, last and next run, people found and anything needing attention. — `dench campaign sources overview` — GET /api/v1/campaigns/{sequenceId}/sources/overview */
+  "campaigns.sources.overview": {
+    sequenceId: string;
+  };
+  /** List people a signal found who are waiting for approval (manual approval mode). — `dench campaign sources pending` — GET /api/v1/campaigns/{sequenceId}/sources/pending */
+  "campaigns.sources.pending": {
+    sequenceId: string;
+  };
+  /** Approve people waiting for review (they start the sequence) or reject them. — `dench campaign sources approve|reject` — POST /api/v1/campaigns/{sequenceId}/sources/review */
+  "campaigns.sources.review": {
+    sequenceId: string;
+    enrollmentIds: string[];
+    decision: "approve" | "reject";
+  };
+  /** Today's queue: who the campaign plans to contact today, warmest first, within the senders' limits. — `dench campaign queue` — GET /api/v1/campaigns/{sequenceId}/queue */
+  "campaigns.queue": {
+    sequenceId: string;
+  };
   /** Read the company profile and suggested campaign audience. — `dench campaign builder profile` — GET /api/v1/campaigns/builder/profile */
   "campaigns.builder.profile": Record<string, unknown>;
   /** Save a signal campaign's audience, signals and terms idempotently. Does not start a build. — `dench campaign builder save` — POST /api/v1/campaigns/builder/drafts */
@@ -449,12 +474,52 @@ export interface ApiRequests {
       industries: string[];
       excludes: string[];
       companies?: string[];
+      companyTypes?: string[];
     };
-    signals: Array<"post_engagement" | "keyword" | "hiring" | "funding" | "launch" | "new_leader">;
+    signals: Array<"post_engagement" | "keyword" | "hiring" | "funding" | "launch" | "new_leader" | "voice_engagement" | "company_engagement" | "brand_engagement" | "lookalike">;
     signalTerms?: {
+      /** Post topics, phrased as what the buyer does ("using AI for outbound"), not bare product names. */
       post_engagement?: string[];
       keyword?: string[];
+      /** Roles being hired for. */
       hiring?: string[];
+      /** LinkedIn profile URLs of market voices whose posts to watch. */
+      voice_engagement?: string[];
+      /** LinkedIn company page URLs of companies and competitors. */
+      company_engagement?: string[];
+      /** The sender's own LinkedIn company page URL. */
+      brand_engagement?: string[];
+      /** Topic signals searched by their exact keywords only (no drafted phrases). */
+      exact?: Array<"post_engagement" | "keyword">;
+    };
+    /** Also add people who match the audience without a signal. */
+    findMoreMatching?: boolean;
+    name?: string;
+    /** How people come in: buying signals, people like one best lead, a pasted list or CSV, CRM records, or a people search. */
+    source?: "signals" | "lookalike" | "existing" | "crm" | "search";
+    screen?: "source" | "signals" | "lookalike" | "target" | "messages" | "outreach" | "review";
+    /** For source lookalike: the edited result of builder lookalike, with signals ["lookalike"]. */
+    lookalike?: {
+      seed: {
+        name: string;
+        linkedinUrl: string;
+        title?: string;
+        companyName?: string;
+        companyDomain?: string;
+        avatarUrl?: string;
+      };
+      title: string;
+      similarRoles: boolean;
+      roles: string[];
+      location?: string;
+      industry?: string;
+      relatedIndustries: boolean;
+      industries: string[];
+      companySizes: string[];
+      companies: {
+        name: string;
+        domain: string;
+      }[];
     };
   };
   /** Read signal build progress, preview people, messages and errors. — `dench campaign builder get` — GET /api/v1/campaigns/builder/drafts/{draftId} */
@@ -470,6 +535,8 @@ export interface ApiRequests {
     draftId: string;
     name?: string;
     timezone?: string;
+    /** Save paused: signals wait to run until launch. */
+    paused?: boolean;
   };
   /** Edit or reset one preview person's opening line before creating the campaign. — `dench campaign builder opener` — PUT /api/v1/campaigns/builder/drafts/{draftId}/people/{leadId}/opener */
   "campaigns.builder.opener": {
@@ -477,21 +544,98 @@ export interface ApiRequests {
     leadId: string;
     opener: string;
   };
+  /** List saved, unfinished campaign drafts that can be resumed. — `dench campaign builder drafts` — GET /api/v1/campaigns/builder/drafts */
+  "campaigns.builder.drafts": Record<string, unknown>;
+  /** Read a saved draft's setup (source, name, targeting, signals, terms, lookalike) to resume it. — `dench campaign builder resume` — GET /api/v1/campaigns/builder/drafts/{draftId}/setup */
+  "campaigns.builder.resume": {
+    draftId: string;
+  };
+  /** Discard a saved draft that has not become a campaign. — `dench campaign builder discard` — DELETE /api/v1/campaigns/builder/drafts/{draftId} */
+  "campaigns.builder.discard": {
+    draftId: string;
+  };
+  /** Save a draft's Outreach and Review choices: AI or manual steps, the brief, the steps, who sends and when, and auto or manual approval. — `dench campaign builder outreach` — PATCH /api/v1/campaigns/builder/drafts/{draftId}/outreach */
+  "campaigns.builder.outreach": {
+    draftId: string;
+    /** ai: generate the sequence from the brief. manual: write steps. */
+    outreachMode?: "ai" | "manual";
+    brief?: {
+      /** What a reply should lead to, e.g. a demo. */
+      goal: string;
+      /** The problem the product solves for them. */
+      helpWith: string;
+      tone: "conversational" | "warm" | "direct" | "formal";
+      channels: "both" | "email" | "linkedin";
+    };
+    steps?: Array<{
+      type: "email" | "wait" | "linkedin_connection" | "linkedin_message";
+      waitHours?: number;
+      emailSubject?: string;
+      emailTextBody?: string;
+      emailReplyToPrevious?: boolean;
+      onlyIf?: "always" | "connected" | "not_connected";
+      linkedinMessageBody?: string;
+      linkedinMessageMode?: "skip_if_not_connected" | "wait_until_connected";
+      connectionTimeoutHours?: number;
+    }>;
+    sending?: {
+      emailMailboxAccountIds: string[];
+      linkedinAccountIds: string[];
+      timezone: string;
+      startHour: number;
+      endHour: number;
+      /** 0 is Sunday, 6 is Saturday. */
+      weekdays: number[];
+      dailySendCap?: number;
+    };
+    /** auto: new people a signal finds start the sequence on their own. manual: they wait for approval. */
+    approvalMode?: "auto" | "manual";
+  };
+  /** Generate the draft's sequence from a brief (goal, problem, tone, channels), as Generate sequence does. AI credits apply. — `dench campaign builder sequence` — POST /api/v1/campaigns/builder/drafts/{draftId}/sequence */
+  "campaigns.builder.sequence": {
+    draftId: string;
+    brief: {
+      /** What a reply should lead to, e.g. a demo. */
+      goal: string;
+      /** The problem the product solves for them. */
+      helpWith: string;
+      tone: "conversational" | "warm" | "direct" | "formal";
+      channels: "both" | "email" | "linkedin";
+    };
+  };
+  /** Set up a lookalike from the best lead's LinkedIn URL (role, similar roles, place, industry, similar companies), suggest roles again, or re-scope to a company. Nothing is saved. Provider credits apply. — `dench campaign builder lookalike` — POST /api/v1/campaigns/builder/lookalike */
+  "campaigns.builder.lookalike": {
+    /** The best lead's LinkedIn profile URL. */
+    linkedinUrl?: string;
+    /** Suggest similar roles and related industries again. */
+    suggest?: {
+      title: string;
+      industry?: string;
+    };
+    /** Re-scope the lookalike to a different company. */
+    rescope?: {
+      seed: {
+        name: string;
+        linkedinUrl: string;
+        title?: string;
+        companyName?: string;
+        companyDomain?: string;
+        avatarUrl?: string;
+      };
+      company: string;
+      title?: string;
+      location?: string;
+    };
+  };
+  /** Suggest market voices (LinkedIn experts) for the campaign's topics, to watch with voice_engagement. AI credits apply. — `dench campaign builder voices` — POST /api/v1/campaigns/builder/voices */
+  "campaigns.builder.voices": {
+    topics?: string[];
+    market?: string;
+  };
   /** Turn an audience description into targeting filters. AI credits apply. — `dench campaign builder autofill` — POST /api/v1/campaigns/builder/autofill */
   "campaigns.builder.autofill": {
     description: string;
   };
-  /** Suggest signal terms for the selected audience. AI credits apply. — `dench campaign builder terms` — POST /api/v1/campaigns/builder/terms */
-  "campaigns.builder.terms": {
-    targeting: {
-      titles: string[];
-      locations: string[];
-      companySizes: string[];
-      industries: string[];
-      excludes: string[];
-      companies?: string[];
-    };
-  };
   /** Estimate audience or weekly signal volume using the UI's cached estimator. Provider credits may apply. — `dench campaign builder estimate` — POST /api/v1/campaigns/builder/estimate */
   "campaigns.builder.estimate": {
     kind: "people" | "week";
@@ -502,12 +646,23 @@ export interface ApiRequests {
       industries: string[];
       excludes: string[];
       companies?: string[];
+      companyTypes?: string[];
     };
-    signals?: Array<"post_engagement" | "keyword" | "hiring" | "funding" | "launch" | "new_leader">;
+    signals?: Array<"post_engagement" | "keyword" | "hiring" | "funding" | "launch" | "new_leader" | "voice_engagement" | "company_engagement" | "brand_engagement" | "lookalike">;
     signalTerms?: {
+      /** Post topics, phrased as what the buyer does ("using AI for outbound"), not bare product names. */
       post_engagement?: string[];
       keyword?: string[];
+      /** Roles being hired for. */
       hiring?: string[];
+      /** LinkedIn profile URLs of market voices whose posts to watch. */
+      voice_engagement?: string[];
+      /** LinkedIn company page URLs of companies and competitors. */
+      company_engagement?: string[];
+      /** The sender's own LinkedIn company page URL. */
+      brand_engagement?: string[];
+      /** Topic signals searched by their exact keywords only (no drafted phrases). */
+      exact?: Array<"post_engagement" | "keyword">;
     };
   };
   /** List all CLI/API operations and parity classifications. — `dench help` — GET /api/v1/commands */
@@ -3535,6 +3690,11 @@ export interface ApiResponses {
     ok: boolean;
     [key: string]: unknown;
   };
+  "campaigns.sources.run": null;
+  "campaigns.sources.overview": Record<string, unknown>;
+  "campaigns.sources.pending": Record<string, unknown>[];
+  "campaigns.sources.review": Record<string, unknown>;
+  "campaigns.queue": Record<string, unknown> | null;
   "campaigns.builder.profile": {
     hasProfile: boolean;
     targeting: {
@@ -3544,6 +3704,7 @@ export interface ApiResponses {
       industries: string[];
       excludes: string[];
       companies?: string[];
+      companyTypes?: string[];
     };
     [key: string]: unknown;
   };
@@ -3559,8 +3720,9 @@ export interface ApiResponses {
       industries: string[];
       excludes: string[];
       companies?: string[];
+      companyTypes?: string[];
     };
-    signals: Array<"post_engagement" | "keyword" | "hiring" | "funding" | "launch" | "new_leader">;
+    signals: Array<"post_engagement" | "keyword" | "hiring" | "funding" | "launch" | "new_leader" | "voice_engagement" | "company_engagement" | "brand_engagement" | "lookalike">;
     people: Record<string, unknown>[];
     [key: string]: unknown;
   };
@@ -3573,7 +3735,10 @@ export interface ApiResponses {
     enrolled: number;
   };
   "campaigns.builder.opener": null;
-  "campaigns.builder.autofill": {
+  "campaigns.builder.drafts": Record<string, unknown>[];
+  "campaigns.builder.resume": {
+    clientRequestId: string;
+    status: string;
     targeting: {
       titles: string[];
       locations: string[];
@@ -3581,14 +3746,25 @@ export interface ApiResponses {
       industries: string[];
       excludes: string[];
       companies?: string[];
+      companyTypes?: string[];
     };
+    signals: Array<"post_engagement" | "keyword" | "hiring" | "funding" | "launch" | "new_leader" | "voice_engagement" | "company_engagement" | "brand_engagement" | "lookalike">;
     [key: string]: unknown;
-  };
-  "campaigns.builder.terms": {
-    signalTerms: {
-      post_engagement?: string[];
-      keyword?: string[];
-      hiring?: string[];
+  } | null;
+  "campaigns.builder.discard": null;
+  "campaigns.builder.outreach": null;
+  "campaigns.builder.sequence": Record<string, unknown>;
+  "campaigns.builder.lookalike": Record<string, unknown>;
+  "campaigns.builder.voices": Record<string, unknown>;
+  "campaigns.builder.autofill": {
+    targeting: {
+      titles: string[];
+      locations: string[];
+      companySizes: string[];
+      industries: string[];
+      excludes: string[];
+      companies?: string[];
+      companyTypes?: string[];
     };
     [key: string]: unknown;
   };
@@ -7880,18 +8056,30 @@ export type DenchApiTree = {
       build(args: Req<"campaigns.builder.build">): Promise<Res<"campaigns.builder.build">>;
       /** Create a campaign from a reviewed signal draft. Does not launch the campaign. (`dench campaign builder create`) */
       create(args: Req<"campaigns.builder.create">): Promise<Res<"campaigns.builder.create">>;
+      /** Discard a saved draft that has not become a campaign. (`dench campaign builder discard`) */
+      discard(args: Req<"campaigns.builder.discard">): Promise<Res<"campaigns.builder.discard">>;
+      /** List saved, unfinished campaign drafts that can be resumed. (`dench campaign builder drafts`) */
+      drafts(args?: Req<"campaigns.builder.drafts">): Promise<Res<"campaigns.builder.drafts">>;
       /** Estimate audience or weekly signal volume using the UI's cached estimator. Provider credits may apply. (`dench campaign builder estimate`) */
       estimate(args: Req<"campaigns.builder.estimate">): Promise<Res<"campaigns.builder.estimate">>;
       /** Read signal build progress, preview people, messages and errors. (`dench campaign builder get`) */
       get(args: Req<"campaigns.builder.get">): Promise<Res<"campaigns.builder.get">>;
+      /** Set up a lookalike from the best lead's LinkedIn URL (role, similar roles, place, industry, similar companies), suggest roles again, or re-scope to a company. Nothing is saved. Provider credits apply. (`dench campaign builder lookalike`) */
+      lookalike(args: Req<"campaigns.builder.lookalike">): Promise<Res<"campaigns.builder.lookalike">>;
       /** Edit or reset one preview person's opening line before creating the campaign. (`dench campaign builder opener`) */
       opener(args: Req<"campaigns.builder.opener">): Promise<Res<"campaigns.builder.opener">>;
+      /** Save a draft's Outreach and Review choices: AI or manual steps, the brief, the steps, who sends and when, and auto or manual approval. (`dench campaign builder outreach`) */
+      outreach(args: Req<"campaigns.builder.outreach">): Promise<Res<"campaigns.builder.outreach">>;
       /** Read the company profile and suggested campaign audience. (`dench campaign builder profile`) */
       profile(args?: Req<"campaigns.builder.profile">): Promise<Res<"campaigns.builder.profile">>;
+      /** Read a saved draft's setup (source, name, targeting, signals, terms, lookalike) to resume it. (`dench campaign builder resume`) */
+      resume(args: Req<"campaigns.builder.resume">): Promise<Res<"campaigns.builder.resume">>;
       /** Save a signal campaign's audience, signals and terms idempotently. Does not start a build. (`dench campaign builder save`) */
       save(args: Req<"campaigns.builder.save">): Promise<Res<"campaigns.builder.save">>;
-      /** Suggest signal terms for the selected audience. AI credits apply. (`dench campaign builder terms`) */
-      terms(args: Req<"campaigns.builder.terms">): Promise<Res<"campaigns.builder.terms">>;
+      /** Generate the draft's sequence from a brief (goal, problem, tone, channels), as Generate sequence does. AI credits apply. (`dench campaign builder sequence`) */
+      sequence(args: Req<"campaigns.builder.sequence">): Promise<Res<"campaigns.builder.sequence">>;
+      /** Suggest market voices (LinkedIn experts) for the campaign's topics, to watch with voice_engagement. AI credits apply. (`dench campaign builder voices`) */
+      voices(args: Req<"campaigns.builder.voices">): Promise<Res<"campaigns.builder.voices">>;
     };
     /** Create a draft outreach campaign with email and LinkedIn sender pools and a business-hours send window in the given timezone. (`dench campaign create`) */
     create(args: Req<"campaigns.create">): Promise<Res<"campaigns.create">>;
@@ -7966,13 +8154,23 @@ export type DenchApiTree = {
     pipeline(args: Req<"campaigns.pipeline">): Promise<Res<"campaigns.pipeline">>;
     /** 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. (`dench campaign preview`) */
     preview(args: Req<"campaigns.preview">): Promise<Res<"campaigns.preview">>;
+    /** Today's queue: who the campaign plans to contact today, warmest first, within the senders' limits. (`dench campaign queue`) */
+    queue(args: Req<"campaigns.queue">): Promise<Res<"campaigns.queue">>;
     /** Resume a paused campaign. (`dench campaign resume`) */
     resume(args: Req<"campaigns.resume">): Promise<Res<"campaigns.resume">>;
     sources: {
       /** Read a campaign's saved signal source, targeting and schedule. (`dench campaign sources get`) */
       get(args: Req<"campaigns.sources.get">): Promise<Res<"campaigns.sources.get">>;
+      /** Read the Sources tab: each signal's status, last and next run, people found and anything needing attention. (`dench campaign sources overview`) */
+      overview(args: Req<"campaigns.sources.overview">): Promise<Res<"campaigns.sources.overview">>;
+      /** List people a signal found who are waiting for approval (manual approval mode). (`dench campaign sources pending`) */
+      pending(args: Req<"campaigns.sources.pending">): Promise<Res<"campaigns.sources.pending">>;
       /** Preview a signal source using its current audience. Provider credits may apply; does not enroll people. (`dench campaign sources preview`) */
       preview(args: Req<"campaigns.sources.preview">): Promise<Res<"campaigns.sources.preview">>;
+      /** Approve people waiting for review (they start the sequence) or reject them. (`dench campaign sources approve|reject`) */
+      review(args: Req<"campaigns.sources.review">): Promise<Res<"campaigns.sources.review">>;
+      /** Run a live campaign's signals now instead of waiting for the schedule (Run now). Provider credits apply; limited to 6 runs an hour. (`dench campaign sources run`) */
+      run(args: Req<"campaigns.sources.run">): Promise<Res<"campaigns.sources.run">>;
       /** Read signal choices, suggested terms and current source configuration. (`dench campaign sources signals`) */
       signals(args: Req<"campaigns.sources.signals">): Promise<Res<"campaigns.sources.signals">>;
       /** Update source cadence, pause/resume, targeting, signals or terms. Active sources may perform billable future work. (`dench campaign sources set`) */
@@ -9152,8 +9350,28 @@ export interface DenchCampaigns {
   setDraftOpener(opts: Req<"campaigns.builder.opener">): Promise<Res<"campaigns.builder.opener">>;
   /** Translate a description into targeting. AI credits apply. Permission: `campaigns:write`. Wraps `campaigns.builder.autofill`. */
   autofill(opts: Req<"campaigns.builder.autofill">): Promise<Res<"campaigns.builder.autofill">>;
-  /** Suggest signal terms. AI credits apply. Permission: `campaigns:write`. Wraps `campaigns.builder.terms`. */
-  suggestTerms(opts: Req<"campaigns.builder.terms">): Promise<Res<"campaigns.builder.terms">>;
+  /** List saved, unfinished campaign drafts. Permission: `campaigns:read`. Wraps `campaigns.builder.drafts`. */
+  savedDrafts(): Promise<Res<"campaigns.builder.drafts">>;
+  /** Read a saved draft's setup to resume it. Permission: `campaigns:read`. Wraps `campaigns.builder.resume`. */
+  resumeDraft(draftId: string): Promise<Res<"campaigns.builder.resume">>;
+  /** Discard a saved draft. Permission: `campaigns:write`. Wraps `campaigns.builder.discard`. */
+  discardDraft(draftId: string): Promise<Res<"campaigns.builder.discard">>;
+  /** Save a draft's steps, brief, senders, schedule and approval mode. Permission: `campaigns:write`. Wraps `campaigns.builder.outreach`. */
+  saveOutreach(opts: Req<"campaigns.builder.outreach">): Promise<Res<"campaigns.builder.outreach">>;
+  /** Generate a draft's sequence from a brief. AI credits apply. Permission: `campaigns:write`. Wraps `campaigns.builder.sequence`. */
+  generateSequence(opts: Req<"campaigns.builder.sequence">): Promise<Res<"campaigns.builder.sequence">>;
+  /** Set up a lookalike from a best lead's LinkedIn URL. Provider credits apply. Permission: `campaigns:write`. Wraps `campaigns.builder.lookalike`. */
+  lookalike(opts: Req<"campaigns.builder.lookalike">): Promise<Res<"campaigns.builder.lookalike">>;
+  /** Suggest LinkedIn experts to watch for the topics. AI credits apply. Permission: `campaigns:write`. Wraps `campaigns.builder.voices`. */
+  suggestVoices(opts: Req<"campaigns.builder.voices">): Promise<Res<"campaigns.builder.voices">>;
+  /** Run a live campaign's signals now. Provider credits apply. Permission: `campaigns:write`. Wraps `campaigns.sources.run`. */
+  runSources(sequenceId: string): Promise<Res<"campaigns.sources.run">>;
+  /** People a signal found who wait for approval. Permission: `campaigns:read`. Wraps `campaigns.sources.pending`. */
+  pendingReview(sequenceId: string): Promise<Res<"campaigns.sources.pending">>;
+  /** Approve or reject people waiting for review. Permission: `campaigns:write`. Wraps `campaigns.sources.review`. */
+  reviewPeople(opts: Req<"campaigns.sources.review">): Promise<Res<"campaigns.sources.review">>;
+  /** Who the campaign plans to contact today. Permission: `campaigns:read`. Wraps `campaigns.queue`. */
+  todayQueue(sequenceId: string): Promise<Res<"campaigns.queue">>;
   /** Estimate audience or signal volume. Permission: `campaigns:write`. Wraps `campaigns.builder.estimate`. */
   estimate(opts: Req<"campaigns.builder.estimate">): Promise<Res<"campaigns.builder.estimate">>;
   /** Mailboxes campaigns can send from, with warm-up and daily cap. Permission: `campaigns:read`. Wraps `campaigns.accounts.email`. */

package/campaign.ts

@@ -4176,6 +4176,7 @@ async function runAccounts(ctx: CampaignCliContext): Promise<void> {
 
 const SUBCOMMAND_ALIASES: Record<string, string> = {
   ls: "list",
+  today: "queue",
   new: "create",
   status: "get",
   show: "get",
@@ -4308,20 +4309,38 @@ Personalized lines (written by AI for each person, about 3 cents a person; up to
   dench campaign personalize rewrite <campaign> --person <enrollmentId|name> [--line <key>]   # a fresh line for one person
   dench campaign personalize clear <campaign>                 # turn lines off (take the {{keys}} out of the steps first)
 
-Signal builder and sources:
-  dench campaign builder profile
-  dench campaign builder save --file draft.json
+Campaign builder (the app's New campaign flow; references/CAMPAIGNS.md walks it):
+  dench campaign builder profile                    # workspace ICP, suggested targeting, signals and terms, connected senders
+  dench campaign builder autofill --description "VP Sales at US software companies"   # description -> targeting
+  dench campaign builder estimate --file estimate.json   # {"kind":"people"|"week","targeting":{...},"signals":[...]}
+  dench campaign builder lookalike --linkedin-url <best lead's LinkedIn URL>   # lookalike setup to edit; also --data '{"suggest":{...}}'|'{"rescope":{...}}'
+  dench campaign builder voices --topics "AI for sales,outbound" [--market "..."]   # LinkedIn experts to watch
+  dench campaign builder save --file draft.json     # source, name, targeting, signals, signalTerms, findMoreMatching, lookalike
+  dench campaign builder build <draftId>            # finds the first people and writes messages; poll builder get
   dench campaign builder get <draftId>
-  dench campaign builder build <draftId>
-  dench campaign builder create <draftId> [--name "New campaign"] [--timezone <tz>]
   dench campaign builder opener <draftId> <leadId> --text "Opening line"
-  dench campaign builder autofill --description "VP Sales at US software companies"
-  dench campaign builder terms --file targeting.json
-  dench campaign builder estimate --file estimate.json
+  dench campaign builder sequence <draftId> --goal "Book a demo" --help-with "..." [--tone conversational|warm|direct|formal] [--channels both|email|linkedin]
+  dench campaign builder outreach <draftId> --file outreach.json [--mode ai|manual] [--approval auto|manual]
+      outreach.json: {"brief":{...},"steps":[...],"sending":{"emailMailboxAccountIds":[],"linkedinAccountIds":[],
+      "timezone":"America/New_York","startHour":9,"endHour":17,"weekdays":[1,2,3,4,5],"dailySendCap":30}}
+  dench campaign builder create <draftId> [--name "New campaign"] [--timezone <tz>] [--paused]
+  dench campaign builder drafts                     # saved drafts that were never created
+  dench campaign builder resume <draftId>           # a saved draft's setup
+  dench campaign builder discard <draftId>
+
+Signals on a campaign (the Sources tab):
+  dench campaign sources overview <campaign>        # each signal's status, last and next run, people found, problems
   dench campaign sources get <campaign>
   dench campaign sources signals <campaign>
-  dench campaign sources set <campaign> --data '{"cadence":"weekly"}'
+  dench campaign sources set <campaign> --data '{"cadence":"weekly"}' [--approval auto|manual]
+      Also: status active|paused, findMoreMatching, targeting, {"signal":{"signal":"hiring","enabled":true}},
+      {"terms":{"signal":"post_engagement","values":["..."]}}. One change per call is safest.
   dench campaign sources preview <campaign> --signal hiring
+  dench campaign sources run <campaign>             # Run now: search the signals now (live campaigns, 6 an hour)
+  dench campaign sources pending <campaign>         # people waiting for approval (manual approval)
+  dench campaign sources approve <campaign> --people <enrollmentId,...>
+  dench campaign sources reject <campaign> --people <enrollmentId,...>
+  dench campaign queue <campaign>                   # who goes out today, warmest first
 
 --filters and --search take the same JSON with every people filter (@file.json
 works) on both search and add. The dench leads find filter flags (--titles,
@@ -4478,7 +4497,10 @@ export async function runCampaignCommand(opts: {
     case "search":
     case "sources":
     case "builder":
+    case "queue":
       return runAgentCommand(ctx, subcommand);
+    case "today":
+      return runAgentCommand(ctx, "queue");
     case "list":
     case "ls":
       return await runList(ctx);