altalandi 0.6.1 → 0.6.3

package/README.md

@@ -99,6 +99,8 @@ altalandi --fast "..."                 # skip the meaning + nativeness gates
 altalandi --diff --file draft.txt      # show before, after and every change with its reason
 altalandi --review --file in.txt --out out.txt   # for agents: one block to show as it is
 altalandi --report --file draft.txt    # also write a Markdown report to ./altalandi-reports/
+altalandi --review --job j_20261013a1b2c3 --job-title "Handbók" --part "Hluti 1 af 3" --file part1.txt
+                                       # one part of a longer text: same --job on every part
 ```
 
 | flag | default | meaning |
@@ -107,11 +109,14 @@ altalandi --report --file draft.txt    # also write a Markdown report to ./altal
 | `--register` | `neutral` | `formal` \| `neutral` \| `warm` |
 | `--json` | off | print the full API response |
 | `--diff` | off | print the text before and after, then each change with its reason, on `stderr` (coloured in a terminal; `NO_COLOR` turns colour off) |
-| `--review` | off | print one Markdown block on `stdout`, made to be shown as it is: the verdict, the text before and after, each change with its reason, what the call cost and the balance and free units left. Exits on the outcome: `0` rewritten and verified or no change needed, `3` refused or unverified, `4` out of credit |
-| `--no-store` | off | send `contribute: false`: this text is never kept. Without it, free use (calls covered by the free daily units) is kept with personal data scrubbed, to improve the service; paid use is kept only with consent ([privacy](https://altalandi.is/personuvernd#textabanki)) |
+| `--review` | off | print one Markdown block on `stdout`, made to be shown as it is: the verdict, the text before and after, each change with its reason, what the call cost and the balance and free characters left. Exits on the outcome: `0` rewritten and verified or no change needed, `3` refused or unverified, `4` out of credit |
+| `--no-store` | off | send `contribute: false`: this text is never kept. Without it, free use (calls covered by the free daily characters) is kept with personal data scrubbed, to improve the service; paid use is kept only with consent ([privacy](https://altalandi.is/personuvernd#textabanki)) |
 | `--out <file>` | | write the refined text to `<file>` (UTF-8); with `--review` the block names it when the text is shortened |
 | `--report` | off | also write `./altalandi-reports/altalandi-<time>-<id>.md`: input, output, a table of every change (before, after, reason, layer), warnings and the verdict |
 | `--report-dir <dir>` | | write the report to `<dir>` instead (implies `--report`) |
+| `--job <id>` | | make this call a part of a job (verk): every call with the same id is one job on the site, one page for the whole text. The id is yours to choose: `j_` and 8–64 of `A-Z a-z 0-9 _ -`, e.g. `j_` + the date + a few random characters. With `--review`, the block links the job (`Verkið`) and this part (`Hlutinn`) |
+| `--job-title <text>` | | the job's name (up to 120 characters); the first call that sends one names it |
+| `--part <text>` | | this call's part, e.g. `Hluti 2 af 5` (up to 300 characters); needs `--job` |
 | `--fast` | off | `preserveMeaning:false`, `scoreNativeness:false`, `onlyImprove:false`, `polishPass:false`, `scoring:"none"` — normally one model call (structured input can still add a structure-preserving retry) |
 
 ## Folders, i18n catalogs and websites
@@ -127,8 +132,11 @@ altalandi https://example.com/pricing --out pricing-is.md   # one page → Markd
 altalandi https://example.com/docs/ --site --max-pages 50    # a site → ./example.com-is/
 ```
 
-Each passage (a paragraph, list item, table cell, heading or string) is its own
-call. Everything outside the passages is written back byte for byte:
+Each passage (a paragraph, list item, table cell, heading or string) is refined
+and checked on its own. Short passages (up to 1,500 characters) are sent
+together through `/v1/refine/batch`, up to 40 a request and 6,000 characters;
+longer ones go one call each to `/v1/refine`. Everything outside the passages is
+written back byte for byte:
 
 | format | refined | never touched |
 |--------|---------|---------------|
@@ -154,13 +162,19 @@ the same origin and under the URL's folder.
 from the public tariff:
 
 ```text
-5 files, 24 passages, about 851 characters (23 calls: repeated passages are sent once).
+5 files, 24 passages, about 851 characters (23 to send: repeated passages are sent once).
+1 request: 23 short passages together in 1 batch.
 1 more file has nothing to refine and is copied unchanged.
-Billing: about 920 units (at least 40 a call), about 74 kr if paid from credit. The free allowance is 2,000 units a day.
+Kostnaður: um 3.016 stafir (um 1 A4-síða), um 30 kr. ef greitt er af inneign.
+Hvert kall telst minnst 250 stafir; margir stuttir textar í einu kalli minnst 130 stafir hver. Hver aðgangur fær ókeypis dagskammt af stöfum (`GET /v1/pricing`).
 ```
 
