@intercom/cli 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -7,6 +7,12 @@ 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

package/dist/index.js

@@ -3183,20 +3183,26 @@ 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 = parseYaml3(text);
       render(parsed, opts, () => formatJson(parsed));
@@ -3314,6 +3320,45 @@ 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intercom/cli",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "CLI tool for managing Intercom workspaces",
   "type": "module",
   "packageManager": "pnpm@10.23.0",