@intercom/cli 0.9.0 → 0.11.0

package/CHANGELOG.md

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 View it from the CLI with `intercom changelog`.
 
+## [0.11.0] - 2026-08-17
+
+### Added
+
+- `fin workflows versions <id>` lists a workflow's server-side version history, showing which version is live, which is draft, and who saved it. `fin workflows get <id> --version <version_id>` downloads any of those versions as re-uploadable YAML, so a local file can be diffed against what Fin is actually running.
+
+## [0.10.0] - 2026-08-17
+
+### Added
+
+- `fin procedures publish <id>` sets a procedure's state to live, and `fin procedures pause <id>` sets it to paused — a convenience for download, edit the state, and re-upload. Both accept `--note <text>` to label the save in `fin procedures versions <id>`. There is no `draft` verb: the upload endpoint rejects that state and directs you to `pause`.
+- `fin procedures versions <id>` lists a procedure's server-side version history, showing which version is live, which is draft, and who saved it. `fin procedures get <id> --version <version_id>` downloads any of those versions as re-uploadable YAML, so a local file can be diffed against what Fin is actually running.
+- `fin procedures upload <file> --note <text>` records a version note against the save, so the entry is identifiable in `fin procedures versions`. `--verify` compares what the server saved against the file you uploaded and exits non-zero listing any field that did not survive the round-trip (fields the server adds, like ids and defaults, are ignored) — useful when a setting silently resets on push.
+- `fin attributes get <name>` shows a single Fin custom attribute by name. `fin attributes download <file>` exports all attributes to a YAML file in the shape `fin attributes upload` accepts, completing the export/edit/re-import round-trip (attributes previously supported only `list` and `upload`).
+
+### Changed
+
+- `--dry-run` (`-n`) now prints the actual file payload for upload commands (`fin attributes upload`, `fin procedures upload`, `fin simulations upload`, `fin workflows upload`) instead of an opaque `[FormData]`. You can now preview the exact YAML that would be sent — including the routing `type:` the CLI adds for you — before uploading.
+
 ## [0.9.0] - 2026-07-03
 
 ### Added

package/dist/index.js

@@ -84,6 +84,9 @@ var _dryRun = false;
 function setDryRun(enabled) {
   _dryRun = enabled;
 }
