clishop 1.5.0 → 1.5.2

package/README.md

@@ -74,13 +74,37 @@ npm link
 
 ## Quick Start
 
-You can create your account on [clishop.ai](https://clishop.ai) or do everything from the CLI:
+You can create your account on [clishop.ai](https://clishop.ai) or do everything from the CLI.
+
+### Human-friendly setup
 
 ```bash
 clishop setup
 ```
 
-The setup wizard walks you through creating an account, adding an address, and linking a payment method. After that:
+This starts the interactive setup flow, creates a resumable setup session, shows a secure payment link, and waits for completion.
+
+### Agent-safe setup
+
+For OpenClaw, MCP clients, Claude-style shells, and other tool runners, use the explicit setup session commands instead of scraping terminal output:
+
+```bash
+clishop setup start --email user@example.com --json
+clishop setup status --setup-id <setup_id> --json
+clishop setup wait --setup-id <setup_id> --timeout 300 --json
+clishop setup cancel --setup-id <setup_id> --json
+```
+
+`setup start` returns immediately with:
+
+- `setup_id`: the resumable setup session handle for the agent
+- `setup_url`: the link the human must open in a browser
+- `expires_at`: when the session expires
+- `poll_after_seconds`: suggested polling interval
+
+The agent sends `setup_url` to the human and keeps `setup_id` locally for `status`, `wait`, or `cancel`.
+
+After setup is complete, add a shipping address and start ordering:
 
 ```
 $ clishop search "wireless headphones"
@@ -179,6 +203,11 @@ clishop-mcp              # If installed globally
 npx -y clishop --mcp     # Without installing
 ```
 
+The MCP onboarding tools now follow the same resumable setup session model:
+
+- `setup` starts the session and returns `setup_id` plus `setup_url`
+- `setup_status` checks progress and finalizes auth when setup is complete
+
 See the [MCP setup guides](https://clishop.ai/docs#mcp-overview) for VS Code, Claude Desktop, Cursor, and Windsurf configuration.
 
 ---

package/dist/index.js

@@ -55,6 +55,7 @@ function registerAuthCommands(program2) {
   program2.command("whoami").description("Show the currently logged-in user").action(async () => {
     if (!await isLoggedIn()) {
       console.log(chalk.yellow("Not set up yet. Run: clishop setup"));
+      console.log(chalk.dim("For agent runners, use: clishop setup start --email <email> --json"));
       return;
     }
     const user = await getUserInfo();
@@ -815,9 +816,6 @@ function divider(color = chalk4.cyan) {
 function writeJson(payload) {
   process.stdout.write(JSON.stringify(payload, null, 2) + "\n");
 }
-function isInteractiveSession() {
-  return Boolean(process.stdin.isTTY && process.stdout.isTTY);
-}
 function isLikelyEmail(value) {
   return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value.trim());
 }
@@ -845,6 +843,16 @@ function printSetupLink(message, setupUrl) {
   console.log("  " + setupUrl);
   console.log();
 }
+function printSetupEmailInstructions() {
+  console.log(chalk4.yellow("  Email is required to start setup."));
+  console.log();
+  console.log(chalk4.dim("  Human-friendly:"));
+  console.log(chalk4.white("    clishop setup user@example.com"));
+  console.log();
+  console.log(chalk4.dim("  Agent-safe JSON:"));
+  console.log(chalk4.white("    clishop setup start --email user@example.com --json"));
+  console.log();
+}
 function printSetupStartResult(result) {
   console.log();
   console.log(chalk4.bold("  Setup session created."));
@@ -1094,8 +1102,8 @@ async function runSetupWizard(emailArg, { json = false } = {}) {
   console.log();
   console.log(chalk4.bold.cyan("      W E L C O M E   T O   C L I S H O P"));
   console.log(chalk4.dim("      Order anything from your terminal."));
-  console.log(chalk4.dim(`      npm:   v${"1.5.0"}`));
-  console.log(chalk4.dim(`      Build: ${"2026-04-04T19:19:52.565Z"}`));
+  console.log(chalk4.dim(`      npm:   v${"1.5.2"}`));
+  console.log(chalk4.dim(`      Build: ${"2026-04-04T20:51:01.276Z"}`));
   console.log();
   divider(chalk4.cyan);
   console.log();
@@ -1109,15 +1117,9 @@ async function runSetupWizard(emailArg, { json = false } = {}) {
   console.log();
   let email = emailArg?.trim();
   if (!email) {
-    if (!isInteractiveSession()) {
-      console.error(chalk4.red("\n\u2717 Email is required in non-interactive mode. Use: clishop setup start --email <email> --json\n"));
-      process.exitCode = 1;
-      return;
-    }
-    const answers = await inquirer3.prompt([
-      { type: "input", name: "email", message: "Email:" }
-    ]);
-    email = answers.email?.trim();
+    printSetupEmailInstructions();
+    process.exitCode = 1;
+    return;
   }
   if (!email || !isLikelyEmail(email)) {
     console.error(chalk4.red("\n\u2717 A valid email address is required.\n"));
@@ -3171,6 +3173,7 @@ function registerStatusCommand(program2) {
     try {
       if (!await isLoggedIn()) {
         console.log(chalk11.yellow("\nNot set up yet. Run: clishop setup\n"));
+        console.log(chalk11.dim("For agent runners, use: clishop setup start --email <email> --json\n"));
         return;
       }
       const spinner = ora8("Fetching account overview...").start();
@@ -4288,10 +4291,11 @@ function registerDoctorCommand(program2) {
 
 // src/index.ts
 var program = new Command();
-program.name("clishop").version("1.5.0").description(
+program.name("clishop").version("1.5.2").description(
   chalk16.bold("CLISHOP") + ` \u2014 Order anything from your terminal.
 
-  Run 'clishop setup' to get started with a single payment link.
+  Run 'clishop setup' for the human-friendly flow, or
+  'clishop setup start --email <email> --json' for agent-safe setup.
   Use agents to set safety limits, addresses, and payment methods.
   The "default" agent is used when no agent is specified.`
 ).option("--agent <name>", "Use a specific agent for this command").hook("preAction", (thisCommand) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clishop",
-  "version": "1.5.0",
+  "version": "1.5.2",
   "mcpName": "io.github.StefDCL/clishop",
   "description": "CLISHOP — Order anything from your terminal",
   "main": "dist/index.js",