@lotics/cli 0.5.0 → 0.7.0

package/README.md

@@ -25,24 +25,41 @@ The CLI checks for updates once per day and prompts when a new version is availa
 
 ## 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.
+**`lotics signup`** — Creates a new Lotics account, organization, workspace, and API key in one step. Sends a magic link email so you can access the web app.
 
 ```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).
+**`lotics login`** — Send a magic link email to access the web app (requires prior signup or setup).
 
 ```bash
-lotics auth                     # interactive prompt
-lotics auth ltk_...             # non-interactive
+lotics login
+```
+
+**`lotics setup`** — Saves an existing API key directly (e.g. one created in the Lotics web app).
+
+```bash
+lotics setup                    # interactive prompt
+lotics setup 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`.
 
+## Workspaces
+
+If your organization has multiple workspaces, select one before running tools:
+
+```bash
+lotics workspace                    # list workspaces (marks current)
+lotics workspace select wks_...     # switch to a workspace
+```
+
+Single-workspace organizations auto-select on first use.
+
 ## CLI
 
 ```bash

package/dist/src/cli.js

@@ -16,29 +16,34 @@ Lotics is an AI-powered operations platform. Through this CLI you can:
 
 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 login                         Send a magic link email to access the web app
+  lotics setup [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)
+    --email <email>        Email (required; prompted if omitted)
+    --name <name>          Display name (defaults to email prefix)
+    --timezone <timezone>  Workspace timezone (defaults to UTC, e.g. Asia/Ho_Chi_Minh)
 
-  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.
+  Signup sends a magic link email so you can access the Lotics web app.
+  Use lotics login to request a new magic link at any time.
+  Setup priority: --api-key flag > LOTICS_API_KEY env > saved config.
 
 USAGE
-  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
+  1. lotics signup (or lotics setup)   Create account or set up API key
+  2. lotics workspace                  Check current workspace (auto-selects if only one)
+  3. lotics tools                      List available tools by category
+  4. lotics tools <name>               Show tool description and full input schema
+  5. lotics run <tool> '<json>'        Execute a tool with JSON arguments
 
-  Always inspect the schema (step 3) before calling a tool.
+  Always inspect the schema (step 4) before calling a tool.
   Tools are grouped by category (tables, records, views, etc.).
   Query tools return IDs used as arguments to other tools.
 
 COMMANDS
+  lotics workspace                     List workspaces (marks current)
+  lotics workspace select <id>         Switch to a different workspace
   lotics tools                         List all available tools
   lotics tools <name>                  Show tool description and input schema
   lotics run <tool> '<json>'           Execute a tool
@@ -84,6 +89,7 @@ function parseArgs(argv) {
         apiKey: undefined,
         email: undefined,
         name: undefined,
+        timezone: undefined,
         version: false,
         help: false,
     };