+function isDryRun() {
+  return _dryRun;
+}
 var IntercomClient = class _IntercomClient {
   token;
   authType;
@@ -153,10 +156,18 @@ var IntercomClient = class _IntercomClient {
     const url = `${this.baseUrl}${path}`;
     if (_dryRun) {
       console.error(`> ${method} ${url}`);
-      if (body) {
-        console.error(
-          `> Body: ${body instanceof FormData ? "[FormData]" : JSON.stringify(body)}`
-        );
+      if (body instanceof FormData) {
+        for (const [name, value] of body.entries()) {
+          if (typeof value === "string") {
+            console.error(`> ${name}: ${value}`);
+          } else {
+            const fileName = "name" in value ? value.name : "file";
+            console.error(`> ${name} (${fileName}):
+${await value.text()}`);
+          }
+        }
+      } else if (body) {
+        console.error(`> Body: ${JSON.stringify(body)}`);
       }
       return {};
     }
@@ -2572,6 +2583,46 @@ import { writeFile as writeFile3 } from "fs/promises";
 import { readFile as readFile2, mkdir as mkdir2 } from "fs/promises";
 import { basename, join as join3 } from "path";
 import AdmZip from "adm-zip";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+
+// src/utils/yaml-drift.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function scalarsMatch(sent, saved) {
+  if (sent == null && saved == null) {
+    return true;
+  }
+  if (sent == null || saved == null) {
+    return false;
+  }
+  if (typeof saved === "object") {
+    return false;
+  }
+  return String(sent) === String(saved);
+}
+function findDrift(sent, saved, path = "") {
+  const here = path || ".";
+  if (Array.isArray(sent)) {
+    if (!Array.isArray(saved) || saved.length !== sent.length) {
+      return [here];
+    }
+    return sent.flatMap((item, index) => findDrift(item, saved[index], `${path}[${index}]`));
+  }
+  if (isRecord(sent)) {
+    if (!isRecord(saved)) {
+      return [here];
+    }
+    return Object.entries(sent).flatMap(
+      ([key, value]) => findDrift(value, saved[key], path ? `${path}.${key}` : key)
+    );
+  }
+  return scalarsMatch(sent, saved) ? [] : [here];
+}
+
+// src/commands/fin/procedures.ts
+var STATE_LIVE = "live";
+var STATE_PAUSED = "paused";
 function registerProceduresCommand(fin) {
   const procedures = fin.command("procedures").description("Manage Fin SDK procedures");
   procedures.command("list").description("List procedures from the Fin SDK manifest").option("--json", "Output as JSON").option("--verbose", "Show HTTP request/response details").action(async function() {
@@ -2591,7 +2642,7 @@ function registerProceduresCommand(fin) {
       return table({ columns: ["ID", "NAME"], rows });
     }, items);
   });
-  procedures.command("get <id> [output]").description("Download a procedure by ID as YAML (writes to [output], or stdout)").option("--with-simulations", "Also download the procedure's simulations").option("--verbose", "Show HTTP request/response details").addHelpText(
+  procedures.command("get <id> [output]").description("Download a procedure by ID as YAML (writes to [output], or stdout)").option("--with-simulations", "Also download the procedure's simulations").option("--version <version_id>", "Download a historical version instead of the current one").option("--verbose", "Show HTTP request/response details").addHelpText(
     "after",
     `
 Examples:
@@ -2599,22 +2650,26 @@ Examples:
   $ intercom fin procedures get proc-1 procedure.yaml        # write YAML to a file
   $ intercom fin procedures get proc-1 ./out --with-simulations
       # writes ./out/procedure.yaml and ./out/simulations.yaml
+  $ intercom fin procedures versions proc-1                  # find a version ID
+  $ intercom fin procedures get proc-1 --version 4821        # print that version's YAML
 
 With --with-simulations, [output] is treated as a directory (default: current
 directory). Without it, [output] is a single file for the procedure YAML.
 
+--version downloads the re-uploadable YAML of a historical version, so you can
+diff a local file against what is live (\`intercom fin procedures versions <id>\`
+shows which version that is). Simulations are not versioned, so --version and
+--with-simulations cannot be combined.
+
 Re-import the pieces with \`intercom fin procedures upload <procedure.yaml>\`
 and \`intercom fin simulations upload <simulations.yaml>\`.`
   ).action(async function(id, output) {
     const opts = this.optsWithGlobals();
-    const client = await resolveClient(opts);
-    const buffer = await client.getBuffer(`/fin-sdk/procedures/${id}/download`);
-    const zip = new AdmZip(buffer);
-    const entry = zip.getEntries().find((e) => e.entryName.endsWith("procedure.yaml"));
-    if (!entry) {
-      throw new Error("procedure.yaml not found in downloaded ZIP");
+    if (opts.version && opts.withSimulations) {
+      throw new CLIError("--version cannot be combined with --with-simulations (simulations are not versioned)");
     }
-    const procedureYaml = zip.readAsText(entry);
+    const client = await resolveClient(opts);
+    const procedureYaml = opts.version ? await getVersionYaml(client, id, opts.version) : await getCurrentYaml(client, id);
     let simulationsYaml;
     if (opts.withSimulations) {
       simulationsYaml = await client.getText(`/fin-sdk/procedures/${id}/simulations`);
@@ -2637,17 +2692,163 @@ and \`intercom fin simulations upload <simulations.yaml>\`.`
       console.log(procedureYaml);
     }
   });
-  procedures.command("upload <file>").description("Upload a procedure file to Fin SDK").option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").action(async function(filePath) {
+  procedures.command("upload <file>").description("Upload a procedure file to Fin SDK").option("--note <text>", "Version note to record against this save").option("--verify", "Fail if the saved procedure differs from the file uploaded").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 procedures upload procedure.yaml
+  $ intercom fin procedures upload procedure.yaml --note "tightened refund wording"
+  $ intercom fin procedures upload procedure.yaml --verify
+
+--note labels this save in the procedure's version history, so it is
+identifiable in \`intercom fin procedures versions <id>\` instead of appearing
+as an unlabelled entry.
+
+--verify compares the procedure the server saved against the file just uploaded
+and exits non-zero listing any field that did not survive the round-trip. Fields
+the server adds (ids, defaults) are ignored; only content that was sent and came
+back missing or changed is reported.`
+  ).action(async function(filePath) {
     const opts = this.optsWithGlobals();
     const client = await resolveClient(opts);
     const fileContent = await readFile2(filePath);
     const formData = new FormData();
     const blob = new Blob([fileContent], { type: "application/x-yaml" });
     formData.append("file_data", blob, basename(filePath));
+    if (opts.note) {
+      formData.append("version_note", opts.note);
+    }
     const result = await client.postFormData("/fin-sdk/upload", formData);
     render(result, opts, () => formatJson(result));
+    if (opts.verify) {
+      verifySaved(filePath, fileContent.toString("utf8"), result);
+    }
+  });
+  procedures.command("publish <id>").description("Set a procedure's state to live").option("--note <text>", "Version note to record against this save").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 procedures publish proc-1
+  $ intercom fin procedures publish proc-1 --note "tightened refund wording"
+
+This is a convenience for download \u2192 set state \u2192 upload. If another operator
+edits the procedure between the download and upload, those edits will be
+overwritten (the server does not expose a concurrency token).
+
+--note labels this save in \`intercom fin procedures versions <id>\`.`
+  ).action(async function(id) {
+    const opts = this.optsWithGlobals();
+    await setProcedureState(id, STATE_LIVE, opts);
+  });
+  procedures.command("pause <id>").description("Set a procedure's state to paused").option("--note <text>", "Version note to record against this save").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 procedures pause proc-1
+  $ intercom fin procedures pause proc-1 --note "pausing during refund policy review"
+
+This is a convenience for download \u2192 set state \u2192 upload. If another operator
+edits the procedure between the download and upload, those edits will be
+overwritten (the server does not expose a concurrency token).
+
+pause is the way to deactivate a procedure: the server rejects an uploaded
+\`state: draft\` outright, so there is no separate "unpublish to draft" command.
+
+--note labels this save in \`intercom fin procedures versions <id>\`.`
+  ).action(async function(id) {
+    const opts = this.optsWithGlobals();
+    await setProcedureState(id, STATE_PAUSED, opts);
+  });
+  procedures.command("versions <id>").description("List a procedure's server-side version history (which one is 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 procedures versions proc-1
+  $ intercom fin procedures versions proc-1 --jq '.entity_version_id'
+
+STATUS is the server's own vocabulary: live is what Fin is running now, draft is
+unpublished, previously_live is superseded. Download any of them with
+\`intercom fin procedures get <id> --version <VERSION>\`.`
+  ).action(async function(id) {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const result = await client.get(`/fin-sdk/procedures/${id}/versions`);
+    const items = result.versions ?? [];
+    render(items, opts, () => {
+      if (items.length === 0) {
+        return "No versions found.";
+      }
+      const rows = items.map((v) => ({
+        VERSION: String(v.entity_version_id ?? ""),
+        STATUS: String(v.status ?? ""),
+        CREATED: String(v.created_at ?? ""),
+        AUTHOR: String(v.author?.name ?? ""),
+        NOTE: String(v.note ?? "")
+      }));
+      return table({ columns: ["VERSION", "STATUS", "CREATED", "AUTHOR", "NOTE"], rows });
+    }, items);
   });
 }
