altalandi 0.6.0 → 0.6.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "altalandi",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Native-sounding Icelandic from your terminal or AI agent: one-time login, a Claude Code skill, and meaning verification.",
   "type": "module",
   "main": "./client.mjs",

package/report.mjs

@@ -88,7 +88,7 @@ export function reportMarkdown(input, data, options = {}) {
     `| Málsnið | ${options.register || "neutral"} |`,
     `| Innfæddni | ${q.nativenessScore ?? "n/a"}/100 |`,
     `| Ritill | ${tier.writer || "standard"} / ${tier.scoring || "?"} |`,
-    `| Auðkenni | ${data?.id || "?"} |`,
+    `| Auðkenni | ${data?.runUrl ? `[${data.id}](${data.runUrl})` : data?.id || "?"} |`,
     "",
     "## Fyrir", "", fence(input), "",
     "## Eftir", "", fence(data?.output), "",
@@ -187,7 +187,7 @@ export function costLines(data, before, after) {
   else if (daily != null && daily > 0) parts.push(`ókeypis ${formatInt(daily)} einingar á dag`);
   if (parts.length) lines.push(`- Staða: ${parts.join(" · ")}`);
   else lines.push("- Staða: náðist ekki að sækja (`npx altalandi whoami`)");
-  if (balance != null && balance < 50) lines.push("- Bæta við inneign: https://altalandi.is/portal");
+  if (balance != null && balance < 50) lines.push("- Bæta við inneign: https://altalandi.is/stjornbord/inneign");
   return lines;
 }
 
@@ -279,7 +279,9 @@ export function reviewMarkdown(input, data, { before = null, after = null, maxCh
   }
 
   out.push("**Kostnaður**", ...costLines(data, before, after));
-  if (data?.id) out.push(`- Auðkenni: \`${data.id}\``);
+  // The run's own page: the text sent, the result, the checks and the review.
+  if (data?.runUrl) out.push(`- Verkið: ${data.runUrl}`);
+  else if (data?.id) out.push(`- Auðkenni: \`${data.id}\``);
   return out.join("\n") + "\n";
 }
 

package/skill/SKILL.md

@@ -1,112 +1,180 @@
----
-name: altalandi
-description: >-
-  Turn English or stiff, translated or AI-written Icelandic into natural native
-  Icelandic through the Altalandi API, with a meaning check and a diff of every
-  change. Use when the user mentions Altalandi, or asks for text in proper,
-  natural, correct or native Icelandic ("á góðri íslensku", "á réttri íslensku",
-  "láttu þetta hljóma eðlilega á íslensku", "translate this into proper
-  Icelandic"), including website copy, UI strings, emails and documents meant for
-  Icelandic readers. Not for incidental Icelandic in conversation.
----
-
-# Altalandi: native Icelandic, with a meaning check
-
-Altalandi rewrites English or stiff Icelandic so it reads as if a native wrote
-it, checks that the meaning held, and lists every change with its reason. Each
-call is paid from the user's free daily units or their credit.
-
-**Follow this procedure exactly, every time.** The user must always see the same
-thing: the verdict, the text before and after, each change with its reason, what
-the call cost and what is left. Do not improvise scripts, parse the JSON
-yourself or summarise the result in your own words.
-
-## The procedure
-
-1. **Save the text** to a UTF-8 temporary file, e.g. `altalandi-in.txt` in the
-   system temp folder. Never put the text on the command line.
-2. **Run one command** and wait for it to finish:
-
-   ```bash
-   npx -y altalandi@latest --review --file <temp>/altalandi-in.txt --out <temp>/altalandi-out.txt
-   ```
-
-   Add `--domain marketing` for website and product copy, `--register formal`
-   for official text, `--register warm` for friendly customer messages.
-3. **Paste its stdout into your reply exactly as printed**, as the first thing in
-   your reply. It is Markdown: a verdict line, **Fyrir**, **Eftir**,
-   **Breytingar** (each change and its reason), **Kostnaður** (cost of this call,
-   balance and free units left) and the request id. Do not shorten, reorder,
-   translate or reword it.
-4. **Then act on the exit code:**
-
-   | Exit | What happened | What you do |
-   |---|---|---|
-   | 0 | rewritten and verified, or no change needed | the result is in `altalandi-out.txt`. If the user asked you to update a file, apply it from there; otherwise ask whether to apply it |
-   | 3 | the rewrite was refused or the meaning could not be verified | keep the user's original text. Say in one sentence that Altalandi left it unchanged and why (the block says why). Do not apply anything |
-   | 4 | out of credit | stop. The block shows the balance and the link to add credit. Do not retry |
-   | 2 | not logged in | connect (below), then run step 2 again |
-   | 1 | other error (network, too many calls) | the block says what happened. For "too many calls", wait a minute and retry once |
-
-5. **Stop there.** After the block and the action, at most one or two sentences
-   of your own.
-
-## Rules
-
-- **Never hand-edit the Icelandic and present it as Altalandi's.** If you think
-  something should still change, say so separately under a heading such as
-  "Mín tillaga (ekki yfirfarin af Altalandi)", or ask before running it again.
-- **One call per coherent text** (a page section, an email, one UI string). For
-  a few strings, run them one by one, at most 4 at a time, and paste each block.
-  Keep keys, placeholders (`{name}`, `%s`), HTML and code out of the text you send.
-  For a whole folder, i18n catalog or website, use the folder run below instead.
-- **Product names and coined words** the meaning check cannot recognise can make
-  it refuse a rewrite (exit 3, "ekki tókst að staðfesta"). That is the safe
-  result: keep the original and tell the user.
-- **A long text** is shortened in the block; the whole result is in
-  `altalandi-out.txt`. Use `--report` when the user wants a full record: it
-  writes `./altalandi-reports/altalandi-<time>-<id>.md`, and the block shows
-  its path. Reports contain the text, so write them only when asked.
-- **Don't use `--fast`** for text people will read: it skips the meaning check.
-- If the user only wants spelling fixed and every other word kept, tell them
-  Altalandi may rephrase, and go through the changes with them.
-- Free use (the free daily units) is kept by Altalandi, with personal data
-  scrubbed, to improve the service; paid use is kept only with consent. Add
-  `--no-store` when the user asks that their text not be kept, or when it is
-  confidential.
-
-## A whole folder, i18n catalog or website
-
-One command refines every `.md`, `.txt`, `.html` and `.json` file in a folder,
-or a web page, or a site. It keeps code, URLs, placeholders, tags and JSON keys
-byte for byte, never writes to the input, and writes only changes whose meaning
-check passed.
-
-1. **Estimate first:** `npx -y altalandi@latest <folder or URL> --dry-run` (add
-   `--site` for a whole site). Show the user the estimate it prints: files,
-   passages, characters, units and the price if paid from credit.
-2. **Only when the user agrees,** run the same command with `--yes` in place of
-   `--dry-run`. The result goes to `<folder>-is` unless they name a place
-   (`--out <path>`).
-3. **Show the summary it prints and the report's path.** Exit 0: done. Exit 2:
-   done, but some passages kept their original text; the report lists them and
-   why. Exit 4: out of credit; the finished files are written, and the same
-   command finishes the rest after a top-up.
-
-## Connect this computer (once)
-
-Only when a call exits with 2 (`Not logged in`):
-
-1. Run `npx -y altalandi@latest login` **in the background**. It waits up to 10
-   minutes.
-2. As soon as it prints a link (`https://altalandi.is/tengja?kodi=XXXX-XXXX`) and
-   a code, show both to the user. Tell them to sign in or create an account
-   (2,000 free units a day, and new accounts get 500 kr. of trial credit) and
-   click **Tengja**.
-3. When it prints `✓ Tengt sem <username>`, run step 2 of the procedure again.
-
-Never ask the user for an API key, and do not tell them to set
-`ALTALANDI_API_KEY`. `npx -y altalandi@latest whoami` shows the account, the
-balance and the free units at any time.
-
-Docs for building the API into an app: https://altalandi.is/agents.md
+---
+name: altalandi
+description: >-
+  Turn English or stiff, translated or AI-written Icelandic into natural native
+  Icelandic through the Altalandi API, with a meaning check and a diff of every
+  change. Use when the user mentions Altalandi, or asks for text in proper,
+  natural, correct or native Icelandic ("á góðri íslensku", "á réttri íslensku",
+  "láttu þetta hljóma eðlilega á íslensku", "translate this into proper
+  Icelandic"), including website copy, UI strings, emails and documents meant for
+  Icelandic readers. Not for incidental Icelandic in conversation.
+---
+
+# Altalandi: native Icelandic, with a meaning check
+
+Altalandi rewrites English or stiff Icelandic so it reads as if a native wrote
+it, checks that the meaning held, and lists every change with its reason. Each
+call is paid from the user's free daily units or their credit.
+
+**Follow this procedure exactly, every time.** The user must always see the same
+thing: the verdict, the text before and after, each change with its reason, what
+the call cost and what is left. Do not improvise scripts, parse the JSON
+yourself or summarise the result in your own words.
+
+## Which way to call it
+
+- **A shell is available (Claude Code, Codex, a terminal):** use the command
+  line, below. It waits up to 5 minutes per call and handles long texts.
+- **No shell, only the Altalandi tools** (`refine_icelandic`,
+  `proofread_icelandic`, `get_refinement_status`, for example in claude.ai or
+  ChatGPT): use the tools, and follow "Long texts through the tools" below. The
+  tools cannot wait as long as the command line, so long texts go in parts.
+
+How long a call takes: a few seconds for a sentence, 10–30 seconds for a
+paragraph, and one to two minutes for a full page of English. A text that fails
+a check is rewritten once more, which can double that.
+
+## The procedure (command line)
+
+1. **Save the text** to a UTF-8 temporary file, e.g. `altalandi-in.txt` in the
+   system temp folder. Never put the text on the command line.
+2. **Run one command and give it time to finish.** Set the shell tool's timeout
+   to 10 minutes (600000 ms) or run it in the background and wait for it. Never
+   stop it early and never start a second call for the same text while one is
+   running: Altalandi is still working and the second call is charged again.
+
+   ```bash
+   npx -y altalandi@latest --review --file <temp>/altalandi-in.txt --out <temp>/altalandi-out.txt
+   ```
+
+   Add `--domain marketing` for website and product copy, `--register formal`
+   for official text, `--register warm` for friendly customer messages.
+3. **Paste its stdout into your reply exactly as printed**, as the first thing in
+   your reply. It is Markdown: a verdict line, **Fyrir**, **Eftir**,
+   **Breytingar** (each change and its reason), **Kostnaður** (cost of this call,
+   balance and free units left) and **Verkið**, the run's own page. Do not
+   shorten, reorder, translate or reword it. The run page shows the user the
+   text sent, the result and the checks, and lets them approve, reject or edit
+   the result there; point them to it when they want to review the work.
+4. **Then act on the exit code:**
+
+   | Exit | What happened | What you do |
+   |---|---|---|
+   | 0 | rewritten and verified, or no change needed | the result is in `altalandi-out.txt`. If the user asked you to update a file, apply it from there; otherwise ask whether to apply it |
+   | 3 | the rewrite was refused or the meaning could not be verified | keep the user's original text. Say in one sentence that Altalandi left it unchanged and why (the block says why). Do not apply anything |
+   | 4 | out of credit | stop. The block shows the balance and the link to add credit. Do not retry |
+   | 2 | not logged in | connect (below), then run step 2 again |
+   | 1 | other error (network, too many calls, timeout) | the block says what happened. For "too many calls", wait a minute and retry once. For a timeout, see "If a call times out" |
+
+5. **Stop there.** After the block and the action, at most one or two sentences
+   of your own.
+
+A document of several sections (more than about 3,000 characters) goes better
+through the folder run below: it sends each passage separately, two at a time,
+and a passage that fails keeps its original without holding up the rest. Save
+the text as a `.md` file in an empty temporary folder and run the folder steps.
+
+## Long texts through the tools
+
+1. **Split the text into parts** at paragraph breaks, never inside a sentence:
+   at most **1,000 characters** a part for English, **1,500** for Icelandic.
+   Keep a heading with the paragraph under it. A list or a table stays in one
+   part when it fits.
+2. **Call the tool once per part,** at most 3 at a time, in order. Give every
+   part its own new `operationId` (a fresh UUID). Keep a note of which ID
+   belongs to which part.
+3. **Join the results in the original order** and give the user the whole text,
+   then each part's verdict and changes, as the tool returns them.
+4. **A part that is refused or unverified keeps its original text.** Say which
+   part, and why (the tool says why). Never rewrite it yourself.
+5. **Terms must match across parts.** If two parts translate the same term
+   differently, point it out and ask which to keep; do not quietly change one.
+
+## If a call times out
+
+A timeout means the answer did not reach you, not that the work stopped.
+Altalandi keeps working and charges for the call once.
+
+With the command line this is rare (it waits 5 minutes). If it happens, do
+not run the text again: tell the user, and that they can see whether it was
+charged at https://altalandi.is/stjornbord/notkun. With the tools:
+
+1. **Call `get_refinement_status` with the same `operationId`.** It costs
+   nothing.
+2. **Act on the status:**
+
+   | Status | What you do |
+   |---|---|
+   | `completed` with the result | use the result as if the call had answered |
+   | `completed` without the result | the call finished and was charged, but the text was not kept. Tell the user, and ask before sending that part again with a new `operationId` (it is charged again) |
+   | `pending` | still working. Wait 30 seconds and check again, up to 4 times. Do not send the text again meanwhile |
+   | `rejected` or `not_found` (`retryable: true`) | nothing was charged. Send the same part again with the **same** `operationId` |
+   | `uncertain` | do not retry. Tell the user the call may or may not have finished, and that they can check their usage at https://altalandi.is/stjornbord/notkun |
+
+3. **Never get round the protection** by inventing a new `operationId` for a
+   text that may still be running. It charges the user twice.
+4. **Next time, send smaller parts** (see above).
+
+## Rules
+
+- **Never hand-edit the Icelandic and present it as Altalandi's.** If you think
+  something should still change, say so separately under a heading such as
+  "Mín tillaga (ekki yfirfarin af Altalandi)", or ask before running it again.
+- **One call per coherent text** (a page section, an email, one UI string). For
+  a few strings, run them one by one, at most 4 at a time, and paste each block.
+  Keep keys, placeholders (`{name}`, `%s`), HTML and code out of the text you send.
+  For a whole folder, i18n catalog or website, use the folder run below instead.
+- **Product names and coined words** the meaning check cannot recognise can make
+  it refuse a rewrite (exit 3, "ekki tókst að staðfesta"). That is the safe
+  result: keep the original and tell the user.
+- **A long text** is shortened in the block; the whole result is in
+  `altalandi-out.txt`. Use `--report` when the user wants a full record: it
+  writes `./altalandi-reports/altalandi-<time>-<id>.md`, and the block shows
+  its path. Reports contain the text, so write them only when asked.
+- **Don't use `--fast`** for text people will read: it skips the meaning check.
+- If the user only wants spelling fixed and every other word kept, use the
+  `proofread_icelandic` tool where it is available. The command line rewrites:
+  tell the user it may rephrase, and go through the changes with them.
+- Every call from a signed-in account is kept in that account's history for
+  90 days, so the run page can show it; only the account and its team see it,
+  and it can be deleted on the page or switched off in Settings. Separately,
+  free use is kept, with personal data scrubbed, to improve the service; paid
+  use only with consent. Add `--no-store` when the user asks that their text
+  not be kept, or when it is confidential: the call is then kept nowhere, and
+  its run page shows only the figures.
+
+## A whole folder, i18n catalog or website
+
+One command refines every `.md`, `.txt`, `.html` and `.json` file in a folder,
+or a web page, or a site. It keeps code, URLs, placeholders, tags and JSON keys
+byte for byte, never writes to the input, and writes only changes whose meaning
+check passed.
+
+1. **Estimate first:** `npx -y altalandi@latest <folder or URL> --dry-run` (add
+   `--site` for a whole site). Show the user the estimate it prints: files,
+   passages, characters, units and the price if paid from credit.
+2. **Only when the user agrees,** run the same command with `--yes` in place of
+   `--dry-run`, with the shell timeout set to 10 minutes or in the background.
+   The result goes to `<folder>-is` unless they name a place (`--out <path>`).
+3. **Show the summary it prints and the report's path.** Exit 0: done. Exit 2:
+   done, but some passages kept their original text; the report lists them and
+   why. Exit 4: out of credit; the finished files are written, and the same
+   command finishes the rest after a top-up.
+
+## Connect this computer (once)
+
+Only when a call exits with 2 (`Not logged in`):
+
+1. Run `npx -y altalandi@latest login` **in the background**. It waits up to 10
+   minutes.
+2. As soon as it prints a link (`https://altalandi.is/tengja?kodi=XXXX-XXXX`) and
+   a code, show both to the user. Tell them to sign in or create an account
+   (2,000 free units a day, and 500 kr. of trial credit once they confirm their email) and
+   click **Tengja**.
+3. When it prints `✓ Tengt sem <username>`, run step 2 of the procedure again.
+
+Never ask the user for an API key, and do not tell them to set
+`ALTALANDI_API_KEY`. `npx -y altalandi@latest whoami` shows the account, the
+balance and the free units at any time.
+
+Docs for building the API into an app: https://altalandi.is/agents.md