@3minapi/cli 0.22.0 → 0.22.2

package/README.md

@@ -76,6 +76,12 @@ npm install -g @3minapi/cli@latest
 
 The CLI tells you when a newer version is recommended, and stops with exit code 6 when it is too old to connect.
 
+## Where releases come from
+
+Releases are built and published by GitHub Actions from the public repository
+[maverick-works-dev/3minapi-cli](https://github.com/maverick-works-dev/3minapi-cli), with npm provenance. The
+**Provenance** section on the npm package page links each version to the commit and workflow run that built it.
+
 ## Links
 
 - Guide: [3minapi.com](https://3minapi.com)

package/dist/modules/workers/results/missing-paths.js

@@ -62,5 +62,5 @@ export function missingPathsWarning(missing) {
     const shown = missing.slice(0, MISSING_PATHS_MAX);
     const more = missing.length - shown.length;
     return (`No result in the scope has ${shown.join(', ')}${more > 0 ? ` and ${more} more` : ''}, so ` +
-        `${missing.length === 1 ? 'it reads' : 'they read'} as NULL — op "describe" lists the paths the results have.`);
+        `${missing.length === 1 ? 'it reads' : 'they read'} as NULL — task_result_describe lists the paths the results have.`);
 }

package/dist/modules/workers/results/reader-input.js

@@ -1,8 +1,7 @@
 import { BUILTIN_TASK_IDS_MAX, READ_LIMIT_MAX } from "../../../core/domain/index.js";
-export const READER_USAGE = 'input is one of: {"op":"describe","task_id":"…","run_no?":1} | {"op":"describe","worker":"…","since?":"ISO date"} | ' +
-    '{"op":"query","sql":"SELECT … FROM results …","worker?":"…","task_id?":"…","task_ids?":["…"],"since?":"ISO date","expect_shape?":"…"} ' +
-    '(at least one of worker, task_id, task_ids, since) | {"op":"read","task_id":"…","run_no?":1,"path?":"$.items","offset?":0,"limit?":100} ' +
-    '(run_no picks a run of a repeating task; the latest run when left out)';
+export const READER_USAGE = 'Use task_result_describe with task_id (and run_no) or worker (and since); task_result_query with sql and at least ' +
+    'one of worker, task_id, task_ids, since (and expect_shape); or task_result_read with task_id (and run_no, path, ' +
+    'offset, limit). run_no picks a run of a repeating task; the latest run when left out';
 const TASK_ID = /^[0-9A-Za-z-]{1,64}$/;
 const SHAPE_HASH = /^[0-9a-f]{16}$/;
 const WORKER_MAX_CHARS = 50;

package/dist/modules/workers/results/reader.js

@@ -79,7 +79,7 @@ function describeOne(db, taskId, hostId, runNo) {
             ? out
             : {
                 ...out,
-                error: { message: 'the saved error is too large to show; read it with op "read"' }
+                error: { message: 'the saved error is too large to show; read it with task_result_read' }
             };
     }
     return {
@@ -382,7 +382,7 @@ function readText(base, text, offset, limit) {
     };
 }
 function missing(path) {
-    return new Failure('read_out_of_range', `${path} does not exist in this result — check the paths with op "describe"`);
+    return new Failure('read_out_of_range', `${path} does not exist in this result — check the paths with task_result_describe`);
 }
 export function parsePath(path) {
     const steps = [];

package/dist/modules/workers/results/substitute.js

@@ -3,9 +3,9 @@ import { formatCount } from "../../../core/text.js";
 import { fitShape } from "./shape.js";
 export const SUBSTITUTE_READ = "The full result is too large to send and is stored on the user's PC. Do not present this summary as the result. " +
     '`shape` summarizes its structure: the paths it has, with types, counts and sample values — an overview; ' +
-    'deeper levels may be left out (`omitted`), and {"op":"describe","task_id":"<task_id>"} returns them. ' +
-    'Compute the answer over those paths by creating a task for the worker in `reader` with input ' +
-    '{"op":"query","task_id":"<task_id>","sql":"SELECT … FROM results"} — help(tasks) explains the view and examples.';
+    'deeper levels may be left out (`omitted`), and task_result_describe with this task_id returns them. ' +
+    'Compute the answer over those paths with task_result_query for this task_id and SQL over the view `results` — ' +
+    'help(tasks) explains the view and examples.';
 export const SUBSTITUTE_READ_LOCAL_ONLY = "The full result is too large to send and is stored on the user's PC. The user can see it with " +
     "'3minapi worker results show <task_id>' or query it with '3minapi worker results query'. " +
     '`shape` summarizes its structure: paths, types, counts and sample values — an overview; deeper ' +

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@3minapi/cli",
-	"version": "0.22.0",
+	"version": "0.22.2",
 	"description": "Run your machine as a 3Min API host — the CLI that fetches tasks from your AI and runs them with your own worker files",
 	"keywords": [
 		"3minapi",