+async function setProcedureState(id, state, opts) {
+  const client = await resolveClient(opts);
+  if (isDryRun()) {
+    console.error(`> would set procedure ${id} state to ${state}`);
+    return;
+  }
+  const procedureYaml = await getCurrentYaml(client, id);
+  let parsed;
+  try {
+    parsed = parseYaml(procedureYaml);
+  } catch (err) {
+    throw new CLIError(
+      `server returned unparseable YAML for procedure ${id}: ${err.message}`
+    );
+  }
+  parsed.state = state;
+  const formData = new FormData();
+  const blob = new Blob([stringifyYaml(parsed)], { type: "application/x-yaml" });
+  formData.append("file_data", blob, `procedure-${id}.yaml`);
+  if (opts.note) {
+    formData.append("version_note", opts.note);
+  }
+  const result = await client.postFormData("/fin-sdk/upload", formData);
+  render(result, opts, () => formatJson(result));
+}
+async function getCurrentYaml(client, id) {
+  const buffer = await client.getBuffer(`/fin-sdk/procedures/${id}/download`);
+  const zip = new AdmZip(buffer);
+  const entry = zip.getEntries().find((e) => e.entryName.endsWith("procedure.yaml"));
+  if (!entry) {
+    throw new CLIError("procedure.yaml not found in downloaded ZIP");
+  }
+  return zip.readAsText(entry);
+}
+async function getVersionYaml(client, id, versionId) {
+  const result = await client.get(
+    `/fin-sdk/procedures/${id}/versions/${versionId}`
+  );
+  const content = result.content;
+  if (content == null) {
+    throw new CLIError(`Procedure version ${versionId} returned no content`);
+  }
+  return typeof content === "string" ? content : stringifyYaml(content);
+}
+function verifySaved(filePath, sentYaml, result) {
+  if (typeof result.new_file_content !== "string") {
+    throw new CLIError("Cannot verify: the server did not return the saved procedure");
+  }
+  const drift = findDrift(parseYaml(sentYaml), parseYaml(result.new_file_content));
+  if (drift.length === 0) {
+    console.error(`Verified: the saved procedure matches ${filePath}`);
+    return;
+  }
+  for (const path of drift) {
+    console.error(`  ${path}`);
+  }
+  throw new CLIError(
+    `${drift.length} field(s) did not survive the upload (listed above). Compare with \`intercom fin procedures get ${result.id ?? "<id>"}\`.`
+  );
+}
 
 // src/commands/fin/data-connectors.ts
 function summarizeKeys(obj) {
@@ -2803,34 +3004,37 @@ Optional fields: state (live or paused, default: paused), audiences`
 // src/commands/fin/attributes.ts
 import { readFile as readFile3 } from "fs/promises";
 import { basename as basename2 } from "path";
-import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+import { parse as parseYaml2, stringify as stringifyYaml2 } from "yaml";
 var ATTRIBUTE_TYPE = "attribute";
+async function fetchAttributes(client) {
+  const result = await client.get("/fin-sdk/attributes");
+  return Array.isArray(result) ? result : result.attributes ?? [];
+}
 function buildAttributesUploadBody(raw) {
   let parsed;
   try {
-    parsed = parseYaml(raw);
+    parsed = parseYaml2(raw);
   } catch {
     return raw;
   }
   if (Array.isArray(parsed)) {
-    return stringifyYaml({ type: ATTRIBUTE_TYPE, attributes: parsed });
+    return stringifyYaml2({ type: ATTRIBUTE_TYPE, attributes: parsed });
   }
   if (parsed == null || typeof parsed !== "object") {
     return raw;
   }
   const obj = parsed;
   if (Array.isArray(obj.attributes)) {
-    return stringifyYaml({ ...obj, type: ATTRIBUTE_TYPE });
+    return stringifyYaml2({ ...obj, type: ATTRIBUTE_TYPE });
   }
-  return stringifyYaml({ type: ATTRIBUTE_TYPE, attributes: [obj] });
+  return stringifyYaml2({ type: ATTRIBUTE_TYPE, attributes: [obj] });
 }
 function registerAttributesCommand(fin) {
   const attributes = fin.command("attributes").description("Manage Fin SDK attributes");
   attributes.command("list").description("List Fin SDK attributes").option("--json", "Output as JSON").option("--verbose", "Show HTTP request/response details").action(async function() {
     const opts = this.optsWithGlobals();
     const client = await resolveClient(opts);
-    const result = await client.get("/fin-sdk/attributes");
-    const items = Array.isArray(result) ? result : result.attributes ?? [];
+    const items = await fetchAttributes(client);
     render(items, opts, () => {
       if (items.length === 0) {
         return "No attributes found.";
@@ -2843,6 +3047,32 @@ function registerAttributesCommand(fin) {
       return table({ columns: ["NAME", "TYPE", "DESCRIPTION"], rows });
     }, items);
   });
+  attributes.command("get <name>").description("Show a single Fin SDK attribute by name").option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").action(async function(name) {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const items = await fetchAttributes(client);
+    const match = items.find((item) => item.name === name);
+    if (!match) {
+      throw new NotFoundError(`No Fin attribute named "${name}".`);
+    }
+    render(
+      match,
+      opts,
+      () => detail({
+        "Name": match.name != null ? String(match.name) : void 0,
+        "Type": match.type != null ? String(match.type) : void 0,
+        "Description": match.description != null ? String(match.description) : void 0
+      })
+    );
+  });
+  attributes.command("download <file>").description("Download all Fin SDK attributes to a YAML file").option("--verbose", "Show HTTP request/response details").action(async function(filePath) {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const items = await fetchAttributes(client);
+    const yaml = stringifyYaml2({ type: ATTRIBUTE_TYPE, attributes: items });
+    await atomicWriteFile(filePath, yaml, 420);
+    console.error(`Wrote ${items.length} attribute${items.length === 1 ? "" : "s"} to ${filePath}`);
+  });
   attributes.command("upload <file>").description("Upload attributes from a YAML file (creates or updates)").option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").addHelpText(
     "after",
     `
@@ -2912,14 +3142,14 @@ function registerAudiencesCommand(fin) {
 // src/commands/fin/workflows.ts
 import { readFile as readFile4 } from "fs/promises";
 import { basename as basename3 } from "path";
-import { parse as parseYaml2, stringify as stringifyYaml2 } from "yaml";
-var STATE_LIVE = "live";
-var STATE_PAUSED = "paused";
+import { parse as parseYaml3, stringify as stringifyYaml3 } from "yaml";
+var STATE_LIVE2 = "live";
+var STATE_PAUSED2 = "paused";
 var WORKFLOW_TYPE = "workflow";
 function ensureWorkflowType(raw) {
   let parsed;
   try {
-    parsed = parseYaml2(raw);
+    parsed = parseYaml3(raw);
   } catch {
     return raw;
   }
@@ -2931,7 +3161,7 @@ function ensureWorkflowType(raw) {
     return raw;
   }
   obj.type = WORKFLOW_TYPE;
-  return stringifyYaml2(obj);
+  return stringifyYaml3(obj);
 }
 function registerWorkflowsCommand(fin) {
   const workflows = fin.command("workflows").description("Manage Fin SDK workflows");
@@ -2953,22 +3183,28 @@ function registerWorkflowsCommand(fin) {
       return table({ columns: ["ID", "TITLE", "STATE", "TRIGGER"], rows });
     }, items);
   });
