vercel-cli 48.0.3__py3-none-any.whl → 48.1.1__py3-none-any.whl

vercel_cli/vendor/node_modules/.package-lock.json

@@ -9,15 +9,18 @@
       "license": "Apache-2.0"
     },
     "node_modules/@vercel/detect-agent": {
-      "version": "0.2.0",
-      "resolved": "https://registry.npmjs.org/@vercel/detect-agent/-/detect-agent-0.2.0.tgz",
-      "integrity": "sha512-qf10Q2UwlbJAcWVqQGkyp9OlLBn9Aj2VVE0M4mTDe0gpB7Fo8qycTJLccDbHeyLrWnT6Q12sVy9ZYHas7B+rwg==",
-      "license": "Apache-2.0"
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/@vercel/detect-agent/-/detect-agent-1.0.0.tgz",
+      "integrity": "sha512-AIPgNkmtFcDgPCl+xvTT1ga90OL7OTX2RKM4zu0PMpwBthPfN2DpdHy10n3bh8K+CA22GDU0/ncjzprZsrk0sw==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=14"
+      }
     },
     "node_modules/@vercel/python": {
-      "version": "5.0.4",
-      "resolved": "https://registry.npmjs.org/@vercel/python/-/python-5.0.4.tgz",
-      "integrity": "sha512-QtwyRRjW3SB5K8QvXn4yI78gQusmdLXCwWa2kXdMwx53eln5UCuVCXrNpA3TASLIgbVQ6i7VFcVwdyFKt3qKcg==",
+      "version": "5.0.5",
+      "resolved": "https://registry.npmjs.org/@vercel/python/-/python-5.0.5.tgz",
+      "integrity": "sha512-XLG/fDe2hflzNtSWuoASTo+N2c4hl6SbcufvBRYa7BnBQK9t4ZH1IEu+vJkq2AUoVczp5JEYLEXkIGm8KBtoeg==",
       "license": "Apache-2.0"
     }
   }

vercel_cli/vendor/node_modules/@vercel/detect-agent/CHANGELOG.md