-Every call costs at least the per-call minimum, so many short strings cost more
-than their word count. In a terminal it asks before sending; without one (CI,
+Billing is by character (stafir): every character sent, spaces and punctuation
+included. In a batch each string is billed at least 130 characters, and the
+250-character per-call minimum is paid once per request, not once per string:
+short strings cost about half what one call each would. The summary and the
+report show the characters actually billed. An older self-hosted engine without the batch endpoint gets one
+call per passage (the run says so once). In a terminal it asks before sending; without one (CI,
 agents) it sends nothing unless you pass `--yes`.
 
 | flag | default | meaning |
@@ -169,15 +183,24 @@ agents) it sends nothing unless you pass `--yes`.
 | `--dry-run` | off | list every passage and the estimate; send nothing, write nothing |
 | `--yes`, `-y` | off | send without asking |
 | `--max-chars <n>` | | files are sent in order until the next would go over n characters; the rest are neither sent nor written |
-| `--concurrency <n>` | `2` | calls at once, 1–4 |
+| `--concurrency <n>` | `2` | requests at once, 1–4 |
 | `--site` / `--max-pages <n>` | off / `20` | read a site from the URL, up to n pages |
 | `--no-store` | off | keep none of the passages (free use is otherwise kept, scrubbed of personal data) |
 | `--json` | off | a machine-readable summary of every file and passage on stdout |
+| `--job <id>` / `--job-title <text>` | a new job | add the run to an existing job, or name it |
 
 A `429` waits as long as `Retry-After` asks (up to 5 minutes) and retries. A
 `402` stops the run cleanly: finished files are written, the rest are listed and
 not written; run the same command again after topping up.
 
+**One job.** A run is one job (verk) on your account: every request sends the
+same `job` id (`j_` + the date + 10 random characters, made per run), titled by
+the folder's name or the site's host, and each file (its relative path) or page
+(its URL) is a part. A batch that holds several small files is named by its
+first file; a file that fits in one batch is not split across two. The summary
+and the report show one `Verkið: <link>` to the job's page, not one link per
+call. An engine that does not know jobs simply leaves the line out.
+
 **Results.** Only verified changes are written. A passage keeps its original
 text when its meaning check did not pass (`meaningCheck` other than `passed`, or
 `meaningPreserved` not `true`), or when the refined text lost or changed code, a
@@ -255,6 +278,6 @@ the explicit verification opt-out and exits 0 after a successful API response.
 
 MIT licensed. Calls are paid from the account's prepaid credit (a 500 kr trial,
 then credit bought in the portal); a call the credit cannot cover exits with the
-server's `402 insufficient_balance` message. The request's text and glossary fields are charged at the effective billing-tier
-weight. Each whitespace-delimited token is at least one unit; an unbroken token
-uses one unit per 20 characters, rounded up.
+server's `402 insufficient_balance` message. The request's text and glossary fields are charged by the character
+(every Unicode character, spaces, punctuation and line breaks included) at the
+effective billing-tier weight, with a minimum per call.

package/altalandi.mjs

@@ -108,6 +108,9 @@ for (let i = 0; i < args.length; i++) {
   else if (a === "--yes" || a === "-y") opts.yes = true;
   else if (a === "--max-chars") opts.maxChars = Number(args[++i]);
   else if (a === "--concurrency") opts.concurrency = Number(args[++i]);
+  else if (a === "--job") opts.job = args[++i] ?? "";
+  else if (a === "--job-title") opts.jobTitle = args[++i] ?? "";
+  else if (a === "--part") opts.part = args[++i] ?? "";
   else positional.push(a);
 }
 
@@ -122,6 +125,9 @@ Usage:
                                         for agents: one block to show as it is
   echo "text" | altalandi
   altalandi --domain marketing --register warm "text"
+  altalandi --review --job j_20261013a1b2c3 --job-title "Handbók" --part "Hluti 1 af 3" --file part1.txt
+                                        one part of a longer text: every part with the same
+                                        --job is one verk (job) on the site
 
 Folders and websites:
   altalandi ./docs                      every .md .txt .html .json under ./docs → ./docs-is