-  workflows.command("get <id> [output]").description("Get a workflow by ID as YAML (writes to [output] file, or stdout)").option("--json", "Output as parsed JSON instead of YAML").option("--jq <expr>", "Filter parsed-JSON output with a jq expression").option("--verbose", "Show HTTP request/response details").addHelpText(
+  workflows.command("get <id> [output]").description("Get a workflow by ID as YAML (writes to [output] file, or stdout)").option("--json", "Output as parsed JSON instead of YAML").option("--jq <expr>", "Filter parsed-JSON output with a jq expression").option("--version <version_id>", "Download a historical version instead of the current one").option("--verbose", "Show HTTP request/response details").addHelpText(
     "after",
     `
 Examples:
   $ intercom fin workflows get 42 workflow.yaml     # write YAML to a file
   $ intercom fin workflows get 42 > workflow.yaml   # or redirect stdout
   $ intercom fin workflows get 42 --json | jq .state
+  $ intercom fin workflows versions 42              # find a version ID
+  $ intercom fin workflows get 42 --version 4821    # print that version's YAML
 
 The YAML it prints is ready to edit and re-upload with
-\`intercom fin workflows upload\`.`
+\`intercom fin workflows upload\`.
+
+--version downloads the re-uploadable YAML of a historical version, so you can
+diff a local file against what is live (\`intercom fin workflows versions <id>\`
+shows which version that is).`
   ).action(async function(id, output) {
     const opts = this.optsWithGlobals();
     const client = await resolveClient(opts);
-    const text = await client.getText(`/fin-sdk/workflows/${id}`);
+    const text = opts.version ? await getVersionYaml2(client, id, opts.version) : await client.getText(`/fin-sdk/workflows/${id}`);
     if (opts.json || opts.jq || opts.agent) {
-      const parsed = parseYaml2(text);
+      const parsed = parseYaml3(text);
       render(parsed, opts, () => formatJson(parsed));
       return;
     }
@@ -3026,13 +3262,13 @@ overwritten (the server does not expose a concurrency token).`
     const text = await client.getText(`/fin-sdk/workflows/${id}`);
     let parsed;
     try {
-      parsed = parseYaml2(text);
+      parsed = parseYaml3(text);
     } catch (err) {
       throw new Error(`server returned unparseable YAML for workflow ${id}: ${err.message}`);
     }
     parsed.type = WORKFLOW_TYPE;
-    parsed.state = STATE_LIVE;
-    const yamlBody = stringifyYaml2(parsed);
+    parsed.state = STATE_LIVE2;
+    const yamlBody = stringifyYaml3(parsed);
     const formData = new FormData();
     const blob = new Blob([yamlBody], { type: "application/x-yaml" });
     formData.append("file_data", blob, `workflow-${id}.yaml`);
@@ -3063,13 +3299,13 @@ overwritten (the server does not expose a concurrency token).`
     const text = await client.getText(`/fin-sdk/workflows/${id}`);
     let parsed;
     try {
-      parsed = parseYaml2(text);
+      parsed = parseYaml3(text);
     } catch (err) {
       throw new Error(`server returned unparseable YAML for workflow ${id}: ${err.message}`);
     }
     parsed.type = WORKFLOW_TYPE;
-    parsed.state = STATE_PAUSED;
-    const yamlBody = stringifyYaml2(parsed);
+    parsed.state = STATE_PAUSED2;
+    const yamlBody = stringifyYaml3(parsed);
     const formData = new FormData();
     const blob = new Blob([yamlBody], { type: "application/x-yaml" });
     formData.append("file_data", blob, `workflow-${id}.yaml`);
@@ -3084,17 +3320,56 @@ overwritten (the server does not expose a concurrency token).`
       })
     );
   });
+  workflows.command("versions <id>").description("List a workflow's server-side version history (which one is 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 versions 42
+  $ intercom fin workflows versions 42 --jq '.entity_version_id'
+
+STATUS is the server's own vocabulary: live is what Fin is running now, draft is
+unpublished, previously_live is superseded. Download any of them with
+\`intercom fin workflows get <id> --version <VERSION>\`.`
+  ).action(async function(id) {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const result = await client.get(`/fin-sdk/workflows/${id}/versions`);
+    const items = result.versions ?? [];
+    render(items, opts, () => {
+      if (items.length === 0) {
+        return "No versions found.";
+      }
+      const rows = items.map((v) => ({
+        VERSION: String(v.entity_version_id ?? ""),
+        STATUS: String(v.status ?? ""),
+        CREATED: String(v.created_at ?? ""),
+        AUTHOR: String(v.author?.name ?? ""),
+        NOTE: String(v.note ?? "")
+      }));
+      return table({ columns: ["VERSION", "STATUS", "CREATED", "AUTHOR", "NOTE"], rows });
+    }, items);
+  });
+}
+async function getVersionYaml2(client, id, versionId) {
+  const result = await client.get(
+    `/fin-sdk/workflows/${id}/versions/${versionId}`
+  );
+  const content = result.content;
+  if (content == null) {
+    throw new CLIError(`Workflow version ${versionId} returned no content`);
+  }
+  return typeof content === "string" ? content : stringifyYaml3(content);
 }
 
 // src/commands/fin/simulations.ts
 import { readFile as readFile5 } from "fs/promises";
 import { basename as basename4 } from "path";
-import { parse as parseYaml3, stringify as stringifyYaml3 } from "yaml";
+import { parse as parseYaml4, stringify as stringifyYaml4 } from "yaml";
 var SIMULATION_SET_TYPE = "simulation_set";
 function ensureSimulationSetType(raw) {
   let parsed;
   try {
-    parsed = parseYaml3(raw);
+    parsed = parseYaml4(raw);
   } catch {
     return raw;
   }
@@ -3106,7 +3381,7 @@ function ensureSimulationSetType(raw) {
     return raw;
   }
   obj.type = SIMULATION_SET_TYPE;
-  return stringifyYaml3(obj);
+  return stringifyYaml4(obj);
 }
 function registerSimulationsCommand(fin) {
   const simulations = fin.command("simulations").description("Manage Fin SDK simulations");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intercom/cli",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "CLI tool for managing Intercom workspaces",
   "type": "module",
   "packageManager": "pnpm@10.23.0",
@@ -41,9 +41,5 @@
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vitest": "^4.1.0"
-  },
-  "pnpm": {
-    "overrides": {},
-    "onlyBuiltDependencies": []
   }
 }