@outlit/cli 3.2.0 → 3.2.2

package/dist/cli.js

@@ -104,7 +104,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@outlit/cli",
-    version: "3.2.0",
+    version: "3.2.2",
     description: "CLI for querying Outlit customer context and installing agent skills",
     license: "Apache-2.0",
     repository: {
@@ -147,7 +147,7 @@ var init_package = __esm(() => {
     },
     dependencies: {
       "@clack/prompts": "^1.0.1",
-      "@outlit/tools": "^2.2.0",
+      "@outlit/tools": "^2.2.1",
       citty: "^0.2.1"
     },
     devDependencies: {
@@ -15776,6 +15776,7 @@ Returns column definitions and example queries for each view.`,
           "TOOL_BINDING_MISSING",
           "TOOL_IMPLEMENTATION_ERROR",
           "TOOL_OUTPUT_INVALID",
+          "TOOL_RESOURCE_NOT_FOUND",
           "TOOL_RESULT_TOO_LARGE",
           "TOOL_GATEWAY_ERROR",
           "plan_api_limit_exceeded",
@@ -19251,6 +19252,15 @@ function readCommandOutput2(command, args) {
     return null;
   }
 }
+function isStandaloneInstall2(argv = process.argv) {
+  const scriptPath = argv[1];
+  if (!scriptPath)
+    return true;
+  if (scriptPath.startsWith("/$bunfs/") || scriptPath.startsWith("~bunfs"))
+    return true;
+  const resolved = safeRealPath2(scriptPath) ?? scriptPath;
+  return !/\.(?:cjs|mjs|jsx?|tsx?)$/.test(resolved);
+}
 function inferInstaller2() {
   const fromAgent = inferInstallerFromUserAgent2(process.env.npm_config_user_agent ?? "");
   if (fromAgent)
@@ -19273,8 +19283,11 @@ function safeRealPath2(filePath) {
     return null;
   }
 }
-function formatUpdateCommand2(installer = inferInstaller2()) {
-  switch (installer) {
+function formatUpdateCommand2(installer, argv = process.argv) {
+  if (isStandaloneInstall2(argv))
+    return STANDALONE_UPDATE_HINT2;
+  const resolved = installer === undefined ? inferInstaller2() : installer;
+  switch (resolved) {
     case "bun":
       return "bun add -g @outlit/cli";
     case "npm":
@@ -19326,15 +19339,16 @@ async function fetchLatestCliVersion2() {
     throw new Error("registry returned no version");
   return data.version;
 }
-function runUpgradeCommand(command) {
-  const result = spawnSync2(command.command, command.args, { stdio: "inherit" });
+function runUpgradeCommand(command, opts) {
+  const stdio = opts?.stdoutToStderr ? ["ignore", process.stderr, process.stderr] : "inherit";
+  const result = spawnSync2(command.command, command.args, { stdio });
   if (result.error)
     throw result.error;
   if (result.status !== 0 || result.signal) {
     throw new Error(`Upgrade command failed: ${command.displayCommand}`);
   }
 }
-var UPDATE_CHECK_INTERVAL_MS2, PACKAGE_NAME2 = "@outlit/cli", LATEST_VERSION_URL2 = "https://registry.npmjs.org/@outlit%2Fcli/latest";
+var UPDATE_CHECK_INTERVAL_MS2, PACKAGE_NAME2 = "@outlit/cli", LATEST_VERSION_URL2 = "https://registry.npmjs.org/@outlit%2Fcli/latest", STANDALONE_UPDATE_HINT2 = "re-run your original install method (for example `curl -fsSL https://outlit.ai/install.sh | bash` or `brew upgrade outlitai/tap/outlit`), or download the latest release from https://github.com/OutlitAI/outlit-sdk/releases";
 var init_update2 = __esm(() => {
   init_config();
   init_tty();
@@ -19695,26 +19709,77 @@ function checkApiKeyPresence(credential) {
 }
 async function validateApiKey(apiKey) {
   try {
-    await pingApiKey(apiKey);
-    return { name: "API validation", status: "pass", message: "Key is valid" };
+    const validation = await pingApiKey(apiKey);
+    const org = validation.organization?.name ?? validation.organization?.slug ?? validation.organizationId;
+    const keyDetail = validation.apiKey ? ` · key "${validation.apiKey.name}" (${validation.apiKey.keyType})` : "";
+    return {
+      check: {
+        name: "API validation",
+        status: "pass",
+        message: "Key is valid",
+        detail: `Org: ${org}${keyDetail}`
+      },
+      validation
+    };
   } catch (err) {
     if (isApiKeyValidationUnavailableError(err)) {
       return {
-        name: "API validation",
-        status: "warn",
-        message: "API validation is temporarily unavailable",
-        detail: "Try again shortly"
+        check: {
+          name: "API validation",
+          status: "warn",
+          message: "API validation is temporarily unavailable",
+          detail: "Try again shortly"
+        },
+        validation: null
       };
     }
     return {
-      name: "API validation",
-      status: "fail",
-      message: `API rejected key: ${errorMessage(err, "unknown error")}`,
-      detail: `Check your key at ${OUTLIT_DASHBOARD_URL}`
+      check: {
+        name: "API validation",
+        status: "fail",
+        message: `API rejected key: ${errorMessage(err, "unknown error")}`,
+        detail: `Check your key at ${OUTLIT_DASHBOARD_URL}`
+      },
+      validation: null
     };
   }
 }
-async function checkIntegrations(apiKey) {
+function grantUsable(grant, grants, createdById) {
+  if (!grants.includes(grant))
+    return false;
+  if (grant === "integrations:connect_own" && !createdById)
+    return false;
+  return true;
+}
+function checkPermissions(validation) {
+  const grants = validation.authorization.grants;
+  const createdById = validation.createdById?.trim() || null;
+  const unavailable = COMMAND_GRANTS.filter((family) => !family.anyOf.some((grant) => grantUsable(grant, grants, createdById)));
+  const detail = [
+    grants.length > 0 ? `grants: ${grants.join(", ")}` : null,
+    unavailable.length > 0 ? `unavailable to this key: ${unavailable.map((family) => family.commands).join("; ")}` : null
+  ].filter((part) => part !== null).join(" · ");
+  return {
+    name: "Permissions",
+    status: unavailable.length > 0 ? "warn" : "pass",
+    message: `${grants.length} key grant${grants.length === 1 ? "" : "s"}`,
+    detail: detail || undefined
+  };
+}
+async function checkIntegrations(apiKey, validation) {
+  const grants = validation?.authorization.grants;
+  if (grants) {
+    const createdById = validation?.createdById?.trim() || null;
+    const canRead = grantUsable("integrations:manage", grants, createdById) || grantUsable("integrations:connect_own", grants, createdById);
+    if (!canRead) {
+      return {
+        name: "Integrations",
+        status: "warn",
+        message: "API key does not grant integrations access",
+        detail: "Requires the integrations:manage grant, or integrations:connect_own on a user-created key"
+      };
+    }
+  }
   try {
     const client = await createClient(apiKey);
     const timeout = new Promise((_2, reject) => setTimeout(() => reject(new Error("Integrations check timed out")), 1e4));
@@ -19746,7 +19811,15 @@ async function checkIntegrations(apiKey) {
       status: "pass",
       message: `${ready} integration(s) ready`
     };
-  } catch {
+  } catch (err) {
+    if (isOutlitToolsApiError(err) && err.envelope?.code === "TOOL_CALL_FORBIDDEN") {
+      return {
+        name: "Integrations",
+        status: "warn",
+        message: "API key was denied integrations access",
+        detail: "Requires the integrations:manage grant, or integrations:connect_own on a user-created key"
+      };
+    }
     return {
       name: "Integrations",
       status: "warn",
@@ -19834,8 +19907,9 @@ function printChecks(checks) {
   }
   console.log("");
 }
-var FAIL_SYMBOL2, STATUS_ICONS, doctor_default, agentChecks;
+var FAIL_SYMBOL2, STATUS_ICONS, doctor_default, COMMAND_GRANTS, agentChecks;
 var init_doctor = __esm(() => {
+  init_dist4();
   init_dist();
   init_auth();
   init_output2();
@@ -19858,11 +19932,13 @@ var init_doctor = __esm(() => {
       description: [
         "Check CLI version, API key, connectivity, and agent detection.",
         "",
-        "Runs four checks in sequence:",
+        "Runs six checks in sequence:",
         "  1. CLI version -- compares against npm registry",
         "  2. API key -- checks presence and format (ok_ prefix)",
         "  3. API validation -- makes a live test call to verify the key works",
-        "  4. Agent detection -- detects supported coding agents and whether the Outlit skill is installed",
+        "  4. Permissions -- shows key grants and unavailable commands",
+        "  5. Integrations -- checks integration readiness or explains missing access",
+        "  6. Agent detection -- detects supported coding agents and whether the Outlit skill is installed",
         "",
         "Exit code: 0 if all checks pass or warn, 1 if any check fails.",
         "",
@@ -19887,9 +19963,12 @@ var init_doctor = __esm(() => {
       checks.push(checkApiKeyPresence(credential));
       if (credential) {
         const apiCheck = await validateApiKey(credential.key);
-        checks.push(apiCheck);
-        if (apiCheck.status !== "fail") {
-          checks.push(await checkIntegrations(credential.key));
+        checks.push(apiCheck.check);
+        if (apiCheck.validation) {
+          checks.push(checkPermissions(apiCheck.validation));
+        }
+        if (apiCheck.check.status !== "fail") {
+          checks.push(await checkIntegrations(credential.key, apiCheck.validation));
         }
       } else {
         checks.push({
@@ -19909,6 +19988,38 @@ var init_doctor = __esm(() => {
         process.exit(1);
     }
   });
+  COMMAND_GRANTS = [
+    {
+      commands: "customers (read), users, facts, sources, search, attention",
+      anyOf: ["customer_intelligence:read"]
+    },
+    { commands: "ws-users", anyOf: ["workspace_members:read"] },
+    { commands: "sql, schema", anyOf: ["analytics:read"] },
+    { commands: "destinations", anyOf: ["destinations:manage"] },
+    { commands: "features", anyOf: ["behavior_metrics:manage"] },
+    {
+      commands: "integrations",
+      anyOf: ["integrations:manage", "integrations:connect_own"]
+    },
+    { commands: "activation get, preview", anyOf: ["activation:read"] },
+    { commands: "activation update, disable", anyOf: ["activation:manage"] },
+    { commands: "settings get", anyOf: ["workspace_settings:read"] },
+    { commands: "settings update", anyOf: ["workspace_settings:manage"] },
+    { commands: "customers grant, revoke, owner", anyOf: ["customer_access:manage"] },
+    {
+      commands: "identity suggestions list",
+      anyOf: ["customer_intelligence:read"]
+    },
+    {
+      commands: "identity suggestions reject",
+      anyOf: ["customer_identity:review"]
+    },
+    {
+      commands: "customers merge (preview), customers merge-status",
+      anyOf: ["customer_intelligence:read"]
+    },
+    { commands: "customers merge --execute", anyOf: ["customer_identity:merge"] }
+  ];
   agentChecks = {
     "claude-code": {
       name: "Claude Code",
@@ -19949,6 +20060,7 @@ __export(exports_upgrade, {
 var upgrade_default;
 var init_upgrade = __esm(() => {
   init_dist();
+  init_output2();
   init_config();
   init_output();
   init_update2();
@@ -19960,20 +20072,16 @@ var init_upgrade = __esm(() => {
         "",
         "Checks npm for the latest published version first.",
         "If the current version is already latest, no install command is run.",
+        "Standalone binaries cannot self-update; they get manual-update guidance instead.",
         "",
         "Examples:",
         "  outlit upgrade"
       ].join(`
 `)
     },
-    async run() {
-      const upgradeCommand = getUpgradeCommand();
-      if (!upgradeCommand) {
-        return outputError({
-          message: "Could not determine how Outlit CLI was installed. Update it manually with your package manager, for example `bun add -g @outlit/cli` or `npm install -g @outlit/cli`.",
-          code: "unknown_installer"
-        }, false);
-      }
+    args: { ...outputArgs },
+    async run({ args }) {
+      const json = !!args.json;
       let latestVersion;
       try {
         latestVersion = await fetchLatestCliVersion2();
@@ -19981,20 +20089,38 @@ var init_upgrade = __esm(() => {
         return outputError({
           message: "Could not check for CLI updates. Try again later or update manually.",
           code: "update_check_failed"
-        }, false);
+        }, json);
       }
       if (compareVersions2(CLI_VERSION2, latestVersion) >= 0) {
+        const result2 = { status: "current", currentVersion: CLI_VERSION2, latestVersion };
+        if (isJsonMode(json))
+          return outputResult(result2);
         console.log(`Outlit CLI is already up to date (v${CLI_VERSION2})`);
         return;
       }
+      const standalone = isStandaloneInstall2();
+      const upgradeCommand = standalone ? null : getUpgradeCommand();
+      if (!upgradeCommand) {
+        const message = standalone ? `Outlit CLI v${latestVersion} is available. This standalone binary cannot update itself — ${STANDALONE_UPDATE_HINT2}.` : `Outlit CLI v${latestVersion} is available. Could not determine how Outlit CLI was installed. Update it manually with your package manager, for example \`bun add -g @outlit/cli\` or \`npm install -g @outlit/cli\`.`;
+        return outputError({ message, code: standalone ? "manual_update_required" : "unknown_installer" }, json);
+      }
       try {
-        runUpgradeCommand(upgradeCommand);
+        runUpgradeCommand(upgradeCommand, { stdoutToStderr: isJsonMode(json) });
       } catch (err) {
         return outputError({
           message: errorMessage(err, `Failed to run ${upgradeCommand.displayCommand}`),
           code: "upgrade_failed"
-        }, false);
+        }, json);
       }
+      const result = {
+        status: "updated",
+        currentVersion: CLI_VERSION2,
+        latestVersion,
+        command: upgradeCommand.displayCommand
+      };
+      if (isJsonMode(json))
+        return outputResult(result);
+      console.log(`Updated Outlit CLI to v${latestVersion}`);
     }
   });
 });
@@ -23452,6 +23578,7 @@ var UPDATE_CHECK_INTERVAL_MS = 12 * 60 * 60 * 1000;
 var PACKAGE_NAME = "@outlit/cli";
 var LATEST_VERSION_URL = "https://registry.npmjs.org/@outlit%2Fcli/latest";
 var INTERNAL_UPDATE_FLAG = "--internal-update-check";
+var STANDALONE_UPDATE_HINT = "re-run your original install method (for example `curl -fsSL https://outlit.ai/install.sh | bash` or `brew upgrade outlitai/tap/outlit`), or download the latest release from https://github.com/OutlitAI/outlit-sdk/releases";
 function getUpdateCachePath() {
   return join2(getConfigDir(), "update-check.json");
 }
@@ -23538,6 +23665,15 @@ function readCommandOutput(command, args) {
     return null;
   }
 }
+function isStandaloneInstall(argv = process.argv) {
+  const scriptPath = argv[1];
+  if (!scriptPath)
+    return true;
+  if (scriptPath.startsWith("/$bunfs/") || scriptPath.startsWith("~bunfs"))
+    return true;
+  const resolved = safeRealPath(scriptPath) ?? scriptPath;
+  return !/\.(?:cjs|mjs|jsx?|tsx?)$/.test(resolved);
+}
 function inferInstaller() {
   const fromAgent = inferInstallerFromUserAgent(process.env.npm_config_user_agent ?? "");
   if (fromAgent)
@@ -23560,8 +23696,11 @@ function safeRealPath(filePath) {
     return null;
   }
 }
-function formatUpdateCommand(installer = inferInstaller()) {
-  switch (installer) {
+function formatUpdateCommand(installer, argv = process.argv) {
+  if (isStandaloneInstall(argv))
+    return STANDALONE_UPDATE_HINT;
+  const resolved = installer === undefined ? inferInstaller() : installer;
+  switch (resolved) {
     case "bun":
       return "bun add -g @outlit/cli";
     case "npm":
@@ -23603,26 +23742,29 @@ function printCachedUpdateNotice(argv = process.argv, notify = console.error) {
 Update with: ${notice.command}`);
   return true;
 }
-function scheduleBackgroundUpdateCheck(argv = process.argv, spawnProcess = spawn) {
+function scheduleBackgroundUpdateCheck(argv = process.argv, spawnProcess = spawn, execPath = process.execPath) {
   if (!shouldShowUpdateNotice(argv))
     return false;
   if (!isUpdateCheckDue(readCachedUpdateState()))
     return false;
-  const runtimePath = argv[0];
-  const scriptPath = argv[1];
-  if (!runtimePath || !scriptPath)
+  const standalone = isStandaloneInstall(argv);
+  const command = standalone ? execPath : argv[0];
+  const scriptPath = standalone ? null : argv[1];
+  if (!command || !standalone && !scriptPath)
     return false;
-  const child = spawnProcess(runtimePath, [scriptPath, INTERNAL_UPDATE_FLAG], {
-    detached: true,
-    stdio: "ignore"
-  });
-  child.unref?.();
-  return true;
+  try {
+    const child = spawnProcess(command, [...scriptPath ? [scriptPath] : [], INTERNAL_UPDATE_FLAG], { detached: true, stdio: "ignore" });
+    child.on?.("error", () => {});
+    child.unref?.();
+    return true;
+  } catch {
+    return false;
+  }
 }
 function initializeUpdateNotifier(opts) {
   const argv = opts?.argv ?? process.argv;
   printCachedUpdateNotice(argv, opts?.notify);
-  scheduleBackgroundUpdateCheck(argv, opts?.spawn);
+  scheduleBackgroundUpdateCheck(argv, opts?.spawn, opts?.execPath);
 }
 async function fetchLatestCliVersion() {
   const response = await fetch(LATEST_VERSION_URL, { signal: AbortSignal.timeout(5000) });
@@ -23635,7 +23777,7 @@ async function fetchLatestCliVersion() {
 }
 async function runInternalUpdateCheck(opts) {
   const fetchLatestVersion = opts?.fetchLatestVersion ?? fetchLatestCliVersion;
-  const installer = opts?.installer ?? inferInstaller();
+  const installer = isStandaloneInstall() ? null : opts?.installer ?? inferInstaller();
   try {
     const latestVersion = await fetchLatestVersion();
     writeCachedUpdateState({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@outlit/cli",
-  "version": "3.2.0",
+  "version": "3.2.2",
   "description": "CLI for querying Outlit customer context and installing agent skills",
   "license": "Apache-2.0",
   "repository": {
@@ -43,7 +43,7 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.0.1",
-    "@outlit/tools": "^2.2.0",
+    "@outlit/tools": "^2.2.1",
     "citty": "^0.2.1"
   },
   "devDependencies": {