@hardfin/cli 0.1.1-dev.60 → 0.1.1-dev.61

package/README.md

@@ -131,6 +131,10 @@ for.
 A person at a terminal reads one plain line on stderr. Anything else reads JSON, also on
 stderr, so a pipe still carries only the result.
 
+JSON is written on one line when a program reads it, and indented when a terminal shows it.
+The indentation of a page of records is close to half its size, which an agent would
+otherwise have to read. Pipe a result through `jq .` to read it indented.
+
 | Field       | Holds                                                                    |
 | ----------- | ------------------------------------------------------------------------ |
 | `code`      | A fixed name for the failure, such as `not_found` or `missing_flag`      |
@@ -554,13 +558,17 @@ connector directory requires.
 A tool call runs the CLI itself, so an agent and a person get identical parsing, output and
 exit codes. Each call has these limits:
 
-| Limit            | Value                                   | Past it                                    |
-| ---------------- | --------------------------------------- | ------------------------------------------ |
-| Time             | 120 seconds                             | The command is stopped, and the call fails |
-| Commands running | 4 at once                               | The next call waits for one to finish      |
-| One argument     | 128 KiB                                 | Refused, pointing at the `input` argument  |
-| Standard input   | The call's `input` argument, or nothing | Always closed, so `--input -` never waits  |
-| One result       | 200,000 characters                      | Cut, with a line saying it is not complete |
+| Limit            | Value                                   | Past it                                                  |
+| ---------------- | --------------------------------------- | -------------------------------------------------------- |
+| Time             | 120 seconds                             | The command is stopped, and the call fails               |
+| Commands running | 4 at once                               | The next call waits for one to finish                    |
+| One argument     | 128 KiB                                 | Refused, pointing at the `input` argument                |
+| Standard input   | The call's `input` argument, or nothing | Always closed, so `--input -` never waits                |
+| One result       | 200,000 characters                      | A list is shortened to the records that fit, and says so |
+
+A list that is too long comes back as valid JSON holding the records that fit, with
+`truncated` saying how many were shown, how many were asked for, and to narrow the list or
+count with `--limit 1`. An asset is about 6 kB, so 30 fit in one result.
 
 A failed call also carries the failure as `structuredContent`, with the same `code`,
 `message`, `errors`, `requestId` and `status` the CLI prints, plus `exitCode`. A file that is

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="7b79fe1d-6296-5c3c-a667-7257662abc80")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="d233e4e5-e149-5533-80be-917bfd948db3")}catch(e){}}();
 import module from "node:module";
 //#region src/cli.ts
 module.enableCompileCache?.();
@@ -14,7 +14,7 @@ process.on("unhandledRejection", (error) => void toCrash(error));
 try {
 	const answer = await toQuickAnswer(process.argv.slice(2));
 	if (answer === void 0) {
-		const { toCli, toParseExitCode, wasReportAttempted } = await import("./program-BP83nk1M.js");
+		const { toCli, toParseExitCode, wasReportAttempted } = await import("./program-CkKf46kC.js");
 		try {
 			await toCli().parseAsync(process.argv);
 		} catch (error) {
@@ -33,7 +33,7 @@ async function toCrash(error) {
 	isCrashing = true;
 	const isJSON = process.argv.includes("--json") || !process.stdout.isTTY;
 	try {
-		const { toReported, writeCrash } = await import("./program-BP83nk1M.js");
+		const { toReported, writeCrash } = await import("./program-CkKf46kC.js");
 		writeCrash(error, isJSON);
 		await toReported(error, isJSON, void 0, "fatal");
 	} catch {
@@ -54,4 +54,4 @@ async function toQuickAnswer(args) {
 export {};
 
 //# sourceMappingURL=cli.js.map
-//# debugId=7b79fe1d-6296-5c3c-a667-7257662abc80
+//# debugId=d233e4e5-e149-5533-80be-917bfd948db3