@dench.com/cli 3.8.0-staging.389 → 3.8.1-staging.390

package/lib/campaign-timeline.ts

@@ -8,6 +8,8 @@ export type TimelineRun = {
   startedAt?: number;
   waitUntil?: number;
   retryAt?: number;
+  /** A wait for acceptance: when it stops waiting either way. */
+  timeoutAt?: number;
   completedAt?: number;
   emailMessageId?: string;
   lastError?: string;
@@ -49,6 +51,8 @@ export type TimelineResult = {
     type: string;
     order: number;
     waitHours?: number;
+    /** If / else and Wait until they accept steps: what they check. */
+    label?: string;
   }>;
   runs: TimelineRun[];
   emailMessages: TimelineEmail[];
@@ -63,6 +67,10 @@ export type TimelineStep = {
   outcome: string;
   at: number | null;
   detail: string[];
+  /** An If / else or a wait for acceptance: the path it took. */
+  branch?: "yes" | "no";
+  /** Still waiting for them to accept: when it stops waiting. */
+  acceptanceDeadline?: number;
   subject?: string;
   text?: string;
   error?: string;
@@ -101,16 +109,66 @@ const EMAIL_STATUS: Record<string, string> = {
   failed: "could not send",
 };
 
+function resultField(result: unknown, key: string): unknown {
+  return result && typeof result === "object"
+    ? (result as Record<string, unknown>)[key]
+    : undefined;
+}
+
 function skipReason(result: unknown): string {
-  const reason =
-    result && typeof result === "object"
-      ? (result as { reason?: unknown }).reason
-      : undefined;
+  const reason = resultField(result, "reason");
   return (typeof reason === "string" && SKIP_REASONS[reason]) || "Skipped";
 }
 
+/** Why an If / else or a wait for acceptance took its No path. */
+const NO_REASONS: Record<string, string> = {
+  missing_linkedin_identity: "no LinkedIn profile",
+  missing_email_identity: "no email address",
+  linkedin_connection_timeout: "they did not accept in time",
+  linkedin_invite_withdrawn: "the connection request was withdrawn",
+  linkedin_invite_not_sent: "no connection request went out",
+};
+
+const LOGIC_TYPES = new Set(["condition", "wait_for_connection"]);
+
+export function branchOf(run: TimelineRun): "yes" | "no" | undefined {
+  if (!LOGIC_TYPES.has(run.type) || run.status !== "sent") return undefined;
+  const branch = resultField(run.result, "branch");
+  return branch === "yes" || branch === "no" ? branch : undefined;
+}
+
+/** What the editor calls each exit: Yes / No, or Accepted / Not accepted. */
+export function branchExitLabel(type: string, branch: "yes" | "no"): string {
+  if (type === "wait_for_connection")
+    return branch === "yes" ? "Accepted" : "Not accepted";
+  return branch === "yes" ? "Yes" : "No";
+}
+
+function logicOutcome(run: TimelineRun): string | undefined {
+  if (!LOGIC_TYPES.has(run.type)) return undefined;
+  const branch = branchOf(run);
+  if (branch) {
+    const reason = resultField(run.result, "reason");
+    const why =
+      branch === "no" && typeof reason === "string" ? NO_REASONS[reason] : "";
+    return `${branchExitLabel(run.type, branch)}${why ? ` (${why})` : ""}`;
+  }
+  if (run.status === "sent") return "Done";
+  if (run.type === "wait_for_connection")
+    return run.status === "waiting"
+      ? "Waiting for them to accept"
+      : run.status === "queued" || run.status === "running"
+        ? "Checking whether they accepted"
+        : undefined;
+  return ["queued", "running", "waiting"].includes(run.status)
+    ? "Checking"
+    : undefined;
+}
+
 function outcomeOf(run: TimelineRun): string {
   if (run.status === "skipped") return skipReason(run.result);
+  const logic = logicOutcome(run);
+  if (logic) return logic;
   if (run.status === "sent") {
     if (run.type === "wait") return "Waited";
     if (run.type === "linkedin_visit") return "Visited";
@@ -153,6 +211,11 @@ export function timelineSteps(result: TimelineResult): TimelineStep[] {
         run.status === "sent" || run.status === "skipped"
           ? undefined
           : (run.lastError ?? email?.lastError)?.trim();
+      const branch = branchOf(run);
+      const waitingForAccept =
+        run.type === "wait_for_connection" &&
+        run.status === "waiting" &&
+        typeof run.timeoutAt === "number";
       return {
         step: (step?.order ?? run.stepIndex) + 1,
         stepId: String(run.stepId),
@@ -167,6 +230,8 @@ export function timelineSteps(result: TimelineResult): TimelineStep[] {
           run.scheduledAt ??
           null,
         detail,
+        ...(branch ? { branch } : {}),
+        ...(waitingForAccept ? { acceptanceDeadline: run.timeoutAt } : {}),
         ...(email?.subject ? { subject: email.subject } : {}),
         ...(text ? { text } : {}),
         ...(problem ? { error: problem } : {}),

package/lib/command-registry.ts

@@ -4183,7 +4183,7 @@ const rawApiOperations = [
     id: "campaigns.analytics",
     group: "campaigns",
     summary:
-      "Campaign funnel: enrolled, contacted, invited, accepted, messaged, replied, opens and clicks.",
+      "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).",
     cli: "dench campaign get",
     method: "GET",
     path: "/campaigns/{sequenceId}/analytics",
@@ -4237,7 +4237,7 @@ const rawApiOperations = [
     id: "campaigns.steps.replace",
     group: "campaigns",
     summary:
-      "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.",
+      "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.",
     cli: "dench campaign steps set",
     method: "PUT",
     path: "/campaigns/{sequenceId}/steps",
@@ -4249,7 +4249,7 @@ const rawApiOperations = [
     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.",
+      "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.",
     cli: "dench campaign steps edit",
     method: "PATCH",
     path: "/campaigns/{sequenceId}/steps",