@lotics/cli 0.48.0 → 0.49.0

package/README.md

@@ -102,7 +102,10 @@ lotics tools query_records      # show full description + input schema
 lotics run query_tables '{}'
 lotics run query_records '{"table_id":"tbl_...","field_keys":["name"]}'
 
-# Pipe args via stdin
+# Large args (a knowledge-doc `content`, a bulk update) exceed the OS arg limit —
+# read them from a file or stdin instead of an inline arg:
+lotics run create_knowledge @args.json
+cat args.json | lotics run create_knowledge
 echo '{"table_id":"tbl_..."}' | lotics run query_records
 
 # Upload files (multiple files and directories supported)

package/dist/cli.js

@@ -54,6 +54,8 @@ COMMANDS
   lotics tools                         List all available tools
   lotics tools <name>                  Show tool description and input schema
   lotics run <tool> '<json>'           Execute a tool
+  lotics run <tool> @args.json         Read JSON args from a file (large payloads)
+  cat args.json | lotics run <tool>    Read JSON args from stdin (large payloads)
   lotics upload <file|dir...>          Upload files (directories expand to their immediate files)
   lotics download <file_id>            Download a file by ID
   lotics download record <record_id> <field_key>
@@ -533,7 +535,9 @@ async function main() {
         process.exit(1);
     }
     if (command === "run" && !subcommand) {
-        console.error('Usage: lotics run <tool> \'<json_args>\'');
+        console.error("Usage: lotics run <tool> '<json_args>'\n" +
+            "       lotics run <tool> @args.json   (read args from a file — for large payloads)\n" +
+            "       cat args.json | lotics run <tool>   (read args from stdin)");
         console.error('Run "lotics tools" to see available tools.');
         process.exit(1);
     }
@@ -779,7 +783,23 @@ async function main() {
     if (command === "run") {
         const toolName = subcommand;
         let rawArgs = toolArgs;
-        if (!rawArgs && !process.stdin.isTTY) {
+        if (rawArgs && rawArgs.startsWith("@")) {
+            // `@<path>` — read the JSON args from a local file. JSON args always
+            // start with `{`, so a leading `@` is unambiguous. This (and piped
+            // stdin below) carries payloads too large for an inline arg, which the
+            // OS caps (ARG_MAX) — e.g. a knowledge doc's `content` or a bulk update.
+            // Reads only a file the caller explicitly named; no new trust boundary.
+            const argsPath = rawArgs.slice(1);
+            try {
+                rawArgs = fs.readFileSync(argsPath, "utf-8");
+            }
+            catch (err) {
+                console.error(`Cannot read args file "${argsPath}": ${err instanceof Error ? err.message : String(err)}`);
+                process.exit(1);
+            }
+        }
+        else if (!rawArgs && !process.stdin.isTTY) {
+            // Piped/redirected stdin — `… | lotics run <tool>` or `< file.json`.
             rawArgs = await readStdin();
         }
         let args = {};

package/dist/src/cli.js

@@ -47594,6 +47594,8 @@ COMMANDS
   lotics tools                         List all available tools
   lotics tools <name>                  Show tool description and input schema
   lotics run <tool> '<json>'           Execute a tool
+  lotics run <tool> @args.json         Read JSON args from a file (large payloads)
+  cat args.json | lotics run <tool>    Read JSON args from stdin (large payloads)
   lotics upload <file|dir...>          Upload files (directories expand to their immediate files)
   lotics download <file_id>            Download a file by ID
   lotics download record <record_id> <field_key>
@@ -48038,7 +48040,9 @@ async function main() {
     process.exit(1);
   }
   if (command === "run" && !subcommand) {
-    console.error("Usage: lotics run <tool> '<json_args>'");
+    console.error(
+      "Usage: lotics run <tool> '<json_args>'\n       lotics run <tool> @args.json   (read args from a file \u2014 for large payloads)\n       cat args.json | lotics run <tool>   (read args from stdin)"
+    );
     console.error('Run "lotics tools" to see available tools.');
     process.exit(1);
   }
@@ -48270,7 +48274,17 @@ ${JSON.stringify(info.input_schema, null, 2)}`);
   if (command === "run") {
     const toolName = subcommand;
     let rawArgs = toolArgs;
-    if (!rawArgs && !process.stdin.isTTY) {
+    if (rawArgs && rawArgs.startsWith("@")) {
+      const argsPath = rawArgs.slice(1);
+      try {
+        rawArgs = fs7.readFileSync(argsPath, "utf-8");
+      } catch (err2) {
+        console.error(
+          `Cannot read args file "${argsPath}": ${err2 instanceof Error ? err2.message : String(err2)}`
+        );
+        process.exit(1);
+      }
+    } else if (!rawArgs && !process.stdin.isTTY) {
       rawArgs = await readStdin();
     }
     let args = {};

package/package.json

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