@lotics/cli 0.2.0 → 0.3.1

package/README.md

@@ -27,7 +27,8 @@ The CLI checks for updates once per day and prompts when a new version is availa
 
 ```bash
 # 1. Authenticate
-lotics auth
+lotics auth                     # interactive prompt
+lotics auth ltk_...             # non-interactive (for agents/CI)
 
 # 2. Discover tools
 lotics tools                    # list tools by category with descriptions
@@ -40,8 +41,8 @@ lotics run query_records '{"table_id":"tbl_...","field_keys":["name"]}'
 # Pipe args via stdin
 echo '{"table_id":"tbl_..."}' | lotics run query_records
 
-# Upload a file
-lotics upload ./report.pdf
+# Upload files (multiple files and directories supported)
+lotics upload ./report.pdf ./data.csv ./documents/
 
 # Generate a file, then download it
 lotics run generate_excel_from_template '{"..."}'
@@ -59,7 +60,7 @@ import { LoticsClient } from "@lotics/cli";
 const client = new LoticsClient({ apiKey: "ltk_..." });
 
 const { result } = await client.execute("query_tables", {});
-const upload = await client.uploadFile("./report.pdf");
+const upload = await client.uploadFiles(["./report.pdf", "./data.csv"]);
 await client.downloadFile(url, "./output.xlsx");
 const { tools, categories } = await client.listTools();
 const info = await client.getTool("query_records");

package/dist/src/cli.js

@@ -1,4 +1,6 @@
 #!/usr/bin/env node
+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";
@@ -13,7 +15,7 @@ Lotics is an AI-powered operations platform. Through this CLI you can:
   - Create and manage apps, knowledge docs, and files
 
 USAGE
-  1. lotics auth                       Authenticate (saves key to ~/.lotics/config.json)
+  1. lotics auth [api_key]               Authenticate (saves key to ~/.lotics/config.json)
   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
@@ -23,12 +25,12 @@ USAGE
   Query tools return IDs used as arguments to other tools.
 
 COMMANDS
-  lotics auth                          Save API key (interactive)
+  lotics auth [api_key]                  Save API key (interactive prompt if omitted)
   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
-  lotics upload <file>                 Upload a local file
+  lotics upload <file|dir...>          Upload files (directories expand to their immediate files)
   lotics download <file_id>            Download a file by ID
 
 FLAGS
@@ -56,8 +58,8 @@ FILES
 
   Upload files before referencing them in tool args:
 
-    lotics upload ./data.csv
-    lotics run create_records '{"file_id":"fil_..."}'
+    lotics upload ./data.csv ./report.pdf ./documents/
+    lotics run create_records '{"table_id":"tbl_...","records":[{"fld_file":["fil_..."]}]}'
 
 STDIN
   Pipe JSON arguments via stdin instead of inline:
@@ -77,6 +79,7 @@ function parseArgs(argv) {
     let command;
     let subcommand;
     let toolArgs;
+    const restArgs = [];
     let i = 0;
     while (i < argv.length) {
         const arg = argv[i];
@@ -115,11 +118,14 @@ function parseArgs(argv) {
                 else if (!toolArgs) {
                     toolArgs = arg;
                 }
+                else {
+                    restArgs.push(arg);
+                }
                 break;
         }
         i++;
     }
-    return { command, subcommand, toolArgs, flags };
+    return { command, subcommand, toolArgs, restArgs, flags };
 }
 function readStdin() {
     return new Promise((resolve, reject) => {
@@ -141,8 +147,8 @@ function prompt(question) {
         });
     });
 }
-async function handleAuth() {
-    const apiKey = await prompt("Enter your API key: ");
+async function handleAuth(providedKey) {
+    const apiKey = providedKey ?? await prompt("Enter your API key: ");
     if (!apiKey) {
         console.error("No API key provided.");
         process.exit(1);
@@ -168,8 +174,30 @@ function requireClient(flags) {
     }
     return new LoticsClient({ apiKey: auth.apiKey });
 }
+/**
+ * Resolve upload paths: files pass through, directories expand to their immediate files.
+ */
+function resolveUploadPaths(rawPaths) {
+    const result = [];
+    for (const p of rawPaths) {
+        const resolved = path.resolve(p);
+        const stat = fs.statSync(resolved);
+        if (stat.isDirectory()) {
+            const entries = fs.readdirSync(resolved, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isFile()) {
+                    result.push(path.join(resolved, entry.name));
+                }
+            }
+        }
+        else {
+            result.push(resolved);
+        }
+    }
+    return result;
+}
 async function main() {
-    const { command, subcommand, toolArgs, flags } = parseArgs(process.argv.slice(2));
+    const { command, subcommand, toolArgs, restArgs, flags } = parseArgs(process.argv.slice(2));
     if (flags.help || (!command && !flags.version)) {
         printHelp();
         return;
@@ -180,7 +208,7 @@ async function main() {
     }
     // --- Commands that don't require auth ---
     if (command === "auth") {
-        await handleAuth();
+        await handleAuth(subcommand ?? flags.apiKey);
         return;
     }
     if (command === "logout") {
@@ -200,8 +228,8 @@ async function main() {
         process.exit(1);
     }
     if (command === "upload" && !subcommand) {
-        console.error('Usage: lotics upload <file> [--as <name>]');
-        console.error('Uploads a local file and returns its file_id.');
+        console.error('Usage: lotics upload <file|dir...> [--as <name>]');
+        console.error('Uploads files and returns their file_ids. Directories expand to their immediate files.');
         process.exit(1);
     }
     if (command === "download" && !subcommand) {
@@ -214,28 +242,58 @@ async function main() {
     if (command === "tools") {
         if (subcommand) {
             const info = await client.getTool(subcommand);
-            console.log(JSON.stringify(info, null, 2));
+            if (flags.json) {
+                console.log(JSON.stringify(info, null, 2));
+            }
+            else {
+                console.log(`${info.name}\n\n${info.description}\n\nInput schema:\n${JSON.stringify(info.input_schema, null, 2)}`);
+            }
         }
         else {
             const { categories } = await client.listTools();
-            for (const [category, { description, tools }] of Object.entries(categories)) {
-                console.log(description ? `\n## ${category} — ${description}` : `\n## ${category}`);
-                console.log(`  ${tools.join(", ")}`);
+            if (flags.json) {
+                console.log(JSON.stringify(categories, null, 2));
+            }
+            else {
+                for (const [category, { description, tools }] of Object.entries(categories)) {
+                    console.log(description ? `\n## ${category} — ${description}` : `\n## ${category}`);
+                    console.log(`  ${tools.join(", ")}`);
+                }
+                console.log("");
             }
