@intercom/cli 0.5.0 → 0.7.0

package/dist/{chunk-Y4JK5AHH.js → chunk-3V2ONMAU.js}

@@ -26,8 +26,8 @@ var NotFoundError = class extends CLIError {
   }
 };
 var PermissionError = class extends CLIError {
-  constructor(message) {
-    super(message, 5);
+  constructor(message, error) {
+    super(message, 5, error);
   }
 };
 var TimeoutError = class extends CLIError {
@@ -106,4 +106,4 @@ export {
   formatJson,
   applyJq
 };
-//# sourceMappingURL=chunk-Y4JK5AHH.js.map
+//# sourceMappingURL=chunk-3V2ONMAU.js.map

package/dist/index.js

@@ -9,7 +9,7 @@ import {
   applyJq,
   detectAuthType,
   formatJson
-} from "./chunk-Y4JK5AHH.js";
+} from "./chunk-3V2ONMAU.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -65,7 +65,7 @@ var _dryRun = false;
 function setDryRun(enabled) {
   _dryRun = enabled;
 }
-var IntercomClient = class {
+var IntercomClient = class _IntercomClient {
   token;
   authType;
   appId;
@@ -88,7 +88,49 @@ var IntercomClient = class {
     }
     return `Bearer ${this.token}`;
   }
-  async request(method, path, body, responseType = "json", extraHeaders) {
+  // Dedicated error code the API returns when the `fin-sdk` feature flag gates
+  // a fin subcommand. It's specific to that self-fixable gate (not the generic
+  // plan-restriction code), so seeing it is a safe signal to auto-enable.
+  static FIN_SDK_GATE_CODE = "fin_sdk_not_enabled";
+  // Thin wrapper over requestOnce that transparently recovers from the fin-sdk
+  // gate: if a call is blocked because the flag isn't enabled, opt the
+  // workspace in via POST /fin-sdk/enable and retry the original request once.
+  // If enabling fails, the original gate error is surfaced unchanged.
+  async request(method, path, body, responseType = "json", extraHeaders, isFinSdkRetry = false) {
+    try {
+      return await this.requestOnce(
+        method,
+        path,
+        body,
+        responseType,
+        extraHeaders
+      );
+    } catch (err) {
+      if (!isFinSdkRetry && !_dryRun && err instanceof PermissionError && err.error?.code === _IntercomClient.FIN_SDK_GATE_CODE) {
+        try {
+          await this.enableFinSdk();
+        } catch {
+          throw err;
+        }
+        return this.request(
+          method,
+          path,
+          body,
+          responseType,
+          extraHeaders,
+          true
+        );
+      }
+      throw err;
+    }
+  }
+  // Opt the current workspace into the fin-sdk feature flag. The notice goes to
+  // stderr so it never contaminates --json / piped stdout output.
+  async enableFinSdk() {
+    console.error("Fin SDK not enabled for this workspace \u2014 enabling it now...");
+    await this.requestOnce("POST", "/fin-sdk/enable", {}, "json");
+  }
+  async requestOnce(method, path, body, responseType = "json", extraHeaders) {
     const url = `${this.baseUrl}${path}`;
     if (_dryRun) {
       console.error(`> ${method} ${url}`);
@@ -149,13 +191,18 @@ var IntercomClient = class {
       }
       const errorBody = await response.json().catch(() => ({}));
       const errorMsg = errorBody?.errors?.[0]?.message ?? `HTTP ${response.status}`;
+      const errorCode = errorBody?.errors?.[0]?.code ?? "";
       if (response.status === 401) {
         throw new AuthError(
           `Authentication expired or invalid: ${errorMsg}. Run "intercom auth login" to re-authenticate.`
         );
       }
       if (response.status === 403) {
-        throw new PermissionError(`Permission denied: ${errorMsg}`);
+        throw new PermissionError(`Permission denied: ${errorMsg}`, {
+          code: errorCode,
+          message: errorMsg,
+          status: 403
+        });
       }
       if (response.status === 404) {
         throw new NotFoundError(errorMsg);
@@ -905,13 +952,18 @@ async function deviseSignIn(baseUrl, email, password, timeoutMs = API_TIMEOUT_MS
   }
   const location = signInResponse.headers.get("location") ?? "";
   if (location.includes("/admins/sign_in")) {
-    throw new Error("Invalid credentials");
+    throw new AuthError("Invalid credentials");
   }
   if (location.includes("two_factor")) {
-    throw new Error(
+    throw new AuthError(
       "Two-factor authentication is required. Please use an API key instead."
     );
   }
+  if (location.includes("/login_verification")) {
+    throw new AuthError(
+      "Login email verification is required.\n  Please sign in to the Intercom web app to complete verification, then retry this command."
+    );
+  }
   cookies = mergeCookies(cookies, extractCookies(signInResponse));
   return cookies;
 }
@@ -1024,7 +1076,12 @@ async function fetchAccessToken(baseUrl, cookies, appPackageId, appId, timeoutMs
 }
 async function getToken(options) {
   const { baseUrl, email, password, appId, appPackageId, timeoutMs } = options;
-  const cookies = await deviseSignIn(baseUrl, email, password, timeoutMs);
+  let cookies = await deviseSignIn(baseUrl, email, password, timeoutMs);
+  const appResponse = await fetchWithTimeout(`${baseUrl}/a/apps/${appId}`, {
+    headers: { Cookie: cookies }
+  }, { timeoutMs: timeoutMs ?? API_TIMEOUT_MS });
+  const appCookies = extractCookies(appResponse);
+  if (appCookies) cookies = mergeCookies(cookies, appCookies);
   const appPackage = await findOrCreateAppPackage(
     baseUrl,
     cookies,
@@ -1805,6 +1862,38 @@ Examples:
 }
 
 // src/commands/conversations.ts
+var BLOCKED_FIELDS = [
+  "topics",
+  "ai_topics",
+  "monitor_evaluations",
+  "scorecards"
+];
+var BLOCKED_CUSTOM_ATTRIBUTE_KEYS = [
+  "AI Topic",
+  "AI Subtopic",
+  "AI Topic and Subtopic",
+  "AI Issue summary",
+  "Query Type",
+  "CX Score rating",
+  "CX Score explanation",
+  "CX Score reasons",
+  "Review status",
+  "Reviewer"
+];
+function sanitizeConversation(conversation) {
+  const sanitized = { ...conversation };
+  for (const field of BLOCKED_FIELDS) {
+    delete sanitized[field];
+  }
+  if (sanitized.custom_attributes && typeof sanitized.custom_attributes === "object") {
+    const filtered = { ...sanitized.custom_attributes };
+    for (const key of BLOCKED_CUSTOM_ATTRIBUTE_KEYS) {
+      delete filtered[key];
+    }
+    sanitized.custom_attributes = filtered;
+  }
+  return sanitized;
+}
 function formatDatetime(ts) {
   if (!ts) return "";
   const n = typeof ts === "number" ? ts : Number(ts);
@@ -1902,9 +1991,10 @@ Examples:
       result = await client.get("/conversations", { per_page: limit });
     }
     const response = result;
-    const items = response.conversations ?? [];
+    const items = (response.conversations ?? []).map(sanitizeConversation);
+    const sanitizedResult = { ...response, conversations: items };
     render(
-      result,
+      sanitizedResult,
       opts,
       () => {
         const rows = items.map((c2) => ({
@@ -1925,10 +2015,11 @@ Examples:
   conversations.command("get <id>").description("Get a conversation by ID").option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").action(async function(id) {
     const opts = this.optsWithGlobals();
     const client = await resolveClient(opts);
-    const result = await client.get(`/conversations/${id}`);
+    const result = sanitizeConversation(
+      await client.get(`/conversations/${id}`)
+    );
     render(result, opts, () => {
-      const r = result;
-      return renderConversationStream(r);
+      return renderConversationStream(result);
     });
   });
   conversations.command("reply <id>").description("Reply to a conversation").option(
@@ -1978,9 +2069,10 @@ Required fields: body, type (admin or user). Also: admin_id, message_type.`
     };
     const result = await client.post("/conversations/search", body);
     const response = result;
-    const items = response.conversations ?? [];
+    const items = (response.conversations ?? []).map(sanitizeConversation);
+    const sanitizedResult = { ...response, conversations: items };
     render(
-      result,
+      sanitizedResult,
       opts,
       () => {
         const rows = items.map((c2) => ({
@@ -2404,7 +2496,7 @@ Examples:
 }
 
 // src/commands/fin.ts
-import { writeFile as writeFile2 } from "fs/promises";
+import { writeFile as writeFile3 } from "fs/promises";
 
 // src/commands/fin/procedures.ts
 import { readFile as readFile2 } from "fs/promises";
@@ -2613,6 +2705,11 @@ function registerAudiencesCommand(fin) {
 }
 
 // src/commands/fin/workflows.ts
+import { readFile as readFile3 } from "fs/promises";
+import { basename as basename2 } from "path";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+var STATE_LIVE = 1;
+var STATE_PAUSED = 2;
 function registerWorkflowsCommand(fin) {
   const workflows = fin.command("workflows").description("Manage Fin SDK workflows");
   workflows.command("list").description("List Fin SDK workflows").option("--json", "Output as JSON").option("--verbose", "Show HTTP request/response details").action(async function() {
@@ -2633,19 +2730,122 @@ function registerWorkflowsCommand(fin) {
       return table({ columns: ["ID", "TITLE", "STATE", "TRIGGER"], rows });
     }, items);
   });
-  workflows.command("get <id>").description("Get a workflow by ID").option("--json", "Output as JSON").option("--verbose", "Show HTTP request/response details").action(async function(id) {
+  workflows.command("get <id>").description("Get a workflow by ID").option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").action(async function(id) {
     const opts = this.optsWithGlobals();
     const client = await resolveClient(opts);
-    const result = await client.get(`/fin-sdk/workflows/${id}`);
-    const r = result;
+    const text = await client.getText(`/fin-sdk/workflows/${id}`);
+    const parsed = parseYaml(text);
+    render(
+      parsed,
+      opts,
+      () => detail({
+        "ID": String(parsed.id ?? ""),
+        "Title": String(parsed.title ?? ""),
+        "State": String(parsed.state ?? ""),
+        "Version": parsed.version != null ? String(parsed.version) : void 0,
+        "Trigger": parsed.trigger_type != null ? String(parsed.trigger_type) : void 0
+      })
+    );
+  });
+  workflows.command("upload <file>").description('Upload a workflow YAML file (creates if id is "new", updates if numeric)').option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").addHelpText(
+    "after",
+    `
+Examples:
+  $ intercom fin workflows upload ./welcome.yaml
+  $ intercom fin workflows get wf-42 > local.yaml; vim local.yaml; intercom fin workflows upload local.yaml
+  $ intercom fin workflows upload ./new.yaml --json | jq .visual_builder_url
+
+The YAML file's id field determines whether this creates or updates:
+  id: "new"   \u2192 creates a new workflow
+  id: <int>   \u2192 updates the existing workflow with that id`
+  ).action(async function(filePath) {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const fileContent = await readFile3(filePath);
+    const formData = new FormData();
+    const blob = new Blob([fileContent], { type: "application/x-yaml" });
+    formData.append("file_data", blob, basename2(filePath));
+    const result = await client.postFormData("/fin-sdk/upload", formData);
+    render(
+      result,
+      opts,
+      () => detail({
+        "ID": String(result.id ?? ""),
+        "Type": result.type != null ? String(result.type) : void 0,
+        "Message": result.message != null ? String(result.message) : void 0,
+        "Visual Builder URL": result.visual_builder_url != null ? String(result.visual_builder_url) : void 0
+      })
+    );
+  });
+  workflows.command("enable <id>").description("Set a workflow's state to live").option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").addHelpText(
+    "after",
+    `
+Examples:
+  $ intercom fin workflows enable 42
+  $ intercom fin workflows enable 42 --json
+
+This is a convenience for GET \u2192 set state \u2192 POST. If another operator
+edits the workflow between the GET and POST, those edits will be
+overwritten (the server does not expose a concurrency token).`
+  ).action(async function(id) {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const text = await client.getText(`/fin-sdk/workflows/${id}`);
+    let parsed;
+    try {
+      parsed = parseYaml(text);
+    } catch (err) {
+      throw new Error(`server returned unparseable YAML for workflow ${id}: ${err.message}`);
+    }
+    parsed.state = STATE_LIVE;
+    const yamlBody = stringifyYaml(parsed);
+    const formData = new FormData();
+    const blob = new Blob([yamlBody], { type: "application/x-yaml" });
+    formData.append("file_data", blob, `workflow-${id}.yaml`);
+    const result = await client.postFormData("/fin-sdk/upload", formData);
+    render(
+      result,
+      opts,
+      () => detail({
+        "ID": String(result.id ?? ""),
+        "Type": result.type != null ? String(result.type) : void 0,
+        "Message": result.message != null ? String(result.message) : void 0
+      })
+    );
+  });
+  workflows.command("disable <id>").description("Set a workflow's state to paused").option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").addHelpText(
+    "after",
+    `
+Examples:
+  $ intercom fin workflows disable 42
+  $ intercom fin workflows disable 42 --json
+
+This is a convenience for GET \u2192 set state \u2192 POST. If another operator
+edits the workflow between the GET and POST, those edits will be
+overwritten (the server does not expose a concurrency token).`
+  ).action(async function(id) {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const text = await client.getText(`/fin-sdk/workflows/${id}`);
+    let parsed;
+    try {
+      parsed = parseYaml(text);
+    } catch (err) {
+      throw new Error(`server returned unparseable YAML for workflow ${id}: ${err.message}`);
+    }
+    parsed.state = STATE_PAUSED;
+    const yamlBody = stringifyYaml(parsed);
+    const formData = new FormData();
+    const blob = new Blob([yamlBody], { type: "application/x-yaml" });
+    formData.append("file_data", blob, `workflow-${id}.yaml`);
+    const result = await client.postFormData("/fin-sdk/upload", formData);
     render(
       result,
       opts,
       () => detail({
-        "ID": String(r.id ?? ""),
-        "Title": String(r.title ?? ""),
-        "State": String(r.state ?? ""),
-        "Trigger": r.trigger_type != null ? String(r.trigger_type) : void 0
+        "ID": String(result.id ?? ""),
+        "Type": result.type != null ? String(result.type) : void 0,
+        "Message": result.message != null ? String(result.message) : void 0
       })
     );
   });
@@ -2888,6 +3088,275 @@ Fin is live on workspace ${appId}`);
   });
 }
 
+// src/commands/fin/monitors.ts
+import { mkdir as mkdir2, writeFile as writeFile2 } from "fs/promises";
+import { join as join3, relative, dirname } from "path";
+import { stringify } from "yaml";
+async function resolveMonitorId(client, nameOrId) {
+  if (/^\d+$/.test(nameOrId)) {
+    return parseInt(nameOrId, 10);
+  }
+  const monitors = await client.get("/fin-sdk/qa/monitors");
+  const exact = monitors.find((m) => m.name === nameOrId);
+  if (exact) return parseInt(exact.id, 10);
+  const lower = nameOrId.toLowerCase();
+  const fuzzy = monitors.find((m) => m.name.toLowerCase().includes(lower));
+  if (fuzzy) return parseInt(fuzzy.id, 10);
+  throw new CLIError(
+    `Monitor not found: "${nameOrId}". Check the name or use the numeric ID.`
+  );
+}
+function buildWorkingSetYaml(result, since) {
+  const header = [
+    `# Generated by: fin monitor pull-flagged "${result.monitor_name}" --since ${since}`,
+    `# Generated at: ${(/* @__PURE__ */ new Date()).toISOString()}`,
+    `# Monitor: ${result.monitor_name} (ID: ${result.monitor_id})`,
+    `# Showing: ${result.conversations.length} of ${result.total_count} total flagged`,
+    "#",
+    "# Edit this file:",
+    "#   - Remove conversations you don't want to act on",
+    "#   - Set the action and message below",
+    "#   - Then run: fin conversation bulk-send --yes",
+    ""
+  ].join("\n");
+  const doc = {
+    action: "reply",
+    message: "Your message here \u2014 this will be sent to all conversations listed below.\n",
+    close_after_reply: false,
+    conversations: result.conversations.map((c2) => ({
+      id: c2.id,
+      flagged_at: c2.flagged_at,
+      reasoning: c2.reasoning || "No reasoning provided"
+    }))
+  };
+  return header + stringify(doc, { lineWidth: 120 });
+}
+function registerMonitorsCommand(fin) {
+  const monitor = fin.command("monitor").description("Manage Fin QA monitors");
+  monitor.command("pull-flagged <monitor>").description(
+    "Pull conversations flagged by a QA monitor into an editable working set file"
+  ).option(
+    "--since <period>",
+    "Time window to look back (e.g. 24h, 7d, 2w)",
+    "24h"
+  ).option("--limit <n>", "Maximum number of conversations to include", "50").option("--output <path>", "Output file path for the working set YAML").option(
+    "--json",
+    "Output flagged conversations as JSON instead of writing a file"
+  ).option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").addHelpText(
+    "after",
+    `
+Examples:
+  $ fin monitor pull-flagged "Compliance Violations" --since 7d
+  $ fin monitor pull-flagged 12345 --since 24h --limit 100
+  $ fin monitor pull-flagged "My Monitor" --json`
+  ).action(async function(monitorArg) {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const since = opts.since ?? "24h";
+    const limit = parseInt(opts.limit ?? "50", 10);
+    const monitorId = await resolveMonitorId(client, monitorArg);
+    const result = await client.get(
+      `/fin-sdk/qa/monitors/${monitorId}/flagged-conversations`,
+      { since, limit: String(limit) }
+    );
+    if (opts.json || opts.jq || !process.stdout.isTTY) {
+      render(result, opts, () => {
+        return `${result.conversations.length} conversations flagged by "${result.monitor_name}"`;
+      });
+      return;
+    }
+    if (result.conversations.length === 0) {
+      console.log(
+        `No conversations flagged by "${result.monitor_name}" in the last ${since}.`
+      );
+      return;
+    }
+    const outputPath = opts.output ?? join3(
+      process.cwd(),
+      "src",
+      "qa",
+      "bulk-actions",
+      "flagged-conversations.yaml"
+    );
+    await mkdir2(dirname(outputPath), { recursive: true });
+    await writeFile2(outputPath, buildWorkingSetYaml(result, since), "utf-8");
+    const relPath = relative(process.cwd(), outputPath);
+    console.log(
+      `Wrote ${result.conversations.length} conversations to ${relPath}`
+    );
+    console.log("");
+    console.log("Next steps:");
+    console.log(`  1. Edit ${relPath}`);
+    console.log("     - Remove conversations you don't want to act on");
+    console.log("     - Set action: reply, note, or close");
+    console.log("     - Write your message");
+    console.log("  2. Preview: fin conversation bulk-send --dry-run");
+    console.log("  3. Send:    fin conversation bulk-send --yes");
+  });
+}
+
+// src/commands/fin/conversation.ts
+import { readFile as readFile4 } from "fs/promises";
+import { join as join4 } from "path";
+import { parse } from "yaml";
+var PLACEHOLDER_MESSAGE = "Your message here \u2014 this will be sent to all conversations listed below.";
+function validateWorkingSet(ws) {
+  const errors = [];
+  if (!ws.action) {
+    errors.push('Missing "action" field. Must be: reply, note, close, tag, or run_procedure.');
+  } else if (!["reply", "note", "close", "tag", "run_procedure"].includes(ws.action)) {
+    errors.push(
+      `Invalid action "${ws.action}". Must be one of: reply, note, close, tag, run_procedure.`
+    );
+  }
+  if (ws.action === "reply" || ws.action === "note") {
+    if (!ws.message || ws.message.trim().startsWith(PLACEHOLDER_MESSAGE.slice(0, 20))) {
+      errors.push(
+        `Message is required for action "${ws.action}". Edit the message field.`
+      );
+    }
+  }
+  if (ws.action === "run_procedure" && !ws.procedure_id && !ws.procedure_name) {
+    errors.push("procedure_id or procedure_name is required for run_procedure actions.");
+  } else if (ws.action === "run_procedure" && ws.procedure_id && typeof ws.procedure_id !== "number") {
+    errors.push("procedure_id must be a number.");
+  }
+  if (ws.action === "tag" && !ws.tag_id && !ws.tag_name) {
+    errors.push("tag_id or tag_name is required for tag actions.");
+  } else if (ws.action === "tag" && ws.tag_id && typeof ws.tag_id !== "number") {
+    errors.push("tag_id must be a number.");
+  }
+  if (!ws.conversations || ws.conversations.length === 0) {
+    errors.push("conversations list is empty. Add at least one conversation.");
+  } else {
+    const invalid = ws.conversations.filter(
+      (c2) => typeof c2.id !== "number" || isNaN(c2.id)
+    );
+    if (invalid.length > 0) {
+      errors.push(
+        `${invalid.length} conversation(s) have invalid IDs. Each entry must have a numeric id.`
+      );
+    }
+  }
+  return errors;
+}
+function registerConversationCommand(fin) {
+  const conversation = fin.command("conversation").description("Manage conversations in bulk");
+  conversation.command("bulk-send").description(
+    "Send bulk actions (reply, note, close, tag, run_procedure) from a working set file"
+  ).option(
+    "--file <path>",
+    "Path to the working set YAML file",
+    join4(process.cwd(), "src", "qa", "bulk-actions", "flagged-conversations.yaml")
+  ).option("--dry-run", "Preview actions without sending").option("--yes", "Skip confirmation prompt (required in TTY mode)").option(
+    "--json",
+    "Output result as JSON"
+  ).option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").addHelpText(
+    "after",
+    `
+Examples:
+  $ fin conversation bulk-send --dry-run
+  $ fin conversation bulk-send --yes
+  $ fin conversation bulk-send --file ./my-working-set.yaml --yes
+  $ fin conversation bulk-send --json`
+  ).action(async function() {
+    const opts = this.optsWithGlobals();
+    const filePath = opts.file ?? join4(
+      process.cwd(),
+      "src",
+      "qa",
+      "bulk-actions",
+      "flagged-conversations.yaml"
+    );
+    let raw;
+    try {
+      raw = await readFile4(filePath, "utf-8");
+    } catch (err) {
+      const e = err;
+      if (e.code === "ENOENT") {
+        throw new CLIError(
+          `Working set file not found: ${filePath}
+Run "fin monitor pull-flagged <monitor>" to create one.`
+        );
+      }
+      throw new CLIError(`Failed to read working set file: ${e.message}`);
+    }
+    let ws;
+    try {
+      ws = parse(raw);
+    } catch (err) {
+      const e = err;
+      throw new CLIError(`Invalid YAML in working set file: ${e.message}`);
+    }
+    const errors = validateWorkingSet(ws);
+    if (errors.length > 0) {
+      throw new CLIError(
+        `Working set validation failed:
+${errors.map((e) => `  - ${e}`).join("\n")}`
+      );
+    }
+    const conversationIds = ws.conversations.map((c2) => c2.id);
+    const count = conversationIds.length;
+    if (opts.dryRun) {
+      const dryResult = {
+        dry_run: true,
+        action_type: ws.action,
+        conversation_count: count,
+        ...ws.message ? { message: ws.message } : {},
+        ...ws.close_after_reply ? { close_after_reply: true } : {},
+        ...ws.procedure_id ? { procedure_id: ws.procedure_id } : {},
+        ...ws.procedure_name ? { procedure_name: ws.procedure_name } : {},
+        ...ws.tag_id ? { tag_id: ws.tag_id } : {},
+        ...ws.tag_name ? { tag_name: ws.tag_name } : {}
+      };
+      render(dryResult, opts, () => {
+        const lines = [
+          `Dry run \u2014 no changes will be made.`,
+          `Action:        ${ws.action}`,
+          `Conversations: ${count}`
+        ];
+        if (ws.message) lines.push(`Message:       ${ws.message.trim()}`);
+        if (ws.close_after_reply) lines.push(`Close after:   yes`);
+        if (ws.procedure_id) lines.push(`Procedure ID:  ${ws.procedure_id}`);
+        if (ws.procedure_name) lines.push(`Procedure:     ${ws.procedure_name}`);
+        if (ws.tag_id) lines.push(`Tag ID:        ${ws.tag_id}`);
+        if (ws.tag_name) lines.push(`Tag:           ${ws.tag_name}`);
+        return lines.join("\n");
+      });
+      return;
+    }
+    if (process.stdout.isTTY && !opts.yes) {
+      console.log(
+        `About to send "${ws.action}" to ${count} conversation(s).`
+      );
+      if (ws.message) {
+        console.log(`Message: ${ws.message.trim()}`);
+      }
+      throw new CLIError(
+        `Add --yes to confirm, or use --dry-run to preview.`
+      );
+    }
+    const client = await resolveClient(opts);
+    const body = {
+      conversation_ids: conversationIds,
+      action_type: ws.action
+    };
+    if (ws.message) body.message = ws.message;
+    if (ws.close_after_reply != null) body.close_after_reply = ws.close_after_reply;
+    if (ws.procedure_id != null) body.procedure_id = ws.procedure_id;
+    if (ws.procedure_name != null) body.procedure_name = ws.procedure_name;
+    if (ws.tag_id != null) body.tag_id = ws.tag_id;
+    if (ws.tag_name != null) body.tag_name = ws.tag_name;
+    const result = await client.post(
+      "/fin-sdk/bulk-actions",
+      body
+    );
+    render(result, opts, () => {
+      return `Sent "${result.action_type}" to ${result.conversation_count} conversation(s). Status: ${result.status}`;
+    });
+  });
+}
+
 // src/commands/fin.ts
 function renderResourceTable(label, items) {
   if (items.length === 0) {
@@ -2948,19 +3417,21 @@ Examples:
   registerAudiencesCommand(fin);
   registerWorkflowsCommand(fin);
   registerSimulationsCommand(fin);
+  registerMonitorsCommand(fin);
+  registerConversationCommand(fin);
   fin.command("download").description("Download Fin SDK resources as a ZIP file").option("-o, --output <path>", "Output file path", "./fin-resources.zip").option("--verbose", "Show HTTP request/response details").action(async function() {
     const opts = this.optsWithGlobals();
     const outputPath = opts.output ?? "./fin-resources.zip";
     const client = await resolveClient(opts);
     const buffer = await client.getBuffer("/fin-sdk/download");
-    await writeFile2(outputPath, buffer);
+    await writeFile3(outputPath, buffer);
     console.log(`Downloaded ${buffer.length} bytes to ${outputPath}`);
   });
 }
 
 // src/commands/setup.ts
 import { readdirSync, readFileSync as readFileSync4, statSync } from "fs";
-import { join as join3, basename as basename2 } from "path";
+import { join as join5, basename as basename3 } from "path";
 function isGreenfield(opts) {
   return !!(opts.email && opts.name && (process.env.INTERCOM_PASSWORD || opts.passwordStdin));
 }
@@ -3018,8 +3489,8 @@ function buildPlan(opts) {
     }
     if (mdFiles.length > 0) {
       const articleCommands = mdFiles.map((file) => {
-        const title = basename2(file, ".md").replace(/-/g, " ").replace(/\b\w/g, (c2) => c2.toUpperCase());
-        return `intercom articles create -f title="${title}" -F body=@${join3(opts.articlesFrom, file)} -f author_id=$(intercom me --json | jq -r .id)`;
+        const title = basename3(file, ".md").replace(/-/g, " ").replace(/\b\w/g, (c2) => c2.toUpperCase());
+        return `intercom articles create -f title="${title}" -F body=@${join5(opts.articlesFrom, file)} -f author_id=$(intercom me --json | jq -r .id)`;
       });
       steps.push({
         step: stepNum++,
@@ -3085,8 +3556,8 @@ async function runPostAuthSteps(client, opts, results, appId) {
     let created = 0;
     let skipped = 0;
     for (const file of mdFiles) {
-      const title = basename2(file, ".md").replace(/-/g, " ").replace(/\b\w/g, (c2) => c2.toUpperCase());
-      const body = readFileSync4(join3(opts.articlesFrom, file), "utf-8");
+      const title = basename3(file, ".md").replace(/-/g, " ").replace(/\b\w/g, (c2) => c2.toUpperCase());
+      const body = readFileSync4(join5(opts.articlesFrom, file), "utf-8");
       if (existingTitles.has(title)) {
         skipped++;
       } else {
@@ -3554,7 +4025,7 @@ function registerPricingCommand(program) {
     }
     const markdown = await response.text();
     if (opts.json) {
-      const { formatJson: formatJson2 } = await import("./json-MMBOB7YU.js");
+      const { formatJson: formatJson2 } = await import("./json-OEUXXCTX.js");
       console.log(formatJson2({ url: PRICING_URL, content: markdown }));
     } else {
       console.log(markdown);
@@ -3563,7 +4034,7 @@ function registerPricingCommand(program) {
 }
 
 // src/commands/config.ts
-import { join as join4 } from "path";
+import { join as join6 } from "path";
 var SUPPORTED_KEYS = ["default_workspace", "timeout"];
 function configDir() {
   return process.env.INTERCOM_CONFIG_DIR ?? defaultConfigDir();
@@ -3652,7 +4123,7 @@ function registerConfigCommand(program) {
     console.log(`Set ${key} = ${value}`);
   });
   cmd.command("path").description("Show configuration file path").action(async function() {
-    console.log(join4(configDir(), "config.json"));
+    console.log(join6(configDir(), "config.json"));
   });
 }
 

package/dist/{json-MMBOB7YU.js → json-OEUXXCTX.js}

@@ -2,9 +2,9 @@
 import {
   applyJq,
   formatJson
-} from "./chunk-Y4JK5AHH.js";
+} from "./chunk-3V2ONMAU.js";
 export {
   applyJq,
   formatJson
 };
-//# sourceMappingURL=json-MMBOB7YU.js.map
+//# sourceMappingURL=json-OEUXXCTX.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intercom/cli",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "CLI tool for managing Intercom workspaces",
   "type": "module",
   "bin": {
@@ -28,7 +28,8 @@
     "adm-zip": "^0.5.16",
     "commander": "^14.0.3",
     "picocolors": "^1.1.1",
-    "turndown": "^7.2.2"
+    "turndown": "^7.2.2",
+    "yaml": "^2.8.3"
   },
   "devDependencies": {
     "@types/adm-zip": "^0.5.8",
@@ -37,6 +38,6 @@
     "msw": "^2.12.13",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "vitest": "^3.2.4"
+    "vitest": "^4.1.0"
   }
 }