@lotics/cli 0.3.0 → 0.4.0

package/README.md

@@ -23,17 +23,34 @@ npm install -g @lotics/cli@latest
 
 The CLI checks for updates once per day and prompts when a new version is available.
 
-## CLI
+## Authentication
+
+**`lotics signup`** — Creates a new Lotics account, organization, workspace, and API key in one step. Prints email and auto-generated password for web app login.
+
+```bash
+lotics signup                                        # interactive prompts
+lotics signup --email a@b.com --name "Agent"         # non-interactive
+```
+
+**`lotics auth`** — Saves an existing API key directly (e.g. one created in the Lotics web app).
 
 ```bash
-# 1. Authenticate
-lotics auth
+lotics auth                     # interactive prompt
+lotics auth ltk_...             # non-interactive
+```
+
+API key is saved to `~/.lotics/config.json`. Run `lotics logout` to remove saved credentials.
+
+Auth priority: `--api-key` flag > `LOTICS_API_KEY` env > `~/.lotics/config.json`.
 
-# 2. Discover tools
+## CLI
+
+```bash
+# Discover tools
 lotics tools                    # list tools by category with descriptions
 lotics tools query_records      # show full description + input schema
 
-# 3. Execute
+# Execute
 lotics run query_tables '{}'
 lotics run query_records '{"table_id":"tbl_...","field_keys":["name"]}'
 

package/dist/src/cli.js

@@ -2,8 +2,8 @@
 import fs from "node:fs";
 import path from "node:path";
 import readline from "node:readline";
-import { LoticsClient } from "./client.js";
-import { resolveAuth, loadConfig, saveConfig, deleteConfig, getConfigPath, checkForUpdate } from "./config.js";
+import { LoticsClient, API_BASE_URL } from "./client.js";
+import { resolveAuth, loadConfig, saveConfig, deleteConfig, checkForUpdate } from "./config.js";
 import { VERSION } from "./version.js";
 function printHelp() {
     console.log(`Lotics CLI v${VERSION} — AI agent interface for Lotics
@@ -14,8 +14,22 @@ Lotics is an AI-powered operations platform. Through this CLI you can:
   - Build and run automations (event-driven workflows)
   - Create and manage apps, knowledge docs, and files
 
+AUTHENTICATION
+  lotics signup                        Create account, org, workspace, and API key
+  lotics auth [api_key]                Save an existing API key (e.g. from the web app)
+  lotics whoami                        Show the email of the current account
+  lotics logout                        Remove saved credentials
+
+  Signup flags:
+    --email <email>    Email (required; prompted if omitted)
+    --name <name>      Display name (defaults to email prefix)
+
+  Signup prints email and auto-generated password for web app login.
+  Use lotics whoami to check the current account email.
+  Auth priority: --api-key flag > LOTICS_API_KEY env > saved config.
+
 USAGE
-  1. lotics auth                       Authenticate (saves key to ~/.lotics/config.json)
+  1. lotics signup                     Create account and get API key
   2. lotics tools                      List available tools by category
   3. lotics tools <name>               Show tool description and full input schema
   4. lotics run <tool> '<json>'        Execute a tool with JSON arguments
@@ -25,8 +39,6 @@ USAGE
   Query tools return IDs used as arguments to other tools.
 
 COMMANDS
-  lotics auth                          Save API key (interactive)
-  lotics logout                        Remove saved credentials
   lotics tools                         List all available tools
   lotics tools <name>                  Show tool description and input schema
   lotics run <tool> '<json>'           Execute a tool
@@ -41,9 +53,6 @@ FLAGS
   --api-key <key>    API key (overrides saved config and LOTICS_API_KEY)
   --version          Show version
 
-  For non-interactive use, set LOTICS_API_KEY in the environment
-  instead of running lotics auth.
-
 OUTPUT
   Default output is a human-readable text summary. Use --json to get
   structured JSON for programmatic use. Errors print to stderr and
@@ -73,6 +82,8 @@ function parseArgs(argv) {
         output: undefined,
         as: undefined,
         apiKey: undefined,
+        email: undefined,
+        name: undefined,
         version: false,
         help: false,
     };
@@ -100,6 +111,12 @@ function parseArgs(argv) {
             case "--api-key":
                 flags.apiKey = argv[++i];
                 break;
+            case "--email":
+                flags.email = argv[++i];
+                break;
+            case "--name":
+                flags.name = argv[++i];
+                break;
             case "--version":
             case "-v":
                 flags.version = true;
@@ -147,8 +164,48 @@ function prompt(question) {
         });
     });
 }
