@intercom/cli 0.8.1 → 0.8.3

package/CHANGELOG.md

@@ -7,6 +7,20 @@ 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
+
+- EU- and AU-hosted workspaces now send API requests to their regional host (`api.eu.intercom.io` / `api.au.intercom.io`) automatically. `intercom auth login` detects the workspace's region from `/me` and stores it, so commands route correctly. This fixes `fin workflows upload` (and `enable`/`disable`) failing with `No file provided` for EU/AU workspaces, which happened because uploads to the US host were proxied cross-region in a way that dropped the file. Existing EU/AU users should run `intercom auth login --token <token>` once to record their region. You can still override the host with `INTERCOM_API_BASE_URL`, or set `INTERCOM_REGION=eu|au|us` when authenticating via the `INTERCOM_TOKEN` environment variable.
+
 ## [0.8.1] - 2026-06-16
 
 ### Fixed

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

@@ -106,4 +106,4 @@ export {
   formatJson,
   applyJq
 };
-//# sourceMappingURL=chunk-3V2ONMAU.js.map
+//# sourceMappingURL=chunk-HMPO42TQ.js.map

package/dist/index.js

@@ -9,7 +9,7 @@ import {
   applyJq,
   detectAuthType,
   formatJson
-} from "./chunk-3V2ONMAU.js";
+} from "./chunk-HMPO42TQ.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -347,6 +347,43 @@ var IntercomClient = class _IntercomClient {
   }
 };
 
+// src/api/regions.ts
+var REGION_BASE_URLS = {
+  us: "https://api.intercom.io",
+  eu: "https://api.eu.intercom.io",
+  au: "https://api.au.intercom.io"
+};
+function regionBaseUrl(region) {
+  if (!region) return void 0;
+  return REGION_BASE_URLS[region];
+}
+function normalizeRegion(value) {
+  if (typeof value !== "string") return void 0;
+  switch (value.trim().toLowerCase()) {
+    case "us":
+    case "usa":
+    case "united states":
+      return "us";
+    case "eu":
+    case "europe":
+      return "eu";
+    case "au":
+    case "australia":
+      return "au";
+    default:
+      return void 0;
+  }
+}
+function detectRegion(me) {
+  if (!me || typeof me !== "object") return void 0;
+  const m = me;
+  const app = m.app;
+  return normalizeRegion(app?.region ?? m.region);
+}
+function resolveBaseUrl(region) {
+  return process.env.INTERCOM_API_BASE_URL || regionBaseUrl(region) || void 0;
+}
+
 // src/auth/store.ts
 import { readFileSync, mkdirSync } from "fs";
 
@@ -583,7 +620,7 @@ async function resolveClient(options = {}) {
       token: envToken,
       authType: detectAuthType(envToken),
       appId: process.env.INTERCOM_APP_ID ?? "",
-      baseUrl: process.env.INTERCOM_API_BASE_URL || void 0,
+      baseUrl: resolveBaseUrl(normalizeRegion(process.env.INTERCOM_REGION)),
       verbose: options.verbose,
       maxRetries: options.retry === false ? 0 : void 0,
       timeoutMs: options.timeout ? parseInt(options.timeout, 10) * 1e3 : void 0
@@ -613,7 +650,7 @@ async function resolveClient(options = {}) {
     token: cred.token,
     authType: cred.auth_type,
     appId: cred.app_id,
-    baseUrl: process.env.INTERCOM_API_BASE_URL || void 0,
+    baseUrl: resolveBaseUrl(cred.region),
     verbose: options.verbose,
     maxRetries: options.retry === false ? 0 : void 0,
     timeoutMs: options.timeout ? parseInt(options.timeout, 10) * 1e3 : void 0
@@ -833,11 +870,13 @@ async function loginWithToken(token) {
   const app = me.app;
   const appId = app?.id_code ?? me.id;
   const name = app?.name ?? "Unknown";
+  const region = detectRegion(me);
   const configDir2 = process.env.INTERCOM_CONFIG_DIR;
   const store = new CredentialStore(createDefaultBackend(configDir2));
-  await store.set(appId, { token, auth_type: authType, app_id: appId });
-  await addWorkspace(configDir2, { app_id: appId, name });
-  console.log(`Authenticated to ${name} (${appId})`);
+  await store.set(appId, { token, auth_type: authType, app_id: appId, region });
+  await addWorkspace(configDir2, { app_id: appId, name, region });
+  const regionLabel = region ? ` [${region.toUpperCase()}]` : "";
+  console.log(`Authenticated to ${name} (${appId})${regionLabel}`);
   emitClaudeCodeHint();
 }
 
@@ -2775,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() {
@@ -2795,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",
@@ -2826,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(
@@ -2862,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();
@@ -2898,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();
@@ -4090,7 +4159,7 @@ function registerPricingCommand(program) {
     }
     const markdown = await response.text();
     if (opts.json) {
-      const { formatJson: formatJson2 } = await import("./json-OEUXXCTX.js");
+      const { formatJson: formatJson2 } = await import("./json-BJB55URV.js");
       console.log(formatJson2({ url: PRICING_URL, content: markdown }));
     } else {
       console.log(markdown);

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

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

package/package.json

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