@mintlify/cli 4.0.1562 → 4.0.1564

package/__test__/agent.test.ts

@@ -0,0 +1,64 @@
+import { detectAgent, isCI } from '../src/agent.js';
+
+const originalIsTTY = process.stdout.isTTY;
+
+afterEach(() => {
+  process.stdout.isTTY = originalIsTTY;
+});
+
+describe('detectAgent', () => {
+  it('returns undefined with no agent env', () => {
+    expect(detectAgent({})).toBeUndefined();
+  });
+
+  it.each([
+    [{ CLAUDECODE: '1' }, 'claude_code'],
+    [{ TERM_PROGRAM: 'claude' }, 'claude_code'],
+    [{ CLAUDECODE: '1', CLAUDE_CODE_IS_COWORK: '1' }, 'cowork'],
+    [{ CODEX_THREAD_ID: 'abc' }, 'codex_cli'],
+    [{ GEMINI_CLI: '1' }, 'gemini_cli'],
+    [{ CURSOR_AGENT: '1' }, 'cursor-cli'],
+    [{ OPENCODE: '1' }, 'open_code'],
+    [{ PATH: '/usr/bin:/home/me/.pi/agent/bin' }, 'pi'],
+    [{ EDITOR: '/opt/devin/bin/code' }, 'devin'],
+  ])('detects %o as %s', (env, expected) => {
+    expect(detectAgent(env)).toBe(expected);
+  });
+
+  it('prefers explicit AI_AGENT and AGENT', () => {
+    expect(detectAgent({ AI_AGENT: 'Amp', CLAUDECODE: '1' })).toBe('amp');
+    expect(detectAgent({ AGENT: 'goose' })).toBe('goose');
+  });
+
+  it('prefers CLI agents over IDE hosts', () => {
+    process.stdout.isTTY = false;
+    expect(detectAgent({ CLAUDECODE: '1', CURSOR_TRACE_ID: 'x' })).toBe('claude_code');
+    expect(detectAgent({ CURSOR_TRACE_ID: 'x' })).toBe('cursor');
+  });
+
+  it('ignores IDE and config markers when a human is at a TTY', () => {
+    process.stdout.isTTY = true;
+    expect(
+      detectAgent({
+        CURSOR_TRACE_ID: 'x',
+        REPL_ID: 'y',
+        TERM_PROGRAM: 'kiro',
+        GOOSE_PROVIDER: 'openai',
+        COPILOT_MODEL: 'gpt',
+        OPENCODE_CLIENT: 'desktop',
+      })
+    ).toBeUndefined();
+  });
+});
+
+describe('isCI', () => {
+  it.each([
+    [{}, false],
+    [{ CI: 'true' }, true],
+    [{ CI: '1' }, true],
+    [{ CI: 'false' }, false],
+    [{ CI: '0' }, false],
+  ])('%o -> %s', (env, expected) => {
+    expect(isCI(env)).toBe(expected);
+  });
+});

package/bin/agent.js

@@ -0,0 +1,42 @@
+import { existsSync } from 'node:fs';
+const set = (...names) => (env) => names.some((name) => Boolean(env[name]));
+const matches = (name, pattern) => (env) => { var _a; return pattern.test((_a = env[name]) !== null && _a !== void 0 ? _a : ''); };
+const noTTY = (check) => (env) => !process.stdout.isTTY && check(env);
+const AGENTS = [
+    [
+        'cursor-cli',
+        (env) => set('CURSOR_AGENT')(env) || env.CURSOR_EXTENSION_HOST_ROLE === 'agent-exec',
+    ],
+    ['kimi', set('KIMI_PLUGIN_ROOT')],
+    ['grok', set('GROK_PLUGIN_ROOT', 'GROK_PLUGIN_DATA')],
+    ['gemini_cli', set('GEMINI_CLI')],
+    ['cline', set('CLINE_ACTIVE')],
+    [
+        'codex_cli',
+        set('CODEX_SANDBOX', 'CODEX_CI', 'CODEX_THREAD_ID', 'CODEX_SANDBOX_NETWORK_DISABLED'),
+    ],
+    ['antigravity', set('ANTIGRAVITY_AGENT', 'ANTIGRAVITY_CLI_ALIAS')],
+    ['augment-cli', set('AUGMENT_AGENT')],
+    ['open_code', (env) => set('OPENCODE')(env) || noTTY(set('OPENCODE_CLIENT'))(env)],
+    ['goose', noTTY(set('GOOSE_PROVIDER'))],
+    ['junie', set('JUNIE_DATA', 'JUNIE_SHIM_PATH')],
+    ['pi', matches('PATH', /\.pi[\\/]agent/)],
+    ['cowork', (env) => set('CLAUDE_CODE_IS_COWORK')(env) && set('CLAUDECODE', 'CLAUDE_CODE')(env)],
+    ['claude_code', (env) => set('CLAUDECODE', 'CLAUDE_CODE')(env) || env.TERM_PROGRAM === 'claude'],
+    ['github-copilot', noTTY(set('COPILOT_MODEL', 'COPILOT_ALLOW_ALL'))],
+    ['openclaw', set('OPENCLAW_SHELL')],
+    ['devin', (env) => matches('EDITOR', /devin/)(env) || existsSync('/opt/.devin')],
+    ['replit', noTTY(set('REPL_ID'))],
+    ['kiro', noTTY(matches('TERM_PROGRAM', /kiro/))],
+    ['cursor', noTTY(set('CURSOR_TRACE_ID'))],
+];
+export function detectAgent(env = process.env) {
+    var _a, _b;
+    const explicit = (_a = (env.AI_AGENT || env.AGENT)) === null || _a === void 0 ? void 0 : _a.trim();
+    if (explicit)
+        return explicit.toLowerCase();
+    return (_b = AGENTS.find(([, check]) => check(env))) === null || _b === void 0 ? void 0 : _b[0];
+}
+export function isCI(env = process.env) {
+    return Boolean(env.CI && env.CI !== 'false' && env.CI !== '0');
+}

