@dench.com/cli 3.8.0-staging.389 → 3.8.2-staging.391

package/ads.ts

@@ -2000,7 +2000,11 @@ async function runWithdrawCommand(opts: {
 // ---------------------------------------------------------------------------
 
 function adsHelp(): void {
-  console.log(`dench ads — monetize the AI "thinking…" line. (aliases: dench ad, dench adline)
+  console.log(adsHelpText());
+}
+
+export function adsHelpText(): string {
+  return `\`dench ads\` — monetize the AI "thinking…" line. (aliases: dench ad, dench adline)
 
 Usage:
   dench ads                 Print the sponsored ad in a decorated rainbow box
@@ -2035,7 +2039,7 @@ Notes:
   • Set DENCH_ADS_ENDPOINT=https://your-server/ads to serve real ads:
     GET returns {id,label,url,icon,iconUrl}; POST {endpoint}/impressions
     takes {events:[{adId,count,flushId}]}.
-`);
+`;
 }
 
 // ---------------------------------------------------------------------------

package/app-sdk.d.ts

@@ -2594,7 +2594,7 @@ export interface ApiRequests {
   "campaigns.get": {
     sequenceId: string;
   };
-  /** Campaign funnel: enrolled, contacted, invited, accepted, messaged, replied, opens and clicks. — `dench campaign get` — GET /api/v1/campaigns/{sequenceId}/analytics */
+  /** Campaign funnel: enrolled, contacted, invited, accepted, messaged, replied, opens and clicks, and for a workflow how many people took each If / else and Wait for them to accept path (branchStats). — `dench campaign get` — GET /api/v1/campaigns/{sequenceId}/analytics */
   "campaigns.analytics": {
     sequenceId: string;
   };
@@ -2643,13 +2643,13 @@ export interface ApiRequests {
     /** Cold emails per day, 1-100. */
     dailySendCap?: number;
   };
-  /** 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. — `dench campaign steps set` — PUT /api/v1/campaigns/{sequenceId}/steps */
+  /** Replace every step of a draft campaign (email, wait, LinkedIn visit, connection request, message, post reaction, InMail, If / else, Wait for them to accept). A workflow (stepModel workflow, or steps with key, next, yesNext or noNext) branches: condition and wait_for_connection steps continue on yesNext or noNext, other steps on next; each points at another step's key or end. Steps are checked first: a field the step type would drop, missing text, {TOKEN} single braces or paths that don't hold together are rejected, not saved. Configure sender pools on the campaign; step sender ids are legacy-only. — `dench campaign steps set` — PUT /api/v1/campaigns/{sequenceId}/steps */
   "campaigns.steps.replace": {
     sequenceId: string;
-    /** Every step, in send order. Rejected, not trimmed: a field the step type would drop (onlyIf off email/post-like steps, a body on a visit, reply-in-thread on the first email), a missing subject or required body, an overlength note/message/InMail subject, out-of-range wait/withdrawal/post-age values, and {TOKEN} single braces, which would be sent as typed. */
+    /** Every step, in send order (a workflow may list them in any order; they are stored in path order). Rejected, not trimmed: a field the step type would drop (onlyIf off email/post-like steps, a body on a visit, reply-in-thread on the first email, condition fields its check ignores), a missing subject or required body, an overlength note/message/InMail subject, out-of-range wait/withdrawal/post-age/acceptance values, {TOKEN} single braces, which would be sent as typed, and workflow paths that don't hold together (duplicate keys, a target that isn't a key or end, a condition or wait_for_connection without both yesNext and noNext, or any other step with them). */
     steps: Array<{
-      /** Step type. */
-      type: "email" | "wait" | "linkedin_visit" | "linkedin_connection" | "linkedin_message" | "linkedin_like_post" | "linkedin_inmail";
+      /** Step type. condition (If / else) and wait_for_connection (Wait for them to accept) send nothing; they continue on yesNext or noNext and make the campaign a workflow. */
+      type: "wait" | "email" | "linkedin_connection" | "linkedin_message" | "linkedin_visit" | "linkedin_like_post" | "linkedin_inmail" | "condition" | "wait_for_connection";
       /** wait steps: hours to wait before the next step. */
       waitHours?: number;
       /** Legacy email step sender. Pool campaigns choose senders in emailMailboxAccountIds on the campaign, not on individual steps. */
@@ -2664,35 +2664,57 @@ export interface ApiRequests {
       emailReplyToPrevious?: boolean;
       /** email and linkedin_like_post only: always (default), connected or not_connected. InMail automatically skips connected people; do not set a condition on it. */
       onlyIf?: "always" | "connected" | "not_connected";
-      /** Legacy LinkedIn step sender. Pool campaigns use the campaign's linkedinAccountIds instead. */
+      /** Legacy LinkedIn step sender (also on wait_for_connection, and on a condition that checks linkedin_connected). Pool campaigns use the campaign's linkedinAccountIds instead. */
       linkedinAccountId?: string;
       /** linkedin_connection: the invite note (optional, up to 300 chars; sent without it if LinkedIn refuses the note); linkedin_message: the required message (up to 3000 chars); linkedin_inmail: the required message (up to 1900 chars). */
       linkedinMessageBody?: string;
       /** linkedin_message: what to do when the invite is still pending. */
       linkedinMessageMode?: "skip_if_not_connected" | "wait_until_connected";
-      /** linkedin_message with linkedinMessageMode=wait_until_connected: wait 1-2160 hours for acceptance (default 720). After a connection step this mode is the default. */
+      /** linkedin_message with linkedinMessageMode=wait_until_connected: wait 1-2160 hours for acceptance (default 720); after a connection step this mode is the default in a linear campaign. wait_for_connection: wait 24-2160 hours (1-90 days, default 720) before taking the Not accepted path. */
       connectionTimeoutHours?: number;
       /** linkedin_like_post only: the reaction to leave (default like). */
       likeReaction?: "like" | "celebrate" | "support" | "love" | "insightful" | "funny";
       /** linkedin_like_post only: select the newest eligible original post from the last 1-365 days (default 30). */
       likeMaxPostAgeDays?: number;
+      /** linkedin_like_post only: before the immediately preceding wait starts, check for eligible posts. If none exist, skip that wait and the like step, keeping following waits. Defaults to false when omitted. */
+      likeSkipPreviousWait?: boolean;
       /** linkedin_like_post only: skip consecutive following wait steps whenever the reaction step is skipped (default true). False keeps those waits. */
       likeSkipNextWait?: boolean;
+      /** linkedin_like_post only: how many recent posts to react to, 1-3 (default 1). */
+      likeCount?: number;
       /** linkedin_inmail only: optional subject, up to 200 characters; merge tokens allowed. Clear with an empty string. */
       inmailSubject?: string;
       /** linkedin_connection only: withdraw a still-pending invitation sent by this campaign after 168-2160 hours (7-90 days). Omitted means off on creation; null turns it off on edit. */
       withdrawAfterHours?: number | null;
+      /** Workflow steps: this step's id, unique in the campaign, which next, yesNext and noNext point at (not "end"). Left out, one is made. */
+      key?: string;
+      /** Workflow steps: where a step that isn't a condition or wait_for_connection goes; left out, the following step: another step's key, or "end" to stop there. Fixed once the campaign launches. */
+      next?: string;
+      /** Workflow steps: condition and wait_for_connection only, required: where the Yes (Accepted) path goes: another step's key, or "end" to stop there. Fixed once the campaign launches. */
+      yesNext?: string;
+      /** Workflow steps: condition and wait_for_connection only, required: where the No (Not accepted) path goes: another step's key, or "end" to stop there. Fixed once the campaign launches. */
+      noNext?: string;
+      /** condition only, required: linkedin_connected, has_email, opened_last_email (needs an email before it on every path) or field_value. Fixed once the campaign launches. */
+      check?: "linkedin_connected" | "has_email" | "opened_last_email" | "field_value";
+      /** condition with check=field_value: the lead field to check, like "Job Title" or "Source" (the campaign itself changes Status, Last touch and LinkedIn connection). Fixed once the campaign launches. */
+      conditionField?: string;
+      /** condition with check=field_value: is, is_not, contains, is_empty or is_not_empty (all case-insensitive). Fixed once the campaign launches. */
+      conditionOperator?: "is" | "is_not" | "is_empty" | "is_not_empty" | "contains";
+      /** condition with check=field_value and is, is_not or contains: the text to compare with. Editable after launch. */
+      conditionValue?: string;
     }>;
+    /** linear: steps run in order. workflow: steps have keys and paths (next, yesNext, noNext) and may include condition and wait_for_connection. Left out, a workflow stays one and steps with keys, paths or those types make one; nothing turns a workflow back into a list. When replacing a workflow's steps, send workflow, so steps without keys or paths are checked here the way they will be saved. */
+    stepModel?: "linear" | "workflow";
     /** Send {single braces} exactly as typed instead of rejecting them. Merge tokens always use {{double braces}}. */
     allowSingleBraces?: boolean;
   };
-  /** 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. — `dench campaign steps edit` — PATCH /api/v1/campaigns/{sequenceId}/steps */
+  /** 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. A workflow keeps its paths and what each If / else checks (key, next, yesNext, noNext, check, conditionField, conditionOperator); conditionValue and acceptance waits stay editable. Messages already sent or being prepared keep their text; drafts use campaigns.steps.replace. — `dench campaign steps edit` — PATCH /api/v1/campaigns/{sequenceId}/steps */
   "campaigns.steps.update": {
     sequenceId: string;
-    /** The steps to change. Rejected, not trimmed: a field the step type would drop, an overlength note/message/InMail subject, out-of-range wait/withdrawal/post-age values, and {TOKEN} single braces. */
+    /** The steps to change. Rejected, not trimmed: a field the step type would drop, an overlength note/message/InMail subject, out-of-range wait/withdrawal/post-age/acceptance values, {TOKEN} single braces, and a changed path or If / else check. */
     steps: Array<{
       /** The step's current type. A launched step's type can't change. */
-      type: "email" | "wait" | "linkedin_visit" | "linkedin_connection" | "linkedin_message" | "linkedin_like_post" | "linkedin_inmail";
+      type: "wait" | "email" | "linkedin_connection" | "linkedin_message" | "linkedin_visit" | "linkedin_like_post" | "linkedin_inmail" | "condition" | "wait_for_connection";
       /** wait steps: hours to wait before the next step. */
       waitHours?: number;
       /** Legacy email step sender. Pool campaigns choose senders in emailMailboxAccountIds on the campaign, not on individual steps. */
@@ -2707,24 +2729,44 @@ export interface ApiRequests {
       emailReplyToPrevious?: boolean;
       /** email and linkedin_like_post only: always (default), connected or not_connected. InMail automatically skips connected people; do not set a condition on it. */
       onlyIf?: "always" | "connected" | "not_connected";
-      /** Legacy LinkedIn step sender. Pool campaigns use the campaign's linkedinAccountIds instead. */
+      /** Legacy LinkedIn step sender (also on wait_for_connection, and on a condition that checks linkedin_connected). Pool campaigns use the campaign's linkedinAccountIds instead. */
       linkedinAccountId?: string;
       /** linkedin_connection: the invite note (optional, up to 300 chars; sent without it if LinkedIn refuses the note); linkedin_message: the required message (up to 3000 chars); linkedin_inmail: the required message (up to 1900 chars). */
       linkedinMessageBody?: string;
       /** linkedin_message: what to do when the invite is still pending. */
       linkedinMessageMode?: "skip_if_not_connected" | "wait_until_connected";
-      /** linkedin_message with linkedinMessageMode=wait_until_connected: wait 1-2160 hours for acceptance (default 720). After a connection step this mode is the default. */
+      /** linkedin_message with linkedinMessageMode=wait_until_connected: wait 1-2160 hours for acceptance (default 720); after a connection step this mode is the default in a linear campaign. wait_for_connection: wait 24-2160 hours (1-90 days, default 720) before taking the Not accepted path. */
       connectionTimeoutHours?: number;
       /** linkedin_like_post only: the reaction to leave (default like). */
       likeReaction?: "like" | "celebrate" | "support" | "love" | "insightful" | "funny";
       /** linkedin_like_post only: select the newest eligible original post from the last 1-365 days (default 30). */
       likeMaxPostAgeDays?: number;
+      /** linkedin_like_post only: before the immediately preceding wait starts, check for eligible posts. If none exist, skip that wait and the like step, keeping following waits. Defaults to false when omitted. */
+      likeSkipPreviousWait?: boolean;
       /** linkedin_like_post only: skip consecutive following wait steps whenever the reaction step is skipped (default true). False keeps those waits. */
       likeSkipNextWait?: boolean;
+      /** linkedin_like_post only: how many recent posts to react to, 1-3 (default 1). */
+      likeCount?: number;
       /** linkedin_inmail only: optional subject, up to 200 characters; merge tokens allowed. Clear with an empty string. */
       inmailSubject?: string;
       /** linkedin_connection only: withdraw a still-pending invitation sent by this campaign after 168-2160 hours (7-90 days). Omitted means off on creation; null turns it off on edit. */
       withdrawAfterHours?: number | null;
+      /** Workflow steps: this step's id, unique in the campaign, which next, yesNext and noNext point at (not "end"). Left out, one is made. */
+      key?: string;
+      /** Workflow steps: where a step that isn't a condition or wait_for_connection goes; left out, the following step: another step's key, or "end" to stop there. Fixed once the campaign launches. */
+      next?: string;
+      /** Workflow steps: condition and wait_for_connection only, required: where the Yes (Accepted) path goes: another step's key, or "end" to stop there. Fixed once the campaign launches. */
+      yesNext?: string;
+      /** Workflow steps: condition and wait_for_connection only, required: where the No (Not accepted) path goes: another step's key, or "end" to stop there. Fixed once the campaign launches. */
+      noNext?: string;
+      /** condition only, required: linkedin_connected, has_email, opened_last_email (needs an email before it on every path) or field_value. Fixed once the campaign launches. */
+      check?: "linkedin_connected" | "has_email" | "opened_last_email" | "field_value";
+      /** condition with check=field_value: the lead field to check, like "Job Title" or "Source" (the campaign itself changes Status, Last touch and LinkedIn connection). Fixed once the campaign launches. */
+      conditionField?: string;
+      /** condition with check=field_value: is, is_not, contains, is_empty or is_not_empty (all case-insensitive). Fixed once the campaign launches. */
+      conditionOperator?: "is" | "is_not" | "is_empty" | "is_not_empty" | "contains";
+      /** condition with check=field_value and is, is_not or contains: the text to compare with. Editable after launch. */
+      conditionValue?: string;
       /** The step's _id from campaigns.get steps[]. */
       stepId: string;
       /** The step's updatedAt when you read it. If someone saved it since, the edit is refused instead of overwriting theirs. */
@@ -6117,6 +6159,8 @@ export interface ApiResponses {
     }[];
     dailySendCap?: number;
     stepCount: number;
+    /** linear: steps run in order. workflow: steps have keys and paths (next, yesNext, noNext) and may include condition and wait_for_connection. Left out, a workflow stays one and steps with keys, paths or those types make one; nothing turns a workflow back into a list. */
+    stepModel?: "linear" | "workflow";
     totalEnrolled: number;
     activeCount: number;
     pausedCount: number;
@@ -6166,6 +6210,8 @@ export interface ApiResponses {
       }[];
       dailySendCap?: number;
       stepCount: number;
+      /** linear: steps run in order. workflow: steps have keys and paths (next, yesNext, noNext) and may include condition and wait_for_connection. Left out, a workflow stays one and steps with keys, paths or those types make one; nothing turns a workflow back into a list. */
+      stepModel?: "linear" | "workflow";
       totalEnrolled: number;
       activeCount: number;
       pausedCount: number;
@@ -6180,9 +6226,10 @@ export interface ApiResponses {
       updatedAt: number;
       [key: string]: unknown;
     };
+    /** The steps in order, each with its _id. condition and wait_for_connection steps also carry a readable label. */
     steps: Array<{
-      /** Step type. */
-      type: "email" | "wait" | "linkedin_visit" | "linkedin_connection" | "linkedin_message" | "linkedin_like_post" | "linkedin_inmail";
+      /** Step type. condition (If / else) and wait_for_connection (Wait for them to accept) send nothing; they continue on yesNext or noNext and make the campaign a workflow. */
+      type: "wait" | "email" | "linkedin_connection" | "linkedin_message" | "linkedin_visit" | "linkedin_like_post" | "linkedin_inmail" | "condition" | "wait_for_connection";
       /** wait steps: hours to wait before the next step. */
       waitHours?: number;
       /** Legacy email step sender. Pool campaigns choose senders in emailMailboxAccountIds on the campaign, not on individual steps. */
@@ -6197,24 +6244,44 @@ export interface ApiResponses {
       emailReplyToPrevious?: boolean;
       /** email and linkedin_like_post only: always (default), connected or not_connected. InMail automatically skips connected people; do not set a condition on it. */
       onlyIf?: "always" | "connected" | "not_connected";
-      /** Legacy LinkedIn step sender. Pool campaigns use the campaign's linkedinAccountIds instead. */
+      /** Legacy LinkedIn step sender (also on wait_for_connection, and on a condition that checks linkedin_connected). Pool campaigns use the campaign's linkedinAccountIds instead. */
       linkedinAccountId?: string;
       /** linkedin_connection: the invite note (optional, up to 300 chars; sent without it if LinkedIn refuses the note); linkedin_message: the required message (up to 3000 chars); linkedin_inmail: the required message (up to 1900 chars). */
       linkedinMessageBody?: string;
       /** linkedin_message: what to do when the invite is still pending. */
       linkedinMessageMode?: "skip_if_not_connected" | "wait_until_connected";
-      /** linkedin_message with linkedinMessageMode=wait_until_connected: wait 1-2160 hours for acceptance (default 720). After a connection step this mode is the default. */
+      /** linkedin_message with linkedinMessageMode=wait_until_connected: wait 1-2160 hours for acceptance (default 720); after a connection step this mode is the default in a linear campaign. wait_for_connection: wait 24-2160 hours (1-90 days, default 720) before taking the Not accepted path. */
       connectionTimeoutHours?: number;
       /** linkedin_like_post only: the reaction to leave (default like). */
       likeReaction?: "like" | "celebrate" | "support" | "love" | "insightful" | "funny";
       /** linkedin_like_post only: select the newest eligible original post from the last 1-365 days (default 30). */
       likeMaxPostAgeDays?: number;
+      /** linkedin_like_post only: before the immediately preceding wait starts, check for eligible posts. If none exist, skip that wait and the like step, keeping following waits. Defaults to false when omitted. */
+      likeSkipPreviousWait?: boolean;
       /** linkedin_like_post only: skip consecutive following wait steps whenever the reaction step is skipped (default true). False keeps those waits. */
       likeSkipNextWait?: boolean;
+      /** linkedin_like_post only: how many recent posts to react to, 1-3 (default 1). */
+      likeCount?: number;
       /** linkedin_inmail only: optional subject, up to 200 characters; merge tokens allowed. Clear with an empty string. */
       inmailSubject?: string;
       /** linkedin_connection only: withdraw a still-pending invitation sent by this campaign after 168-2160 hours (7-90 days). Omitted means off on creation; null turns it off on edit. */
       withdrawAfterHours?: number | null;
+      /** Workflow steps: this step's id, unique in the campaign, which next, yesNext and noNext point at (not "end"). Left out, one is made. */
+      key?: string;
+      /** Workflow steps: where a step that isn't a condition or wait_for_connection goes; left out, the following step: another step's key, or "end" to stop there. Fixed once the campaign launches. */
+      next?: string;
+      /** Workflow steps: condition and wait_for_connection only, required: where the Yes (Accepted) path goes: another step's key, or "end" to stop there. Fixed once the campaign launches. */
+      yesNext?: string;
+      /** Workflow steps: condition and wait_for_connection only, required: where the No (Not accepted) path goes: another step's key, or "end" to stop there. Fixed once the campaign launches. */
+      noNext?: string;
+      /** condition only, required: linkedin_connected, has_email, opened_last_email (needs an email before it on every path) or field_value. Fixed once the campaign launches. */
+      check?: "linkedin_connected" | "has_email" | "opened_last_email" | "field_value";
+      /** condition with check=field_value: the lead field to check, like "Job Title" or "Source" (the campaign itself changes Status, Last touch and LinkedIn connection). Fixed once the campaign launches. */
+      conditionField?: string;
+      /** condition with check=field_value: is, is_not, contains, is_empty or is_not_empty (all case-insensitive). Fixed once the campaign launches. */
+      conditionOperator?: "is" | "is_not" | "is_empty" | "is_not_empty" | "contains";
+      /** condition with check=field_value and is, is_not or contains: the text to compare with. Editable after launch. */
+      conditionValue?: string;
       [key: string]: unknown;
     }>;
     enrollments: Record<string, unknown>[];
@@ -6250,6 +6317,14 @@ export interface ApiResponses {
     replyRate: number;
     openRate: number;
     clickRate: number;
+    /** Workflows only: each condition and wait_for_connection step, in step order, with how many people took each path. */
+    branchStats?: {
+      stepId: string;
+      /** People who took the Yes (Accepted) path. */
+      yes: number;
+      /** People who took the No (Not accepted) path. */
+      no: number;
+    }[];
     truncated: boolean;
     [key: string]: unknown;
   };
@@ -6262,7 +6337,15 @@ export interface ApiResponses {
     dailySendCap: number | null;
     nextEmailAt: number | null;
     now: Record<string, unknown> | null;
-    next: Record<string, unknown> | null;
+    next: {
+      /** profile, visit, invite, message, like, inmail, withdraw, email, wait or check (an If / else). */
+      kind: string;
+      /** Waiting for them to accept: when the wait ends either way. */
+      acceptanceDeadline?: number;
+      /** kind check: what the If / else checks, e.g. "Has an email address". */
+      label?: string;
+      [key: string]: unknown;
+    } | null;
     paused: Record<string, unknown> | null;
     senders: Record<string, unknown>[];
     [key: string]: unknown;
@@ -6538,8 +6621,8 @@ export interface ApiResponses {
     sequence: Record<string, unknown> | null;
     /** The campaign's steps in order, each with its _id. */
     steps: Array<{
-      /** Step type. */
-      type: "email" | "wait" | "linkedin_visit" | "linkedin_connection" | "linkedin_message" | "linkedin_like_post" | "linkedin_inmail";
+      /** Step type. condition (If / else) and wait_for_connection (Wait for them to accept) send nothing; they continue on yesNext or noNext and make the campaign a workflow. */
+      type: "wait" | "email" | "linkedin_connection" | "linkedin_message" | "linkedin_visit" | "linkedin_like_post" | "linkedin_inmail" | "condition" | "wait_for_connection";
       /** wait steps: hours to wait before the next step. */
       waitHours?: number;
       /** Legacy email step sender. Pool campaigns choose senders in emailMailboxAccountIds on the campaign, not on individual steps. */
@@ -6554,24 +6637,44 @@ export interface ApiResponses {
       emailReplyToPrevious?: boolean;
       /** email and linkedin_like_post only: always (default), connected or not_connected. InMail automatically skips connected people; do not set a condition on it. */
       onlyIf?: "always" | "connected" | "not_connected";
-      /** Legacy LinkedIn step sender. Pool campaigns use the campaign's linkedinAccountIds instead. */
+      /** Legacy LinkedIn step sender (also on wait_for_connection, and on a condition that checks linkedin_connected). Pool campaigns use the campaign's linkedinAccountIds instead. */
       linkedinAccountId?: string;
       /** linkedin_connection: the invite note (optional, up to 300 chars; sent without it if LinkedIn refuses the note); linkedin_message: the required message (up to 3000 chars); linkedin_inmail: the required message (up to 1900 chars). */
       linkedinMessageBody?: string;
       /** linkedin_message: what to do when the invite is still pending. */
       linkedinMessageMode?: "skip_if_not_connected" | "wait_until_connected";
-      /** linkedin_message with linkedinMessageMode=wait_until_connected: wait 1-2160 hours for acceptance (default 720). After a connection step this mode is the default. */
+      /** linkedin_message with linkedinMessageMode=wait_until_connected: wait 1-2160 hours for acceptance (default 720); after a connection step this mode is the default in a linear campaign. wait_for_connection: wait 24-2160 hours (1-90 days, default 720) before taking the Not accepted path. */
       connectionTimeoutHours?: number;
       /** linkedin_like_post only: the reaction to leave (default like). */
       likeReaction?: "like" | "celebrate" | "support" | "love" | "insightful" | "funny";
       /** linkedin_like_post only: select the newest eligible original post from the last 1-365 days (default 30). */
       likeMaxPostAgeDays?: number;
+      /** linkedin_like_post only: before the immediately preceding wait starts, check for eligible posts. If none exist, skip that wait and the like step, keeping following waits. Defaults to false when omitted. */
+      likeSkipPreviousWait?: boolean;
       /** linkedin_like_post only: skip consecutive following wait steps whenever the reaction step is skipped (default true). False keeps those waits. */
       likeSkipNextWait?: boolean;
+      /** linkedin_like_post only: how many recent posts to react to, 1-3 (default 1). */
+      likeCount?: number;
       /** linkedin_inmail only: optional subject, up to 200 characters; merge tokens allowed. Clear with an empty string. */
       inmailSubject?: string;
       /** linkedin_connection only: withdraw a still-pending invitation sent by this campaign after 168-2160 hours (7-90 days). Omitted means off on creation; null turns it off on edit. */
       withdrawAfterHours?: number | null;
+      /** Workflow steps: this step's id, unique in the campaign, which next, yesNext and noNext point at (not "end"). Left out, one is made. */
+      key?: string;
+      /** Workflow steps: where a step that isn't a condition or wait_for_connection goes; left out, the following step: another step's key, or "end" to stop there. Fixed once the campaign launches. */
+      next?: string;
+      /** Workflow steps: condition and wait_for_connection only, required: where the Yes (Accepted) path goes: another step's key, or "end" to stop there. Fixed once the campaign launches. */
+      yesNext?: string;
+      /** Workflow steps: condition and wait_for_connection only, required: where the No (Not accepted) path goes: another step's key, or "end" to stop there. Fixed once the campaign launches. */
+      noNext?: string;
+      /** condition only, required: linkedin_connected, has_email, opened_last_email (needs an email before it on every path) or field_value. Fixed once the campaign launches. */
+      check?: "linkedin_connected" | "has_email" | "opened_last_email" | "field_value";
+      /** condition with check=field_value: the lead field to check, like "Job Title" or "Source" (the campaign itself changes Status, Last touch and LinkedIn connection). Fixed once the campaign launches. */
+      conditionField?: string;
+      /** condition with check=field_value: is, is_not, contains, is_empty or is_not_empty (all case-insensitive). Fixed once the campaign launches. */
+      conditionOperator?: "is" | "is_not" | "is_empty" | "is_not_empty" | "contains";
+      /** condition with check=field_value and is, is_not or contains: the text to compare with. Editable after launch. */
+      conditionValue?: string;
       [key: string]: unknown;
     }>;
     /** One run for each step the person has reached, in order. */
@@ -6581,8 +6684,8 @@ export interface ApiResponses {
       stepId: string;
       /** The step's place, from 0. */
       stepIndex: number;
-      /** Step type. */
-      type: "email" | "wait" | "linkedin_visit" | "linkedin_connection" | "linkedin_message" | "linkedin_like_post" | "linkedin_inmail";
+      /** Step type. condition (If / else) and wait_for_connection (Wait for them to accept) send nothing; they continue on yesNext or noNext and make the campaign a workflow. */
+      type: "wait" | "email" | "linkedin_connection" | "linkedin_message" | "linkedin_visit" | "linkedin_like_post" | "linkedin_inmail" | "condition" | "wait_for_connection";
       /** sent: done (a wait that finished is sent too). skipped: see result.reason. retry: will be tried again at retryAt. unknown: needs a look. */
       status: "queued" | "running" | "waiting" | "retry" | "sent" | "skipped" | "failed" | "unknown";
       scheduledAt?: number;
@@ -6593,7 +6696,9 @@ export interface ApiResponses {
       /** The email this run sent, in emailMessages[]. */
       emailMessageId?: string;
       lastError?: string;
-      /** For a skipped step, { reason } says why. */
+      /** wait_for_connection: when it stops waiting for the accept. */
+      timeoutAt?: number;
+      /** For a skipped step, { reason } says why. A finished condition or wait_for_connection has { branch: "yes" | "no" } (Yes / Accepted or No / Not accepted), and { reason } for some No paths. */
       result?: unknown;
       [key: string]: unknown;
     }>;
@@ -7760,7 +7865,7 @@ export type DenchApiTree = {
       /** Discover LinkedIn sender ids, labels, availability and remaining capacity visible to the acting workspace member. Never returns provider credentials. (`dench campaign accounts`) */
       linkedin(args?: Req<"campaigns.accounts.linkedin">): Promise<Res<"campaigns.accounts.linkedin">>;
     };
-    /** Campaign funnel: enrolled, contacted, invited, accepted, messaged, replied, opens and clicks. (`dench campaign get`) */
+    /** Campaign funnel: enrolled, contacted, invited, accepted, messaged, replied, opens and clicks, and for a workflow how many people took each If / else and Wait for them to accept path (branchStats). (`dench campaign get`) */
     analytics(args: Req<"campaigns.analytics">): Promise<Res<"campaigns.analytics">>;
     /** 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. (`dench campaign archive`) */
     archive(args: Req<"campaigns.archive">): Promise<Res<"campaigns.archive">>;
@@ -7874,9 +7979,9 @@ export type DenchApiTree = {
       update(args: Req<"campaigns.sources.update">): Promise<Res<"campaigns.sources.update">>;
     };
     steps: {
-      /** 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. (`dench campaign steps set`) */
+      /** Replace every step of a draft campaign (email, wait, LinkedIn visit, connection request, message, post reaction, InMail, If / else, Wait for them to accept). A workflow (stepModel workflow, or steps with key, next, yesNext or noNext) branches: condition and wait_for_connection steps continue on yesNext or noNext, other steps on next; each points at another step's key or end. Steps are checked first: a field the step type would drop, missing text, {TOKEN} single braces or paths that don't hold together are rejected, not saved. Configure sender pools on the campaign; step sender ids are legacy-only. (`dench campaign steps set`) */
       replace(args: Req<"campaigns.steps.replace">): Promise<Res<"campaigns.steps.replace">>;
-      /** 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. (`dench campaign steps edit`) */
+      /** 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. A workflow keeps its paths and what each If / else checks (key, next, yesNext, noNext, check, conditionField, conditionOperator); conditionValue and acceptance waits stay editable. Messages already sent or being prepared keep their text; drafts use campaigns.steps.replace. (`dench campaign steps edit`) */
       update(args: Req<"campaigns.steps.update">): Promise<Res<"campaigns.steps.update">>;
     };
     /** Change a campaign's name, sender pools, send windows, daily email cap, stop-on-reply, start or end. Works until archived; existing conversations keep their assigned sender. (`dench campaign set`) */

package/apps.ts

@@ -91,8 +91,12 @@ function withAuth(ctx: Ctx, args: Record<string, unknown>) {
   } as never;
 }
 
-function appsHelp() {
-  console.log(`Usage: dench apps <subcommand>   (App Store — not connected apps; see 'dench integrations')
+function appsHelp(): void {
+  console.log(appsHelpText());
+}
+
+export function appsHelpText(): string {
+  return `Usage: dench apps <subcommand>   (App Store — not connected apps; see 'dench integrations')
 
   dench apps list [--json]                       Installed apps in this workspace
   dench apps gallery [--json]                    Discover listings — Official (Dench) + Community
@@ -113,7 +117,7 @@ function appsHelp() {
   dench apps webhooks list <slug>
   dench apps webhooks poll <slug> <hookName> [--since <ms>] [--limit <n>]
   dench apps webhooks delete <slug> <hookName>
-`);
+`;
 }
 
 const TEXT_FILE = /\.(html?|js|mjs|cjs|ts|jsx|tsx|css|json|ya?ml|md|txt|svg)$/i;

package/browser.ts

@@ -81,7 +81,11 @@ const ACTIONS = new Set([
 ]);
 
 function browserHelp(): void {
-  console.log(`Usage: dench browser <action> [options]
+  console.log(browserHelpText());
+}
+
+export function browserHelpText(): string {
+  return `Usage: dench browser <action> [options]
 
 Control Dench Browser without opening dench.com locally.
 Commands authenticate with the active dench signin session or DENCH_API_KEY.
@@ -105,6 +109,7 @@ Common:
   dench browser activate-tab <targetId>
   dench browser close-tab <targetId>
   dench browser stop
+  dench browser reset
 
 Playwright sessions:
   dench browser session create --json
@@ -114,8 +119,8 @@ Playwright sessions:
 State:
   The CLI remembers the latest browser thread per Dench host/session.
   Use --thread <threadId> to control a specific thread, or
-  dench browser reset to forget the local remembered thread.
-`);
+  \`dench browser reset\` to forget the local remembered thread.
+`;
 }
 
 function consumeFlagValue(args: string[], name: string): string | undefined {