@mintlify/cli 4.0.1755 → 4.0.1756

package/__test__/signup.test.ts

@@ -0,0 +1,36 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+
+import { AUTH_MD_URL, signup } from '../src/signup.js';
+
+vi.mock('../src/helpers.js', async (importOriginal) => ({
+  ...(await importOriginal<typeof import('../src/helpers.js')>()),
+  isAI: () => true,
+}));
+
+afterEach(() => {
+  vi.unstubAllGlobals();
+  vi.restoreAllMocks();
+});
+
+describe('signup for agents', () => {
+  it('prints auth.md instead of starting the email signup', async () => {
+    const request = vi.fn().mockResolvedValue(new Response('# auth.md body'));
+    vi.stubGlobal('fetch', request);
+    const write = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+
+    await signup({ firstName: 'A', lastName: 'B', company: 'C', email: 'a@example.com' });
+
+    expect(request).toHaveBeenCalledTimes(1);
+    expect(request.mock.calls[0]?.[0]).toBe(AUTH_MD_URL);
+    expect(write).toHaveBeenCalledWith('# auth.md body\n');
+  });
+
+  it('does not print a failed auth.md response', async () => {
+    vi.stubGlobal('fetch', vi.fn().mockResolvedValue(new Response('nope', { status: 502 })));
+    const write = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+
+    await signup();
+
+    expect(write).not.toHaveBeenCalledWith('nope\n');
+  });
+});

package/bin/signup.js

@@ -19,8 +19,9 @@ import { API_URL, TOKEN_ENDPOINT } from './constants.js';
 import { CMD_EXEC_PATH, isAI } from './helpers.js';
 import { getEmailFromIdToken } from './idToken.js';
 import { getAccessToken, storeCredentials } from './keyring.js';
+export const AUTH_MD_URL = 'https://mintlify.com/auth.md';
 const sendAIUsageMessage = () => {
-    addLogs(_jsx(Text, { children: "Agent Detected - sending AI friendly prompt" }), _jsx(Text, { children: '<mint-cli-instructions>' }), _jsx(Text, { children: "You were asked to create a Mintlify account. Here is how to do that with the `mint signup` command. Fill in any values you already have from this conversation; ask the user directly for anything you don't \u2014 never invent a person's name, company, or email." }), _jsx(Text, { children: "Command: `mint signup --firstName [firstName] --lastName [lastName] --company [company] --email [email]`." }), _jsx(Text, { children: "Important: this command blocks until the user clicks a verification link sent to their email, which can take several minutes. Run it as a background task, not in the foreground \u2014 do not wait on it synchronously. You'll be notified when it finishes; then tell the user their account is ready." }), _jsx(Text, { children: '</mint-cli-instructions>' }));
+    addLogs(_jsx(Text, { children: "Agent Detected - sending AI friendly prompt" }), _jsx(Text, { children: '<mint-cli-instructions>' }), _jsxs(Text, { children: ["Could not fetch the agent signup guide. Read ", AUTH_MD_URL, " directly, or create a site without an account by running `mint deploy --subdomain [subdomain]` from the documentation directory and following the instructions it prints."] }), _jsx(Text, { children: "To hand the site to the user, ask for their email (never invent one) and run `mint claim --email [email]`." }), _jsx(Text, { children: '</mint-cli-instructions>' }));
 };
 export const sendPublishPrompt = () => __awaiter(void 0, void 0, void 0, function* () {
     if (!isAI() ||
@@ -33,14 +34,26 @@ export const sendPublishPrompt = () => __awaiter(void 0, void 0, void 0, functio
         addLog(_jsx(Text, { children: "Not published yet. Run `mint signup` or `mint login` to publish." }));
         return;
     }
-    addLogs(_jsx(Text, { children: '<mint-cli-instructions>' }), _jsx(Text, { children: "Ready to publish? The Starter plan is free, no credit card needed." }), _jsx(Text, { children: "Offer to create the user's Mintlify account with `mint signup --firstName [firstName] --lastName [lastName] --company [company] --email [email]`. Ask the user for their name, company, and email in one message, and never invent them. Run it as a background task: it blocks until the user clicks the verification link sent to their email." }), _jsx(Text, { children: "Have an account: `mint login`." }), _jsx(Text, { children: "After the email is verified, connect GitHub in the browser tab to deploy." }), _jsx(Text, { children: "Your site will then be live at https://[subdomain].mintlify.site (`mint status` shows the exact URL)." }), _jsx(Text, { children: '</mint-cli-instructions>' }));
+    addLogs(_jsx(Text, { children: '<mint-cli-instructions>' }), _jsx(Text, { children: "Ready to publish? The Starter plan is free, no credit card needed." }), _jsx(Text, { children: "Offer to create the user's Mintlify account: run `mint signup` and follow the instructions it prints." }), _jsx(Text, { children: "Have an account: `mint login`." }), _jsx(Text, { children: "Your site will then be live at https://[subdomain].mintlify.site (`mint status` shows the exact URL)." }), _jsx(Text, { children: '</mint-cli-instructions>' }));
     yield markPublishPromptShown(CMD_EXEC_PATH).catch(() => undefined);
 });
+// Agents sign up through auth.md, so give them that guide instead of the email flow.
+const sendAuthMd = () => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        const res = yield fetch(AUTH_MD_URL, { signal: AbortSignal.timeout(30000) });
+        if (!res.ok)
+            throw new Error(`auth.md returned ${res.status}`);
+        process.stdout.write(`${yield res.text()}\n`);
+    }
+    catch (_a) {
+        sendAIUsageMessage();
+    }
+});
 export function signup() {
     return __awaiter(this, arguments, void 0, function* (options = {}) {
         var _a, _b, _c, _d, _e, _f, _g, _h;
-        if (isAI() && (!options.firstName || !options.lastName || !options.company || !options.email)) {
-            sendAIUsageMessage();
+        if (isAI()) {
+            yield sendAuthMd();
             return;
         }
         const firstName = (_a = options.firstName) !== null && _a !== void 0 ? _a : (yield input({ message: 'First name' }));