@@ -0,0 +1,19 @@
+# @vercel/detect-agent
+
+## 1.0.0
+
+### Major Changes
+
+- Change return format to be an object to future proof ([#13965](https://github.com/vercel/vercel/pull/13965))
+
+## 0.2.0
+
+### Minor Changes
+
+- Improve agent detection ([#13762](https://github.com/vercel/vercel/pull/13762))
+
+## 0.1.0
+
+### Minor Changes
+
+- Initial release ([#13745](https://github.com/vercel/vercel/pull/13745))

vercel_cli/vendor/node_modules/@vercel/detect-agent/README.md

@@ -0,0 +1,123 @@
+# @vercel/detect-agent
+
+A lightweight utility for detecting if code is being executed by an AI agent or automated development environment.
+
+## Installation
+
+```bash
+npm install @vercel/detect-agent
+```
+
+## Usage
+
+```typescript
+import { determineAgent } from '@vercel/detect-agent';
+
+const { isAgent, agent } = await determineAgent();
+
+if (isAgent) {
+  console.log(`Running in ${agent.name} environment`);
+  // Adapt behavior for AI agent context
+}
+```
+
+## Supported Agents
+
+This package can detect the following AI agents and development environments:
+
+- **Custom agents** via `AI_AGENT` environment variable
+- **Cursor** (cursor editor and cursor-cli)
+- **Claude Code** (Anthropic's Claude)
+- **Devin** (Cognition Labs)
+- **Gemini CLI** (Google)
+- **Codex** (OpenAI)
+- **Replit** (online IDE)
+
+## The AI_AGENT Standard
+
+We're promoting `AI_AGENT` as a universal environment variable standard for AI development tools. This allows any tool or library to easily detect when it's running in an AI-driven environment.
+
+### For AI Tool Developers
+
+Set the `AI_AGENT` environment variable to identify your tool:
+
+```bash
+export AI_AGENT="your-tool-name"
+# or
+AI_AGENT="your-tool-name" your-command
+```
+
+### Recommended Naming Convention
+
+- Use lowercase with hyphens for multi-word names
+- Include version information if needed, separated by an `@` symbol
+- Examples: `claude-code`, `cursor-cli`, `devin@1`, `custom-agent@2.0`
+
+## Use Cases
+
+### Adaptive Behavior
+
+```typescript
+import { determineAgent } from '@vercel/detect-agent';
+
+async function setupEnvironment() {
+  const { isAgent, agent } = await determineAgent();
+
+  if (isAgent) {
+    // Running in AI environment - adjust behavior
+    process.env.LOG_LEVEL = 'verbose';
+    console.log(`🤖 Detected AI agent: ${agent.name}`);
+  }
+}
+```
+
+### Telemetry and Analytics
+
+```typescript
+import { determineAgent } from '@vercel/detect-agent';
+
+async function trackUsage(event: string) {
+  const result = await determineAgent();
+
+  analytics.track(event, {
+    agent: result.isAgent ? result.agent.name : 'human',
+    timestamp: Date.now(),
+  });
+}
+```
+
+### Feature Toggles
+
+```typescript
+import { determineAgent } from '@vercel/detect-agent';
+
+async function shouldEnableFeature(feature: string) {
+  const result = await determineAgent();
+
+  // Enable experimental features for AI agents
+  if (result.isAgent && feature === 'experimental-ai-mode') {
+    return true;
+  }
+
+  return false;
+}
+```
+
+## Contributing
+
+We welcome contributions! Please see our [contributing guidelines](../../CONTRIBUTING.md).
+
+### Adding New Agent Support
+
+To add support for a new AI agent:
+
+1. Add detection logic to `src/index.ts`
+2. Add comprehensive test cases in `test/unit/determine-agent.test.ts`
+3. Update this README with the new agent information
+4. Follow the existing priority order pattern
+
+## Links
+
+- [GitHub Repository](https://github.com/vercel/vercel/tree/main/packages/detect-agent)
+- [npm Package](https://www.npmjs.com/package/@vercel/detect-agent)
+- [Vercel Documentation](https://vercel.com/docs)

vercel_cli/vendor/node_modules/@vercel/detect-agent/dist/index.d.ts

@@ -1 +1,29 @@
-export declare function determineAgent(): Promise<string | false>;
+declare const CURSOR: "cursor";
+declare const CURSOR_CLI: "cursor-cli";
+declare const CLAUDE: "claude";
+declare const DEVIN: "devin";
+declare const REPLIT: "replit";
+declare const GEMINI: "gemini";
+declare const CODEX: "codex";
+export type KnownAgentNames = typeof CURSOR | typeof CURSOR_CLI | typeof CLAUDE | typeof DEVIN | typeof REPLIT | typeof GEMINI | typeof CODEX;
+export interface KnownAgentDetails {
+    name: KnownAgentNames;
+}
+export type AgentResult = {
+    isAgent: true;
+    agent: KnownAgentDetails;
+} | {
+    isAgent: false;
+    agent: undefined;
+};
+export declare const KNOWN_AGENTS: {
+    readonly CURSOR: "cursor";
+    readonly CURSOR_CLI: "cursor-cli";
+    readonly CLAUDE: "claude";
+    readonly DEVIN: "devin";
+    readonly REPLIT: "replit";
+    readonly GEMINI: "gemini";
+    readonly CODEX: "codex";
+};
+export declare function determineAgent(): Promise<AgentResult>;
+export {};

vercel_cli/vendor/node_modules/@vercel/detect-agent/dist/index.js

@@ -18,12 +18,13 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var src_exports = {};
 __export(src_exports, {
+  KNOWN_AGENTS: () => KNOWN_AGENTS,
   determineAgent: () => determineAgent
 });
 module.exports = __toCommonJS(src_exports);
 var import_promises = require("node:fs/promises");
 var import_node_fs = require("node:fs");
-const devinLocalPath = "/opt/.devin";
+const DEVIN_LOCAL_PATH = "/opt/.devin";
 const CURSOR = "cursor";
 const CURSOR_CLI = "cursor-cli";
 const CLAUDE = "claude";
@@ -31,36 +32,52 @@ const DEVIN = "devin";
 const REPLIT = "replit";
 const GEMINI = "gemini";
 const CODEX = "codex";
+const KNOWN_AGENTS = {
+  CURSOR,
+  CURSOR_CLI,
+  CLAUDE,
+  DEVIN,
+  REPLIT,
+  GEMINI,
+  CODEX
+};
 async function determineAgent() {
   if (process.env.AI_AGENT) {
-    return process.env.AI_AGENT;
+    const name = process.env.AI_AGENT.trim();
+    if (name) {
+      return {
+        isAgent: true,
+        agent: { name }
+      };
+    }
   }
   if (process.env.CURSOR_TRACE_ID) {
-    return CURSOR;
+    return { isAgent: true, agent: { name: CURSOR } };
   }
   if (process.env.CURSOR_AGENT) {
-    return CURSOR_CLI;
+    return { isAgent: true, agent: { name: CURSOR_CLI } };
   }
   if (process.env.GEMINI_CLI) {
-    return GEMINI;
+    return { isAgent: true, agent: { name: GEMINI } };
   }
   if (process.env.CODEX_SANDBOX) {
-    return CODEX;
+    return { isAgent: true, agent: { name: CODEX } };
   }
   if (process.env.CLAUDECODE || process.env.CLAUDE_CODE) {
-    return CLAUDE;
+    return { isAgent: true, agent: { name: CLAUDE } };
   }
   if (process.env.REPL_ID) {
-    return REPLIT;
+    return { isAgent: true, agent: { name: REPLIT } };
   }
   try {
-    await (0, import_promises.access)(devinLocalPath, import_node_fs.constants.F_OK);
-    return DEVIN;
+    await (0, import_promises.access)(DEVIN_LOCAL_PATH, import_node_fs.constants.F_OK);
+    return { isAgent: true, agent: { name: DEVIN } };
   } catch (error) {
-    return false;
   }
+  return { isAgent: false, agent: void 0 };
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  KNOWN_AGENTS,
   determineAgent
 });

vercel_cli/vendor/node_modules/@vercel/detect-agent/package.json

@@ -1,19 +1,48 @@
 {
   "name": "@vercel/detect-agent",
-  "version": "0.2.0",
+  "version": "1.0.0",
+  "description": "Detect if code is running in an AI agent or automated development environment",
+  "keywords": [
+    "ai",
+    "agent",
+    "detection",
+    "environment",
+    "cursor",
+    "claude",
+    "devin",
+    "automation",
+    "ai-agent"
+  ],
   "license": "Apache-2.0",
+  "author": "Vercel",
   "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
   "publishConfig": {
     "access": "public"
   },
-  "homepage": "https://vercel.com/docs",
+  "homepage": "https://github.com/vercel/vercel/tree/main/packages/detect-agent#readme",
   "repository": {
     "type": "git",
     "url": "https://github.com/vercel/vercel.git",
     "directory": "packages/detect-agent"
   },
+  "bugs": {
+    "url": "https://github.com/vercel/vercel/issues"
+  },
+  "engines": {
+    "node": ">=14"
+  },
   "files": [
-    "dist"
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
   ],
   "dependencies": {},
   "devDependencies": {
@@ -24,8 +53,7 @@
   },
   "scripts": {
     "build": "node ../../utils/build.mjs",
-    "vitest-run": "vitest -c ../../vitest.config.mts",
-    "vitest-unit": "glob --absolute 'test/unit/**/*.test.ts' 'test/unit/**/*.test.mts'",
+    "test": "vitest -c ../../vitest.config.mts",
     "type-check": "tsc --noEmit"
   }
 }