@@ -117,6 +123,9 @@ function parseArgs(argv) {
             case "--name":
                 flags.name = argv[++i];
                 break;
+            case "--timezone":
+                flags.timezone = argv[++i];
+                break;
             case "--version":
             case "-v":
                 flags.version = true;
@@ -183,10 +192,12 @@ async function handleSignup(flags) {
     const body = { email };
     if (name)
         body.name = name;
+    if (flags.timezone)
+        body.timezone = flags.timezone;
     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");
+            console.error("An account with this email already exists. Use: lotics setup");
         }
         else if (status === 429) {
             console.error("Too many signup attempts. Try again later.");
@@ -197,22 +208,28 @@ async function handleSignup(flags) {
         process.exit(1);
     }
     const existing = loadConfig() ?? {};
-    saveConfig({ ...existing, api_key: data.api_key, email: data.email });
+    saveConfig({
+        ...existing,
+        api_key: data.api_key,
+        email: data.email,
+        workspace_id: data.workspace_id,
+    });
     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.`);
+    console.error(`  Email: ${data.email}`);
+    console.error(`\nCheck your email for a magic link to access the Lotics web app.`);
+    console.error(`Run "lotics login" to request a new link at any time.`);
 }
-async function handleAuth(providedKey) {
+async function handleSetup(providedKey) {
     const apiKey = providedKey ?? await prompt("Enter your API key: ");
     if (!apiKey) {
         console.error("No API key provided.");
         process.exit(1);
     }
     const client = new LoticsClient({ apiKey });
+    let email;
     try {
-        await client.listTools();
+        const info = await client.whoami();
+        email = info.email;
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
@@ -220,16 +237,69 @@ async function handleAuth(providedKey) {
         process.exit(1);
     }
     const existing = loadConfig() ?? {};
-    saveConfig({ ...existing, api_key: apiKey });
+    const newConfig = { ...existing, api_key: apiKey, email };
+    // Auto-resolve workspace
+    try {
+        const workspaces = await client.listWorkspaces();
+        if (workspaces.length === 1) {
+            newConfig.workspace_id = workspaces[0].id;
+        }
+        else if (workspaces.length > 1) {
+            console.error(`\nMultiple workspaces found. Run "lotics workspace select <id>" to choose one:`);
+            printWorkspaceList(workspaces);
+        }
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        console.error(`Warning: could not resolve workspace: ${msg}`);
+    }
+    saveConfig(newConfig);
     console.error("Authenticated.");
 }
 function requireClient(flags) {
     const auth = resolveAuth(flags);
     if (!auth) {
-        console.error('Not authenticated. Run "lotics auth" or set LOTICS_API_KEY.');
+        console.error('Not authenticated. Run "lotics setup" or set LOTICS_API_KEY.');
+        process.exit(1);
+    }
+    const config = loadConfig();
+    return new LoticsClient({ apiKey: auth.apiKey, workspaceId: config?.workspace_id });
+}
+function printWorkspaceList(workspaces, currentId) {
+    for (const ws of workspaces) {
+        const marker = ws.id === currentId ? " (current)" : "";
+        console.error(`  ${ws.id}  ${ws.name}  ${ws.timezone}  ${ws.default_currency}${marker}`);
+    }
+}
+async function resolveWorkspace(client) {
+    const config = loadConfig();
+    if (config?.workspace_id)
+        return;
+    let workspaces;
+    try {
+        workspaces = await client.listWorkspaces();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`Failed to list workspaces: ${message}`);
         process.exit(1);
     }
-    return new LoticsClient({ apiKey: auth.apiKey });
+    if (workspaces.length === 0) {
+        console.error("No workspaces found for this organization.");
+        process.exit(1);
+    }
+    if (workspaces.length === 1) {
+        const existing = config ?? {};
+        saveConfig({ ...existing, workspace_id: workspaces[0].id });
+        client.setWorkspaceId(workspaces[0].id);
+        return;
+    }
+    // Multiple workspaces, none selected
+    console.error("Multiple workspaces available. Select one with:\n");
+    console.error('  lotics workspace select <id>\n');
+    printWorkspaceList(workspaces);
+    console.error("");
+    process.exit(1);
 }
 /**
  * Resolve upload paths: files pass through, directories expand to their immediate files.
@@ -268,17 +338,33 @@ async function main() {
         await handleSignup(flags);
         return;
     }
-    if (command === "auth") {
-        await handleAuth(subcommand ?? flags.apiKey);
+    if (command === "setup") {
+        await handleSetup(subcommand ?? flags.apiKey);
         return;
     }
     if (command === "whoami") {
         const config = loadConfig();
         if (config?.email) {
             console.log(config.email);
+            return;
         }
-        else {
-            console.error("Not signed up. Run: lotics signup");
+        // No email cached — try fetching from API
+        const auth = resolveAuth(flags);
+        if (!auth) {
+            console.error('Not authenticated. Run "lotics setup" or set LOTICS_API_KEY.');
+            process.exit(1);
+        }
+        const client = new LoticsClient({ apiKey: auth.apiKey });
+        try {
+            const info = await client.whoami();
+            // Cache for next time
+            const existing = loadConfig() ?? {};
+            saveConfig({ ...existing, email: info.email });
+            console.log(info.email);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(`Failed to fetch account info: ${message}`);
             process.exit(1);
         }
         return;
@@ -288,8 +374,14 @@ async function main() {
         console.error("Logged out. Credentials removed.");
         return;
     }
+    if (command === "login") {
+        const client = requireClient(flags);
+        const { email } = await client.login();
+        console.error(`Magic link sent to ${email}. Check your email to access the Lotics web app.`);
+        return;
+    }
     // --- Validate command before auth ---
-    if (command !== "tools" && command !== "upload" && command !== "run" && command !== "download") {
+    if (command !== "tools" && command !== "upload" && command !== "run" && command !== "download" && command !== "workspace") {
         console.error(`Unknown command: ${command}`);
         console.error('Run "lotics --help" for usage.');
         process.exit(1);
@@ -310,6 +402,51 @@ async function main() {
         process.exit(1);
     }
     const client = requireClient(flags);
+    // lotics workspace / lotics workspace list / lotics workspace select <id>
+    if (command === "workspace") {
+        const workspaces = await client.listWorkspaces();
+        const config = loadConfig();
+        if (subcommand === "select") {
+            const targetId = toolArgs;
+            if (!targetId) {
+                console.error('Usage: lotics workspace select <workspace_id>');
+                process.exit(1);
+            }
+            const target = workspaces.find((ws) => ws.id === targetId);
+            if (!target) {
+                console.error(`Workspace not found: ${targetId}\n\nAvailable workspaces:`);
+                printWorkspaceList(workspaces, config?.workspace_id);
+                process.exit(1);
+            }
+            const existing = config ?? {};
+            saveConfig({ ...existing, workspace_id: target.id });
+            console.error(`Switched to workspace: ${target.name} (${target.id})`);
+            return;
+        }
+        // Default: list workspaces
+        if (subcommand && subcommand !== "list") {
+            console.error(`Unknown workspace subcommand: ${subcommand}`);
+            console.error('Usage: lotics workspace [list | select <id>]');
+            process.exit(1);
+        }
+        if (flags.json) {
+            console.log(JSON.stringify(workspaces, null, 2));
+        }
+        else {
+            if (workspaces.length === 0) {
+                console.error("No workspaces found.");
+            }
+            else {
+                for (const ws of workspaces) {
+                    const marker = ws.id === config?.workspace_id ? " (current)" : "";
+                    console.log(`${ws.id}  ${ws.name}  ${ws.timezone}  ${ws.default_currency}${marker}`);
+                }
+            }
+        }
+        return;
+    }
+    // Ensure workspace is resolved for all remaining commands
+    await resolveWorkspace(client);
     // lotics tools / lotics tools <name>
     if (command === "tools") {
         if (subcommand) {

package/dist/src/client.d.ts

@@ -1,5 +1,14 @@
 export interface LoticsClientOptions {
     apiKey: string;
+    workspaceId?: string;
+}
+export interface WorkspaceInfo {
+    id: string;
+    name: string;
+    timezone: string;
+    default_currency: string;
+    organization_id: string;
+    created_at: string;
 }
 export interface ToolExecuteResult {
     result: unknown;
@@ -25,10 +34,22 @@ export interface FileUploadResult {
 export declare const API_BASE_URL: string;
 export declare class LoticsClient {
     private apiKey;
+    private workspaceId;
     private baseUrl;
     constructor(options: LoticsClientOptions);
     private throwResponseError;
+    private buildHeaders;
     private request;
+    whoami(): Promise<{
+        email: string;
+        name: string;
+        organization_id: string;
+    }>;
+    setWorkspaceId(id: string): void;
+    listWorkspaces(): Promise<WorkspaceInfo[]>;
+    login(): Promise<{
+        email: string;
+    }>;
     listTools(): Promise<{
         tools: string[];
         categories: Record<string, {

package/dist/src/client.js

@@ -24,9 +24,11 @@ function getMimeType(filename) {
 export const API_BASE_URL = process.env.LOTICS_API_URL ?? "https://api.lotics.ai";
 export class LoticsClient {
     apiKey;
+    workspaceId;
     baseUrl;
     constructor(options) {
         this.apiKey = options.apiKey;
+        this.workspaceId = options.workspaceId;
         this.baseUrl = API_BASE_URL;
     }
     async throwResponseError(response) {
@@ -41,11 +43,18 @@ export class LoticsClient {
         }
         throw new Error(`${response.status}: ${message}`);
     }
-    async request(method, path, body) {
-        const url = `${this.baseUrl}${path}`;
+    buildHeaders() {
         const headers = {
             "x-api-key": this.apiKey,
         };
+        if (this.workspaceId) {
+            headers["x-workspace-id"] = this.workspaceId;
+        }
+        return headers;
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = this.buildHeaders();
         const init = { method, headers };
         if (body !== undefined) {
             headers["Content-Type"] = "application/json";
@@ -56,6 +65,18 @@ export class LoticsClient {
             await this.throwResponseError(response);
         return response.json();
     }
+    async whoami() {
+        return this.request("GET", "/v1/cli/whoami");
+    }
+    setWorkspaceId(id) {
+        this.workspaceId = id;
+    }
+    async listWorkspaces() {
+        return this.request("GET", "/v1/workspaces");
+    }
+    async login() {
+        return this.request("POST", "/v1/cli/login");
+    }
     async listTools() {
         return this.request("GET", "/v1/tools");
     }
@@ -71,7 +92,7 @@ export class LoticsClient {
                 const url = `${this.baseUrl}/v1/tools/execute`;
                 const response = await fetch(url, {
                     method: "POST",
-                    headers: { "x-api-key": this.apiKey, "Content-Type": "application/json" },
+                    headers: { ...this.buildHeaders(), "Content-Type": "application/json" },
                     body: JSON.stringify(body),
                     signal: controller.signal,
                 });
@@ -104,7 +125,7 @@ export class LoticsClient {
     async downloadFileById(fileId, outputDir) {
         const url = `${this.baseUrl}/v1/files/${encodeURIComponent(fileId)}/download`;
         const response = await fetch(url, {
-            headers: { "x-api-key": this.apiKey },
+            headers: this.buildHeaders(),
         });
         if (!response.ok)
             await this.throwResponseError(response);
@@ -130,7 +151,7 @@ export class LoticsClient {
         const url = `${this.baseUrl}/v1/files`;
         const response = await fetch(url, {
             method: "POST",
-            headers: { "x-api-key": this.apiKey },
+            headers: this.buildHeaders(),
             body: formData,
         });
         if (!response.ok)

package/dist/src/config.d.ts

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

package/package.json

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