-async function handleAuth() {
-    const apiKey = await prompt("Enter your API key: ");
+async function publicPost(path, body) {
+    const response = await fetch(`${API_BASE_URL}${path}`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+    });
+    const data = await response.json();
+    return { ok: response.ok, status: response.status, data };
+}
+async function handleSignup(flags) {
+    const email = flags.email ?? (process.stdin.isTTY ? await prompt("Email: ") : "");
+    if (!email) {
+        console.error("Email is required. Use --email or run interactively.");
+        process.exit(1);
+    }
+    const name = flags.name ?? (process.stdin.isTTY ? await prompt("Name (enter to use email): ") : undefined);
+    const body = { email };
+    if (name)
+        body.name = name;
+    const { ok, status, data } = await publicPost("/v1/cli/signup", body);
+    if (!ok) {
+        if (status === 409) {
+            console.error("An account with this email already exists. Use: lotics auth");
+        }
+        else if (status === 429) {
+            console.error("Too many signup attempts. Try again later.");
+        }
+        else {
+            console.error(`Signup failed: ${data.message ?? JSON.stringify(data)}`);
+        }
+        process.exit(1);
+    }
+    const existing = loadConfig() ?? {};
+    saveConfig({ ...existing, api_key: data.api_key, email: data.email });
+    console.error(`Account created. You can now use the CLI.`);
+    console.error(`  Email:    ${data.email}`);
+    console.error(`  Password: ${data.password}`);
+    console.error(`\nUse these credentials to log into the Lotics web app.`);
+    console.error(`Run "lotics whoami" to check the current account email.`);
+}
+async function handleAuth(providedKey) {
+    const apiKey = providedKey ?? await prompt("Enter your API key: ");
     if (!apiKey) {
         console.error("No API key provided.");
         process.exit(1);
@@ -164,7 +221,7 @@ async function handleAuth() {
     }
     const existing = loadConfig() ?? {};
     saveConfig({ ...existing, api_key: apiKey });
-    console.error(`Authenticated. Config saved to ${getConfigPath()}`);
+    console.error("Authenticated.");
 }
 function requireClient(flags) {
     const auth = resolveAuth(flags);
@@ -207,8 +264,23 @@ async function main() {
         return;
     }
     // --- Commands that don't require auth ---
+    if (command === "signup") {
+        await handleSignup(flags);
+        return;
+    }
     if (command === "auth") {
-        await handleAuth();
+        await handleAuth(subcommand ?? flags.apiKey);
+        return;
+    }
+    if (command === "whoami") {
+        const config = loadConfig();
+        if (config?.email) {
+            console.log(config.email);
+        }
+        else {
+            console.error("Not signed up. Run: lotics signup");
+            process.exit(1);
+        }
         return;
     }
     if (command === "logout") {

package/dist/src/client.d.ts

@@ -22,6 +22,7 @@ export interface FileUploadResult {
         error: string;
     }>;
 }
+export declare const API_BASE_URL: string;
 export declare class LoticsClient {
     private apiKey;
     private baseUrl;

package/dist/src/client.js

@@ -21,12 +21,13 @@ function getMimeType(filename) {
     const ext = path.extname(filename).toLowerCase();
     return MIME_MAP[ext] ?? "application/octet-stream";
 }
+export const API_BASE_URL = process.env.LOTICS_API_URL ?? "https://api.lotics.ai";
 export class LoticsClient {
     apiKey;
     baseUrl;
     constructor(options) {
         this.apiKey = options.apiKey;
-        this.baseUrl = "https://api.lotics.ai";
+        this.baseUrl = API_BASE_URL;
     }
     async throwResponseError(response) {
         const text = await response.text();

package/dist/src/config.d.ts

@@ -1,5 +1,6 @@
 export interface LoticsConfig {
     api_key?: string;
+    email?: string;
     last_update_check?: number;
     latest_version?: string;
 }

package/dist/src/config.js

@@ -70,7 +70,18 @@ async function fetchLatestVersion() {
         clearTimeout(timeout);
     }
 }
+function isNewerVersion(latest, current) {
+    const [lMaj, lMin, lPat] = latest.split(".").map(Number);
+    const [cMaj, cMin, cPat] = current.split(".").map(Number);
+    if (lMaj !== cMaj)
+        return lMaj > cMaj;
+    if (lMin !== cMin)
+        return lMin > cMin;
+    return lPat > cPat;
+}
 function printUpdateWarning(current, latest) {
+    if (!isNewerVersion(latest, current))
+        return;
     console.error(`\nUpdate available: ${current} → ${latest}`);
     console.error(`Run: npm i -g @lotics/cli\n`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/cli",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Lotics SDK and CLI for AI agents",
   "type": "module",
   "bin": {