@@ -154,6 +160,10 @@ Options:
   --report     also write a Markdown report (input, output, changes, reasons, verdict)
                to ./altalandi-reports/  (or --report-dir <dir>; ALTALANDI_REPORT=1 turns it on)
   --file       read the text from a UTF-8 file instead of an argument
+  --job        a job id (j_ and 8-64 of A-Z a-z 0-9 _ -) you choose: calls with the same id
+               are the parts of one verk; --review then links the job and this part
+  --job-title  the job's name, kept from the first call that sends one (up to 120 characters)
+  --part       this call's part, e.g. "Hluti 2 af 5" (up to 300 characters; needs --job)
   --base-url   API base  (default $ALTALANDI_BASE_URL or https://altalandi.is/api)
 
 stdout = refined text; stderr = nativeness / meaning / warnings / diff.
@@ -169,6 +179,9 @@ Folder and website options:
   --site         with a URL: its pages on the same site, under the URL's folder
   --max-pages    pages to read with --site (default 20)
   --json         print a machine-readable summary at the end
+  --job          add the run to this job; --job-title names it (default: a new
+                 job per run, named by the folder or the site's host; each file
+                 or page is a part)
 Code, URLs, link targets, placeholders ({name}, %s, ICU), HTML tags and JSON keys
 stay byte for byte. Only changes whose meaning check passed are written; other
 passages keep the original text and are listed in the report
@@ -186,6 +199,13 @@ function readStdin() {
   });
 }
 
+// --job / --job-title / --part: checked here so a bad id never reaches the API.
+const JOB_ID = /^j_[A-Za-z0-9_-]{8,64}$/;
+if (opts.job !== undefined && !JOB_ID.test(opts.job)) {
+  console.error(`--job must be j_ followed by 8 to 64 letters, digits, _ or - (for example j_20261013a1b2c3); got "${opts.job}".`);
+  process.exit(2);
+}
+
 const stored = readCredentials();
 const baseUrl = (opts.baseUrl || process.env.ALTALANDI_BASE_URL || stored?.baseUrl || "https://altalandi.is/api").replace(/\/$/, "");
 const { key } = resolveKey({ flag: opts.key });
@@ -206,6 +226,10 @@ if (opts.site || opts.dryRun || opts.maxChars !== undefined || opts.maxPages !==
   console.error("--site, --dry-run, --max-chars, --max-pages and --concurrency need a folder or a URL:  altalandi ./docs --dry-run");
   process.exit(2);
 }
+if (opts.job === undefined && (opts.jobTitle !== undefined || opts.part !== undefined)) {
+  console.error("--job-title and --part need --job <id>: the same id on every part of the text.");
+  process.exit(2);
+}
 
 let text = positional.join(" ").trim();
 if (opts.file) {
@@ -224,6 +248,14 @@ const requestOptions = {
   register: opts.register,
   ...(opts.noStore ? { contribute: false } : {}),
 };
+if (opts.job) {
+  const cap = (s, n) => [...String(s)].slice(0, n).join("");
+  requestOptions.job = {
+    id: opts.job,
+    ...(opts.jobTitle ? { title: cap(opts.jobTitle, 120) } : {}),
+    ...(opts.part ? { part: cap(opts.part, 300) } : {}),
+  };
+}
 // --fast disables every optional quality/verification pass. The writer can
 // still retry once when it drops document structure, as documented in --help.
 // Name every switch explicitly so a future server-default change cannot make

package/auth.mjs

@@ -211,10 +211,8 @@ export async function runWhoami(flags = {}, io = {}) {
   const me = await res.json();
   if (flags.json) out(JSON.stringify({ ...me, keySource: source }, null, 2));
   else {
-    const { formatInt, formatIsk } = await import("./report.mjs");
-    const free = me.freeUnitsLeftToday != null && me.freeDailyUnits != null
-      ? `ókeypis eftir í dag ${formatInt(me.freeUnitsLeftToday)} af ${formatInt(me.freeDailyUnits)} einingum`
-      : me.freeDailyUnits ? `ókeypis ${formatInt(me.freeDailyUnits)} einingar á dag` : "";
+    const { formatIsk, freeCharsText } = await import("./report.mjs");
+    const free = freeCharsText(null, me);
     out([me.username ?? "(lykill án aðgangs)",
       `inneign ${me.balanceIsk != null ? formatIsk(me.balanceIsk) : "—"}`,
       free, `lykill ${me.keyId} (${source})`].filter(Boolean).join(" · "));