@intercom/cli 0.8.2 → 0.8.3

package/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 View it from the CLI with `intercom changelog`.
 
+## [0.8.3] - 2026-06-18
+
+### Fixed
+
+- `fin workflows upload` now works with workflow YAML that doesn't declare a top-level `type:`. The upload endpoint is shared with procedures and routes by that field, so a workflow file without `type: workflow` was being validated as a procedure (`object at root is missing required properties: name, trigger_description, procedure`). The CLI now sets `type: workflow` for you when it's absent.
+- `fin workflows enable` and `fin workflows disable` no longer fail with `Resource not found`. They re-upload the workflow after changing its state, and the re-uploaded YAML was missing `type: workflow`, so the server looked for a procedure with that id and 404'd. The state-change upload now carries `type: workflow`.
+- `fin workflows get <id>` now prints the workflow as YAML (the format `upload` expects) instead of a lossy JSON summary, and accepts an optional output file: `intercom fin workflows get 42 workflow.yaml`. `--json` still returns parsed JSON.
+
 ## [0.8.2] - 2026-06-17
 
 ### Fixed

package/dist/index.js

@@ -2814,6 +2814,24 @@ import { basename as basename2 } from "path";
 import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
 var STATE_LIVE = "live";
 var STATE_PAUSED = "paused";
+var WORKFLOW_TYPE = "workflow";
+function ensureWorkflowType(raw) {
+  let parsed;
+  try {
+    parsed = parseYaml(raw);
+  } catch {
+    return raw;
+  }
+  if (parsed == null || typeof parsed !== "object" || Array.isArray(parsed)) {
+    return raw;
+  }
+  const obj = parsed;
+  if (obj.type != null && obj.type !== "") {
+    return raw;
+  }
+  obj.type = WORKFLOW_TYPE;
+  return stringifyYaml(obj);
+}
 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() {
@@ -2834,22 +2852,31 @@ 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("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").action(async function(id) {
+  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(
+    "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
+
+The YAML it prints is ready to edit and re-upload with
+\`intercom fin workflows upload\`.`
+  ).action(async function(id, output) {
     const opts = this.optsWithGlobals();
     const client = await resolveClient(opts);
     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
-      })
-    );
+    if (opts.json || opts.jq || opts.agent) {
+      const parsed = parseYaml(text);
+      render(parsed, opts, () => formatJson(parsed));
+      return;
+    }
+    if (output) {
+      await atomicWriteFile(output, text, 420);
+      console.error(`Wrote workflow ${id} to ${output}`);
+    } else {
+      console.log(text.replace(/\n+$/, ""));
+    }
   });
   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",
@@ -2865,9 +2892,10 @@ The YAML file's id field determines whether this creates or updates:
   ).action(async function(filePath) {
     const opts = this.optsWithGlobals();
     const client = await resolveClient(opts);
-    const fileContent = await readFile3(filePath);
+    const fileContent = await readFile3(filePath, "utf8");
+    const yamlBody = ensureWorkflowType(fileContent);
     const formData = new FormData();
-    const blob = new Blob([fileContent], { type: "application/x-yaml" });
+    const blob = new Blob([yamlBody], { type: "application/x-yaml" });
     formData.append("file_data", blob, basename2(filePath));
     const result = await client.postFormData("/fin-sdk/upload", formData);
     render(
@@ -2901,6 +2929,7 @@ overwritten (the server does not expose a concurrency token).`
     } catch (err) {
       throw new Error(`server returned unparseable YAML for workflow ${id}: ${err.message}`);
     }
+    parsed.type = WORKFLOW_TYPE;
     parsed.state = STATE_LIVE;
     const yamlBody = stringifyYaml(parsed);
     const formData = new FormData();
@@ -2937,6 +2966,7 @@ overwritten (the server does not expose a concurrency token).`
     } catch (err) {
       throw new Error(`server returned unparseable YAML for workflow ${id}: ${err.message}`);
     }
+    parsed.type = WORKFLOW_TYPE;
     parsed.state = STATE_PAUSED;
     const yamlBody = stringifyYaml(parsed);
     const formData = new FormData();

package/package.json

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