-            console.log("");
         }
         return;
     }
-    // lotics upload <file> [--as <name>]
+    // lotics upload <file|dir...> [--as <name>]
     if (command === "upload") {
-        const upload = await client.uploadFile(subcommand, {
-            filename: flags.as,
+        const rawPaths = [subcommand, ...(toolArgs ? [toolArgs] : []), ...restArgs];
+        const filePaths = resolveUploadPaths(rawPaths);
+        if (filePaths.length === 0) {
+            console.error("No files found in the specified paths.");
+            process.exit(1);
+        }
+        if (flags.as && filePaths.length > 1) {
+            console.error("Cannot use --as with multiple files.");
+            process.exit(1);
+        }
+        const upload = await client.uploadFiles(filePaths, {
+            filenames: flags.as ? [flags.as] : undefined,
         });
-        if (upload.errors.length > 0) {
-            console.error(`Upload failed: ${upload.errors[0].error}`);
+        if (upload.files.length === 0 && upload.errors.length > 0) {
+            console.error(`Upload failed: ${upload.errors.map((e) => `${e.filename}: ${e.error}`).join(", ")}`);
             process.exit(1);
         }
-        console.log(JSON.stringify(upload.files[0], null, 2));
+        if (flags.json) {
+            console.log(JSON.stringify({ files: upload.files, errors: upload.errors }, null, 2));
+        }
+        else {
+            for (const file of upload.files) {
+                console.log(`${file.id}  ${file.filename}  ${file.mime_type}`);
+            }
+            for (const error of upload.errors) {
+                console.error(`FAILED  ${error.filename}  ${error.error}`);
+            }
+        }
         return;
     }
     // lotics download <file_id> [-o <path>]
@@ -261,18 +319,22 @@ async function main() {
                 process.exit(1);
             }
         }
-        const format = flags.json ? "json" : "text";
         const timeoutMs = flags.timeout ?? 60000;
-        const result = await client.execute(toolName, args, { format, timeoutMs });
+        // Always request text format so model_output is available; --json only affects CLI output
+        const result = await client.execute(toolName, args, { format: "text", timeoutMs });
         if (result.error) {
             console.error(result.error);
             console.error(`\nHint: run "lotics tools ${toolName}" to see the expected input schema.`);
             process.exit(1);
         }
-        if (format === "text" && result.model_output) {
+        if (flags.json) {
+            console.log(JSON.stringify(result.result, null, 2));
+        }
+        else if (result.model_output) {
             console.log(result.model_output);
         }
         else {
+            // Fallback: compact JSON when no text output is available
             console.log(JSON.stringify(result.result, null, 2));
         }
         return;

package/dist/src/client.d.ts

@@ -45,7 +45,7 @@ export declare class LoticsClient {
         path: string;
         filename: string;
     }>;
-    uploadFile(filePath: string, options?: {
-        filename?: string;
+    uploadFiles(filePaths: string[], options?: {
+        filenames?: string[];
     }): Promise<FileUploadResult>;
 }

package/dist/src/client.js

@@ -116,14 +116,16 @@ export class LoticsClient {
         await fs.promises.writeFile(absolutePath, buffer);
         return { path: absolutePath, filename };
     }
-    async uploadFile(filePath, options) {
-        const absolutePath = path.resolve(filePath);
-        const buffer = await fs.promises.readFile(absolutePath);
-        const filename = options?.filename ?? path.basename(absolutePath);
-        const mimeType = getMimeType(filename);
-        const blob = new Blob([buffer], { type: mimeType });
+    async uploadFiles(filePaths, options) {
         const formData = new FormData();
-        formData.append("file", blob, filename);
+        for (let i = 0; i < filePaths.length; i++) {
+            const absolutePath = path.resolve(filePaths[i]);
+            const buffer = await fs.promises.readFile(absolutePath);
+            const filename = options?.filenames?.[i] ?? path.basename(absolutePath);
+            const mimeType = getMimeType(filename);
+            const blob = new Blob([buffer], { type: mimeType });
+            formData.append("file", blob, filename);
+        }
         const url = `${this.baseUrl}/v1/files`;
         const response = await fetch(url, {
             method: "POST",

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.2.0",
+  "version": "0.3.1",
   "description": "Lotics SDK and CLI for AI agents",
   "type": "module",
   "bin": {