package/bin/helpers.js

@@ -23,6 +23,7 @@ import { createRequire } from 'node:module';
 import { fileURLToPath } from 'node:url';
 import { promisify } from 'node:util';
 import path from 'path';
+import { detectAgent } from './agent.js';
 import { shutdownPostHog } from './telemetry/client.js';
 export const CMD_EXEC_PATH = process.cwd();
 export const checkPort = (argv) => __awaiter(void 0, void 0, void 0, function* () {
@@ -217,7 +218,7 @@ export const terminate = (code) => __awaiter(void 0, void 0, void 0, function* (
 });
 export const execFileAsync = promisify(execFile);
 export function isAI() {
-    return (!process.stdin.isTTY || process.env.CLAUDECODE === '1' || process.env.TERM_PROGRAM === 'claude');
+    return !process.stdin.isTTY || detectAgent() !== undefined;
 }
 export const detectPackageManager = (_a) => __awaiter(void 0, [_a], void 0, function* ({ packageName }) {
     assertValidPackageName(packageName);

package/bin/telemetry/track.js

@@ -8,13 +8,26 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import os from 'os';
+import { detectAgent, isCI } from '../agent.js';
 import { isTelemetryEnabled } from '../config.js';
 import { TELEMETRY_ASYNC_TIMEOUT_MS, TELEMETRY_IDENTITY_TIMEOUT_MS } from '../constants.js';
-import { getVersions, isAI } from '../helpers.js';
+import { getVersions } from '../helpers.js';
 import { getAccessToken, getUserEmail, storeUserEmail } from '../keyring.js';
 import { fetchCliStatus } from '../status.js';
 import { deferShutdownUntil, getPostHogClient } from './client.js';
 import { getDistinctId } from './distinctId.js';
+function getEnvironmentProperties() {
+    const agent = detectAgent();
+    return {
+        os: os.platform(),
+        arch: os.arch(),
+        node_version: process.version,
+        is_ai_agent: agent !== undefined,
+        ai_agent: agent,
+        is_ci: isCI(),
+        is_tty: Boolean(process.stdin.isTTY),
+    };
+}
 function captureWithTimeout(event, properties) {
     return __awaiter(this, void 0, void 0, function* () {
         yield Promise.race([
@@ -59,7 +72,7 @@ export function trackCommand(_a) {
         const work = (() => __awaiter(this, void 0, void 0, function* () {
             try {
                 const email = yield getAuthenticatedUserEmail();
-                yield captureWithTimeout('cli.command.executed', Object.assign({ command, cli_version: cliVersion, os: os.platform(), arch: os.arch(), node_version: process.version, is_ai_agent: isAI(), subdomain }, (email ? { email, $set: { email } } : {})));
+                yield captureWithTimeout('cli.command.executed', Object.assign(Object.assign(Object.assign({ command, cli_version: cliVersion }, getEnvironmentProperties()), { subdomain }), (email ? { email, $set: { email } } : {})));
             }
             catch (_a) { }
         }))();
@@ -73,7 +86,7 @@ function trackLoginEvent(event, extra) {
             return;
         try {
             const { cli: cliVersion } = getVersions();
-            yield captureWithTimeout(event, Object.assign(Object.assign({}, extra), { cli_version: cliVersion, os: os.platform(), arch: os.arch(), node_version: process.version }));
+            yield captureWithTimeout(event, Object.assign(Object.assign(Object.assign({}, extra), { cli_version: cliVersion }), getEnvironmentProperties()));
         }
         catch (_a) { }
     });
@@ -99,7 +112,7 @@ export function trackEvent(event, properties) {
             return;
         try {
             const { cli: cliVersion } = getVersions();
-            yield captureWithTimeout(event, Object.assign(Object.assign({}, properties), { cli_version: cliVersion, os: os.platform(), arch: os.arch(), node_version: process.version, is_ai_agent: isAI() }));
+            yield captureWithTimeout(event, Object.assign(Object.assign(Object.assign({}, properties), { cli_version: cliVersion }), getEnvironmentProperties()));
         }
         catch (_a) { }
     });
@@ -110,13 +123,7 @@ export function trackTelemetryPreferenceChange(options) {
             return;
         try {
             const { cli: cliVersion } = getVersions();
-            yield captureWithTimeout('cli.telemetry.preference_changed', {
-                enabled: options.enabled,
-                cli_version: cliVersion,
-                os: os.platform(),
-                arch: os.arch(),
-                node_version: process.version,
-            });
+            yield captureWithTimeout('cli.telemetry.preference_changed', Object.assign({ enabled: options.enabled, cli_version: cliVersion }, getEnvironmentProperties()));
         }
         catch (_a) { }
     });