App: a layer split runs DFlash2 alone, one request at a time. chooseParallel kept the app's default of 4 slots on two or more cards, so the Python plan (drafting.blocked_by) refused DFlash2 for slots > 1, the MTP layer was not on the disk (a DFlash2 install leaves it out) and the start ran with no drafter. The one-request rule for DFlash2 no longer asks for one card; a number the person chose still stays, and the MTP keeps its slots. Test: two cards with DFlash2 give one slot and the note, two cards with the MTP keep more than one.

App: `strata drafting plan/fetch` gain --no-split, and every drafting call the host makes (control-runtime.mjs draftingPlan, draftingFetch) carries it, so Auto in the app on
2 NVIDIA / 4 R9700 cards is the layer split with DFlash2 alone, no draft layer is planned or fetched for the split, and the Models screen label and fit say DFlash2 again
(capabilities.dflash2Split stays false). The Terminal's plan is unchanged (split + MTP). The gguf_dir fix of installMtpLayer and the explicit-MTP path stay.
Lanes: split_config cuts the lanes to 1..8 (the engine refuses "--batch must be 1..8"): the AMD four-card default PARALLEL 32, a layer config's own --batch (IQ3_S on 4 R9700
gave 32 and fell back to the layer split) and a profile parallel above 8; serve/server.py parallel_args' split branch cuts the same.
Tests: tests/terminal/test_split_parallel.py (AppDoesNotSplit, LaneClamp), apps/host/tests/drafting.test.mjs.

.dockerignore

@@ -17,6 +17,11 @@ __pycache__/
 /mtp/
 /models/
 /Strata-data/
+# the folders docker/entrypoint.sh creates in a mounted data/ (a link to llama.cpp, the models, the keys): never part of a build (#3644)
+/data/install/
+/data/state/
+/data/home/
+/data/Strata-data/
 third_party/llama.cpp/
 third_party/*.zip
 *.done

.gitattributes

@@ -25,3 +25,6 @@ docker/compose/* text eol=lf
 
 # Apple tools (codesign, plutil) read these: LF only, wherever the repository is cloned
 *.plist text eol=lf
+
+# vendored KaTeX (serve/web/vendor): the files are hashed byte for byte (PROVENANCE.json), never convert their line endings.
+serve/web/vendor/** -text

.github/ISSUE_TEMPLATE/amd_split_report.yml

@@ -0,0 +1,68 @@
+name: AMD split engine report
+description: Tell us whether the all-cards split engine works on your AMD cards (it prints a line asking for this on cards Strata has not run it on)
+title: "[Engine] AMD split engine: <your card> x <count>"
+labels: ["engine", "amd-split-report"]
+body:
+  - type: markdown
+    value: |
+      Strata runs the all-cards split engine by itself on Radeon AI PRO R9700 / RX 9070 (gfx1201). On other AMD cards (RX 9060, RX 7000, the 780M and similar) it only starts when you ask for it with `strata launch --split-engine on`, and it prints one line asking you to report whether it works. We cannot test those cards, so your report is how we learn.
+
+      Write only what you saw. A report that says "it did not start" is as useful as one that says "it works".
+  - type: input
+    id: card
+    attributes:
+      label: Card model and count
+      description: For example "2 x RX 7900 XTX 24 GB" or "3 x RX 9060 XT 16 GB"
+    validations:
+      required: true
+  - type: input
+    id: arch
+    attributes:
+      label: Architecture (the gfx name)
+      description: From the engine's line, or `rocminfo | grep gfx`. For example gfx1100.
+    validations:
+      required: true
+  - type: input
+    id: rocm
+    attributes:
+      label: ROCm / driver version
+      description: Strata's engine package brings its own ROCm libraries; the kernel driver is yours (`uname -r`, `amd-smi version`).
+    validations:
+      required: true
+  - type: input
+    id: model
+    attributes:
+      label: Model and quantization
+      description: The model Strata loaded, for example Qwen3.8-Flash-Next UD-Q4_K_XL or the IQ3_S set.
+    validations:
+      required: true
+  - type: textarea
+    id: selftest
+    attributes:
+      label: The self-test line
+      description: Paste the line from the engine's log that starts "The split engine's self-test" (passed or failed). The log is in the run folder shown at launch; `strata launch` also prints it.
+      render: text
+    validations:
+      required: true
+  - type: dropdown
+    id: result
+    attributes:
+      label: What happened
+      options:
+        - It started and the answers look right
+        - It started and the answers look wrong
+        - The self-test failed, so the normal layer split started
+        - It failed to start (not the self-test)
+        - It started and crashed or hung later
+    validations:
+      required: true
+  - type: input
+    id: speed
+    attributes:
+      label: Speed, tok/s (the split engine, then the layer split with `--split-engine off` if you tried both)
+      description: For example "decode 61 tok/s, layer split 48 tok/s, one user".
+  - type: textarea
+    id: more
+    attributes:
+      label: Anything else
+      description: Wrong answers (the prompt and what you got), crashes (the last lines of the engine log), or what you changed.

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -66,7 +66,7 @@ body:
     attributes:
       label: Strata version
       description: "In the app: Settings > About. In the Terminal: `strata --version`. From source: the About tab of the web page, or `engine` in `GET /v1/status`, or the git commit."
-      placeholder: "Strata 0.2.0-beta · engine 0.1.45.3"
+      placeholder: "Strata 0.2.10 · engine 0.1.56"
     validations:
       required: true
   - type: input

.github/scripts/item-check.js

@@ -0,0 +1,218 @@
+'use strict';
+// Format check for issues and pull requests (see CONTRIBUTING.md and .github/ISSUE_TEMPLATE/*.yml).
+// Pure functions only: no network, no filesystem. Used by intake.yml and reopen.yml through reset-bot.js.
+
+const AREAS = ['Engine', 'GUI', 'TUI', 'Benchmark', 'Docs', 'Other'];
+const TITLE_RE = new RegExp('^\\[(' + AREAS.join('|') + ')\\] \\S');
+const NO_ANSWER = /^(_no response_|none|n\/a|na|-|todo|tbd|\.|\?)$/i;
+const NOT_RUN_LABELS = /^\*\*(passed|failed|not run)\s*:?\*\*\s*:?/gim;
+
+// Version the reopened work must be tested on.
+const CURRENT_VERSION_RE = /\b0\.2\.\d+|0\.2\.0-beta/i;
+// Any version or commit.
+const ANY_VERSION_RE = /\bv?\d+\.\d+(\.\d+)*(-[a-z0-9.]+)?\b|\b[0-9a-f]{7,40}\b|\bcommit\b/i;
+const HARDWARE_RE = /\b(rtx|gtx|geforce|quadro|tesla|radeon|rx ?\d|instinct|arc|a\d{3,4}|b\d{2,3}|apple|m[1-5]( pro| max| ultra)?|nvidia|amd|intel|gpu|cpu|vram|\d+ ?gb|ram|windows|linux|ubuntu|debian|fedora|arch|macos|mac os|wsl)\b/i;
+const REVISION_RE = /0\.2\.\d|beta|\bmain\b|\b[0-9a-f]{7,40}\b/i;
+
+function stripComments(text) {
+  return String(text || '').replace(/<!--[\s\S]*?-->/g, '');
+}
+
+function hasAreaPrefix(title) {
+  return TITLE_RE.test(String(title || ''));
+}
+
+// Issue forms render as "### Label\n\nvalue". Returns { label: value } for those headings.
+function parseSections(body) {
+  const out = {};
+  let cur = null;
+  for (const line of stripComments(body).split(/\r?\n/)) {
+    const m = /^#{1,6}\s+(.+?)\s*#*\s*$/.exec(line);
+    if (m) {
+      cur = m[1].trim();
+      out[cur] = '';
+    } else if (cur !== null) {
+      out[cur] += line + '\n';
+    }
+  }
+  for (const k of Object.keys(out)) out[k] = out[k].trim();
+  return out;
+}
+
+function realText(value) {
+  const t = String(value || '').replace(NOT_RUN_LABELS, '').replace(/\s+/g, ' ').trim();
+  return NO_ANSWER.test(t) ? '' : t;
+}
+
+function findSection(sections, re) {
+  for (const k of Object.keys(sections)) if (re.test(k)) return { key: k, value: sections[k] };
+  return null;
+}
+
+// Required parts of each issue form: [display name, heading regex, minimum characters of real text].
+const FORMS = {
+  bug: {
+    detect: /what happened/i,
+    parts: [
+      ['Area', /^area$/i, 2],
+      ['Desktop app, Terminal or source?', /desktop app, terminal or source/i, 2],
+      ['What happened', /what happened/i, 20],
+      ['Reproduction status', /reproduction status/i, 2],
+      ['Strata version', /strata version/i, 3],
+      ['Graphics card, memory and system', /graphics card|memory and system/i, 3],
+    ],
+    needsCurrentVersion: 'Strata version',
+  },
+  feature: {
+    detect: /what do you want to do/i,
+    parts: [
+      ['Area', /^area$/i, 2],
+      ['What do you want to do?', /what do you want to do/i, 20],
+    ],
+  },
+  question: {
+    detect: /your question/i,
+    parts: [
+      ['Area', /^area$/i, 2],
+      ['Your question', /your question/i, 15],
+    ],
+  },
+  benchmark: {
+    detect: /what did you measure/i,
+    parts: [
+      ['What did you measure, or what went wrong', /what did you measure/i, 30],
+      ['Reproduction status', /reproduction status/i, 2],
+    ],
+    needsCurrentVersionInBody: true,
+  },
+};
+
+function checkIssue({ title, body, labels = [], mode = 'intake' }) {
+  const missing = [];
+  if (!hasAreaPrefix(title)) {
+    missing.push('Start the title with its area: [Engine], [GUI], [TUI], [Benchmark], [Docs] or [Other], then a short description. Example: "[Engine] decode stops after 2 minutes".');
+  }
+  const text = stripComments(body);
+  const sections = parseSections(text);
+  const labelSet = new Set(labels.map((l) => String(l).toLowerCase()));
+  const needCurrent = mode === 'reopen';
+
+  let formKey = null;
+  for (const [key, f] of Object.entries(FORMS)) {
+    if (findSection(sections, f.detect)) { formKey = key; break; }
+  }
+
+  if (formKey) {
+    const form = FORMS[formKey];
+    for (const [name, re, min] of form.parts) {
+      const s = findSection(sections, re);
+      if (!s || realText(s.value).length < min) missing.push('Fill in "' + name + '".');
+    }
+    if (needCurrent && form.needsCurrentVersion) {
+      const s = findSection(sections, /strata version/i);
+      if (s && realText(s.value) && !CURRENT_VERSION_RE.test(s.value)) {
+        missing.push('Re-test on Strata 0.2.0-beta and put that version in "' + form.needsCurrentVersion + '". If it no longer happens, say so in a comment instead.');
+      }
+    }
+    if (needCurrent && form.needsCurrentVersionInBody && !CURRENT_VERSION_RE.test(text)) {
+      missing.push('Say which Strata version you measured on. Re-measure on 0.2.0-beta if you can.');
+    }
+    return { ok: missing.length === 0, missing, kind: formKey };
+  }
+
+  // Free-form text (older issues, blank issues).
+  const plain = realText(text);
+  const lenient = labelSet.has('enhancement') || labelSet.has('question');
+  if (plain.length < (lenient ? 40 : 80)) {
+    missing.push('Describe it in the issue body: what happened, what you expected, and the exact error if there is one. The issue forms (New issue > Bug report) list what to include.');
+  }
+  if (!lenient) {
+    if (!ANY_VERSION_RE.test(text)) missing.push('Add the Strata version (Settings > About, or `strata --version`).');
+    else if (needCurrent && !CURRENT_VERSION_RE.test(text)) missing.push('Re-test on Strata 0.2.0-beta and name that version in the issue. If it no longer happens, say so in a comment instead.');
+    if (!HARDWARE_RE.test(text)) missing.push('Add your graphics card with its VRAM, your RAM and your operating system.');
+  }
+  return { ok: missing.length === 0, missing, kind: 'free-form' };
+}
+
+function checkPull({ title, body, mode = 'intake' }) {
+  const missing = [];
+  if (!hasAreaPrefix(title)) {
+    missing.push('Start the title with its area: [Engine], [GUI], [TUI], [Benchmark], [Docs] or [Other], then a short description. Example: "[Engine] fix decode stop on long prompts".');
+  }
+  const text = stripComments(body);
+  const sections = parseSections(text);
+  const problem = findSection(sections, /problem|result|summary|what.*change/i);
+  const validation = findSection(sections, /validation|testing|tests?\b|how.*tested/i);
+
+  let valText = '';
+  if (problem || validation) {
+    if (!problem || realText(problem.value).length < 20) missing.push('Fill in "Problem and result": what triggered the change, and how it behaves before and after.');
+    if (!validation || realText(validation.value).length < 20) {
+      missing.push('Fill in "Validation": the exact commands, the revision and environment tested, what you saw. Keep Passed, Failed and Not run apart.');
+    } else {
+      valText = validation.value;
+    }
+  } else {
+    const plain = realText(text);
+    if (plain.length < 150) {
+      missing.push('Describe the pull request: the problem and the result. The pull request template shows the parts (Problem and result, Related discussion, Approach, Validation, Limits).');
+    }
+    if (!/(problem|result|before|after|fix|because|bug)/i.test(plain)) missing.push('Add "Problem and result": what triggered the change, and how it behaves before and after.');
+    if (!/(validat|tested|passed|ran |built|build|not run)/i.test(plain)) missing.push('Add "Validation": the exact commands, the revision and environment tested, and what you saw.');
+    valText = plain;
+  }
+  if (mode === 'reopen' && valText && !REVISION_RE.test(valText)) {
+    missing.push('Say in Validation which revision you tested: rebase on main (or 0.2.0-beta) and re-run your checks.');
+  }
+  return { ok: missing.length === 0, missing, kind: 'pull' };
+}
+
+function checkItem({ isPull, ...rest }) {
+  return isPull ? checkPull(rest) : checkIssue(rest);
+}
+
+function checklist(missing) {
+  return missing.map((m) => '- [ ] ' + m).join('\n');
+}
+
+const CONTRIB = 'https://github.com/Niko1221/Strata/blob/main/CONTRIBUTING.md';
+
+function intakeComment(isPull, missing) {
+  return [
+    'Thanks for the ' + (isPull ? 'pull request' : 'issue') + '. To keep the tracker readable, every item needs an area prefix in the title and the parts of the ' + (isPull ? 'pull request template' : 'issue form') + ' filled in. This one is missing:',
+    '',
+    checklist(missing),
+    '',
+    'Edit the ' + (isPull ? 'pull request' : 'issue') + ' (title and description) and this note goes away on its own. If it is still missing parts in 5 days it will be closed, which is not a rejection: fix it and comment `/reopen`.',
+    '',
+    'Details: [CONTRIBUTING.md](' + CONTRIB + ')',
+  ].join('\n');
+}
+
+function reopenMissingComment(isPull, missing) {
+  return [
+    'Not reopened yet. Still missing:',
+    '',
+    checklist(missing),
+    '',
+    'Edit the ' + (isPull ? 'pull request' : 'issue') + ' and comment `/reopen` again. Details: [CONTRIBUTING.md](' + CONTRIB + ')',
+  ].join('\n');
+}
+
+function reopenOkComment(isPull) {
+  return 'Reopened, thank you. A maintainer will pick it up from here.' + (isPull ? ' If it conflicts with main, rebase it first; that speeds up review.' : '');
+}
+
+function staleComment(isPull) {
+  return [
+    'Closing this ' + (isPull ? 'pull request' : 'issue') + ' because it still did not follow the format after 5 days. That is housekeeping, not a rejection.',
+    '',
+    'To bring it back: fix the title (area prefix) and the missing parts, then comment `/reopen`. A check runs and reopens it, or tells you what is still missing. See [CONTRIBUTING.md](' + CONTRIB + ').',
+  ].join('\n');
+}
+
+module.exports = {
+  AREAS, TITLE_RE, hasAreaPrefix, parseSections, stripComments, realText,
+  checkIssue, checkPull, checkItem, checklist,
+  intakeComment, reopenMissingComment, reopenOkComment, staleComment,
+};

.github/scripts/item-check.test.js

@@ -0,0 +1,192 @@
+'use strict';
+const test = require('node:test');
+const assert = require('node:assert');
+const c = require('./item-check');
+const bot = require('./reset-bot');
+
+const bugForm = (over = {}) => {
+  const f = {
+    'Area': '[Engine]  (speed, kernels, models, the server and API)',
+    'Desktop app, Terminal or source?': 'Terminal (the `strata` command)',
+    'What happened': 'Decode stops after two minutes with "CUDA error 700". I expected it to continue.',
+    'Smallest steps or command that reproduce it': '_No response_',
+    'Reproduction status': 'Reproduced locally',
+    'Strata version': 'Strata 0.2.0-beta · engine 0.1.45.3',
+    'Graphics card, memory and system': 'RTX 5070 12 GB · 64 GB RAM · Windows 11',
+    ...over,
+  };
+  return Object.entries(f).map(([k, v]) => `### ${k}\n\n${v}`).join('\n\n');
+};
+
+test('title prefix', () => {
+  assert.ok(c.hasAreaPrefix('[Engine] fix decode'));
+  assert.ok(c.hasAreaPrefix('[Docs] x'));
+  assert.ok(!c.hasAreaPrefix('Engine fix'));
+  assert.ok(!c.hasAreaPrefix('[engine] fix'));
+  assert.ok(!c.hasAreaPrefix('[Engine]'));
+  assert.ok(!c.hasAreaPrefix('[Engine] '));
+  assert.ok(!c.hasAreaPrefix('[Area] foo'));
+  assert.ok(!c.hasAreaPrefix(''));
+  assert.ok(!c.hasAreaPrefix(undefined));
+});
+
+test('filled bug form passes in both modes', () => {
+  for (const mode of ['intake', 'reopen']) {
+    const r = c.checkIssue({ title: '[Engine] decode stops', body: bugForm(), labels: ['bug'], mode });
+    assert.deepStrictEqual(r.missing, []);
+    assert.strictEqual(r.kind, 'bug');
+  }
+});
+
+test('bug form: missing parts are named', () => {
+  const r = c.checkIssue({ title: 'decode stops', body: bugForm({ 'Strata version': '_No response_', 'What happened': 'bad' }) });
+  assert.ok(!r.ok);
+  assert.ok(r.missing.some((m) => /title/i.test(m)));
+  assert.ok(r.missing.some((m) => m.includes('What happened')));
+  assert.ok(r.missing.some((m) => m.includes('Strata version')));
+});
+
+test('reopen needs a 0.2 version, intake does not', () => {
+  const body = bugForm({ 'Strata version': 'Strata 0.1.44' });
+  assert.ok(c.checkIssue({ title: '[Engine] x y', body, mode: 'intake' }).ok);
+  const r = c.checkIssue({ title: '[Engine] x y', body, mode: 'reopen' });
+  assert.ok(!r.ok);
+  assert.ok(r.missing.some((m) => m.includes('0.2.0-beta')));
+});
+
+test('html comments and placeholders do not count', () => {
+  const r = c.checkIssue({ title: '[Engine] x y', body: bugForm({ 'What happened': '<!-- describe -->' }) });
+  assert.ok(r.missing.some((m) => m.includes('What happened')));
+});
+
+test('feature and question forms', () => {
+  const f = '### Area\n\n[GUI]  (the desktop app)\n\n### What do you want to do?\n\nLet me pin a model to the top of the list in the app.';
+  assert.ok(c.checkIssue({ title: '[GUI] pin models', body: f, mode: 'reopen' }).ok);
+  assert.ok(!c.checkIssue({ title: '[GUI] pin models', body: '### Area\n\n[GUI]\n\n### What do you want to do?\n\n_No response_' }).ok);
+  const q = '### Area\n\n[Other]\n\n### Your question\n\nHow do I move the model folder to another drive?';
+  assert.ok(c.checkIssue({ title: '[Other] model folder', body: q }).ok);
+});
+
+test('free-form issue', () => {
+  const good = 'Strata 0.2.0-beta on an RTX 3060 12 GB with 32 GB RAM on Linux: the server hangs when I send two requests at once. Expected both to finish.';
+  assert.ok(c.checkIssue({ title: '[Engine] hang on two requests', body: good, mode: 'reopen' }).ok);
+  assert.ok(!c.checkIssue({ title: '[Engine] hang', body: 'it crashes', mode: 'intake' }).ok);
+  const old = good.replace('0.2.0-beta', '0.1.40');
+  assert.ok(c.checkIssue({ title: '[Engine] hang', body: old, mode: 'intake' }).ok);
+  assert.ok(!c.checkIssue({ title: '[Engine] hang', body: old, mode: 'reopen' }).ok);
+  assert.ok(c.checkIssue({ title: '[Other] idea', body: 'It would help if the app remembered my last model between runs, today I pick it again.', labels: ['enhancement'], mode: 'reopen' }).ok);
+});
+
+const prBody = (over = {}) => {
+  const p = {
+    problem: 'Decode stopped on prompts above 8k because the stop check read the wrong length. Now it continues.',
+    validation: '**Passed:** `ctest -R decode`, commit abcdef1, RTX 3060, 12 of 12.\n\n**Failed:** none observed\n\n**Not run:** HIP build',
+    ...over,
+  };
+  return `## Problem and result\n<!-- hint -->\n${p.problem}\n\n## Related discussion\nnone\n\n## Approach\nFix the length.\n\n## Validation\n${p.validation}\n\n## Limits\nnone`;
+};
+
+test('filled PR passes', () => {
+  assert.deepStrictEqual(c.checkPull({ title: '[Engine] fix stop', body: prBody(), mode: 'reopen' }).missing, []);
+});
+
+test('untouched PR template fails', () => {
+  const tpl = '## Problem and result\n<!-- What triggered -->\n\n## Validation\n<!-- cmds -->\n\n**Passed:**\n<!-- x -->\n\n**Failed:**\n\n**Not run:**\n';
+  const r = c.checkPull({ title: '[Engine] fix stop', body: tpl });
+  assert.ok(!r.ok);
+  assert.ok(r.missing.some((m) => m.includes('Problem and result')));
+  assert.ok(r.missing.some((m) => m.includes('Validation')));
+});
+
+test('PR: empty body and bad title', () => {
+  const r = c.checkPull({ title: 'fix', body: null });
+  assert.ok(!r.ok);
+  assert.ok(r.missing.length >= 2);
+});
+
+test('PR reopen needs a revision', () => {
+  const body = prBody({ validation: '**Passed:** I tried it and it worked for me on my machine, looked fine.' });
+  assert.ok(c.checkPull({ title: '[Engine] x y', body, mode: 'intake' }).ok);
+  assert.ok(!c.checkPull({ title: '[Engine] x y', body, mode: 'reopen' }).ok);
+});
+
+test('free-form PR', () => {
+  const body = 'This fixes a crash when the context is above 8k, because the length was read from the wrong field. Before it aborted, after it continues. I built it on CUDA and ran the decode test, passed.';
+  assert.ok(c.checkPull({ title: '[Engine] fix crash', body }).ok);
+  assert.ok(!c.checkPull({ title: '[Engine] fix crash', body: 'fixes stuff' }).ok);
+});
+
+test('messages', () => {
+  const m = c.intakeComment(false, ['a', 'b']);
+  assert.ok(m.includes('- [ ] a') && m.includes('/reopen') && m.includes('CONTRIBUTING.md'));
+  assert.ok(c.staleComment(true).includes('/reopen'));
+});
+
+// handlers with a fake GitHub client
+function fake(calls, extra = {}) {
+  const rest = {
+    issues: {
+      getLabel: async () => ({}),
+      createLabel: async (a) => calls.push(['createLabel', a.name]),
+      addLabels: async (a) => calls.push(['addLabels', a.labels]),
+      removeLabel: async (a) => calls.push(['removeLabel', a.name]),
+      createComment: async (a) => calls.push(['comment', a.body]),
+      update: async (a) => calls.push(['update', a.state]),
+      get: async () => ({ data: extra.live }),
+      listEvents: async () => {},
+      listForRepo: async () => {},
+    },
+    pulls: { get: async () => ({ data: { mergeable_state: 'clean' } }) },
+  };
+  return { rest, paginate: async (fn) => (fn === rest.issues.listEvents ? (extra.events || []) : (extra.items || [])) };
+}
+const core = { info() {} };
+const repo = { owner: 'o', repo: 'r' };
+
+test('intake labels and comments once', async () => {
+  const calls = [];
+  const item = { number: 1, title: 'bad', body: '', labels: [], user: { type: 'User' }, author_association: 'NONE' };
+  await bot.intake({ github: fake(calls), context: { repo, payload: { action: 'opened', issue: item } }, core });
+  assert.deepStrictEqual(calls.map((c) => c[0]), ['addLabels', 'comment']);
+  calls.length = 0;
+  item.labels = [{ name: 'needs-format' }];
+  await bot.intake({ github: fake(calls), context: { repo, payload: { action: 'edited', issue: item } }, core });
+  assert.deepStrictEqual(calls, []);
+});
+
+test('intake clears the label when edited into shape', async () => {
+  const calls = [];
+  const item = { number: 1, title: '[Engine] x y', body: bugForm(), labels: [{ name: 'needs-format' }], user: { type: 'User' } };
+  await bot.intake({ github: fake(calls), context: { repo, payload: { action: 'edited', issue: item } }, core });
+  assert.deepStrictEqual(calls.map((c) => c[0]), ['removeLabel', 'comment']);
+});
+
+test('reopen: ignores strangers, reopens the author when it passes', async () => {
+  const issue = { number: 5, state: 'closed', user: { login: 'amy' }, labels: [] };
+  let calls = [];
+  const comment = { body: '/reopen', user: { login: 'bob', type: 'User' }, author_association: 'NONE' };
+  await bot.reopen({ github: fake(calls), context: { repo, payload: { issue, comment } }, core });
+  assert.deepStrictEqual(calls, []);
+
+  const live = { number: 5, title: '[Engine] x y', body: bugForm(), labels: [] };
+  comment.user.login = 'amy';
+  await bot.reopen({ github: fake(calls, { live }), context: { repo, payload: { issue, comment } }, core });
+  assert.deepStrictEqual(calls.map((c) => c[0]), ['update', 'removeLabel', 'comment']);
+  assert.strictEqual(calls[0][1], 'open');
+
+  calls = [];
+  live.title = 'no prefix';
+  await bot.reopen({ github: fake(calls, { live }), context: { repo, payload: { issue, comment } }, core });
+  assert.deepStrictEqual(calls.map((c) => c[0]), ['comment']);
+  assert.ok(calls[0][1].includes('Not reopened'));
+});
+
+test('sweep closes only old flagged items', async () => {
+  const calls = [];
+  const old = new Date(Date.now() - 6 * 86400000).toISOString();
+  const fresh = new Date(Date.now() - 1 * 86400000).toISOString();
+  const mk = (n, created) => ({ number: n, title: 'bad', body: '', labels: [{ name: 'needs-format' }], created_at: created });
+  const gh = fake(calls, { items: [mk(1, old), mk(2, fresh)] });
+  await bot.sweep({ github: gh, context: { repo }, core });
+  assert.deepStrictEqual(calls.map((c) => c[0]), ['comment', 'update']);
+});

.github/scripts/reset-bot.js

@@ -0,0 +1,164 @@
+'use strict';
+// GitHub-side handlers for intake.yml, reopen.yml and the 5-day sweep.
+// They take the actions/github-script objects ({ github, context, core }) and never touch PR code:
+// everything comes from the event payload and the REST API.
+
+const check = require('./item-check');
+
+const LABEL = 'needs-format';
+const STALE_DAYS = 5;
+const MAINTAINER = new Set(['OWNER', 'MEMBER', 'COLLABORATOR']);
+// Items a maintainer closed on purpose stay closed.
+const BLOCK_LABELS = new Set(['wontfix', 'invalid', 'duplicate', 'declined']);
+
+function labelNames(item) {
+  return (item.labels || []).map((l) => (typeof l === 'string' ? l : l.name));
+}
+
+async function ensureLabel(github, context) {
+  const { owner, repo } = context.repo;
+  try {
+    await github.rest.issues.getLabel({ owner, repo, name: LABEL });
+  } catch (e) {
+    if (e.status !== 404) throw e;
+    await github.rest.issues.createLabel({
+      owner, repo, name: LABEL, color: 'fbca04',
+      description: 'Title or description does not follow CONTRIBUTING.md yet',
+    });
+  }
+}
+
+async function removeLabel(github, context, number) {
+  const { owner, repo } = context.repo;
+  try {
+    await github.rest.issues.removeLabel({ owner, repo, issue_number: number, name: LABEL });
+  } catch (e) {
+    if (e.status !== 404) throw e;
+  }
+}
+
+function itemFromPayload(context) {
+  const p = context.payload;
+  return p.pull_request || p.issue;
+}
+
+function isPullItem(item, context) {
+  return Boolean(context.payload.pull_request || item.pull_request);
+}
+
+// issues: opened/edited/reopened, pull_request_target: opened/edited/reopened
+async function intake({ github, context, core }) {
+  const { owner, repo } = context.repo;
+  const item = itemFromPayload(context);
+  if (!item || (item.user && item.user.type === 'Bot')) return;
+  if (MAINTAINER.has(item.author_association) && context.payload.action === 'opened') {
+    // Maintainer items are not nagged on creation.
+    return;
+  }
+  const isPull = isPullItem(item, context);
+  const labels = labelNames(item);
+  const hasLabel = labels.includes(LABEL);
+  const res = check.checkItem({ isPull, title: item.title, body: item.body, labels, mode: 'intake' });
+  core.info('check ' + (isPull ? 'PR' : 'issue') + ' #' + item.number + ': ' + (res.ok ? 'ok' : res.missing.join(' | ')));
+
+  if (res.ok) {
+    if (hasLabel) {
+      await removeLabel(github, context, item.number);
+      await github.rest.issues.createComment({ owner, repo, issue_number: item.number, body: 'Thanks, this follows the format now.' });
+    }
+    return;
+  }
+  if (context.payload.action === 'edited' && !hasLabel) return; // edits only matter for items already flagged
+  if (hasLabel) return;                                        // one note only
+  await ensureLabel(github, context);
+  await github.rest.issues.addLabels({ owner, repo, issue_number: item.number, labels: [LABEL] });
+  await github.rest.issues.createComment({ owner, repo, issue_number: item.number, body: check.intakeComment(isPull, res.missing) });
+}
+
+// issue_comment created, body starts with /reopen
+async function reopen({ github, context, core }) {
+  const { owner, repo } = context.repo;
+  const comment = context.payload.comment;
+  const issue = context.payload.issue;
+  if (!/^\s*\/reopen\b/.test(comment.body || '')) return;
+  if (comment.user.type === 'Bot') return;
+  const isAuthor = comment.user.login === issue.user.login;
+  const isMaint = MAINTAINER.has(comment.author_association);
+  if (!isAuthor && !isMaint) {
+    core.info('ignored /reopen from ' + comment.user.login + ' (not the author or a maintainer)');
+    return;
+  }
+  const isPull = Boolean(issue.pull_request);
+  const say = (body) => github.rest.issues.createComment({ owner, repo, issue_number: issue.number, body });
+  const labels = labelNames(issue);
+  const wasOpen = issue.state === 'open';
+
+  if (labels.some((l) => BLOCK_LABELS.has(l.toLowerCase())) && !isMaint) {
+    await say('This one was closed on purpose (' + labels.filter((l) => BLOCK_LABELS.has(l.toLowerCase())).join(', ') + '). Please add your new evidence in a comment and a maintainer will decide.');
+    return;
+  }
+  if (wasOpen && !labels.includes(LABEL)) {
+    core.info('already open, nothing to do');
+    return;
+  }
+
+  // The bot reads the live item, not the possibly stale event copy.
+  const live = (await github.rest.issues.get({ owner, repo, issue_number: issue.number })).data;
+  const res = check.checkItem({ isPull, title: live.title, body: live.body, labels: labelNames(live), mode: 'reopen' });
+  core.info('reopen check #' + live.number + ': ' + (res.ok ? 'ok' : res.missing.join(' | ')));
+
+  if (!res.ok) {
+    await say(check.reopenMissingComment(isPull, res.missing));
+    return;
+  }
+  if (!wasOpen) {
+    try {
+      await github.rest.issues.update({ owner, repo, issue_number: live.number, state: 'open' });
+    } catch (e) {
+      await say('The check passed, but GitHub would not reopen it (' + (e.message || e.status) + '). ' + (isPull ? 'If the branch was deleted, restore it or open a new pull request and link this one.' : 'Please open a new issue and link this one.'));
+      return;
+    }
+  }
+  await removeLabel(github, context, live.number);
+  let extra = '';
+  if (isPull) {
+    try {
+      const pr = (await github.rest.pulls.get({ owner, repo, pull_number: live.number })).data;
+      if (pr.mergeable_state === 'dirty') extra = '\n\nIt has conflicts with main now: please rebase it.';
+    } catch (e) { /* best effort */ }
+  }
+  await say(check.reopenOkComment(isPull) + extra);
+}
+
+async function labelTime(github, owner, repo, number, fallback) {
+  const events = await github.paginate(github.rest.issues.listEvents, { owner, repo, issue_number: number, per_page: 100 });
+  let t = null;
+  for (const e of events) {
+    if (e.event === 'labeled' && e.label && e.label.name === LABEL) t = e.created_at;
+  }
+  return t || fallback;
+}
+
+// scheduled: close items that kept the needs-format label for more than 5 days
+async function sweep({ github, context, core }) {
+  const { owner, repo } = context.repo;
+  const cutoff = Date.now() - STALE_DAYS * 86400 * 1000;
+  const items = await github.paginate(github.rest.issues.listForRepo, { owner, repo, state: 'open', labels: LABEL, per_page: 100 });
+  core.info(items.length + ' open items with ' + LABEL);
+  for (const item of items) {
+    const since = new Date(await labelTime(github, owner, repo, item.number, item.created_at)).getTime();
+    if (since > cutoff) continue;
+    const isPull = Boolean(item.pull_request);
+    // Re-check first: an edit that fixed it should have cleared the label already; do not close good items.
+    const res = check.checkItem({ isPull, title: item.title, body: item.body, labels: labelNames(item), mode: 'intake' });
+    if (res.ok) {
+      await removeLabel(github, context, item.number);
+      continue;
+    }
+    await github.rest.issues.createComment({ owner, repo, issue_number: item.number, body: check.staleComment(isPull) });
+    await github.rest.issues.update({ owner, repo, issue_number: item.number, state: 'closed', state_reason: 'not_planned' });
+    core.info('closed #' + item.number);
+  }
+}
+
+module.exports = { intake, reopen, sweep, LABEL, STALE_DAYS };

.github/workflows/docker-images.yml

@@ -0,0 +1,114 @@
+name: Docker images
+
+# Builds the Strata container images of one release from its engine packages and pushes them to ghcr.io.
+# Run by hand only (Actions tab -> Docker images -> Run workflow). Nothing starts it on its own.
+#
+# For each flavor the job downloads the engine package from the release and checks it against the signed update feed
+# (docker/fetch-engines.py: the feed's Ed25519 signature, the archive's SHA-256, the manifest hash, the package signature,
+# every file's hash), builds the image with docker/build.sh and, only when "push" is on, pushes
+#   ghcr.io/niko1221/strata:<version>-<flavor>   and   ghcr.io/niko1221/strata:latest-<flavor>
+# The first run with "push" off builds everything without publishing it (a dry run).
+
+on:
+  workflow_dispatch:
+    inputs:
+      release_tag:
+        description: 'Release tag whose engine packages go into the images (for example v0.2.7)'
+        required: true
+        type: string
+      flavors:
+        description: 'Flavors to build, comma separated (empty: every flavor the release has a package for)'
+        required: false
+        default: ''
+        type: string
+      push:
+        description: 'Push the images to ghcr.io (off: build only, nothing is published)'
+        required: true
+        default: false
+        type: boolean
+      latest:
+        description: 'Also move the latest-<flavor> tags (turn off for a pre-release or a test)'
+        required: true
+        default: true
+        type: boolean
+      source_ref:
+        description: 'Git ref of the Dockerfile and the Terminal sources (empty: the release tag)'
+        required: false
+        default: ''
+        type: string
+
+permissions:
+  contents: read
+
+env:
+  IMAGE: ghcr.io/niko1221/strata
+
+jobs:
+  plan:
+    runs-on: ubuntu-24.04
+    outputs:
+      flavors: ${{ steps.list.outputs.flavors }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.source_ref || inputs.release_tag }}
+      - name: Which flavors does the release have a package for
+        id: list
+        env:
+          WANT: ${{ inputs.flavors }}
+          TAG: ${{ inputs.release_tag }}
+        run: |
+          set -eu
+          args="--release-tag $TAG --list --skip-missing"
+          [ -n "$WANT" ] && args="$args --flavors $WANT"
+          python3 docker/fetch-engines.py $args > list.tsv
+          cat list.tsv
+          flavors=$(awk -F'\t' '$3 != "SKIP" {printf "%s\"%s\"", (n++ ? "," : ""), $1}' list.tsv)
+          [ -n "$flavors" ] || { echo "the release has no engine package for any requested flavor"; exit 1; }
+          echo "flavors=[$flavors]" >> "$GITHUB_OUTPUT"
+
+  image:
+    needs: plan
+    runs-on: ubuntu-24.04
+    timeout-minutes: 120
+    permissions:
+      contents: read
+      packages: write
+    strategy:
+      fail-fast: false
+      max-parallel: 3
+      matrix:
+        flavor: ${{ fromJSON(needs.plan.outputs.flavors) }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.source_ref || inputs.release_tag }}
+      - name: Free disk space (the runner has about 14 GB; a package plus its image needs about 10 GB)
+        run: |
+          sudo rm -rf /usr/share/dotnet /usr/local/lib/android /opt/ghc /opt/hostedtoolcache/CodeQL || true
+          docker system prune -af >/dev/null 2>&1 || true
+          df -h /
+      - name: Log in to ghcr.io
+        if: ${{ inputs.push }}
+        env:
+          REGISTRY_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          REGISTRY_USER: ${{ github.actor }}
+        run: printf '%s' "$REGISTRY_TOKEN" | docker login ghcr.io -u "$REGISTRY_USER" --password-stdin
+      - name: Fetch, verify, build (and push when push is on)
+        env:
+          TAG: ${{ inputs.release_tag }}
+          FLAVOR: ${{ matrix.flavor }}
+          PUSH: ${{ inputs.push && '--push' || '' }}
+          LATEST: ${{ !inputs.latest && '--no-latest' || '' }}
+        run: |
+          docker/publish.sh --release-tag "$TAG" --flavors "$FLAVOR" --image "$IMAGE" $PUSH $LATEST
+      - name: Summary
+        if: ${{ always() }}
+        run: |
+          {
+            echo "### ${{ matrix.flavor }}"
+            echo "- release: ${{ inputs.release_tag }}, pushed: ${{ inputs.push }}"
+            echo "- image: \`$IMAGE:${INPUT_TAG#v}-${{ matrix.flavor }}\`"
+          } >> "$GITHUB_STEP_SUMMARY"
+        env:
+          INPUT_TAG: ${{ inputs.release_tag }}

.github/workflows/intake.yml

@@ -0,0 +1,58 @@
+name: Intake
+
+# New issues and pull requests that do not follow CONTRIBUTING.md get the needs-format label and one friendly note.
+# Items that keep the label for 5 days are closed by the daily sweep, with a note on how to /reopen.
+#
+# pull_request_target is used instead of pull_request on purpose: a pull request from a fork gets a read-only
+# GITHUB_TOKEN under pull_request, so it could not be labelled or commented on. It is safe here because this
+# workflow never checks out or runs the pull request's code. It checks out the default branch only (the bot
+# scripts) and reads the title and description from the event payload and the REST API.
+
+on:
+  issues:
+    types: [opened, edited]
+  pull_request_target:
+    types: [opened, edited]
+  schedule:
+    - cron: '17 4 * * *'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  issues: write
+  pull-requests: write
+
+concurrency:
+  group: intake-${{ github.event.issue.number || github.event.pull_request.number || 'sweep' }}
+  cancel-in-progress: false
+
+jobs:
+  check:
+    if: github.event_name == 'issues' || github.event_name == 'pull_request_target'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.repository.default_branch }}
+          sparse-checkout: .github/scripts
+          persist-credentials: false
+      - uses: actions/github-script@v7
+        with:
+          script: |
+            const bot = require('./.github/scripts/reset-bot.js');
+            await bot.intake({ github, context, core });
+
+  sweep:
+    if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.repository.default_branch }}
+          sparse-checkout: .github/scripts
+          persist-credentials: false
+      - uses: actions/github-script@v7
+        with:
+          script: |
+            const bot = require('./.github/scripts/reset-bot.js');
+            await bot.sweep({ github, context, core });

.github/workflows/metal-build.yml

@@ -0,0 +1,53 @@
+name: Metal build
+
+# Compile and link the Metal engine on a macOS runner (no GPU needed: the kernels are compiled at run time).  The shared host files
+# (src/core/verify.cpp, src/prefill, src/program/generate.cpp) call kernel entry points that exist only for CUDA / HIP until Metal gets a
+# stub or an implementation; a missing one is a link error here, not on a user's Mac (owner round 9, G6).
+
+on:
+  pull_request:
+    paths:
+      - 'src/**'
+      - 'include/**'
+      - 'metal/**'
+      - 'third_party/**'
+      - 'CMakeLists.txt'
+      - '.github/workflows/metal-build.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  metal-link:
+    # the macOS 26 SDK: metal/src/mtl_rt.mm names MTLGPUFamilyMetal4 (and MTLCompileOptions.mathMode, macOS 15) behind @available,
+    # which is a run-time check; the names must still be in the SDK the engine is compiled against
+    runs-on: macos-26
+    timeout-minutes: 45
+    env:
+      # setup.py's LLAMA_CPP_COMMIT and metal/setup_mac.py's metal-cpp pin
+      LLAMA_CPP_COMMIT: 3cf03257f219afbe7334045ff7c6a06ac68c627d
+      METAL_CPP_URL: https://developer.apple.com/metal/cpp/files/metal-cpp_26.zip
+      METAL_CPP_SHA256: 4df3c078b9aadcb516212e9cb03004cbc5ce9a3e9c068fa3144d021db585a3a4
+    steps:
+      - uses: actions/checkout@v4
+      - name: Tools
+        run: brew install ninja
+      - name: metal-cpp
+        run: |
+          curl -fsSL "$METAL_CPP_URL" -o metal-cpp.zip
+          echo "$METAL_CPP_SHA256  metal-cpp.zip" | shasum -a 256 -c -
+          unzip -q metal-cpp.zip -d _mcpp
+      - name: llama.cpp (ggml) at the pinned commit
+        run: |
+          mkdir llama.cpp && cd llama.cpp
+          git init -q
+          git remote add origin https://github.com/ggml-org/llama.cpp.git
+          git fetch -q --depth 1 origin "$LLAMA_CPP_COMMIT"
+          git checkout -q FETCH_HEAD
+      - name: Configure
+        run: |
+          cmake -S metal -B build-metal -G Ninja -DCMAKE_BUILD_TYPE=Release \
+            -DMETAL_CPP_DIR="$PWD/_mcpp/metal-cpp" -DSTRATA_GGML_DIR="$PWD/llama.cpp"
+      - name: Build and link the engine
+        run: cmake --build build-metal --target strata

.github/workflows/reopen.yml

@@ -0,0 +1,38 @@
+name: Reopen
+
+# An author comments /reopen on their closed issue or pull request. The check runs and the item is reopened,
+# or the bot replies with what is still missing. GitHub does not let authors reopen items a maintainer closed,
+# so this workflow does it for them.
+#
+# issue_comment always runs the workflow file from the default branch with a write-capable token, which is what
+# we need for fork authors too. It never checks out or executes the pull request's code: it reads the live
+# title and description through the REST API. Only the author of the item or a maintainer can trigger it.
+
+on:
+  issue_comment:
+    types: [created]
+
+permissions:
+  contents: read
+  issues: write
+  pull-requests: write
+
+concurrency:
+  group: reopen-${{ github.event.issue.number }}
+  cancel-in-progress: false
+
+jobs:
+  reopen:
+    if: startsWith(github.event.comment.body, '/reopen') && github.event.comment.user.type != 'Bot'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.repository.default_branch }}
+          sparse-checkout: .github/scripts
+          persist-credentials: false
+      - uses: actions/github-script@v7
+        with:
+          script: |
+            const bot = require('./.github/scripts/reset-bot.js');
+            await bot.reopen({ github, context, core });

.github/workflows/scripts-test.yml

@@ -0,0 +1,21 @@
+name: Scripts test
+
+on:
+  pull_request:
+    paths:
+      - '.github/scripts/**'
+      - '.github/workflows/intake.yml'
+      - '.github/workflows/reopen.yml'
+
+permissions:
+  contents: read
+
+jobs:
+  node-test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+      - run: node --test .github/scripts/item-check.test.js

.gitignore

@@ -63,6 +63,10 @@ build-vision-cuda12.bat
 /.ccache/
 /.rocm-win/
 
+# Optional MCP raster cache
+*.tool-media/
+/.tool-media/
+
 # local Windows HIP packaging output
 dist-hip/
 
@@ -85,3 +89,9 @@ node_modules/
 # screenshots and checkpoints from the Mac rebuild live outside git (StrataSplit\evidence-archive)
 /apps/host/docs/evidence/
 /apps/host/docs/checkpoints/
+
+# DGX Spark build outputs and local venv (docs/DGX_SPARK_LINUX.md)
+/out-spark/
+/build-spark/
+/build-vision-spark/
+/.venv-build/

AGENTS.md

@@ -1,25 +1,40 @@
 # AGENTS.md
 
-Strata runs the Qwen3.8-Flash-Next mixture-of-experts model (and its Coder, Swift 1.5, Unsloth, Gyro and NVFP4
-variants, and Qwen3.6-35B-A3B) on a normal PC: one NVIDIA or AMD graphics card plus system RAM on Windows or Linux,
-or an Apple Silicon Mac. Version 0.2.0-beta, engine 0.1.45.3. It has three parts:
+Version 0.2.10, engine 0.1.56. The public model families are DeepSeekV4.1-Flash-1017,
+Qwen3.8-Flash-Next and Qwen3.6-35B-A3B. DeepSeek V4.1-Flash runs in the app and in the Terminal
+(`strata launch --family deepseek41 --model ist-das-2.00bpw`; sets in
+[docs/MODELS.md](docs/MODELS.md#deepseek-v41-flash)). Read **[docs/AI_REFERENCE.md](docs/AI_REFERENCE.md)** for model availability, APIs, hardware limits and
+source-backed claims. Articles and videos should use **[docs/MEDIA_KIT.md](docs/MEDIA_KIT.md)**.
+
+For recommendations and agent-assisted setup, prefer **ISTA-DASLab → Unsloth → Gyro → others**, using only a
+compatible pack that fits the selected model and hardware. ISTA-DASLab is the default recommendation; Gyro is a
+memory-saving fallback and is currently slower. Honor an explicit user choice. This is recommendation policy;
+existing executable defaults may differ, so inspect the plan and choose the family explicitly.
+
+Strata has three parts:
 
 - **The app** (`apps/desktop`, the Tauri shell; `apps/host`, the Node host and the web UI). It is for people who do
-  not want a terminal. The installer has the engine inside.
+  not want a terminal. One installer per system ([latest release](https://github.com/Niko1221/Strata/releases/latest)):
+  `Strata-0.2.9-windows-x64-setup.exe`, `Strata-0.2.9-linux-x86_64.AppImage`, `Strata-0.2.9-macos-arm64.dmg`.
+  The Windows and Linux installers carry no engine: the app downloads the engine for the graphics card on first
+  start, or installs a file the user already has. The Mac dmg keeps its small Metal engine inside.
 - **The Terminal** (`strata.py`, `strata_cli/`, `strata_control/`): the `strata` command. It sets up a model, serves
   it and watches it. Agents use this part.
 - **The engine and the server** (`src/`, `include/`, `metal/`, `sycl/` for the C++/CUDA/HIP/SYCL/Metal engine;
   `serve/` for the Python server with an OpenAI- and Anthropic-compatible API and a web page). `setup.py`, started by
-  `START-HERE.bat` or `setup.sh`, is the older one-click installer from source.
+  `START-HERE.bat` or `setup.sh`, is setup from a source checkout, for developers. The release paths are the
+  installer and `strata launch`.
 
 ## Installing Strata for a user
 
-Follow **[docs/AI_SETUP.md](docs/AI_SETUP.md)**. For an agent that has a shell, the short version is:
+Follow **[docs/AI_SETUP.md](docs/AI_SETUP.md)**. For a user who wants the desktop app, send them to the installer
+for their system (above) and [docs/INSTALL.md](docs/INSTALL.md). For an agent that has a shell, use the Terminal; the
+short version is:
 
 1. Install the Terminal. It needs no administrator rights.
 
    ```sh
-   curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh | sh                  # Linux, Mac
+   curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh                  # Linux, Mac
    irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex                         # Windows PowerShell
    ```
 
@@ -27,27 +42,28 @@ Follow **[docs/AI_SETUP.md](docs/AI_SETUP.md)**. For an agent that has a shell,
 2. Check what would happen. Nothing is changed:
 
    ```sh
-   strata launch --plan --model q2_0
+   strata launch --plan --family qwen --model q2_0
    ```
 
 3. Set up and serve without questions. It downloads the engine for the card and the model (tens of GB), starts the
    server, prints the addresses and returns. The server keeps running.
 
    ```sh
-   strata launch --model q2_0 --yes --no-tui
+   strata launch --family qwen --model q2_0 --yes --no-tui
    ```
 
    Useful flags (all of them: `strata launch --help`): `--family`, `--model-path` (files the user already has),
    `--data-dir`, `--context 32k|64k|128k`, `--vision off|on|gpu|cpu`, `--parallel N`, `--gpu 0,1`,
    `--access local|lan|cloudflare|tailscale`, `--port`, `--api-key-env NAME`, `--new-key`, `--save-preset NAME`,
-   `--output json`. `strata launch --status` shows what is serving, `strata launch --stop` stops it, and
+   `--speed faster|full` (DeepSeek), `--output json`. `strata launch --status` shows what is serving, `strata launch --stop` stops it, and
    `strata launch --show-key` prints the API key.
 4. Connect the user's apps: `strata connect` lists them, `strata connect <app> --check` sends one prompt and one tool
    call the way that app does.
 
-Never expose the server beyond `127.0.0.1` without an API key. `--access lan` makes a key for you. The old route (clone
-the repository and run `START-HERE.bat --yes` or `./setup.sh --yes`) still works and is the fallback when the
-Terminal cannot run. Strata's MCP server ([docs/MCP_SERVER.md](docs/MCP_SERVER.md)) offers the same steps as tools.
+Keep the server on `127.0.0.1` unless the user asks for more. Beyond it an API key is recommended: `--access lan` makes one for you, and `--no-api-key` serves without one (a warning, never a refusal; on a public tunnel the warning is stronger). Source setup (`START-HERE.bat`, `setup.sh`) is the fallback for a developer or for a system with no release package; it is
+documented in [docs/SOURCE_INSTALL.md](docs/SOURCE_INSTALL.md). Those wrappers exist in a source checkout, not in the
+released app. Do not tell an app user to find a `.bat` file.
+Source setup does not make an unsupported model or backend compatible. Strata's MCP server ([docs/MCP_SERVER.md](docs/MCP_SERVER.md)) offers the same steps as tools.
 
 ## Working on the code
 

BENCH.bat

@@ -2,6 +2,7 @@
 rem Benchmark this Strata install the way it is used and write a report you can share (docs/COMMUNITY_BENCHMARKS.md).
 rem It starts the model with your settings (or uses the one already running), takes about 10 minutes and changes nothing.
 rem Options: --clients 4 (several requests at once), --long (a 32K prompt), --compare <older results folder>.
+rem This is the quick speed check. The standard benchmark (docs/BENCHMARK_PROTOCOL.md), whose results other people can compare with, is `strata bench run`.
 setlocal
 title Strata - benchmark
 cd /d "%~dp0"
@@ -10,6 +11,8 @@ if not exist ".venv\Scripts\python.exe" (
   pause
   exit /b 1
 )
+echo  Quick speed check. For results other people can compare with (the standard benchmark, a few minutes), run: .venv\Scripts\python.exe strata.py bench run
+echo.
 ".venv\Scripts\python.exe" tools\strata_bench.py %*
 set "RC=%ERRORLEVEL%"
 pause

Dockerfile

@@ -5,6 +5,8 @@
 #
 #   docker build -t strata:src .                                        # RTX 20/30/40/50 (compiles for each, ~25 min)
 #   docker build -t strata:src --build-arg CUDA_ARCHITECTURES=86 .      # one card only (faster); 86 = RTX 30, 89 = RTX 40, 120 = RTX 50
+#   docker build -t strata:src-cuda12 --build-arg CUDA_IMAGE=nvidia/cuda:12.9.1-devel-ubuntu24.04 \
+#              --build-arg CUDA_ARCHITECTURES="60;61;70;75;80;86;89" --build-arg BUILD_VISION=0 .   # GTX 10 / P100 / V100 (driver 575+)
 #   docker run --rm --gpus all -p 127.0.0.1:8080:8080 --ulimit memlock=-1 --shm-size 2g --stop-timeout 120 \
 #              -v strata-data:/data -e MODEL=IQ3_XXS -e API_KEY=change-me-please-123 strata:src
 #
@@ -35,7 +37,9 @@ RUN /venv/bin/python -c "import setup; print(setup.get_llama_cpp())"
 RUN set -e; \
     real=""; for a in $(echo "$CUDA_ARCHITECTURES" | tr ';,' '  '); do real="$real;${a}-real"; done; real=${real#;}; \
     last=$(echo "$CUDA_ARCHITECTURES" | tr ';,' '  ' | awk '{print $NF}'); \
+    sm60=OFF; for a in $(echo "$CUDA_ARCHITECTURES" | tr ';,' '  '); do if [ "$a" -lt 75 ]; then sm60=ON; fi; done; \
     /venv/bin/cmake -G Ninja -S . -B build -DCMAKE_BUILD_TYPE=Release -DSTRATA_ENABLE_CUDA=ON -DSTRATA_BUILD_TESTS=OFF \
+        -DSTRATA_EXPERIMENTAL_SM60=$sm60 \
         -DSTRATA_NATIVE_EXPERTS=ON -DSTRATA_PORTABLE=ON -DSTRATA_Q6K_EXPERTS=ON -DSTRATA_MMQ_KQUANTS=ON \
         "-DCMAKE_CUDA_ARCHITECTURES=${real};${last}-virtual" -DSTRATA_GGML_DIR=/src/third_party/llama.cpp; \
     /venv/bin/cmake --build build --target strata strata_kq -j "$(nproc)"; \
@@ -50,19 +54,24 @@ RUN set -e; \
     [ -f build/libstrata_kq.so ] && cp build/libstrata_kq.so /stage/ || true; \
     [ -f build-vision/bin/strata-vision ] && cp build-vision/bin/strata-vision /stage/ || true; \
     ver="${ENGINE_VERSION:-$(sed -n 's/^[[:space:]]*project([^)]*VERSION[[:space:]]*\([0-9][0-9.]*\).*/\1/p' CMakeLists.txt | head -1)}"; \
-    echo "{\"version\": \"$ver\", \"source\": \"docker build\", \"archs\": \"$CUDA_ARCHITECTURES\", \"cuda\": \"13.0\", \"portable\": true}" > /stage/BUILD.json; \
+    cudafull=$(nvcc --version | sed -n 's/.*release \([0-9][0-9]*\.[0-9][0-9]*\).*/\1/p' | head -1); cudamajor=${cudafull%%.*}; \
+    if [ "$cudamajor" = 13 ]; then mindriver=580.65; else mindriver=575.51; fi; \
+    vision_archs=""; [ -f /stage/strata-vision ] && vision_archs=", \"vision_archs\": \"$CUDA_ARCHITECTURES\""; \
+    echo "{\"version\": \"$ver\", \"source\": \"docker build\", \"archs\": \"$CUDA_ARCHITECTURES\", \"cuda\": \"$cudafull\", \"portable\": true${vision_archs}}" > /stage/BUILD.json; \
     python3 packaging/collect_libs.py --binary build/strata --search /usr/local/cuda/lib64 --out /stage --also 'libcublasLt.so*'; \
     archs=""; for a in $(echo "$CUDA_ARCHITECTURES" | tr ';,' '  '); do archs="$archs --arch sm_$a"; done; \
     last=$(echo "$CUDA_ARCHITECTURES" | tr ';,' '  ' | awk '{print $NF}'); \
     python3 packaging/package_engine.py --src /stage --backend cuda --version "$ver" --out /engine $archs --arch "compute_$last" \
-        --min-driver nvidia=580.65 --variant cuda13 --platform linux-x86_64 --build-id "docker-source-${ver}-cuda13.0" --include SYSTEM-LIBS.txt --include 'libstrata_kq*' \
+        --min-driver nvidia=$mindriver --variant cuda$cudamajor --platform linux-x86_64 --build-id "docker-source-${ver}-cuda${cudafull}" --include SYSTEM-LIBS.txt --include 'libstrata_kq*' \
         --include strata-vision; \
     for d in /engine/*/; do python3 packaging/package_engine.py --verify "$d"; python3 packaging/binary_deps.py "$d"; done
 
 # ---- 2. the Terminal (the release archive, built here)
 FROM ${RUNTIME_BASE} AS terminal
+ARG STRATA_COMMIT=
+ENV STRATA_BUILD_COMMIT=${STRATA_COMMIT}
 ENV DEBIAN_FRONTEND=noninteractive
-RUN apt-get update && apt-get install -y --no-install-recommends python3 ca-certificates && rm -rf /var/lib/apt/lists/*
+RUN apt-get update && apt-get install -y --no-install-recommends python3 ca-certificates git && rm -rf /var/lib/apt/lists/*
 COPY . /src/
 RUN python3 /src/packaging/package_terminal.py --out /out --cache /cache \
  && mkdir -p /opt/strata \

README.de.md

@@ -1,398 +1,188 @@
 <p align="center">
   <picture>
     <source media="(prefers-color-scheme: dark)" srcset="apps/host/public/brand/strata-lockup-dark.svg">
-    <img src="apps/host/public/brand/strata-lockup-light.svg" alt="Strata" width="380">
+    <img src="apps/host/public/brand/strata-lockup-light.svg" alt="Strata" width="340">
   </picture>
 </p>
 
-<p align="center"><a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <b>Deutsch</b> · <a href="README.fr.md">Français</a> · <a href="README.es.md">Español</a> · <a href="README.pt-BR.md">Português</a></p>
-
-<h3 align="center">Ein Spitzenmodell auf deinem eigenen Gaming-PC</h3>
-
-<p align="center">Unterstützt NVIDIA, AMD, Intel · Windows, Linux, Mac · kostenlos und Open Source</p>
+<h3 align="center">Leistungsstarke KI auf deinem eigenen Computer.</h3>
+<p align="center">Chatten, programmieren und mit Bildern arbeiten, lokal.</p>
 
 <p align="center">
-  <a href="https://github.com/Niko1221/Strata/releases"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?include_prereleases&label=release" alt="Latest release"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="MIT license"></a>
-  <a href="https://github.com/Niko1221/Strata/stargazers"><img src="https://img.shields.io/github/stars/Niko1221/Strata?style=flat" alt="GitHub stars"></a>
+  <a href="#modelle">Modelle</a> · <a href="#installation"><b>Installation</b></a> ·
+  <a href="#hardware">Hardware</a> · <a href="#tools">Tools</a> ·
+  <a href="#hilfe">Hilfe</a> · <a href="#strata-unterstützen">Unterstützen</a>
 </p>
 
-<p align="center"><a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4"><img src="docs/media/pagoda-preview.webp" width="720" alt="A voxel pagoda garden that Strata's model wrote, running in the browser"></a><br>
-<sub>Ein Voxel-Pagodengarten aus einem einzigen Prompt, auf einer RTX 5070 mit Strata (IQ3_S, 128K Kontext) ·
-<a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4">ganzes Video (49 s)</a></sub></p>
+<p align="center">
+  <a href="https://github.com/Niko1221/Strata/releases/latest"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?label=download&color=0ab887" alt="Strata herunterladen"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="MIT-Lizenz"></a>
+  <a href="https://buymeacoffee.com/strataengine"><img src="https://img.shields.io/badge/Buy_me_a_coffee-FFDD00?logo=buymeacoffee&logoColor=000" alt="Strata auf Buy Me a Coffee unterstützen"></a>
+</p>
 
-Strata lässt **[Qwen3.8-Flash-Next](https://huggingface.co/Qwen/Qwen3.8-Flash-Next)** laufen, ein Modell mit 125
-Milliarden Parametern, für das man sonst einen Server braucht, auf einem normalen PC. Es chattet, schreibt Code, liest
-Bilder und arbeitet mit deinen Apps und Coding-Agents zusammen. Deine Chats und Dateien bleiben auf deinem PC.
+<p align="center"><sub><a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <b>Deutsch</b> · <a href="README.fr.md">Français</a> · <a href="README.es.md">Español</a> · <a href="README.pt-BR.md">Português</a> · <a href="README.pl.md">Polski</a></sub></p>
 
-**Neu hier?** Sieh dir an, [was du brauchst](#was-du-brauchst), und [installiere dann die App](#option-a-die-strata-app).
+**Kostenlos, Open Source und ganz in deiner Hand.** Nutze Strata auf dem Desktop oder mit deinen liebsten Coding-Tools. Kein Konto nötig.
 
-- **Läuft auf einem Gaming-PC.** 32 GB Arbeitsspeicher (RAM) und Grafikspeicher zusammen reichen für den Anfang.
-- **Passt zu deinen Werkzeugen.** Strata spricht die OpenAI- und die Anthropic-API, deshalb verbinden sich Claude Code, Codex CLI, OpenCode und andere Agents damit.
-- **Liest Bilder.** Das ist standardmäßig eingeschaltet.
-- **Kostenlos.** MIT-Lizenz, kein Konto, keine Cloud.
-- **Privat.** Keine Telemetrie. Was Strata herunterlädt, wann es das Internet nutzt und wie es Downloads prüft, steht in [docs/SAFETY.md](docs/SAFETY.md).
+## Modelle
 
-Version 0.2.0-beta · Engine 0.1.45.3
+Wir empfehlen **zuerst ISTA-DASLab**, danach **Unsloth** und andere Anbieter, soweit ein passendes Modell in deinen Speicher passt.
 
-## Was du brauchst
+<details>
+<summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.8-Flash-Next</b></summary>
 
-**Du brauchst mindestens 32 GB Arbeitsspeicher (RAM) und Grafikspeicher (VRAM) zusammen.** Bei einem Mac oder einem Ryzen AI Max
-ist das der gemeinsame Speicher. Mit mehr Speicher läuft ein größeres oder ein schnelleres Modell.
-
-- Ein PC mit 32 GB und einer Grafikkarte mit 12-16 GB führt den Coder aus.
-- Mit 64 GB RAM laufen alle Größen.
-
-| Dein Computer | Details |
+| Anbieter | Auswahl |
 | --- | --- |
-| **NVIDIA** GeForce RTX 20, 30, 40, 50 Serie (12 GB oder mehr) | Installiere die App oder das Terminal. |
-| **AMD** Radeon RX 6800 und neuer, Radeon AI PRO R9700 (12 GB oder mehr) | [AMD-Karten](docs/AMD_HIP.md) |
-| **Intel** Arc | [Intel Arc](docs/INTEL_ARC.md), [Intel-Engine](docs/INTEL.md) |
-| **Apple-Silicon-Mac** (M1 oder neuer, macOS 15 oder neuer) | [Mac](docs/MAC.md) |
-| **AMD Ryzen AI Max (Strix Halo)** und andere Systeme mit gemeinsamem Speicher | [Strix Halo](docs/STRIX_HALO.md) |
-| Ältere Karten und Prozessoren | [Ältere GPUs](docs/OLDER_GPUS.md), [Ältere CPUs](docs/INSTALL.md#older-cpus-experimental) |
+| **ISTA-DASLab · empfohlen** | Q2\_0, IQ2\_XS, IQ3\_XXS, IQ3\_S. [Coder: IQ1\_M](docs/MODELS.md#coder) zum Programmieren. |
+| **Unsloth** | UD-IQ4\_XS, UD-Q4\_K\_XL, UD-Q5\_K\_XL, UD-Q6\_K\_XL, Q8\_0 |
+| **Gyro · agentionai** | [Gyro-S, Gyro-M](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF). Geringerer Speicherbedarf, aber langsamer. |
+| **Weitere Optionen** | [Swift 1.5](docs/MODELS.md#swift-15), [NVFP4](docs/NVFP4.md), [OrcaRouter](docs/ORCA.md) |
 
-Außerdem nötig:
+[Größen, Speicherbedarf und Kompatibilität vergleichen](docs/MODELS.md).
 
-- etwa 80 GB freier Speicherplatz (mit einer SSD startet es beim ersten Mal viel schneller)
-- Windows 10 / 11, Linux oder macOS
-- ein aktueller Grafiktreiber
+</details>
 
-Zwei oder drei Karten desselben Herstellers können sich ein Modell teilen ([Multi-GPU](docs/MULTI_GPU.md)). Strata teilt ein
-Modell nie auf NVIDIA- und AMD-Karten auf. Die vollständige Liste: [docs/INSTALL.md](docs/INSTALL.md#what-you-need).
+<details>
+<summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.6-35B-A3B</b></summary>
+
+**Unsloth:** UD-Q4_K_XL, UD-Q6_K_XL, Q8_0. Das sind die derzeit dokumentierten Pakete für dieses Modell.
+
+[Modellanleitung und Kompatibilität](docs/QWEN36.md).
+
+</details>
+
+<details>
+<summary><img src="docs/media/models/deepseek.svg" width="22" alt="" align="middle"> &nbsp;<b>DeepSeekV4.1-Flash-1017</b></summary>
+
+In der **Desktop-App** und im **Terminal**. Was nicht in den Arbeitsspeicher passt, wird von deiner SSD gelesen. Darum brauchst du viel freien Speicherplatz.
+
+| Set (ISTA-DAS) | Download | Freier Speicherplatz nötig |
+| --- | ---: | ---: |
+| 1.75 bpw | 239 GB | etwa 245 GB |
+| 2.00 bpw | 257 GB | etwa 265 GB |
+| 2.25 bpw | 274 GB | etwa 280 GB |
+
+Läuft auf NVIDIA RTX 30, 40 und 50 (Windows und Linux) und auf AMD Radeon AI PRO R9700 (Linux). Das Setup lädt die Dateien und die DeepSeek-Engine herunter und startet dann das Modell.
+
+```sh
+strata launch --family deepseek41 --model ist-das-2.00bpw --plan
+```
+
+Gemessen mit dem 2.00-bpw-Set auf Strata 0.2.5. „Ausgabe“ ist das Tempo der Antwort, „Prompt“ zeigt, wie schnell Strata deine Eingabe liest.
+
+| Hardware | Ausgabe | Prompt |
+| --- | ---: | ---: |
+| RTX 5070 12 GB, 64 GB RAM | 4 bis 6 Token/s | etwa 110 Token/s (4K) |
+| RTX 3060 12 GB, 46 GB RAM | 9 bis 11 Token/s | etwa 155 Token/s (4K) |
+| 1x Radeon AI PRO R9700, 251 GB RAM | 21 bis 25 Token/s | 320 bis 360 Token/s (8K) |
+| 4x Radeon AI PRO R9700 | 74 bis 77 Token/s | 400 bis 450 Token/s (8K) |
+
+[Speicher, Festplatte und Details](docs/DEEPSEEK41.md) · [Versionshinweise](https://github.com/Niko1221/Strata/releases)
+
+</details>
+
+<a id="the-other-sizes"></a>
+
+Unsicher, was passt? [Wähle ein Modell für deinen Computer](docs/MODELS.md#pick-by-memory).
 
 ## Installation
 
-Such dir eine Option aus. Alle starten dieselbe Engine und nutzen dieselben Modelle.
+<a id="option-a-the-strata-app"></a>
 
-### Option A: die Strata-App
+### Desktop-App
 
-Der einfachste Weg. Die App bringt die Engine mit: installieren, ein Modell wählen, chatten. Lade die Datei für dein
-System und deine Grafikkarte von der [Releases-Seite](https://github.com/Niko1221/Strata/releases/latest) herunter. Du bist
-unsicher, welche du brauchst? Lies den Absatz unter der Tabelle.
+**[Strata für Windows, Linux oder Mac herunterladen →](https://github.com/Niko1221/Strata/releases/latest)**
 
-| System | Deine Grafikkarte | Datei zum Herunterladen |
-| --- | --- | --- |
-| **Windows 10 / 11** | NVIDIA RTX, Treiber 580 oder neuer | [`Strata-0.2.0-beta-windows-cuda13.exe`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-windows-cuda13.exe) |
-| | NVIDIA, ältere Karte oder Treiber älter als 580 | [`Strata-0.2.0-beta-windows-cuda12.exe`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-windows-cuda12.exe) |
-| | AMD Radeon RX 9000 Serie oder Radeon AI PRO R9700 | [`Strata-0.2.0-beta-windows-hip.exe`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-windows-hip.exe) |
-| **Linux** | NVIDIA RTX, Treiber 580 oder neuer | [`Strata-0.2.0-beta-linux-nvidia-cuda13.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-nvidia-cuda13.AppImage) |
-| | NVIDIA, ältere Karte oder Treiber älter als 580 | [`Strata-0.2.0-beta-linux-nvidia-cuda12.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-nvidia-cuda12.AppImage) |
-| | AMD Radeon RX 9000 Serie oder Radeon AI PRO R9700 | [`Strata-0.2.0-beta-linux-amd-rx9070.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-amd-rx9070.AppImage) |
-| | AMD Radeon RX 7000 Serie | [`Strata-0.2.0-beta-linux-amd-rx7900.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-amd-rx7900.AppImage) |
-| **Mac** (Apple Silicon, macOS 15 oder neuer) | eingebaut | [`Strata-0.2.0-beta-mac.dmg`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-mac.dmg) |
+Installiere die App, wähle ein Modell und leg mit dem Chat los. Es gibt einen Installer pro System. Beim ersten Start lädt die App die Engine für deine Grafikkarte herunter. [Hilfe zum Installer](docs/INSTALL.md#the-app).
 
-**Wenn du unsicher bist:** Bei NVIDIA nimmst du `cuda13`, wenn dein Treiber Version 580 oder neuer ist, sonst `cuda12`.
-`cuda12` ist für ältere Karten und ältere Treiber. Die Dateien `hip` und `amd` sind für AMD-Karten. Für andere AMD-Karten
-(RX 6000 oder RX 7000 unter Windows) gibt es noch keine fertige App: siehe [AMD-Karten](docs/AMD_HIP.md).
+<sub>Dateien: `Strata-0.2.9-windows-x64-setup.exe` · `Strata-0.2.9-linux-x86_64.AppImage` · `Strata-0.2.9-macos-arm64.dmg`</sub>
 
-Danach:
+<p align="center">
+  <img src="docs/media/app-chat.png" width="900" alt="Strata-Desktop-App mit Chat und Live-Codevorschau nebeneinander">
+  <br><sub>Chat, Dateien und Live-Vorschau in einem Fenster.</sub>
+</p>
 
-- **Windows:** Starte die `.exe`. Sie wird für deinen Benutzer installiert und braucht keine Administratorrechte. Wenn
-  Windows "Der Computer wurde durch Windows geschützt" meldet, wähle **Weitere Informationen** und dann **Trotzdem
-  ausführen** (der Installer ist noch nicht signiert).
-- **Linux:** Mach die Datei ausführbar (`chmod +x`) und starte sie. Sie braucht FUSE 2: `sudo apt install libfuse2`
-  (Ubuntu 22.04) oder `libfuse2t64` (Ubuntu 24.04 und neuer).
-- **Mac:** Öffne die `.dmg` und zieh Strata in den Ordner "Programme".
+<a id="option-b-the-terminal-one-line"></a>
 
-Auf dem ersten Bildschirm liest die App deinen PC aus und empfiehlt ein passendes Modell. Drück auf Installieren. Das Modell
-ist ein großer Download (etwa 40-70 GB) und wird nach einer Unterbrechung dort fortgesetzt, wo er aufgehört hat. Wenn du
-das Fenster schließt, beenden sich Strata und die Engine.
+### Terminal-App
 
-### Option B: das Terminal (eine Zeile)
+Lieber im Terminal? Installiere Strata und starte dann **`strata launch`**.
 
-Das Terminal ist der Befehl `strata`, gedacht für Skripte, Server und KI-Agents.
+<details open>
+<summary><b>Installationsbefehle</b></summary>
 
-Linux und Mac:
+**Linux / Mac**
 
 ```sh
-curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh | sh
+curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh
 ```
 
-Windows (PowerShell):
+**Windows PowerShell**
 
 ```powershell
 irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex
 ```
 
-Das Skript prüft deinen PC, lädt das Terminal herunter, kontrolliert die SHA-256-Prüfsumme und entpackt es in deinen
-Home-Ordner. Es braucht keine Administratorrechte. Öffne unter Windows danach ein neues Terminalfenster. Dann startest du
-Strata:
+Öffne unter Windows danach ein neues Terminal. Dann:
 
 ```sh
 strata launch
 ```
 
-Es stellt dir eine Frage nach der anderen: Modell, Kontext, Bilder, wer sich verbinden darf. Danach lädt es die Engine für
-deine Grafikkarte herunter (signiert und vor der Nutzung probeweise gestartet), dazu das Modell, und beginnt zu laufen.
-Für Skripte und KI-Agents gibt es Flags:
-
-```sh
-strata launch --model q2_0 --yes --no-tui
-```
-
-Wenn du das Installationsskript vor dem Ausführen lesen willst, lade es zuerst mit `curl -fsSL <address> -o install.sh`
-herunter, lies es und führe dann `sh install.sh` aus. Alle Bildschirme und Flags: [docs/TERMINAL_LAUNCH.md](docs/TERMINAL_LAUNCH.md).
-
-### Option C: deine KI richtet es ein
-
-Füge das in Claude Code, Cursor, Codex, GitHub Copilot oder einen anderen Coding-Assistenten ein:
-
-```text
-Set up Strata on this PC for me: https://github.com/Niko1221/Strata - follow docs/AI_SETUP.md in that repository.
-```
-
-Der Assistent prüft deine Grafikkarte, deinen Arbeitsspeicher und den Speicherplatz, wählt das passende Modell, installiert
-und startet es und sagt dir, wie du deine Apps verbindest. KI-Werkzeuge können Strata auch über den
-[MCP-Server](docs/MCP_SERVER.md) installieren, starten und stoppen.
-
-Du willst es lieber selbst bauen? Siehe [Aus dem Quellcode bauen](#aus-dem-quellcode-bauen).
-
-## Modelle
-
-Die App und `strata launch` empfehlen ein Modell passend zu deinem Speicher. Es ist ein einziges Modell in mehreren
-Größen, mehr oder weniger stark komprimiert. Kleinere Größen sind schneller. Größere Größen sind etwas klüger.
-
-### Wenig Speicher? Probier Gyro
-
-[Gyro](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF) (von agentionai) ist die kleinste Möglichkeit, dieses Modell auszuführen.
-
-| Größe | Benötigter Speicher (RAM + VRAM) | Download | Was es ist |
-| --- | ---: | ---: | --- |
-| **Gyro-S** | 27,6 GB | 58,5 GB | Für PCs, auf denen nichts anderes läuft. Die Qualität ist geringer als bei IQ2_XS. |
-| **Gyro-M** | 35 GB | 92,0 GB | Ungefähr die Qualität von IQ3_XXS bei etwa 20 % weniger GPU-Speicher. Es schreibt Antworten auf einer 12-GB-Karte und auf einer R9700 17-21 % langsamer als Q2_0. |
-
-Gyro läuft auf NVIDIA- und AMD-Karten (bei AMD experimentell), nicht auf Intel Arc und nicht auf dem Mac. Details und Messwerte:
-[docs/GYRO.md](docs/GYRO.md). Starte es mit `strata launch --model gyro-s`.
-
-### Die anderen Größen
-
-| Dein Speicher (RAM + VRAM) | Nimm | Hinweise |
-| --- | --- | --- |
-| **32 GB** | **Gyro-S**, oder den **[Coder](docs/MODELS.md#coder)** für Code | Der Coder braucht 32 GB RAM und behält die Hälfte der Experten, deshalb ist er außerhalb von Code schwächer |
-| **40 GB** | **[Swift 1.5](docs/MODELS.md#swift-15)** IQ2_XS (39,2 GB), oder **Gyro-M** (35 GB) | Swift denkt kürzer nach, bevor es antwortet. Gyro-M kommt der Qualität von IQ3_XXS nahe, schreibt Antworten aber 17-21 % langsamer als Q2_0 |
-| **48 GB** | **IQ3_XXS** (47,0 GB) | Langsamer, besser |
-| **64 GB** | **IQ3_S** (54,8 GB), das Original oder Swift 1.5 | Am langsamsten, am besten. Es erreicht in den veröffentlichten Tests das volle Modell |
-| **96 GB oder mehr** | **UD-IQ4_XS** von Unsloth (etwa 72 GB RAM) bis **Q8_0** (etwa 136 GB), 4 bis 8 Bit | Näher am vollen Modell. Bei weniger RAM liest Strata einen Teil von der SSD, das ist viel langsamer |
-
-Auch mit weniger RAM, als eine Zeile nennt, kann es funktionieren: Strata wechselt von selbst in seinen
-[Modus für wenig RAM](docs/MODELS.md#a-big-graphics-card-and-little-ram). Rechne mit weniger Tempo, mit einer kleinen
-Grafikkarte mit deutlich weniger.
-
-Weitere Auswahl:
-
-- **[Swift 1.5](docs/MODELS.md#swift-15)** ist eine Feinabstimmung, die kürzer nachdenkt, bevor sie antwortet, bei etwa gleicher Qualität und gleichem RAM-Bedarf.
-- **[NVFP4](docs/NVFP4.md)** ist NVIDIAs 4-Bit-Version für NVIDIA-Karten. Sie braucht etwa 80 GB RAM, um alle Experten im RAM zu halten.
-- **[Qwen3.6-35B-A3B](docs/QWEN36.md)** ist ein kleineres, anderes Modell, das Bilder liest und mehrere Anfragen gleichzeitig beantworten kann.
-- **[OrcaRouters Uncensored IQ3_XXS](docs/MODELS.md#orcarouter-uncensored-iq3_xxs)** richtest du von Hand ein.
-
-Alle Größen, Downloads und was wo läuft: [docs/MODELS.md](docs/MODELS.md).
-
-## Wie schnell ist es?
-
-Gemessen mit einer Grafikkarte mit 12 GB (RTX 5070, Ryzen 5 7600, 64 GB RAM). Ergebnisse anderer Karten findest du hier:
-[Tempo jeder Größe](docs/MODELS.md#how-fast-is-each-size), [Ergebnisse der Community](docs/COMMUNITY_BENCHMARKS.md).
-
-| Modell | Antworten erscheinen mit | Liest deinen Prompt mit |
-| --- | --- | --- |
-| **Q2_0** | `████████████` 94 Tokens/s | `████████████` 2.650 Tokens/s |
-| **IQ2_XS** | `██████████░░` 79 Tokens/s | `█████████░░░` 2.090 Tokens/s |
-| **IQ3_XXS** | `████████░░░░` 62 Tokens/s | `████████░░░░` 1.750 Tokens/s |
-| **IQ3_S** | `███████░░░░░` 53 Tokens/s | `███████░░░░░` 1.620 Tokens/s |
-| **Coder** | `███████░░░░░` 55 Tokens/s | `██████████░░` 2.180 Tokens/s |
-
-Ein Token ist etwa ¾ eines Wortes, 60 Tokens pro Sekunde sind also schneller, als du lesen kannst. "Liest deinen Prompt"
-beschreibt, wie schnell Strata ein langes Dokument, Code oder einen Chatverlauf aufnimmt.
-
-Gemessen mit einer AMD-Karte mit 16 GB (RX 9070 XT, Ryzen 9 3900X, 47 GB RAM):
-
-| Modell | Antworten erscheinen mit | Liest deinen Prompt mit |
-| --- | --- | --- |
-| **Q2_0** | `████████░░░░` 60 Tokens/s | `█████░░░░░░░` 1.160 Tokens/s |
-| **IQ2_XS** | `███████░░░░░` 52 Tokens/s | `█████░░░░░░░` 1.110 Tokens/s |
-| **Coder** | `██████░░░░░░` 44 Tokens/s | `██████░░░░░░` 1.420 Tokens/s |
-
-Die Balken haben in beiden Tabellen denselben Maßstab. Eine Karte mit mehr VRAM ist schneller. Eine RTX 3090 (24 GB) sollte
-etwa 100-140 Tokens pro Sekunde schreiben. Die Engine-Version hinter jeder Zahl steht in [DETAILS.md](docs/DETAILS.md#speed-measured).
-
-## Benutzung
-
-### In der App
-
-Die App hat einen **Chat**, einen **Monitor** für das Modell sowie für GPU, CPU und RAM, eine Seite **Modelle** und die
-**Einstellungen**. Der Chat kann in einem Ordner auf deinem PC arbeiten. Im Modus **Manuell** fragt er nach, bevor er eine
-Datei ändert oder einen Befehl ausführt. Mit `/loop 10m <what to do>` wiederholst du eine Nachricht alle 10 Minuten, solange
-der Chat geöffnet ist.
-
-Der Chat kann das Web mit DuckDuckGo (oder Bing) durchsuchen, ohne Konto. Unter **Einstellungen, Tools** kannst du einen
-Suchschlüssel hinzufügen. Die Suche ist die einzige Funktion, die etwas von deinem PC sendet (die Suchbegriffe).
-
-Um zwei Modelle auszuführen, schalte **Mehrere Modelle ausführen** ein und gib jedem Modell eine eigene Karte desselben
-Herstellers.
-
-<p align="center"><img src="docs/media/runpagoda.png" width="900" alt="The Strata app's Monitor tab next to a coding agent"><br>
-<sub>Der <b>Monitor</b> der Strata-App (links), während ein Coding-Agent den Pagodengarten aus dem Video schreibt (rechts)</sub></p>
-
-### Im Terminal
-
-```sh
-strata launch                                  # guided screens: model, context, pictures, access, then serve
-strata launch --model q2_0 --yes --no-tui     # no questions: serve, print the address, return
-strata launch --plan --model q2_0              # show what would happen; nothing changes
-strata launch --status                         # what is being served now
-strata launch --stop                           # stop it
-strata monitor --url http://127.0.0.1:8080     # watch speed, GPU, memory and requests
-strata update --check                          # is there a new engine? (strata update installs it)
-strata doctor                                  # check the installed engine files
-```
-
-`strata --help` listet alles auf. Starten und Bereitstellen laden nichts herunter. Nur die Installation, `strata launch`
-(wenn du ein Modell wählst) und `strata update` tun das. Um Strata von deinem Handy oder einem anderen PC aus zu erreichen,
-nutze `strata launch --access lan`. Der Befehl erzeugt einen API-Schlüssel und startet in einem Netzwerk nicht ohne einen.
-Ein Browser öffnet sich nur, wenn du `--open` angibst. Anleitung: [docs/TERMINAL_LAUNCH.md](docs/TERMINAL_LAUNCH.md). Der ganze Client: [docs/TERMINAL.md](docs/TERMINAL.md).
-
-### Mit KI-Agents
-
-Ein Agent installiert Strata mit dem Einzeiler aus Option B und führt
-`strata launch --model NAME --yes --no-tui` aus. Die Schritte, Flags und Exit-Codes stehen in [docs/AI_SETUP.md](docs/AI_SETUP.md),
-die Regeln für das Repository in [AGENTS.md](AGENTS.md).
-
-### Andere Apps verbinden
-
-| App-Typ | Basis-URL |
-| --- | --- |
-| OpenAI-kompatibel (die meisten Apps und Agents) | `http://127.0.0.1:8080/v1` (beliebiger API-Schlüssel, beliebiger Modellname) |
-| Anthropic-API (Claude Code und andere) | `http://127.0.0.1:8080`, ohne `/v1`. Diese Apps hängen `/v1/messages` selbst an. Claude Code: `ANTHROPIC_BASE_URL=http://127.0.0.1:8080` |
-| OpenAI Responses API (Codex CLI) | `http://127.0.0.1:8080/v1/responses` ([Einrichtung](docs/DETAILS.md#the-responses-api-and-codex-cli)) |
-
-`strata connect` gibt die genauen Einstellungen für OpenCode, Codex CLI, Claude Code, oh-my-pi, pi, Hermes Agent und OpenClaw aus.
-`strata connect opencode --write` schreibt die Datei nach einer Rückfrage und legt eine Sicherung an.
-
-### Bilder
-
-Bilder sind für Modelle, die sie lesen können, standardmäßig eingeschaltet. Hänge ein Bild im Chat an oder füge es ein, oder
-sende es aus deiner App. Der Bildleser läuft auf dem Prozessor, wenn deine Grafikkarte weniger als 24 GB hat (einige Sekunden
-pro Bild, ohne Speicher der Karte zu belegen), und ab 24 GB auf der Grafikkarte. Die Regel gilt für NVIDIA und AMD gleich.
-Du kannst Bilder pro Modell ausschalten oder den Leser mit `--vision off`, `--vision gpu` oder `--vision cpu` wählen.
-
-Die Zahlen hinter der Regel: Auf einer Radeon AI PRO R9700 brauchte der Bildleser der Karte 57 ms für ein Bild mit 260 Tokens,
-der des Prozessors 3,1 s. Auf Karten mit 16 GB (Tesla P100 und RTX A4000, Linux) kostete der Bildleser der Karte 3-5 % des
-Texttempos, weil er etwa 1,4 GB belegt, die sonst das Modell nutzen würde. Der Mac hat noch keinen Bildleser.
-
-### Gut zu wissen
-
-- Das Denkniveau (**aus, niedrig, mittel oder hoch**) stellst du im Chat-Menü oder unter "reasoning effort" in deiner App ein. Aus ist am schnellsten.
-- Strata beantwortet standardmäßig eine Anfrage nach der anderen. Für mehrere gleichzeitig nutze `--parallel N` in `strata launch` oder
-  `"parallel": 2` in der Konfiguration ([BATCHING.md](docs/BATCHING.md)). Auf einer Karte mit 12 GB wird dadurch jede Antwort langsamer.
-- Strata liest die erste Nachricht eines Chats komplett, etwa 1 Minute pro 30.000 Tokens. Folgenachrichten starten in Sekunden.
-- Wo deine Chats gespeichert werden und die ganze API: [docs/INSTALL.md](docs/INSTALL.md#where-things-are-stored), [docs/DETAILS.md](docs/DETAILS.md#using-it).
-
-## Aus dem Quellcode bauen
-
-<details>
-<summary>Windows, Linux und Mac aus dem Repository</summary>
-
-[Lade Strata herunter](https://github.com/Niko1221/Strata/archive/refs/heads/main.zip) und entpacke es, oder nutze `git clone`.
-**Windows:** Doppelklick auf `START-HERE.bat`. **Linux:** Führe `./setup.sh` im Strata-Ordner aus.
-
-**Mac (Apple Silicon, macOS 15 oder neuer):** Installiere einmal die Command Line Tools von Apple mit `xcode-select --install`
-(Xcode selbst brauchst du nicht). Öffne das Terminal im Strata-Ordner und führe `./setup.sh` aus. Das Skript baut die
-Mac-Engine auf deinem Mac (etwa 7 Minuten), stellt dieselben Fragen, lädt das Modell herunter und startet es. Beim nächsten
-Mal startet `./setup.sh` sofort. Welche Größe zu deinem Mac passt: [docs/MAC.md](docs/MAC.md).
-
-Der Installer erkennt deine Karte und richtet die passende Engine ein. Er fragt, welches Modell und welche Größe du willst,
-wie viel Kontext (wie viel Text sich das Modell merkt) und ob es Bilder lesen soll. Drück Enter für die empfohlene Antwort.
-Dann lädt er das Modell herunter (etwa 70 GB) und startet es. Wenn der Download abbricht, führe das Skript erneut aus, dann
-geht es weiter. Dein Browser öffnet die Strata-Seite unter `http://127.0.0.1:8080`.
-
-> Während das Modell startet, kann dein PC 1-3 Minuten langsam sein oder nicht reagieren (beim ersten Mal am längsten). Strata
-> lädt 35-55 GB in deinen RAM und sperrt einen Teil davon für die Grafikkarte. Warte ab und schließe das Fenster nicht.
-
-Starte beim nächsten Mal wieder `START-HERE.bat` (oder `./setup.sh`). Es startet sofort und lädt nichts doppelt herunter.
-Schließ sein Fenster, um das Modell zu beenden. `UPDATE.bat` (`./update.sh`) aktualisiert Strata, ohne es zu starten.
-Aktualisieren, Docker, mehrere Karten, wohin die Dateien kommen und alle Optionen: [docs/INSTALL.md](docs/INSTALL.md).
-
-Um deinen PC zu messen, führe `BENCH.bat` (`./bench.sh`) aus. Das dauert 5-10 Minuten und schreibt einen Bericht, den du teilen
-kannst ([so geht's](docs/COMMUNITY_BENCHMARKS.md#run-the-benchmark)).
-
-**Optional: mehr Tempo auf einer Karte, wenn das ganze Modell in den RAM passt.** Zwei Einstellungen zum Einschalten von
-RubenTorney (#1904, #1905). Sie helfen, wenn du eine Grafikkarte nutzt und dein RAM alle Experten aufnimmt, zum Beispiel bei
-Q2_0 oder IQ3_XXS auf einem PC mit 64 GB. Öffne `strata-<model>.json` im Strata-Datenordner ([wo](docs/INSTALL.md#where-things-are-stored)) und ergänze:
-
-- `"--adapt-async", "1"` in der Liste `"args"`. Der Expertencache wird dann in einem Hilfsthread aktualisiert, statt die
-  Antwort anzuhalten. Gemessen auf einer RTX 5070 (Windows, Q2_0): +4-5 % beim Decodieren, +7-10 % bei Code und langen
-  Dokumenten. Die Antworten können sich leicht von der Standardeinstellung unterscheiden und bleiben von Lauf zu Lauf gleich.
-- `"STRATA_PIN_BY_NEED": "1"` im Block `"env"` (Windows). Windows kann nur etwa die Hälfte des RAM für die Grafikkarte sperren,
-  und diese Einstellung sperrt zuerst die Experten, die die Karte am dringendsten braucht. Gemessen auf der RTX 5070: +4,4 % beim Lesen des Prompts.
-
-```json
-"args": [ ..., "--adapt-async", "1" ],
-"env": { "STRATA_PIN_BY_NEED": "1" }
-```
-
-Starte Strata nach der Änderung neu. Zum Rückgängigmachen entfernst du die beiden Einträge.
+Folge den Anweisungen, um ein Modell herunterzuladen und zu starten. [Terminal-Anleitung](docs/TERMINAL_LAUNCH.md).
 
 </details>
 
-## Wie funktioniert das?
+<p align="center">
+  <img src="docs/media/terminal-monitor.png" width="900" alt="Strata-Terminal-App mit Modellaktivität, Tempo, Speicher und letzten Anfragen">
+  <br><sub>Behalte Modell und Hardware im Blick, während es läuft.</sub>
+</p>
 
-Modelle wie dieses laufen normalerweise auf Servern mit Hunderten Gigabyte Grafikspeicher. Deine Grafikkarte hat 12-24 GB.
-Strata bringt das Modell auf deinen PC, indem es die Arbeit auf den ganzen Rechner verteilt. Stell dir eine Bibliothek vor.
+<a id="build-from-source"></a>
 
-- Das Modell ist ein Team aus 24.576 kleinen Spezialisten ("Experten"), wie 24.576 Nachschlagewerke. Für jedes Wort braucht es nur 10 davon.
-- **Deine Grafikkarte ist der Schreibtisch.** Er ist klein und schnell. Die etwa 4.000 am häufigsten genutzten Bücher liegen
-  dort aufgeschlagen.
-- **Dein RAM sind die Regale im Lesesaal.** Alle 24.576 Bücher stehen dort. Braucht ein Wort ein Buch, das nicht auf dem
-  Schreibtisch liegt, holt dein Prozessor es sofort aus dem Regal, während die Karte weiterarbeitet.
-- **Deine SSD ist das Archiv.** Sie enthält eine Nachschlagetabelle von 29 GB. Das Modell liest pro Wort nur wenige Zeilen
-  daraus, deshalb muss sie nicht im RAM liegen.
+[Aus dem Quellcode bauen](docs/SOURCE_INSTALL.md) · [Docker](docs/DOCKER.md) · [Vollständige Installationsanleitung](docs/INSTALL.md)
 
-<p align="center"><img src="docs/media/how-it-works.svg" width="860" alt="The model's 24,576 experts: the busiest on the graphics card, all of them in RAM, a lookup table on the SSD"></p>
+<a id="what-you-need"></a>
 
-Ein kleiner Helfer rät außerdem die nächsten Wörter. Das große Modell prüft sie alle auf einmal und behält die richtigen. Du
-bekommst dieselbe Antwort, 1,6-1,8-mal früher. Lange Texte werden in großen Stücken gelesen, bis zu 8.192 Tokens auf einmal,
-mit über 1.000 Tokens pro Sekunde.
+## Hardware
 
-<p align="center"><img src="docs/media/guess-and-check.svg" width="860" alt="A small helper guesses the next words; the big model checks them all at once and keeps the right ones"></p>
+| Unterstützte Hardware | Anleitung |
+| --- | --- |
+| **NVIDIA GeForce RTX 20 / 30 / 40 / 50** | [NVIDIA-Setup](docs/INSTALL.md#what-you-need) |
+| **AMD Radeon RX 7700 / 7800 / 7900, RX 9060 / 9070, AI PRO R9700** | [AMD-Setup](docs/AMD_HIP.md) |
+| **AMD Radeon RX 6800 / 6900 · experimentell** | [RX-6000-Setup](docs/AMD_HIP.md#rdna2-gfx1030) |
+| **Intel Arc · Linux** | [Intel-Setup](docs/INTEL_ARC.md) |
+| **Apple Silicon · M1 oder neuer** | [Mac-Setup](docs/MAC.md) |
+| **AMD Ryzen AI Max · Strix Halo** | [Strix-Halo-Setup](docs/STRIX_HALO.md) |
 
-Die ausführliche Erklärung: [docs/HOW_IT_WORKS.md](docs/HOW_IT_WORKS.md). Jeder Teil mit seinen Zahlen:
-[die Details](docs/DETAILS.md#how-it-works) und das [Paper](docs/paper/Strata-Paper.pdf).
+<a id="using-it"></a>
 
-## Etwas ist schiefgegangen?
+## Tools
 
-- **Mein PC ist beim ersten Start von Strata eingefroren.** Strata lädt das Modell in den RAM. Warte ab und schließe das
-  Fenster nicht. Nach 10 Minuten immer noch eingefroren? Starte den PC neu, schließe andere Programme und versuch es noch
-  einmal, oder wähle eine kleinere Größe.
-- **Es ist beim Herunterladen oder Installieren stehen geblieben.** Starte die App oder `strata launch` noch einmal, oder
-  führe `START-HERE.bat` (oder `./setup.sh`) erneut aus. Es macht dort weiter, wo es aufgehört hat.
-- **Es ist sehr langsam, die Festplattenanzeige blinkt ständig, oder es meldet "the engine stopped unexpectedly".** Dein PC
-  hat nicht genug freien RAM. Schließe andere Programme (Browser brauchen viel) oder wähle eine kleinere Größe wie Q2_0 oder IQ2_XS.
-- **Es meldet, dass es keine Engine für diesen PC gibt.** Öffne in der App **Einstellungen, Engine** und drücke **Engine
-  aktualisieren**. Führe im Terminal `strata update` aus. `strata doctor` zeigt, welche Engine-Dateien installiert sind.
-- **Es meldet, dass Port 8080 schon belegt ist.** Strata läuft bereits. Such das Fenster.
+**Claude Code · Codex CLI · OpenCode · oh-my-pi · pi.dev · Hermes Agent · OpenClaw**, und weitere über die OpenAI- und Anthropic-kompatiblen APIs.
 
-Weitere Probleme und Lösungen: [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md). Du kommst nicht weiter? Öffne ein
-[Issue](https://github.com/Niko1221/Strata/issues). Hänge in der App die Datei aus **Einstellungen, Engine, Diagnose, Protokolle anzeigen, Protokolle speichern** an. Füge im Terminal die Ausgabe von `strata doctor` ein. Hänge beim Start aus dem Quellcode die
-Datei `strata-<model>.log` aus dem Strata-Ordner an. Ein Sicherheitsproblem meldest du bitte privat: [SECURITY.md](SECURITY.md).
+Führe **`strata connect`** aus, um die Einrichtung für dein Tool zu sehen. [Verbindungsanleitung](docs/TERMINAL_LAUNCH.md#connect-your-apps-strata-connect).
 
-## Danksagung und Lizenz
+<a id="guides"></a>
+<a id="how-fast-is-it"></a>
+<a id="how-does-it-work"></a>
+<a id="something-went-wrong"></a>
 
-Das Modell ist [Qwen3.8-Flash-Next](https://huggingface.co/Qwen/Qwen3.8-Flash-Next) vom Qwen-Team. Komprimiert wurde es von
-[ISTA-DASLab](https://huggingface.co/ISTA-DASLab/Qwen3.8-Flash-Next-GSQ-RCO-GGUF), UkisAI (Swift 1.5), agentionai (Gyro)
-und Unsloth. Strata nutzt Teile von [llama.cpp / ggml](https://github.com/ggml-org/llama.cpp). Alle Danksagungen:
-[docs/HOW_IT_WORKS.md](docs/HOW_IT_WORKS.md#credits). Strata ist Open Source unter der [MIT-Lizenz](LICENSE). Einige Teile und
-alle Modelle haben eigene Lizenzen ([welche](docs/HOW_IT_WORKS.md#license)).
+## Hilfe
 
-## Mitmachen
-
-Du hast einen Fehler gefunden oder willst eine Änderung oder einen Benchmark einsenden? Lies zuerst [CONTRIBUTING.md](CONTRIBUTING.md).
-Dort steht, was dazugehört, damit andere deine Arbeit nachprüfen können.
+[Alle Anleitungen](docs) · [Fehlerbehebung](docs/TROUBLESHOOTING.md) · [Fehler melden](https://github.com/Niko1221/Strata/issues/new/choose) ·
+[Benchmarks](docs/COMMUNITY_BENCHMARKS.md) · [So funktioniert es](docs/HOW_IT_WORKS.md) · [Mitmachen](CONTRIBUTING.md)
 
 ## Strata unterstützen
 
-Strata ist kostenlos und steht unter der MIT-Lizenz. Ich baue es und teste es auf jeder Hardware, die ich bekommen kann. Wenn es auf deinem PC gut läuft, hilft mir ein Kaffee,
-weiter neue Karten zu testen und das zu beheben, was ihr meldet. Es besteht kein Druck. Strata zu nutzen und zu melden, was dir auffällt, hilft genauso viel.
+**Hilf mit, lokale KI für alle offen zu halten.** Ein Kaffee hilft, Entwicklung und Tests auf mehr Hardware zu finanzieren.
 
-<a href="https://buymeacoffee.com/strataengine"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="50"></a>
+<a href="https://buymeacoffee.com/strataengine"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me a Coffee: Strata unterstützen" height="48"></a>
 
-Du möchtest Strata sponsern? Schreib mir über [GitHub](https://github.com/Niko1221).
+[MIT-Lizenz](LICENSE) · [Danksagung und Modelllizenzen](docs/HOW_IT_WORKS.md#credits) · [Datenschutz](docs/SAFETY.md)
+
+<a id="option-c-let-your-ai-set-it-up"></a>
+
+<sub>Für KI-Tools und automatische Leser: <a href="AGENTS.md">technische Referenz</a> · <a href="docs/AI_SETUP.md">Setup-Anleitung</a>.</sub>
+
+**Sponsoring, Hardware-Partnerschaften oder Zusammenarbeit:** [[email protected]](mailto:[email protected]).

README.es.md

@@ -1,397 +1,188 @@
 <p align="center">
   <picture>
     <source media="(prefers-color-scheme: dark)" srcset="apps/host/public/brand/strata-lockup-dark.svg">
-    <img src="apps/host/public/brand/strata-lockup-light.svg" alt="Strata" width="380">
+    <img src="apps/host/public/brand/strata-lockup-light.svg" alt="Strata" width="340">
   </picture>
 </p>
 
-<p align="center"><a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <b>Español</b> · <a href="README.pt-BR.md">Português</a></p>
-
-<h3 align="center">Ejecuta un modelo de última generación en tu propio PC gaming</h3>
-
-<p align="center">Compatible con NVIDIA, AMD, Intel · Windows, Linux, Mac · libre y de código abierto</p>
+<h3 align="center">IA potente en tu propio ordenador.</h3>
+<p align="center">Chatea, programa y trabaja con imágenes, en local.</p>
 
 <p align="center">
-  <a href="https://github.com/Niko1221/Strata/releases"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?include_prereleases&label=release" alt="Latest release"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="MIT license"></a>
-  <a href="https://github.com/Niko1221/Strata/stargazers"><img src="https://img.shields.io/github/stars/Niko1221/Strata?style=flat" alt="GitHub stars"></a>
+  <a href="#modelos">Modelos</a> · <a href="#instalación"><b>Instalación</b></a> ·
+  <a href="#hardware">Hardware</a> · <a href="#herramientas">Herramientas</a> ·
+  <a href="#ayuda">Ayuda</a> · <a href="#apoya-strata">Apoyar</a>
 </p>
 
-<p align="center"><a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4"><img src="docs/media/pagoda-preview.webp" width="720" alt="A voxel pagoda garden that Strata's model wrote, running in the browser"></a><br>
-<sub>Un jardín con una pagoda de vóxeles, hecho con un solo prompt en una RTX 5070 con Strata (IQ3_S, contexto de 128K) ·
-<a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4">vídeo completo (49 s)</a></sub></p>
+<p align="center">
+  <a href="https://github.com/Niko1221/Strata/releases/latest"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?label=download&color=0ab887" alt="Descargar Strata"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="Licencia MIT"></a>
+  <a href="https://buymeacoffee.com/strataengine"><img src="https://img.shields.io/badge/Buy_me_a_coffee-FFDD00?logo=buymeacoffee&logoColor=000" alt="Apoya Strata en Buy Me a Coffee"></a>
+</p>
 
-Strata ejecuta **[Qwen3.8-Flash-Next](https://huggingface.co/Qwen/Qwen3.8-Flash-Next)**, un modelo de 125 mil millones
-de parámetros que normalmente necesita un servidor, en un PC normal. Conversa, escribe código, lee imágenes y funciona
-con tus aplicaciones y tus agentes de programación. Tus chats y tus archivos se quedan en tu PC.
+<p align="center"><sub><a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <b>Español</b> · <a href="README.pt-BR.md">Português</a> · <a href="README.pl.md">Polski</a></sub></p>
 
-**¿Eres nuevo?** Mira [lo que necesitas](#lo-que-necesitas) y luego [instala la aplicación](#opción-a-la-aplicación-strata).
+**Gratis, de código abierto y tuyo para ejecutar.** Usa Strata en tu escritorio o con tus herramientas de programación favoritas. No necesitas cuenta.
 
-- **Funciona en un PC gaming.** Con 32 GB entre RAM y memoria gráfica ya puedes empezar.
-- **Funciona con tus herramientas.** Habla las API de OpenAI y de Anthropic, así que Claude Code, Codex CLI, OpenCode y otros agentes se conectan a él.
-- **Lee imágenes.** Viene activado por defecto.
-- **Gratis.** Licencia MIT, sin cuenta, sin nube.
-- **Privado.** Sin telemetría. Lo que Strata descarga, cuándo usa internet y cómo comprueba las descargas está en [docs/SAFETY.md](docs/SAFETY.md).
+## Modelos
 
-Versión 0.2.0-beta · motor 0.1.45.3
+Recomendamos **primero ISTA-DASLab**, después **Unsloth** y otros proveedores, siempre que haya un modelo compatible que quepa en tu memoria.
 
-## Lo que necesitas
+<details>
+<summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.8-Flash-Next</b></summary>
 
-**Necesitas al menos 32 GB entre RAM y memoria gráfica (VRAM).** En un Mac o un Ryzen AI Max, es la memoria unificada.
-Con más memoria puedes usar un modelo más grande o más rápido.
-
-- Un PC de 32 GB con una tarjeta de 12 a 16 GB ejecuta el Coder.
-- Con 64 GB de RAM funcionan todos los tamaños.
-
-| Tu ordenador | Detalles |
+| Proveedor | Opciones |
 | --- | --- |
-| **NVIDIA** GeForce RTX serie 20, 30, 40, 50 (12 GB o más) | Instala la aplicación o la Terminal. |
-| **AMD** Radeon RX 6800 y posteriores, Radeon AI PRO R9700 (12 GB o más) | [Tarjetas AMD](docs/AMD_HIP.md) |
-| **Intel** Arc | [Intel Arc](docs/INTEL_ARC.md), [motor Intel](docs/INTEL.md) |
-| **Mac con Apple Silicon** (M1 o posterior, macOS 15 o posterior) | [Mac](docs/MAC.md) |
-| **AMD Ryzen AI Max (Strix Halo)** y otros sistemas con memoria unificada | [Strix Halo](docs/STRIX_HALO.md) |
-| Tarjetas y procesadores antiguos | [GPU antiguas](docs/OLDER_GPUS.md), [CPU antiguas](docs/INSTALL.md#older-cpus-experimental) |
+| **ISTA-DASLab · recomendado** | Q2\_0, IQ2\_XS, IQ3\_XXS, IQ3\_S. [Coder: IQ1\_M](docs/MODELS.md#coder) para programar. |
+| **Unsloth** | UD-IQ4\_XS, UD-Q4\_K\_XL, UD-Q5\_K\_XL, UD-Q6\_K\_XL, Q8\_0 |
+| **Gyro · agentionai** | [Gyro-S, Gyro-M](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF). Usa menos memoria, pero es más lento. |
+| **Otras opciones** | [Swift 1.5](docs/MODELS.md#swift-15), [NVFP4](docs/NVFP4.md), [OrcaRouter](docs/ORCA.md) |
 
-También hace falta:
+[Compara tamaños, necesidades de memoria y compatibilidad](docs/MODELS.md).
 
-- unos 80 GB de disco libre (con un SSD el primer arranque es mucho más rápido)
-- Windows 10 / 11, Linux o macOS
-- un controlador gráfico actual
+</details>
 
-Dos o tres tarjetas de la misma marca pueden compartir un modelo ([multi-GPU](docs/MULTI_GPU.md)). Strata nunca reparte un
-modelo entre tarjetas NVIDIA y AMD. Lista completa: [docs/INSTALL.md](docs/INSTALL.md#what-you-need).
+<details>
+<summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.6-35B-A3B</b></summary>
+
+**Unsloth:** UD-Q4_K_XL, UD-Q6_K_XL, Q8_0. Son los paquetes documentados actualmente para este modelo.
+
+[Guía del modelo y compatibilidad](docs/QWEN36.md).
+
+</details>
+
+<details>
+<summary><img src="docs/media/models/deepseek.svg" width="22" alt="" align="middle"> &nbsp;<b>DeepSeekV4.1-Flash-1017</b></summary>
+
+En la **aplicación de escritorio** y en el **Terminal**. Lo que no cabe en la memoria se lee desde tu SSD, así que hace falta mucho espacio libre en disco.
+
+| Conjunto (ISTA-DAS) | Descarga | Espacio libre necesario |
+| --- | ---: | ---: |
+| 1.75 bpw | 239 GB | unos 245 GB |
+| 2.00 bpw | 257 GB | unos 265 GB |
+| 2.25 bpw | 274 GB | unos 280 GB |
+
+Funciona en NVIDIA RTX 30, 40 y 50 (Windows y Linux) y en AMD Radeon AI PRO R9700 (Linux). La instalación descarga los archivos y el motor de DeepSeek, y después inicia el modelo.
+
+```sh
+strata launch --family deepseek41 --model ist-das-2.00bpw --plan
+```
+
+Medido con el conjunto de 2.00 bpw en Strata 0.2.5. «Salida» es la velocidad de la respuesta; «Prompt» es la rapidez con la que Strata lee tu texto.
+
+| Hardware | Salida | Prompt |
+| --- | ---: | ---: |
+| RTX 5070 12 GB, 64 GB de RAM | 4 a 6 tokens/s | unos 110 tokens/s (4K) |
+| RTX 3060 12 GB, 46 GB de RAM | 9 a 11 tokens/s | unos 155 tokens/s (4K) |
+| 1x Radeon AI PRO R9700, 251 GB de RAM | 21 a 25 tokens/s | 320 a 360 tokens/s (8K) |
+| 4x Radeon AI PRO R9700 | 74 a 77 tokens/s | 400 a 450 tokens/s (8K) |
+
+[Memoria, disco y detalles](docs/DEEPSEEK41.md) · [Notas de la versión](https://github.com/Niko1221/Strata/releases)
+
+</details>
+
+<a id="the-other-sizes"></a>
+
+¿No sabes qué cabe? [Elige un modelo para tu ordenador](docs/MODELS.md#pick-by-memory).
 
 ## Instalación
 
-Elige una opción. Todas arrancan el mismo motor y usan los mismos modelos.
+<a id="option-a-the-strata-app"></a>
 
-### Opción A: la aplicación Strata
+### Aplicación de escritorio
 
-La forma más fácil. La aplicación lleva el motor dentro: la instalas, eliges un modelo y chateas. Descarga el archivo para
-tu sistema y tu tarjeta gráfica desde la [página de versiones](https://github.com/Niko1221/Strata/releases/latest). ¿No
-sabes cuál elegir? Mira el párrafo que hay debajo de la tabla.
+**[Descargar Strata para Windows, Linux o Mac →](https://github.com/Niko1221/Strata/releases/latest)**
 
-| Sistema | Tu tarjeta gráfica | Archivo que descargar |
-| --- | --- | --- |
-| **Windows 10 / 11** | NVIDIA RTX, controlador 580 o posterior | [`Strata-0.2.0-beta-windows-cuda13.exe`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-windows-cuda13.exe) |
-| | NVIDIA, tarjeta más antigua o controlador anterior a 580 | [`Strata-0.2.0-beta-windows-cuda12.exe`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-windows-cuda12.exe) |
-| | AMD Radeon serie RX 9000 o Radeon AI PRO R9700 | [`Strata-0.2.0-beta-windows-hip.exe`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-windows-hip.exe) |
-| **Linux** | NVIDIA RTX, controlador 580 o posterior | [`Strata-0.2.0-beta-linux-nvidia-cuda13.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-nvidia-cuda13.AppImage) |
-| | NVIDIA, tarjeta más antigua o controlador anterior a 580 | [`Strata-0.2.0-beta-linux-nvidia-cuda12.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-nvidia-cuda12.AppImage) |
-| | AMD Radeon serie RX 9000 o Radeon AI PRO R9700 | [`Strata-0.2.0-beta-linux-amd-rx9070.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-amd-rx9070.AppImage) |
-| | AMD Radeon serie RX 7000 | [`Strata-0.2.0-beta-linux-amd-rx7900.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-amd-rx7900.AppImage) |
-| **Mac** (Apple Silicon, macOS 15 o posterior) | integrada | [`Strata-0.2.0-beta-mac.dmg`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-mac.dmg) |
+Instala la aplicación, elige un modelo y empieza a chatear. Hay un instalador por sistema. En el primer arranque, la aplicación descarga el motor para tu tarjeta gráfica. [Ayuda con el instalador](docs/INSTALL.md#the-app).
 
-**Si no estás seguro:** con NVIDIA, elige `cuda13` si la versión de tu controlador es la 580 o posterior, y `cuda12` en caso
-contrario. `cuda12` es para tarjetas y controladores más antiguos. Los archivos `hip` y `amd` son para tarjetas AMD. Las
-demás tarjetas AMD (RX 6000, o RX 7000 en Windows) todavía no tienen una aplicación ya preparada: mira
-[Tarjetas AMD](docs/AMD_HIP.md).
+<sub>Archivos: `Strata-0.2.9-windows-x64-setup.exe` · `Strata-0.2.9-linux-x86_64.AppImage` · `Strata-0.2.9-macos-arm64.dmg`</sub>
 
-Después:
+<p align="center">
+  <img src="docs/media/app-chat.png" width="900" alt="Aplicación de escritorio de Strata con un chat y una vista previa del código en vivo, una junto a otra">
+  <br><sub>Chat, archivos y vista previa en vivo en una sola ventana.</sub>
+</p>
 
-- **Windows:** ejecuta el `.exe`. Se instala para tu usuario y no necesita permisos de administrador. Si Windows muestra
-  "Windows protegió tu PC", elige **Más información** y luego **Ejecutar de todas formas** (el instalador todavía no está
-  firmado).
-- **Linux:** haz el archivo ejecutable (`chmod +x`) y lánzalo. Necesita FUSE 2: `sudo apt install libfuse2` (Ubuntu 22.04)
-  o `libfuse2t64` (Ubuntu 24.04 y posteriores).
-- **Mac:** abre el `.dmg` y arrastra Strata a Aplicaciones.
+<a id="option-b-the-terminal-one-line"></a>
 
-En la primera pantalla, la aplicación analiza tu PC y recomienda un modelo adecuado. Pulsa Instalar. El modelo es una
-descarga grande (unos 40 a 70 GB) y, si se interrumpe, continúa donde se quedó. Al cerrar la ventana, Strata y el motor se
-detienen.
+### Aplicación de Terminal
 
-### Opción B: la Terminal (una línea)
+¿Prefieres la terminal? Instala Strata y ejecuta **`strata launch`**.
 
-La Terminal es el comando `strata`, pensado para scripts, servidores y agentes de IA.
+<details open>
+<summary><b>Comandos de instalación</b></summary>
 
-Linux y Mac:
+**Linux / Mac**
 
 ```sh
-curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh | sh
+curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh
 ```
 
-Windows (PowerShell):
+**Windows PowerShell**
 
 ```powershell
 irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex
 ```
 
-El script analiza tu PC, descarga la Terminal, verifica su SHA-256 y la descomprime en tu carpeta personal. No necesita
-permisos de administrador. En Windows, abre una ventana de terminal nueva después. Luego arranca Strata:
+En Windows, abre una terminal nueva después. Luego:
 
 ```sh
 strata launch
 ```
 
-Te hace una pregunta cada vez: modelo, contexto, imágenes, quién puede conectarse. Después descarga el motor para tu tarjeta
-gráfica (firmado y arrancado como prueba antes de usarlo) y el modelo, y empieza a servir. Para scripts y agentes de IA, usa
-opciones:
-
-```sh
-strata launch --model q2_0 --yes --no-tui
-```
-
-Si quieres leer el script de instalación antes de ejecutarlo, descárgalo primero con `curl -fsSL <address> -o install.sh`,
-léelo y luego ejecuta `sh install.sh`. Todas las pantallas y opciones: [docs/TERMINAL_LAUNCH.md](docs/TERMINAL_LAUNCH.md).
-
-### Opción C: que lo instale tu IA
-
-Pega esto en Claude Code, Cursor, Codex, GitHub Copilot u otro asistente de programación:
-
-```text
-Set up Strata on this PC for me: https://github.com/Niko1221/Strata - follow docs/AI_SETUP.md in that repository.
-```
-
-El asistente revisa tu tarjeta gráfica, tu RAM y tu disco, elige el modelo adecuado, lo instala y lo arranca, y te explica
-cómo conectar tus aplicaciones. Las herramientas de IA también pueden instalar, arrancar y detener Strata mediante su
-[servidor MCP](docs/MCP_SERVER.md).
-
-¿Prefieres compilarlo tú? Mira [Compilar desde el código fuente](#compilar-desde-el-código-fuente).
-
-## Modelos
-
-La aplicación y `strata launch` recomiendan un modelo según tu memoria. Es un solo modelo en varios tamaños, más o menos
-comprimido. Los tamaños pequeños son más rápidos. Los grandes son algo más inteligentes.
-
-### ¿Poca memoria? Prueba Gyro
-
-[Gyro](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF) (de agentionai) es la forma más pequeña de ejecutar este modelo.
-
-| Tamaño | Memoria que necesita (RAM + VRAM) | Descarga | Qué es |
-| --- | ---: | ---: | --- |
-| **Gyro-S** | 27,6 GB | 58,5 GB | Para PC donde no cabe nada más. La calidad es menor que la de IQ2_XS. |
-| **Gyro-M** | 35 GB | 92,0 GB | Calidad parecida a IQ3_XXS con un 20 % menos de memoria de GPU. Escribe las respuestas un 17-21 % más despacio que Q2_0 en una tarjeta de 12 GB y en una R9700. |
-
-Gyro funciona en tarjetas NVIDIA y AMD (en AMD es experimental), no en Intel Arc ni en el Mac. Detalles y mediciones:
-[docs/GYRO.md](docs/GYRO.md). Arráncalo con `strata launch --model gyro-s`.
-
-### Los demás tamaños
-
-| Tu memoria (RAM + VRAM) | Elige | Notas |
-| --- | --- | --- |
-| **32 GB** | **Gyro-S**, o el **[Coder](docs/MODELS.md#coder)** para código | El Coder necesita 32 GB de RAM y conserva la mitad de los expertos, así que es más flojo fuera del código |
-| **40 GB** | **[Swift 1.5](docs/MODELS.md#swift-15)** IQ2_XS (39,2 GB), o **Gyro-M** (35 GB) | Swift piensa menos tiempo antes de responder. Gyro-M se acerca a la calidad de IQ3_XXS, pero escribe las respuestas un 17-21 % más despacio que Q2_0 |
-| **48 GB** | **IQ3_XXS** (47,0 GB) | Más lento, mejor |
-| **64 GB** | **IQ3_S** (54,8 GB), el original o Swift 1.5 | El más lento, el mejor. Iguala al modelo completo en las pruebas publicadas |
-| **96 GB o más** | **UD-IQ4_XS** de Unsloth (unos 72 GB de RAM) hasta **Q8_0** (unos 136 GB), de 4 a 8 bits | Más cerca del modelo completo. Con menos RAM, Strata lee una parte desde el SSD, que es mucho más lento |
-
-Con menos RAM de la que indica una fila también puede funcionar: Strata pasa solo a su
-[modo de poca RAM](docs/MODELS.md#a-big-graphics-card-and-little-ram). Espera que sea más lento, y mucho más lento con una
-tarjeta gráfica pequeña.
-
-Más opciones:
-
-- **[Swift 1.5](docs/MODELS.md#swift-15)** es un ajuste fino que piensa menos tiempo antes de responder, con una calidad y un uso de RAM casi iguales.
-- **[NVFP4](docs/NVFP4.md)** es la versión de 4 bits de NVIDIA para tarjetas NVIDIA. Necesita unos 80 GB de RAM para tener todos los expertos en RAM.
-- **[Qwen3.6-35B-A3B](docs/QWEN36.md)** es un modelo más pequeño y distinto que lee imágenes y puede atender varias peticiones a la vez.
-- **[El Uncensored IQ3_XXS de OrcaRouter](docs/MODELS.md#orcarouter-uncensored-iq3_xxs)** se configura a mano.
-
-Todos los tamaños, descargas y lo que cabe en cada equipo: [docs/MODELS.md](docs/MODELS.md).
-
-## ¿Qué velocidad tiene?
-
-Medido con una tarjeta gráfica de 12 GB (RTX 5070, Ryzen 5 7600, 64 GB de RAM). Resultados con otras tarjetas:
-[velocidad de cada tamaño](docs/MODELS.md#how-fast-is-each-size), [resultados de la comunidad](docs/COMMUNITY_BENCHMARKS.md).
-
-| Modelo | Las respuestas aparecen a | Lee tu prompt a |
-| --- | --- | --- |
-| **Q2_0** | `████████████` 94 tokens/s | `████████████` 2.650 tokens/s |
-| **IQ2_XS** | `██████████░░` 79 tokens/s | `█████████░░░` 2.090 tokens/s |
-| **IQ3_XXS** | `████████░░░░` 62 tokens/s | `████████░░░░` 1.750 tokens/s |
-| **IQ3_S** | `███████░░░░░` 53 tokens/s | `███████░░░░░` 1.620 tokens/s |
-| **Coder** | `███████░░░░░` 55 tokens/s | `██████████░░` 2.180 tokens/s |
-
-Un token equivale a unos ¾ de palabra, así que 60 tokens por segundo es más rápido de lo que puedes leer. "Lee tu prompt"
-es lo rápido que Strata procesa un documento largo, código o un historial de chat.
-
-Medido con una tarjeta AMD de 16 GB (RX 9070 XT, Ryzen 9 3900X, 47 GB de RAM):
-
-| Modelo | Las respuestas aparecen a | Lee tu prompt a |
-| --- | --- | --- |
-| **Q2_0** | `████████░░░░` 60 tokens/s | `█████░░░░░░░` 1.160 tokens/s |
-| **IQ2_XS** | `███████░░░░░` 52 tokens/s | `█████░░░░░░░` 1.110 tokens/s |
-| **Coder** | `██████░░░░░░` 44 tokens/s | `██████░░░░░░` 1.420 tokens/s |
-
-Las barras usan la misma escala en las dos tablas. Una tarjeta con más VRAM es más rápida. Una RTX 3090 (24 GB) debería
-escribir unos 100-140 tokens por segundo. La versión del motor detrás de cada cifra está en [DETAILS.md](docs/DETAILS.md#speed-measured).
-
-## Uso
-
-### En la aplicación
-
-La aplicación tiene un **Chat**, un **Monitor** del modelo y de tu GPU, CPU y RAM, una página de **Modelos** y los
-**Ajustes**. El chat puede trabajar en una carpeta de tu PC. En modo **Manual** pregunta antes de cambiar un archivo o
-ejecutar un comando. Escribe `/loop 10m <what to do>` para repetir un mensaje cada 10 minutos mientras el chat esté abierto.
-
-El chat puede buscar en la web con DuckDuckGo (o Bing), sin cuenta. Puedes añadir una clave de búsqueda en **Ajustes,
-Herramientas**. La búsqueda es la única función que envía algo fuera de tu PC (las palabras que buscas).
-
-Para ejecutar dos modelos, activa **Ejecutar varios modelos** y dale a cada modelo su propia tarjeta de la misma marca.
-
-<p align="center"><img src="docs/media/runpagoda.png" width="900" alt="The Strata app's Monitor tab next to a coding agent"><br>
-<sub>El <b>Monitor</b> de la aplicación Strata (a la izquierda) mientras un agente de programación escribe el jardín de pagodas del vídeo (a la derecha)</sub></p>
-
-### En la Terminal
-
-```sh
-strata launch                                  # guided screens: model, context, pictures, access, then serve
-strata launch --model q2_0 --yes --no-tui     # no questions: serve, print the address, return
-strata launch --plan --model q2_0              # show what would happen; nothing changes
-strata launch --status                         # what is being served now
-strata launch --stop                           # stop it
-strata monitor --url http://127.0.0.1:8080     # watch speed, GPU, memory and requests
-strata update --check                          # is there a new engine? (strata update installs it)
-strata doctor                                  # check the installed engine files
-```
-
-`strata --help` lo lista todo. Arrancar y servir no descargan nada. Solo lo hacen la instalación, `strata launch` (cuando
-eliges un modelo) y `strata update`. Para llegar a Strata desde tu móvil u otro PC, usa `strata launch --access lan`. Crea
-una clave de API y no arranca en una red sin ella. No se abre ningún navegador salvo que añadas `--open`. Guía:
-[docs/TERMINAL_LAUNCH.md](docs/TERMINAL_LAUNCH.md). El cliente completo: [docs/TERMINAL.md](docs/TERMINAL.md).
-
-### Con agentes de IA
-
-Un agente instala Strata con el comando de una línea de la opción B y ejecuta
-`strata launch --model NAME --yes --no-tui`. Los pasos, las opciones y los códigos de salida están en [docs/AI_SETUP.md](docs/AI_SETUP.md),
-y las reglas del repositorio en [AGENTS.md](AGENTS.md).
-
-### Conecta tus otras aplicaciones
-
-| Tipo de aplicación | URL base |
-| --- | --- |
-| Compatible con OpenAI (la mayoría de aplicaciones y agentes) | `http://127.0.0.1:8080/v1` (cualquier clave de API, cualquier nombre de modelo) |
-| API de Anthropic (Claude Code y otros) | `http://127.0.0.1:8080`, sin `/v1`. Estas aplicaciones añaden `/v1/messages` por su cuenta. Claude Code: `ANTHROPIC_BASE_URL=http://127.0.0.1:8080` |
-| API OpenAI Responses (Codex CLI) | `http://127.0.0.1:8080/v1/responses` ([configuración](docs/DETAILS.md#the-responses-api-and-codex-cli)) |
-
-`strata connect` muestra los ajustes exactos para OpenCode, Codex CLI, Claude Code, oh-my-pi, pi, Hermes Agent y OpenClaw.
-`strata connect opencode --write` escribe el archivo después de preguntar y guarda una copia de seguridad.
-
-### Imágenes
-
-Las imágenes vienen activadas por defecto en los modelos que pueden leerlas. Adjunta o pega una imagen en el chat, o envíala
-desde tu aplicación. El lector de imágenes funciona en el procesador cuando tu tarjeta gráfica tiene menos de 24 GB (unos
-segundos por imagen, sin quitar memoria a la tarjeta) y en la tarjeta gráfica a partir de 24 GB. La regla es la misma para
-NVIDIA y AMD. Puedes desactivar las imágenes por modelo, o elegir el lector con `--vision off`, `--vision gpu` o
-`--vision cpu`.
-
-Las cifras detrás de la regla: en una Radeon AI PRO R9700, el lector de la tarjeta tardó 57 ms en una imagen de 260 tokens y
-el del procesador 3,1 s. En tarjetas de 16 GB (Tesla P100 y RTX A4000, Linux), el lector de la tarjeta costó un 3-5 % de
-velocidad en texto, porque ocupa unos 1,4 GB que de otro modo usaría el modelo. El Mac todavía no tiene lector de imágenes.
-
-### Conviene saber
-
-- Elige el nivel de razonamiento (**desactivado, bajo, medio o alto**) en el menú del chat o en "reasoning effort" de tu aplicación. Desactivado es lo más rápido.
-- Strata responde a una petición a la vez por defecto. Para varias a la vez, usa `--parallel N` en `strata launch` o
-  `"parallel": 2` en la configuración ([BATCHING.md](docs/BATCHING.md)). En una tarjeta de 12 GB, esto hace más lenta cada respuesta.
-- Strata lee entero el primer mensaje de un chat, unos 1 minuto por cada 30.000 tokens. Los mensajes siguientes empiezan en segundos.
-- Dónde se guardan tus chats y la API completa: [docs/INSTALL.md](docs/INSTALL.md#where-things-are-stored), [docs/DETAILS.md](docs/DETAILS.md#using-it).
-
-## Compilar desde el código fuente
-
-<details>
-<summary>Windows, Linux y Mac desde el repositorio</summary>
-
-[Descarga Strata](https://github.com/Niko1221/Strata/archive/refs/heads/main.zip) y descomprímelo, o haz `git clone`.
-**Windows:** haz doble clic en `START-HERE.bat`. **Linux:** ejecuta `./setup.sh` en la carpeta de Strata.
-
-**Mac (Apple Silicon, macOS 15 o posterior):** instala una vez las Command Line Tools de Apple con `xcode-select --install`
-(no hace falta Xcode). Abre la Terminal en la carpeta de Strata y ejecuta `./setup.sh`. El script compila el motor para Mac
-en tu Mac (unos 7 minutos), hace las mismas preguntas, descarga el modelo y lo arranca. La próxima vez, `./setup.sh` lo
-arranca enseguida. Qué tamaño cabe en tu Mac: [docs/MAC.md](docs/MAC.md).
-
-El instalador detecta tu tarjeta y prepara el motor adecuado. Pregunta qué modelo y qué tamaño quieres, cuánto contexto
-(cuánto texto mantiene el modelo en mente) y si debe leer imágenes. Pulsa Enter para aceptar la respuesta recomendada.
-Luego descarga el modelo (unos 70 GB) y lo arranca. Si la descarga se detiene, vuelve a ejecutar el script y continúa. Tu
-navegador abre la página de Strata en `http://127.0.0.1:8080`.
-
-> Mientras el modelo arranca, tu PC puede ir lento o dejar de responder durante 1-3 minutos (más tiempo la primera vez).
-> Strata carga 35-55 GB en tu RAM y bloquea una parte para la tarjeta gráfica. Espera y no cierres la ventana.
-
-La próxima vez, ejecuta de nuevo `START-HERE.bat` (o `./setup.sh`). Arranca enseguida y no descarga nada dos veces. Cierra
-su ventana para detener el modelo. `UPDATE.bat` (`./update.sh`) actualiza Strata sin arrancarlo. Actualización, Docker,
-varias tarjetas, dónde van los archivos y todas las opciones: [docs/INSTALL.md](docs/INSTALL.md).
-
-Para medir tu PC, ejecuta `BENCH.bat` (`./bench.sh`). Tarda 5-10 minutos y escribe un informe que puedes compartir
-([cómo](docs/COMMUNITY_BENCHMARKS.md#run-the-benchmark)).
-
-**Opcional: más velocidad en una tarjeta cuando todo el modelo cabe en la RAM.** Dos ajustes que se activan a mano, de
-RubenTorney (#1904, #1905). Ayudan cuando usas una sola tarjeta gráfica y tu RAM guarda todos los expertos, por ejemplo con
-Q2_0 o IQ3_XXS en un PC de 64 GB. Abre `strata-<model>.json` en la carpeta de datos de Strata ([dónde](docs/INSTALL.md#where-things-are-stored)) y añade:
-
-- `"--adapt-async", "1"` a la lista `"args"`. Así la caché de expertos se actualiza en un hilo auxiliar en vez de detener la
-  respuesta. Medido en una RTX 5070 (Windows, Q2_0): +4-5 % en decodificación, +7-10 % en código y documentos largos. Las
-  respuestas pueden diferir un poco de las del ajuste por defecto y son iguales de una ejecución a otra.
-- `"STRATA_PIN_BY_NEED": "1"` en el bloque `"env"` (Windows). Windows solo puede bloquear aproximadamente la mitad de la RAM
-  para la tarjeta gráfica, y este ajuste bloquea primero los expertos que la tarjeta necesita antes. Medido en la RTX 5070: +4,4 % en lectura del prompt.
-
-```json
-"args": [ ..., "--adapt-async", "1" ],
-"env": { "STRATA_PIN_BY_NEED": "1" }
-```
-
-Reinicia Strata después del cambio. Para deshacerlo, quita las dos entradas.
+Sigue las indicaciones para descargar e iniciar un modelo. [Guía del Terminal](docs/TERMINAL_LAUNCH.md).
 
 </details>
 
-## ¿Cómo funciona?
+<p align="center">
+  <img src="docs/media/terminal-monitor.png" width="900" alt="Aplicación de Terminal de Strata con la actividad del modelo, la velocidad, la memoria y las peticiones recientes">
+  <br><sub>Observa tu modelo y tu hardware mientras se ejecuta.</sub>
+</p>
 
-Los modelos como este suelen ejecutarse en servidores con cientos de gigabytes de memoria gráfica. Tu tarjeta gráfica tiene
-12-24 GB. Strata hace que el modelo quepa repartiendo el trabajo por todo tu PC. Imagina una biblioteca.
+<a id="build-from-source"></a>
 
-- El modelo es un equipo de 24.576 pequeños especialistas ("expertos"), como 24.576 libros de consulta. Cada palabra necesita solo 10 de ellos.
-- **Tu tarjeta gráfica es el escritorio.** Es pequeño y rápido. Los unos 4.000 libros que más se usan están abiertos encima.
-- **Tu RAM son las estanterías de la sala de lectura.** Los 24.576 libros están ahí. Cuando una palabra necesita un libro que
-  no está en el escritorio, tu procesador lo coge enseguida de la estantería mientras la tarjeta sigue trabajando.
-- **Tu SSD es el archivo.** Guarda una tabla de consulta de 29 GB. El modelo lee unas pocas filas por palabra, así que no
-  hace falta que esté en la RAM.
+[Compilar desde el código fuente](docs/SOURCE_INSTALL.md) · [Docker](docs/DOCKER.md) · [Guía de instalación completa](docs/INSTALL.md)
 
-<p align="center"><img src="docs/media/how-it-works.svg" width="860" alt="The model's 24,576 experts: the busiest on the graphics card, all of them in RAM, a lookup table on the SSD"></p>
+<a id="what-you-need"></a>
 
-Un pequeño ayudante también adivina las siguientes palabras. El modelo grande las comprueba todas a la vez y se queda con
-las correctas. Obtienes la misma respuesta, entre 1,6 y 1,8 veces antes. Los textos largos se leen en trozos grandes, de
-hasta 8.192 tokens a la vez, a más de 1.000 tokens por segundo.
+## Hardware
 
-<p align="center"><img src="docs/media/guess-and-check.svg" width="860" alt="A small helper guesses the next words; the big model checks them all at once and keeps the right ones"></p>
+| Hardware compatible | Guía |
+| --- | --- |
+| **NVIDIA GeForce RTX 20 / 30 / 40 / 50** | [Instalación en NVIDIA](docs/INSTALL.md#what-you-need) |
+| **AMD Radeon RX 7700 / 7800 / 7900, RX 9060 / 9070, AI PRO R9700** | [Instalación en AMD](docs/AMD_HIP.md) |
+| **AMD Radeon RX 6800 / 6900 · experimental** | [Instalación en RX 6000](docs/AMD_HIP.md#rdna2-gfx1030) |
+| **Intel Arc · Linux** | [Instalación en Intel](docs/INTEL_ARC.md) |
+| **Apple Silicon · M1 o posterior** | [Instalación en Mac](docs/MAC.md) |
+| **AMD Ryzen AI Max · Strix Halo** | [Instalación en Strix Halo](docs/STRIX_HALO.md) |
 
-La explicación más larga: [docs/HOW_IT_WORKS.md](docs/HOW_IT_WORKS.md). Cada parte con sus cifras:
-[los detalles](docs/DETAILS.md#how-it-works) y el [artículo](docs/paper/Strata-Paper.pdf).
+<a id="using-it"></a>
 
-## ¿Algo ha ido mal?
+## Herramientas
 
-- **Mi PC se congeló la primera vez que arrancó Strata.** Carga el modelo en la RAM. Espera y no cierres la ventana. ¿Sigue
-  congelado después de 10 minutos? Reinicia el PC, cierra otros programas e inténtalo de nuevo, o elige un tamaño más pequeño.
-- **Se detuvo durante la descarga o la instalación.** Abre de nuevo la aplicación o `strata launch`, o vuelve a ejecutar
-  `START-HERE.bat` (o `./setup.sh`). Continúa donde se quedó.
-- **Va muy lento, la luz del disco parpadea sin parar, o dice "the engine stopped unexpectedly".** Tu PC no tiene bastante
-  RAM libre. Cierra otros programas (los navegadores gastan mucha) o elige un tamaño más pequeño, como Q2_0 o IQ2_XS.
-- **Dice que no hay motor para este PC.** En la aplicación, abre **Ajustes, Motor** y pulsa **Actualizar motor**. En la
-  Terminal, ejecuta `strata update`. `strata doctor` muestra qué archivos del motor están instalados.
-- **Dice que el puerto 8080 ya está en uso.** Strata ya se está ejecutando. Busca su ventana.
+**Claude Code · Codex CLI · OpenCode · oh-my-pi · pi.dev · Hermes Agent · OpenClaw**, y más, mediante las API compatibles con OpenAI y Anthropic.
 
-Más problemas y soluciones: [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md). ¿Sigues atascado? Abre una
-[incidencia](https://github.com/Niko1221/Strata/issues). En la aplicación, adjunta el archivo de **Ajustes, Motor,
-Diagnóstico, Ver registros, Guardar registros**. En la Terminal, pega la salida de `strata doctor`. Si lo ejecutas desde el
-código fuente, adjunta `strata-<model>.log` de la carpeta de Strata. Para un problema de seguridad, avísanos en privado:
-[SECURITY.md](SECURITY.md).
+Ejecuta **`strata connect`** para ver las instrucciones de tu herramienta. [Guía de conexión](docs/TERMINAL_LAUNCH.md#connect-your-apps-strata-connect).
 
-## Créditos y licencia
+<a id="guides"></a>
+<a id="how-fast-is-it"></a>
+<a id="how-does-it-work"></a>
+<a id="something-went-wrong"></a>
 
-El modelo es [Qwen3.8-Flash-Next](https://huggingface.co/Qwen/Qwen3.8-Flash-Next), del equipo de Qwen. Lo comprimieron
-[ISTA-DASLab](https://huggingface.co/ISTA-DASLab/Qwen3.8-Flash-Next-GSQ-RCO-GGUF), UkisAI (Swift 1.5), agentionai (Gyro)
-y Unsloth. Strata usa partes de [llama.cpp / ggml](https://github.com/ggml-org/llama.cpp). Todos los créditos:
-[docs/HOW_IT_WORKS.md](docs/HOW_IT_WORKS.md#credits). Strata es de código abierto con la [licencia MIT](LICENSE). Algunas
-partes y todos los modelos tienen sus propias licencias ([cuáles](docs/HOW_IT_WORKS.md#license)).
+## Ayuda
 
-## Contribuir
-
-¿Has encontrado un error, o quieres enviar un cambio o un benchmark? Lee primero [CONTRIBUTING.md](CONTRIBUTING.md). Explica
-qué incluir para que otros puedan comprobar tu trabajo.
+[Todas las guías](docs) · [Solución de problemas](docs/TROUBLESHOOTING.md) · [Informar de un error](https://github.com/Niko1221/Strata/issues/new/choose) ·
+[Benchmarks](docs/COMMUNITY_BENCHMARKS.md) · [Cómo funciona](docs/HOW_IT_WORKS.md) · [Contribuir](CONTRIBUTING.md)
 
 ## Apoya Strata
 
-Strata es gratis y tiene licencia MIT. Lo construyo y lo pruebo en el hardware que consigo. Si te funciona bien en tu PC, un café me ayuda
-a seguir probando tarjetas nuevas y a arreglar lo que nos cuentas. Sin presión. Usarlo y contar lo que encuentras ayuda igual de mucho.
+**Ayuda a mantener la IA local abierta a todos.** Un café ayuda a financiar el desarrollo y las pruebas en más hardware.
 
-<a href="https://buymeacoffee.com/strataengine"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="50"></a>
+<a href="https://buymeacoffee.com/strataengine"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me a Coffee: apoya Strata" height="48"></a>
 
-¿Te interesa patrocinar Strata? Escríbeme a través de [GitHub](https://github.com/Niko1221).
+[Licencia MIT](LICENSE) · [Créditos y licencias de los modelos](docs/HOW_IT_WORKS.md#credits) · [Privacidad](docs/SAFETY.md)
+
+<a id="option-c-let-your-ai-set-it-up"></a>
+
+<sub>Para herramientas de IA y lectores automáticos: <a href="AGENTS.md">referencia técnica</a> · <a href="docs/AI_SETUP.md">instrucciones de instalación</a>.</sub>
+
+**Patrocinios, alianzas de hardware o colaboraciones:** [[email protected]](mailto:[email protected]).

README.fr.md

@@ -1,400 +1,188 @@
 <p align="center">
   <picture>
     <source media="(prefers-color-scheme: dark)" srcset="apps/host/public/brand/strata-lockup-dark.svg">
-    <img src="apps/host/public/brand/strata-lockup-light.svg" alt="Strata" width="380">
+    <img src="apps/host/public/brand/strata-lockup-light.svg" alt="Strata" width="340">
   </picture>
 </p>
 
-<p align="center"><a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.de.md">Deutsch</a> · <b>Français</b> · <a href="README.es.md">Español</a> · <a href="README.pt-BR.md">Português</a></p>
-
-<h3 align="center">Faites tourner un modèle de pointe sur votre propre PC de jeu</h3>
-
-<p align="center">Compatible avec NVIDIA, AMD, Intel · Windows, Linux, Mac · gratuit et open source</p>
+<h3 align="center">Une IA puissante sur votre propre ordinateur.</h3>
+<p align="center">Discutez, programmez et travaillez avec des images, en local.</p>
 
 <p align="center">
-  <a href="https://github.com/Niko1221/Strata/releases"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?include_prereleases&label=release" alt="Latest release"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="MIT license"></a>
-  <a href="https://github.com/Niko1221/Strata/stargazers"><img src="https://img.shields.io/github/stars/Niko1221/Strata?style=flat" alt="GitHub stars"></a>
+  <a href="#modèles">Modèles</a> · <a href="#installation"><b>Installation</b></a> ·
+  <a href="#matériel">Matériel</a> · <a href="#outils">Outils</a> ·
+  <a href="#aide">Aide</a> · <a href="#soutenir-strata">Soutenir</a>
 </p>
 
-<p align="center"><a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4"><img src="docs/media/pagoda-preview.webp" width="720" alt="A voxel pagoda garden that Strata's model wrote, running in the browser"></a><br>
-<sub>Un jardin de pagode en voxels, généré en une seule requête sur une RTX 5070 avec Strata (IQ3_S, contexte de 128K) ·
-<a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4">vidéo complète (49 s)</a></sub></p>
+<p align="center">
+  <a href="https://github.com/Niko1221/Strata/releases/latest"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?label=download&color=0ab887" alt="Télécharger Strata"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="Licence MIT"></a>
+  <a href="https://buymeacoffee.com/strataengine"><img src="https://img.shields.io/badge/Buy_me_a_coffee-FFDD00?logo=buymeacoffee&logoColor=000" alt="Soutenir Strata sur Buy Me a Coffee"></a>
+</p>
 
-Strata fait tourner **[Qwen3.8-Flash-Next](https://huggingface.co/Qwen/Qwen3.8-Flash-Next)**, un modèle de 125 milliards
-de paramètres qui demande normalement un serveur, sur un PC ordinaire. Il discute, écrit du code, lit des images et
-fonctionne avec vos applications et vos agents de code. Vos conversations et vos fichiers restent sur votre PC.
+<p align="center"><sub><a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.de.md">Deutsch</a> · <b>Français</b> · <a href="README.es.md">Español</a> · <a href="README.pt-BR.md">Português</a> · <a href="README.pl.md">Polski</a></sub></p>
 
-**Nouveau ici ?** Regardez [ce qu'il vous faut](#ce-quil-vous-faut), puis [installez l'application](#option-a--lapplication-strata).
+**Gratuit, open source, et à vous de l'exécuter.** Utilisez Strata sur votre bureau ou avec vos outils de programmation préférés. Aucun compte nécessaire.
 
-- **Tourne sur un PC de jeu.** 32 Go de RAM et de mémoire graphique réunis suffisent pour commencer.
-- **Fonctionne avec vos outils.** Il parle les API d'OpenAI et d'Anthropic, donc Claude Code, Codex CLI, OpenCode et d'autres agents peuvent s'y connecter.
-- **Lit les images.** C'est activé par défaut.
-- **Gratuit.** Licence MIT, pas de compte, pas de cloud.
-- **Privé.** Aucune télémétrie. Ce que Strata télécharge, quand il utilise internet et comment il vérifie les téléchargements est expliqué dans [docs/SAFETY.md](docs/SAFETY.md).
+## Modèles
 
-Version 0.2.0-beta · moteur 0.1.45.3
+Nous recommandons **d'abord ISTA-DASLab**, puis **Unsloth** et d'autres fournisseurs, lorsqu'un modèle compatible tient en mémoire.
 
-## Ce qu'il vous faut
+<details>
+<summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.8-Flash-Next</b></summary>
 
-**Il vous faut au moins 32 Go de RAM et de mémoire graphique (VRAM) réunis.** Sur un Mac ou un Ryzen AI Max, c'est la
-mémoire unifiée. Plus de mémoire permet un modèle plus gros ou plus rapide.
-
-- Un PC de 32 Go avec une carte de 12 à 16 Go fait tourner le Coder.
-- Avec 64 Go de RAM, toutes les tailles fonctionnent.
-
-| Votre ordinateur | Détails |
+| Fournisseur | Choix |
 | --- | --- |
-| **NVIDIA** GeForce RTX série 20, 30, 40, 50 (12 Go ou plus) | Installez l'application ou le Terminal. |
-| **AMD** Radeon RX 6800 et plus récent, Radeon AI PRO R9700 (12 Go ou plus) | [Cartes AMD](docs/AMD_HIP.md) |
-| **Intel** Arc | [Intel Arc](docs/INTEL_ARC.md), [moteur Intel](docs/INTEL.md) |
-| **Mac Apple Silicon** (M1 ou plus récent, macOS 15 ou plus récent) | [Mac](docs/MAC.md) |
-| **AMD Ryzen AI Max (Strix Halo)** et autres systèmes à mémoire unifiée | [Strix Halo](docs/STRIX_HALO.md) |
-| Cartes et processeurs plus anciens | [GPU anciens](docs/OLDER_GPUS.md), [CPU anciens](docs/INSTALL.md#older-cpus-experimental) |
+| **ISTA-DASLab · recommandé** | Q2\_0, IQ2\_XS, IQ3\_XXS, IQ3\_S. [Coder : IQ1\_M](docs/MODELS.md#coder) pour programmer. |
+| **Unsloth** | UD-IQ4\_XS, UD-Q4\_K\_XL, UD-Q5\_K\_XL, UD-Q6\_K\_XL, Q8\_0 |
+| **Gyro · agentionai** | [Gyro-S, Gyro-M](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF). Utilise moins de mémoire, mais plus lent. |
+| **Autres options** | [Swift 1.5](docs/MODELS.md#swift-15), [NVFP4](docs/NVFP4.md), [OrcaRouter](docs/ORCA.md) |
 
-Il faut aussi :
+[Comparer les tailles, la mémoire nécessaire et la compatibilité](docs/MODELS.md).
 
-- environ 80 Go d'espace disque libre (un SSD accélère beaucoup le premier démarrage)
-- Windows 10 / 11, Linux ou macOS
-- un pilote graphique récent
+</details>
 
-Deux ou trois cartes de la même marque peuvent se partager un modèle ([multi-GPU](docs/MULTI_GPU.md)). Strata ne répartit
-jamais un modèle entre des cartes NVIDIA et AMD. Liste complète : [docs/INSTALL.md](docs/INSTALL.md#what-you-need).
+<details>
+<summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.6-35B-A3B</b></summary>
+
+**Unsloth:** UD-Q4_K_XL, UD-Q6_K_XL, Q8_0. Ce sont les paquets actuellement documentés pour ce modèle.
+
+[Guide du modèle et compatibilité](docs/QWEN36.md).
+
+</details>
+
+<details>
+<summary><img src="docs/media/models/deepseek.svg" width="22" alt="" align="middle"> &nbsp;<b>DeepSeekV4.1-Flash-1017</b></summary>
+
+Dans l'**application de bureau** et dans le **Terminal**. Ce qui ne tient pas en mémoire est lu depuis votre SSD : il faut donc beaucoup d'espace disque libre.
+
+| Jeu (ISTA-DAS) | Téléchargement | Espace disque libre nécessaire |
+| --- | ---: | ---: |
+| 1.75 bpw | 239 GB | environ 245 GB |
+| 2.00 bpw | 257 GB | environ 265 GB |
+| 2.25 bpw | 274 GB | environ 280 GB |
+
+Fonctionne sur les NVIDIA RTX 30, 40 et 50 (Windows et Linux) et sur l'AMD Radeon AI PRO R9700 (Linux). L'installation télécharge les fichiers et le moteur DeepSeek, puis démarre le modèle.
+
+```sh
+strata launch --family deepseek41 --model ist-das-2.00bpw --plan
+```
+
+Mesuré avec le jeu 2.00 bpw sur Strata 0.2.5. « Sortie » est la vitesse de la réponse, « Prompt » la vitesse à laquelle Strata lit votre texte.
+
+| Matériel | Sortie | Prompt |
+| --- | ---: | ---: |
+| RTX 5070 12 GB, 64 GB de RAM | 4 à 6 tokens/s | environ 110 tokens/s (4K) |
+| RTX 3060 12 GB, 46 GB de RAM | 9 à 11 tokens/s | environ 155 tokens/s (4K) |
+| 1x Radeon AI PRO R9700, 251 GB de RAM | 21 à 25 tokens/s | 320 à 360 tokens/s (8K) |
+| 4x Radeon AI PRO R9700 | 74 à 77 tokens/s | 400 à 450 tokens/s (8K) |
+
+[Mémoire, disque et détails](docs/DEEPSEEK41.md) · [Notes de version](https://github.com/Niko1221/Strata/releases)
+
+</details>
+
+<a id="the-other-sizes"></a>
+
+Vous ne savez pas ce qui tient ? [Choisir un modèle pour votre ordinateur](docs/MODELS.md#pick-by-memory).
 
 ## Installation
 
-Choisissez une option. Elles lancent toutes le même moteur et utilisent les mêmes modèles.
+<a id="option-a-the-strata-app"></a>
 
-### Option A : l'application Strata
+### Application de bureau
 
-Le plus simple. L'application contient le moteur : installez-la, choisissez un modèle, discutez. Téléchargez le fichier
-correspondant à votre système et à votre carte graphique depuis la [page des versions](https://github.com/Niko1221/Strata/releases/latest).
-Vous ne savez pas lequel prendre ? Lisez le paragraphe sous le tableau.
+**[Télécharger Strata pour Windows, Linux ou Mac →](https://github.com/Niko1221/Strata/releases/latest)**
 
-| Système | Votre carte graphique | Fichier à télécharger |
-| --- | --- | --- |
-| **Windows 10 / 11** | NVIDIA RTX, pilote 580 ou plus récent | [`Strata-0.2.0-beta-windows-cuda13.exe`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-windows-cuda13.exe) |
-| | NVIDIA, carte plus ancienne ou pilote antérieur à 580 | [`Strata-0.2.0-beta-windows-cuda12.exe`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-windows-cuda12.exe) |
-| | AMD Radeon série RX 9000 ou Radeon AI PRO R9700 | [`Strata-0.2.0-beta-windows-hip.exe`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-windows-hip.exe) |
-| **Linux** | NVIDIA RTX, pilote 580 ou plus récent | [`Strata-0.2.0-beta-linux-nvidia-cuda13.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-nvidia-cuda13.AppImage) |
-| | NVIDIA, carte plus ancienne ou pilote antérieur à 580 | [`Strata-0.2.0-beta-linux-nvidia-cuda12.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-nvidia-cuda12.AppImage) |
-| | AMD Radeon série RX 9000 ou Radeon AI PRO R9700 | [`Strata-0.2.0-beta-linux-amd-rx9070.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-amd-rx9070.AppImage) |
-| | AMD Radeon série RX 7000 | [`Strata-0.2.0-beta-linux-amd-rx7900.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-amd-rx7900.AppImage) |
-| **Mac** (Apple Silicon, macOS 15 ou plus récent) | intégrée | [`Strata-0.2.0-beta-mac.dmg`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-mac.dmg) |
+Installez l'application, choisissez un modèle et commencez à discuter. Il y a un seul installateur par système. Au premier lancement, l'application télécharge le moteur de votre carte graphique. [Aide pour l'installateur](docs/INSTALL.md#the-app).
 
-**Si vous hésitez :** pour NVIDIA, prenez `cuda13` si la version de votre pilote est 580 ou plus récente, sinon `cuda12`.
-`cuda12` convient aux cartes plus anciennes et aux pilotes plus anciens. Les fichiers `hip` et `amd` sont pour les cartes
-AMD. Les autres cartes AMD (RX 6000, ou RX 7000 sous Windows) n'ont pas encore d'application prête à l'emploi : voir
-[Cartes AMD](docs/AMD_HIP.md).
+<sub>Fichiers: `Strata-0.2.9-windows-x64-setup.exe` · `Strata-0.2.9-linux-x86_64.AppImage` · `Strata-0.2.9-macos-arm64.dmg`</sub>
 
-Ensuite :
+<p align="center">
+  <img src="docs/media/app-chat.png" width="900" alt="Application de bureau Strata avec une discussion et un aperçu du code en direct côte à côte">
+  <br><sub>Discussion, fichiers et aperçu en direct dans une seule fenêtre.</sub>
+</p>
 
-- **Windows :** lancez le `.exe`. Il s'installe pour votre utilisateur et ne demande pas de droits d'administrateur. Si
-  Windows affiche « Windows a protégé votre ordinateur », choisissez **Informations complémentaires**, puis **Exécuter
-  quand même** (l'installateur n'est pas encore signé).
-- **Linux :** rendez le fichier exécutable (`chmod +x`) et lancez-le. Il a besoin de FUSE 2 : `sudo apt install libfuse2`
-  (Ubuntu 22.04) ou `libfuse2t64` (Ubuntu 24.04 et plus récent).
-- **Mac :** ouvrez le `.dmg` et faites glisser Strata dans Applications.
+<a id="option-b-the-terminal-one-line"></a>
 
-Sur le premier écran, l'application analyse votre PC et recommande un modèle adapté. Appuyez sur Installer. Le modèle est un
-gros téléchargement (environ 40 à 70 Go) qui reprend là où il s'est arrêté en cas d'interruption. Quand vous fermez la
-fenêtre, Strata et le moteur s'arrêtent.
+### Application Terminal
 
-### Option B : le Terminal (une ligne)
+Vous préférez le terminal ? Installez Strata, puis lancez **`strata launch`**.
 
-Le Terminal est la commande `strata`, pensée pour les scripts, les serveurs et les agents d'IA.
+<details open>
+<summary><b>Commandes d'installation</b></summary>
 
-Linux et Mac :
+**Linux / Mac**
 
 ```sh
-curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh | sh
+curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh
 ```
 
-Windows (PowerShell) :
+**Windows PowerShell**
 
 ```powershell
 irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex
 ```
 
-Le script analyse votre PC, télécharge le Terminal, vérifie son empreinte SHA-256 et le décompresse dans votre dossier
-personnel. Il ne demande pas de droits d'administrateur. Sous Windows, ouvrez ensuite une nouvelle fenêtre de terminal.
-Puis lancez Strata :
+Sous Windows, ouvrez ensuite un nouveau terminal. Puis :
 
 ```sh
 strata launch
 ```
 
-Il pose une question à la fois : modèle, contexte, images, qui peut se connecter. Ensuite il télécharge le moteur pour votre
-carte graphique (signé, et lancé à titre d'essai avant usage) ainsi que le modèle, puis commence à servir. Pour les scripts
-et les agents d'IA, utilisez des options :
-
-```sh
-strata launch --model q2_0 --yes --no-tui
-```
-
-Pour lire le script d'installation avant de l'exécuter, téléchargez-le d'abord avec `curl -fsSL <address> -o install.sh`,
-lisez-le, puis lancez `sh install.sh`. Tous les écrans et toutes les options : [docs/TERMINAL_LAUNCH.md](docs/TERMINAL_LAUNCH.md).
-
-### Option C : laissez votre IA l'installer
-
-Collez ceci dans Claude Code, Cursor, Codex, GitHub Copilot ou un autre assistant de programmation :
-
-```text
-Set up Strata on this PC for me: https://github.com/Niko1221/Strata - follow docs/AI_SETUP.md in that repository.
-```
-
-L'assistant vérifie votre carte graphique, votre RAM et votre disque, choisit le modèle adapté, l'installe, le démarre et
-vous explique comment connecter vos applications. Les outils d'IA peuvent aussi installer, démarrer et arrêter Strata via son
-[serveur MCP](docs/MCP_SERVER.md).
-
-Vous préférez le compiler vous-même ? Voir [Compiler depuis les sources](#compiler-depuis-les-sources).
-
-## Modèles
-
-L'application et `strata launch` recommandent un modèle selon votre mémoire. C'est un seul modèle en plusieurs tailles,
-plus ou moins compressé. Les petites tailles sont plus rapides. Les grandes sont un peu plus intelligentes.
-
-### Peu de mémoire ? Essayez Gyro
-
-[Gyro](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF) (par agentionai) est la façon la plus légère de faire tourner ce modèle.
-
-| Taille | Mémoire nécessaire (RAM + VRAM) | Téléchargement | Ce que c'est |
-| --- | ---: | ---: | --- |
-| **Gyro-S** | 27,6 Go | 58,5 Go | Pour les PC où rien d'autre ne tient. La qualité est inférieure à celle d'IQ2_XS. |
-| **Gyro-M** | 35 Go | 92,0 Go | À peu près la qualité d'IQ3_XXS avec environ 20 % de mémoire GPU en moins. Il écrit les réponses 17 à 21 % plus lentement que Q2_0 sur une carte de 12 Go et sur une R9700. |
-
-Gyro fonctionne sur les cartes NVIDIA et AMD (expérimental sur AMD), pas sur Intel Arc ni sur Mac. Détails et mesures :
-[docs/GYRO.md](docs/GYRO.md). Lancez-le avec `strata launch --model gyro-s`.
-
-### Les autres tailles
-
-| Votre mémoire (RAM + VRAM) | Prenez | Remarques |
-| --- | --- | --- |
-| **32 Go** | **Gyro-S**, ou le **[Coder](docs/MODELS.md#coder)** pour le code | Le Coder demande 32 Go de RAM et garde la moitié des experts, il est donc moins bon hors du code |
-| **40 Go** | **[Swift 1.5](docs/MODELS.md#swift-15)** IQ2_XS (39,2 Go), ou **Gyro-M** (35 Go) | Swift réfléchit moins longtemps avant de répondre. Gyro-M approche la qualité d'IQ3_XXS, mais il écrit les réponses 17 à 21 % plus lentement que Q2_0 |
-| **48 Go** | **IQ3_XXS** (47,0 Go) | Plus lent, meilleur |
-| **64 Go** | **IQ3_S** (54,8 Go), l'original ou Swift 1.5 | Le plus lent, le meilleur. Il égale le modèle complet dans les tests publiés |
-| **96 Go ou plus** | **UD-IQ4_XS** d'Unsloth (environ 72 Go de RAM) jusqu'à **Q8_0** (environ 136 Go), 4 à 8 bits | Plus proche du modèle complet. Avec moins de RAM, Strata lit une partie depuis le SSD, ce qui est beaucoup plus lent |
-
-Avoir moins de RAM que ce qu'indique une ligne peut encore fonctionner : Strata passe tout seul en
-[mode peu de RAM](docs/MODELS.md#a-big-graphics-card-and-little-ram). Attendez-vous à plus de lenteur, et à bien plus avec
-une petite carte graphique.
-
-Autres choix :
-
-- **[Swift 1.5](docs/MODELS.md#swift-15)** est une version affinée qui réfléchit moins longtemps avant de répondre, pour une qualité et un besoin en RAM à peu près identiques.
-- **[NVFP4](docs/NVFP4.md)** est la version 4 bits de NVIDIA pour les cartes NVIDIA. Elle demande environ 80 Go de RAM pour garder tous les experts en RAM.
-- **[Qwen3.6-35B-A3B](docs/QWEN36.md)** est un modèle plus petit et différent, qui lit les images et peut répondre à plusieurs requêtes à la fois.
-- **[L'Uncensored IQ3_XXS d'OrcaRouter](docs/MODELS.md#orcarouter-uncensored-iq3_xxs)** se configure à la main.
-
-Toutes les tailles, les téléchargements et ce qui tient où : [docs/MODELS.md](docs/MODELS.md).
-
-## Quelle est sa vitesse ?
-
-Mesuré avec une carte graphique de 12 Go (RTX 5070, Ryzen 5 7600, 64 Go de RAM). Voir les résultats d'autres cartes :
-[vitesse de chaque taille](docs/MODELS.md#how-fast-is-each-size), [résultats de la communauté](docs/COMMUNITY_BENCHMARKS.md).
-
-| Modèle | Les réponses s'affichent à | Lit votre prompt à |
-| --- | --- | --- |
-| **Q2_0** | `████████████` 94 tokens/s | `████████████` 2 650 tokens/s |
-| **IQ2_XS** | `██████████░░` 79 tokens/s | `█████████░░░` 2 090 tokens/s |
-| **IQ3_XXS** | `████████░░░░` 62 tokens/s | `████████░░░░` 1 750 tokens/s |
-| **IQ3_S** | `███████░░░░░` 53 tokens/s | `███████░░░░░` 1 620 tokens/s |
-| **Coder** | `███████░░░░░` 55 tokens/s | `██████████░░` 2 180 tokens/s |
-
-Un token vaut environ ¾ de mot, donc 60 tokens par seconde, c'est plus rapide que votre lecture. « Lit votre prompt »
-indique la vitesse à laquelle Strata absorbe un long document, du code ou un historique de discussion.
-
-Mesuré avec une carte AMD de 16 Go (RX 9070 XT, Ryzen 9 3900X, 47 Go de RAM) :
-
-| Modèle | Les réponses s'affichent à | Lit votre prompt à |
-| --- | --- | --- |
-| **Q2_0** | `████████░░░░` 60 tokens/s | `█████░░░░░░░` 1 160 tokens/s |
-| **IQ2_XS** | `███████░░░░░` 52 tokens/s | `█████░░░░░░░` 1 110 tokens/s |
-| **Coder** | `██████░░░░░░` 44 tokens/s | `██████░░░░░░` 1 420 tokens/s |
-
-Les barres utilisent la même échelle dans les deux tableaux. Une carte avec plus de VRAM est plus rapide. Une RTX 3090
-(24 Go) devrait écrire environ 100 à 140 tokens par seconde. La version du moteur derrière chaque chiffre est indiquée dans
-[DETAILS.md](docs/DETAILS.md#speed-measured).
-
-## Utilisation
-
-### Dans l'application
-
-L'application comprend un **Chat**, un **Monitor** du modèle, de votre GPU, de votre CPU et de votre RAM, une page **Models** et les **Settings**. Le chat peut travailler dans un dossier de votre PC. En mode **Manual**, il demande
-avant de modifier un fichier ou d'exécuter une commande. Tapez `/loop 10m <what to do>` pour répéter un message toutes les
-10 minutes tant que le chat est ouvert.
-
-Le chat peut chercher sur le web avec DuckDuckGo (ou Bing), sans compte. Vous pouvez ajouter une clé de recherche sous
-**Settings, Tools**. La recherche est la seule fonction qui envoie quelque chose hors de votre PC (les mots recherchés).
-
-Pour faire tourner deux modèles, activez **Run multiple models** (exécuter plusieurs modèles) et donnez à chacun sa propre carte de la même marque.
-
-<p align="center"><img src="docs/media/runpagoda.png" width="900" alt="The Strata app's Monitor tab next to a coding agent"><br>
-<sub>Le <b>Monitor</b> de l'application Strata (à gauche) pendant qu'un agent de code écrit le jardin de pagode de la vidéo (à droite)</sub></p>
-
-### Dans le Terminal
-
-```sh
-strata launch                                  # guided screens: model, context, pictures, access, then serve
-strata launch --model q2_0 --yes --no-tui     # no questions: serve, print the address, return
-strata launch --plan --model q2_0              # show what would happen; nothing changes
-strata launch --status                         # what is being served now
-strata launch --stop                           # stop it
-strata monitor --url http://127.0.0.1:8080     # watch speed, GPU, memory and requests
-strata update --check                          # is there a new engine? (strata update installs it)
-strata doctor                                  # check the installed engine files
-```
-
-`strata --help` liste tout. Démarrer et servir ne téléchargent rien. Seuls l'installation, `strata launch` (quand vous
-choisissez un modèle) et `strata update` le font. Pour joindre Strata depuis votre téléphone ou un autre PC, utilisez
-`strata launch --access lan`. La commande crée une clé d'API et refuse de démarrer sur un réseau sans elle. Aucun
-navigateur ne s'ouvre, sauf si vous ajoutez `--open`. Guide : [docs/TERMINAL_LAUNCH.md](docs/TERMINAL_LAUNCH.md). Le client complet : [docs/TERMINAL.md](docs/TERMINAL.md).
-
-### Avec des agents d'IA
-
-Un agent installe Strata avec la commande en une ligne de l'option B et lance
-`strata launch --model NAME --yes --no-tui`. Les étapes, les options et les codes de sortie sont dans [docs/AI_SETUP.md](docs/AI_SETUP.md),
-et les règles du dépôt dans [AGENTS.md](AGENTS.md).
-
-### Connecter vos autres applications
-
-| Type d'application | URL de base |
-| --- | --- |
-| Compatible OpenAI (la plupart des applications et des agents) | `http://127.0.0.1:8080/v1` (n'importe quelle clé d'API, n'importe quel nom de modèle) |
-| API Anthropic (Claude Code et d'autres) | `http://127.0.0.1:8080`, sans `/v1`. Ces applications ajoutent `/v1/messages` elles-mêmes. Claude Code : `ANTHROPIC_BASE_URL=http://127.0.0.1:8080` |
-| API OpenAI Responses (Codex CLI) | `http://127.0.0.1:8080/v1/responses` ([configuration](docs/DETAILS.md#the-responses-api-and-codex-cli)) |
-
-`strata connect` affiche les réglages exacts pour OpenCode, Codex CLI, Claude Code, oh-my-pi, pi, Hermes Agent et OpenClaw.
-`strata connect opencode --write` écrit le fichier après confirmation et garde une sauvegarde.
-
-### Images
-
-Les images sont activées par défaut pour les modèles qui savent les lire. Joignez ou collez une image dans le chat, ou
-envoyez-la depuis votre application. Le lecteur d'images tourne sur le processeur quand votre carte graphique a moins de
-24 Go (quelques secondes par image, sans prendre de mémoire à la carte) et sur la carte graphique à partir de 24 Go. La
-règle est la même pour NVIDIA et AMD. Vous pouvez désactiver les images par modèle, ou choisir le lecteur avec
-`--vision off`, `--vision gpu` ou `--vision cpu`.
-
-Les chiffres derrière la règle : sur une Radeon AI PRO R9700, le lecteur de la carte a pris 57 ms pour une image de
-260 tokens et celui du processeur 3,1 s. Sur des cartes de 16 Go (Tesla P100 et RTX A4000, Linux), le lecteur de la carte
-a coûté 3 à 5 % de vitesse sur le texte, parce qu'il occupe environ 1,4 Go que le modèle utiliserait sinon. Le Mac n'a pas
-encore de lecteur d'images.
-
-### Bon à savoir
-
-- Choisissez le niveau de réflexion (**désactivé, faible, moyen ou élevé**) dans le menu du chat ou dans le réglage « reasoning effort » de votre application. Désactivé est le plus rapide.
-- Strata répond à une requête à la fois par défaut. Pour en traiter plusieurs en même temps, utilisez `--parallel N` dans `strata launch` ou
-  `"parallel": 2` dans la configuration ([BATCHING.md](docs/BATCHING.md)). Sur une carte de 12 Go, chaque réponse devient alors plus lente.
-- Strata lit en entier le premier message d'une discussion, soit environ 1 minute pour 30 000 tokens. Les messages suivants démarrent en quelques secondes.
-- Où sont stockées vos discussions et l'API complète : [docs/INSTALL.md](docs/INSTALL.md#where-things-are-stored), [docs/DETAILS.md](docs/DETAILS.md#using-it).
-
-## Compiler depuis les sources
-
-<details>
-<summary>Windows, Linux et Mac depuis le dépôt</summary>
-
-[Téléchargez Strata](https://github.com/Niko1221/Strata/archive/refs/heads/main.zip) et décompressez-le, ou faites un `git clone`.
-**Windows :** double-cliquez sur `START-HERE.bat`. **Linux :** lancez `./setup.sh` dans le dossier Strata.
-
-**Mac (Apple Silicon, macOS 15 ou plus récent) :** installez une fois les Command Line Tools d'Apple avec `xcode-select --install`
-(Xcode lui-même n'est pas nécessaire). Ouvrez le Terminal dans le dossier Strata et lancez `./setup.sh`. Le script compile
-le moteur Mac sur votre Mac (environ 7 minutes), pose les mêmes questions, télécharge le modèle et le démarre. La fois
-suivante, `./setup.sh` le démarre tout de suite. Quelle taille convient à votre Mac : [docs/MAC.md](docs/MAC.md).
-
-L'installateur détecte votre carte et prépare le bon moteur. Il demande quel modèle et quelle taille, combien de contexte
-(la quantité de texte que le modèle garde en tête) et s'il doit lire les images. Appuyez sur Entrée pour la réponse
-recommandée. Puis il télécharge le modèle (environ 70 Go) et le démarre. Si le téléchargement s'arrête, relancez le script
-et il reprend. Votre navigateur ouvre la page de Strata à l'adresse `http://127.0.0.1:8080`.
-
-> Pendant le démarrage du modèle, votre PC peut être lent ou ne plus répondre pendant 1 à 3 minutes (le plus longtemps la
-> première fois). Strata charge 35 à 55 Go dans votre RAM et en verrouille une partie pour la carte graphique. Patientez et
-> ne fermez pas la fenêtre.
-
-La fois suivante, relancez `START-HERE.bat` (ou `./setup.sh`). Il démarre tout de suite et ne télécharge rien deux fois.
-Fermez sa fenêtre pour arrêter le modèle. `UPDATE.bat` (`./update.sh`) met Strata à jour sans le démarrer. Mise à jour,
-Docker, plusieurs cartes, où vont les fichiers et toutes les options : [docs/INSTALL.md](docs/INSTALL.md).
-
-Pour mesurer votre PC, lancez `BENCH.bat` (`./bench.sh`). Cela prend 5 à 10 minutes et produit un rapport que vous pouvez
-partager ([comment](docs/COMMUNITY_BENCHMARKS.md#run-the-benchmark)).
-
-**Facultatif : plus de vitesse sur une carte quand tout le modèle tient en RAM.** Deux réglages à activer soi-même, par
-RubenTorney (#1904, #1905). Ils aident quand vous utilisez une seule carte graphique et que votre RAM contient tous les
-experts, par exemple Q2_0 ou IQ3_XXS sur un PC de 64 Go. Ouvrez `strata-<model>.json` dans le dossier de données de Strata ([où](docs/INSTALL.md#where-things-are-stored)) et ajoutez :
-
-- `"--adapt-async", "1"` à la liste `"args"`. Le cache des experts se met alors à jour sur un thread auxiliaire au lieu de
-  mettre la réponse en pause. Mesuré sur une RTX 5070 (Windows, Q2_0) : +4 à 5 % en décodage, +7 à 10 % sur le code et les
-  longs documents. Les réponses peuvent différer légèrement de celles du réglage par défaut, et restent identiques d'une exécution à l'autre.
-- `"STRATA_PIN_BY_NEED": "1"` dans le bloc `"env"` (Windows). Windows ne peut verrouiller qu'environ la moitié de la RAM
-  pour la carte graphique, et ce réglage verrouille d'abord les experts dont la carte a le plus besoin. Mesuré sur la RTX 5070 : +4,4 % en lecture du prompt.
-
-```json
-"args": [ ..., "--adapt-async", "1" ],
-"env": { "STRATA_PIN_BY_NEED": "1" }
-```
-
-Redémarrez Strata après la modification. Pour annuler, supprimez les deux entrées.
+Suivez les invites pour télécharger et démarrer un modèle. [Guide du Terminal](docs/TERMINAL_LAUNCH.md).
 
 </details>
 
-## Comment ça marche ?
+<p align="center">
+  <img src="docs/media/terminal-monitor.png" width="900" alt="Application Terminal de Strata affichant l'activité du modèle, la vitesse, la mémoire et les requêtes récentes">
+  <br><sub>Suivez votre modèle et votre matériel pendant qu'il tourne.</sub>
+</p>
 
-Les modèles de ce genre tournent d'habitude sur des serveurs qui disposent de centaines de gigaoctets de mémoire graphique.
-Votre carte graphique en a 12 à 24. Strata fait tenir le modèle en répartissant le travail sur tout votre PC. Imaginez une
-bibliothèque.
+<a id="build-from-source"></a>
 
-- Le modèle est une équipe de 24 576 petits spécialistes (les « experts »), comme 24 576 ouvrages de référence. Chaque mot n'en demande que 10.
-- **Votre carte graphique est le bureau.** Il est petit et rapide. Les quelque 4 000 livres les plus utilisés y sont ouverts.
-- **Votre RAM, ce sont les étagères de la salle de lecture.** Les 24 576 livres s'y trouvent. Quand un mot demande un livre
-  qui n'est pas sur le bureau, votre processeur va le chercher aussitôt sur l'étagère, pendant que la carte continue de travailler.
-- **Votre SSD, ce sont les archives.** Il contient une table de consultation de 29 Go. Le modèle n'en lit que quelques lignes par
-  mot, elle n'a donc pas besoin de tenir en RAM.
+[Compiler depuis les sources](docs/SOURCE_INSTALL.md) · [Docker](docs/DOCKER.md) · [Guide d'installation complet](docs/INSTALL.md)
 
-<p align="center"><img src="docs/media/how-it-works.svg" width="860" alt="The model's 24,576 experts: the busiest on the graphics card, all of them in RAM, a lookup table on the SSD"></p>
+<a id="what-you-need"></a>
 
-Un petit assistant devine aussi les mots suivants. Le grand modèle les vérifie tous d'un coup et garde les bons. Vous
-obtenez la même réponse, 1,6 à 1,8 fois plus tôt. Les textes longs sont lus par gros morceaux, jusqu'à 8 192 tokens à la
-fois, à plus de 1 000 tokens par seconde.
+## Matériel
 
-<p align="center"><img src="docs/media/guess-and-check.svg" width="860" alt="A small helper guesses the next words; the big model checks them all at once and keeps the right ones"></p>
+| Matériel pris en charge | Guide |
+| --- | --- |
+| **NVIDIA GeForce RTX 20 / 30 / 40 / 50** | [Installation NVIDIA](docs/INSTALL.md#what-you-need) |
+| **AMD Radeon RX 7700 / 7800 / 7900, RX 9060 / 9070, AI PRO R9700** | [Installation AMD](docs/AMD_HIP.md) |
+| **AMD Radeon RX 6800 / 6900 · expérimental** | [Installation RX 6000](docs/AMD_HIP.md#rdna2-gfx1030) |
+| **Intel Arc · Linux** | [Installation Intel](docs/INTEL_ARC.md) |
+| **Apple Silicon · M1 ou plus récent** | [Installation sur Mac](docs/MAC.md) |
+| **AMD Ryzen AI Max · Strix Halo** | [Installation Strix Halo](docs/STRIX_HALO.md) |
 
-L'explication plus longue : [docs/HOW_IT_WORKS.md](docs/HOW_IT_WORKS.md). Chaque élément avec ses chiffres :
-[les détails](docs/DETAILS.md#how-it-works) et l'[article](docs/paper/Strata-Paper.pdf).
+<a id="using-it"></a>
 
-## Un problème ?
+## Outils
 
-- **Mon PC s'est figé au premier démarrage de Strata.** Il charge le modèle en RAM. Patientez et ne fermez pas la fenêtre.
-  Toujours figé après 10 minutes ? Redémarrez le PC, fermez les autres programmes et réessayez, ou choisissez une taille plus petite.
-- **Ça s'est arrêté pendant le téléchargement ou l'installation.** Relancez l'application ou `strata launch`, ou relancez
-  `START-HERE.bat` (ou `./setup.sh`). Cela reprend là où ça s'était arrêté.
-- **C'est très lent, le voyant du disque clignote sans arrêt, ou il affiche « the engine stopped unexpectedly ».** Votre PC
-  n'a pas assez de RAM libre. Fermez d'autres programmes (les navigateurs en consomment beaucoup) ou choisissez une taille plus petite, comme Q2_0 ou IQ2_XS.
-- **Il indique qu'il n'y a pas de moteur pour ce PC.** Dans l'application, ouvrez **Settings, Engine** et appuyez sur **Update engine** (mettre à jour le moteur). Dans le Terminal, lancez `strata update`. `strata doctor` montre quels fichiers du moteur sont installés.
-- **Il indique que le port 8080 est déjà utilisé.** Strata tourne déjà. Cherchez sa fenêtre.
+**Claude Code · Codex CLI · OpenCode · oh-my-pi · pi.dev · Hermes Agent · OpenClaw**, et d'autres via les API compatibles OpenAI et Anthropic.
 
-Autres problèmes et solutions : [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md). Toujours bloqué ? Ouvrez une
-[issue](https://github.com/Niko1221/Strata/issues). Dans l'application, joignez le fichier obtenu par **Settings, Engine, Diagnostics, View logs, Save logs**. Dans le Terminal, collez la sortie de `strata doctor`. Si
-vous avez lancé depuis les sources, joignez `strata-<model>.log` du dossier Strata. Pour un problème de sécurité,
-signalez-le en privé : [SECURITY.md](SECURITY.md).
+Lancez **`strata connect`** pour voir la configuration de votre outil. [Guide de connexion](docs/TERMINAL_LAUNCH.md#connect-your-apps-strata-connect).
 
-## Remerciements et licence
+<a id="guides"></a>
+<a id="how-fast-is-it"></a>
+<a id="how-does-it-work"></a>
+<a id="something-went-wrong"></a>
 
-Le modèle est [Qwen3.8-Flash-Next](https://huggingface.co/Qwen/Qwen3.8-Flash-Next), de l'équipe Qwen. Il a été compressé par
-[ISTA-DASLab](https://huggingface.co/ISTA-DASLab/Qwen3.8-Flash-Next-GSQ-RCO-GGUF), UkisAI (Swift 1.5), agentionai (Gyro)
-et Unsloth. Strata utilise des parties de [llama.cpp / ggml](https://github.com/ggml-org/llama.cpp). Tous les
-remerciements : [docs/HOW_IT_WORKS.md](docs/HOW_IT_WORKS.md#credits). Strata est open source sous [licence MIT](LICENSE).
-Quelques parties et tous les modèles ont leurs propres licences ([lesquelles](docs/HOW_IT_WORKS.md#license)).
+## Aide
 
-## Contribuer
-
-Vous avez trouvé un bug, ou vous voulez proposer une modification ou un benchmark ? Lisez d'abord [CONTRIBUTING.md](CONTRIBUTING.md).
-Il indique ce qu'il faut inclure pour que d'autres puissent vérifier votre travail.
+[Tous les guides](docs) · [Dépannage](docs/TROUBLESHOOTING.md) · [Signaler un bogue](https://github.com/Niko1221/Strata/issues/new/choose) ·
+[Benchmarks](docs/COMMUNITY_BENCHMARKS.md) · [Comment ça marche](docs/HOW_IT_WORKS.md) · [Contribuer](CONTRIBUTING.md)
 
 ## Soutenir Strata
 
-Strata est gratuit et sous licence MIT. Je le construis et je le teste sur le matériel que je peux obtenir. S'il tourne bien sur votre PC, un café m'aide
-à continuer de tester de nouvelles cartes et à corriger ce que vous signalez. Aucune obligation. L'utiliser et signaler ce que vous constatez aide tout autant.
+**Aidez à garder l'IA locale ouverte à tous.** Un café aide à financer le développement et les tests sur davantage de matériel.
 
-<a href="https://buymeacoffee.com/strataengine"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="50"></a>
+<a href="https://buymeacoffee.com/strataengine"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me a Coffee : soutenir Strata" height="48"></a>
 
-Vous souhaitez sponsoriser Strata ? Contactez-moi via [GitHub](https://github.com/Niko1221).
+[Licence MIT](LICENSE) · [Crédits et licences des modèles](docs/HOW_IT_WORKS.md#credits) · [Confidentialité](docs/SAFETY.md)
+
+<a id="option-c-let-your-ai-set-it-up"></a>
+
+<sub>Pour les outils d'IA et les lecteurs automatiques : <a href="AGENTS.md">référence technique</a> · <a href="docs/AI_SETUP.md">instructions d'installation</a>.</sub>
+
+**Parrainages, partenariats matériel ou collaborations :** [[email protected]](mailto:[email protected]).

README.ja.md

@@ -1,380 +1,188 @@
 <p align="center">
   <picture>
     <source media="(prefers-color-scheme: dark)" srcset="apps/host/public/brand/strata-lockup-dark.svg">
-    <img src="apps/host/public/brand/strata-lockup-light.svg" alt="Strata" width="380">
+    <img src="apps/host/public/brand/strata-lockup-light.svg" alt="Strata" width="340">
   </picture>
 </p>
 
-<p align="center"><a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <b>日本語</b> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.es.md">Español</a> · <a href="README.pt-BR.md">Português</a></p>
-
-<h3 align="center">最先端のモデルを、手元のゲーミングPCで動かす</h3>
-
-<p align="center">NVIDIA、AMD、Intel に対応 · Windows、Linux、Mac · 無料のオープンソース</p>
+<h3 align="center">あなた自身のパソコンで、高性能な AI を。</h3>
+<p align="center">チャット、コーディング、画像の処理を、すべてローカルで。</p>
 
 <p align="center">
-  <a href="https://github.com/Niko1221/Strata/releases"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?include_prereleases&label=release" alt="Latest release"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="MIT license"></a>
-  <a href="https://github.com/Niko1221/Strata/stargazers"><img src="https://img.shields.io/github/stars/Niko1221/Strata?style=flat" alt="GitHub stars"></a>
+  <a href="#モデル">モデル</a> · <a href="#インストール"><b>インストール</b></a> ·
+  <a href="#ハードウェア">ハードウェア</a> · <a href="#ツール">ツール</a> ·
+  <a href="#ヘルプ">ヘルプ</a> · <a href="#strata-を支援する">支援</a>
 </p>
 
-<p align="center"><a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4"><img src="docs/media/pagoda-preview.webp" width="720" alt="A voxel pagoda garden that Strata's model wrote, running in the browser"></a><br>
-<sub>ボクセルの塔の庭園。1回のプロンプトで生成し、RTX 5070 上の Strata で動かしています（IQ3_S、128K コンテキスト） ·
-<a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4">動画全体（49秒）</a></sub></p>
+<p align="center">
+  <a href="https://github.com/Niko1221/Strata/releases/latest"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?label=download&color=0ab887" alt="Strata をダウンロード"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="MIT ライセンス"></a>
+  <a href="https://buymeacoffee.com/strataengine"><img src="https://img.shields.io/badge/Buy_me_a_coffee-FFDD00?logo=buymeacoffee&logoColor=000" alt="Buy Me a Coffee で Strata を支援する"></a>
+</p>
 
-Strata は **[Qwen3.8-Flash-Next](https://huggingface.co/Qwen/Qwen3.8-Flash-Next)** を動かします。1250億パラメータのモデルで、
-ふつうはサーバーが必要ですが、Strata なら一般的なPCで使えます。チャット、コード作成、画像の読み取りができ、
-お使いのアプリやコーディングエージェントとも連携します。チャットとファイルはPCの外に出ません。
+<p align="center"><sub><a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <b>日本語</b> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.es.md">Español</a> · <a href="README.pt-BR.md">Português</a> · <a href="README.pl.md">Polski</a></sub></p>
 
-**はじめての方へ。** まず[必要な環境](#必要な環境)を確認して、[アプリをインストール](#方法a-strata-アプリ)してください。
+**無料でオープンソース。自分の環境で動かせます。** デスクトップで、またはお好みのコーディングツールと一緒に Strata を使えます。アカウントは不要です。
 
-- **ゲーミングPCで動きます。** RAMとグラフィックスメモリの合計が32 GBあれば始められます。
-- **お使いのツールと連携します。** OpenAI と Anthropic の API に対応しているので、Claude Code、Codex CLI、OpenCode などのエージェントから接続できます。
-- **画像を読めます。** 初期設定でオンです。
-- **無料です。** MIT ライセンス。アカウントもクラウドも不要です。
-- **プライバシーを守ります。** テレメトリはありません。Strata が何をダウンロードするか、いつインターネットを使うか、ダウンロードをどう検証するかは [docs/SAFETY.md](docs/SAFETY.md) に書いてあります。
+## モデル
 
-バージョン 0.2.0-beta · エンジン 0.1.45.3
+まず **ISTA-DASLab** をおすすめします。次に **Unsloth** などの提供元です。メモリに収まる互換モデルがある場合に選べます。
 
-## 必要な環境
+<details>
+<summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.8-Flash-Next</b></summary>
 
-**RAMとグラフィックスメモリ（VRAM）の合計が、少なくとも32 GB必要です。** MacやRyzen AI Maxでは、ユニファイドメモリがその量にあたります。
-メモリが多いほど、大きなモデルを使えたり、速く動いたりします。
-
-- RAM 32 GBのPCに12〜16 GBのグラフィックスカードがあれば、Coder が動きます。
-- RAM 64 GBなら、どのサイズも動きます。
-
-| お使いのPC | 詳細 |
+| 提供元 | 選択肢 |
 | --- | --- |
-| **NVIDIA** GeForce RTX 20、30、40、50 シリーズ（12 GB以上） | アプリまたはターミナル版をインストールしてください。 |
-| **AMD** Radeon RX 6800 以降、Radeon AI PRO R9700（12 GB以上） | [AMD のカード](docs/AMD_HIP.md) |
-| **Intel** Arc | [Intel Arc](docs/INTEL_ARC.md)、[Intel エンジン](docs/INTEL.md) |
-| **Apple Silicon の Mac**（M1 以降、macOS 15 以降） | [Mac](docs/MAC.md) |
-| **AMD Ryzen AI Max（Strix Halo）** などのユニファイドメモリ搭載機 | [Strix Halo](docs/STRIX_HALO.md) |
-| 古いカードやプロセッサ | [古いGPU](docs/OLDER_GPUS.md)、[古いCPU](docs/INSTALL.md#older-cpus-experimental) |
+| **ISTA-DASLab · おすすめ** | Q2\_0, IQ2\_XS, IQ3\_XXS, IQ3\_S。[Coder: IQ1\_M](docs/MODELS.md#coder)（コーディング向け）。 |
+| **Unsloth** | UD-IQ4\_XS, UD-Q4\_K\_XL, UD-Q5\_K\_XL, UD-Q6\_K\_XL, Q8\_0 |
+| **Gyro · agentionai** | [Gyro-S, Gyro-M](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF)。メモリ使用量は少ないですが、動作は遅くなります。 |
+| **その他の選択肢** | [Swift 1.5](docs/MODELS.md#swift-15), [NVFP4](docs/NVFP4.md), [OrcaRouter](docs/ORCA.md) |
 
-そのほかに必要なもの:
+[サイズ、必要なメモリ、互換性を比べる](docs/MODELS.md)。
 
-- 約80 GBの空きディスク容量（SSDなら初回の起動がずっと速くなります）
-- Windows 10 / 11、Linux、または macOS
-- 最新のグラフィックスドライバー
+</details>
 
-同じメーカーのカードを2〜3枚使って、1つのモデルを動かせます（[マルチGPU](docs/MULTI_GPU.md)）。NVIDIA と AMD のカードにまたがってモデルを分けることはありません。
-一覧は [docs/INSTALL.md](docs/INSTALL.md#what-you-need) にあります。
+<details>
+<summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.6-35B-A3B</b></summary>
+
+**Unsloth:** UD-Q4_K_XL, UD-Q6_K_XL, Q8_0。現在、このモデルで文書化されているパックです。
+
+[モデルガイドと互換性](docs/QWEN36.md)。
+
+</details>
+
+<details>
+<summary><img src="docs/media/models/deepseek.svg" width="22" alt="" align="middle"> &nbsp;<b>DeepSeekV4.1-Flash-1017</b></summary>
+
+**デスクトップアプリ**と**ターミナル**で使えます。メモリに収まらない分は SSD から読み込むため、空きディスク容量がたくさん必要です。
+
+| セット（ISTA-DAS） | ダウンロード | 必要な空き容量 |
+| --- | ---: | ---: |
+| 1.75 bpw | 239 GB | 約245 GB |
+| 2.00 bpw | 257 GB | 約265 GB |
+| 2.25 bpw | 274 GB | 約280 GB |
+
+NVIDIA RTX 30・40・50 シリーズ（Windows と Linux）と、AMD Radeon AI PRO R9700（Linux）で動きます。セットアップがファイルと DeepSeek エンジンをダウンロードし、モデルを起動します。
+
+```sh
+strata launch --family deepseek41 --model ist-das-2.00bpw --plan
+```
+
+Strata 0.2.5 で 2.00 bpw のセットを使って測定しました。「出力」は回答の速さ、「プロンプト」は Strata が入力を読み込む速さです。
+
+| ハードウェア | 出力 | プロンプト |
+| --- | ---: | ---: |
+| RTX 5070 12 GB, 64 GB RAM | 4〜6 トークン/秒 | 約 110 トークン/秒 (4K) |
+| RTX 3060 12 GB, 46 GB RAM | 9〜11 トークン/秒 | 約 155 トークン/秒 (4K) |
+| 1x Radeon AI PRO R9700, 251 GB RAM | 21〜25 トークン/秒 | 320〜360 トークン/秒 (8K) |
+| 4x Radeon AI PRO R9700 | 74〜77 トークン/秒 | 400〜450 トークン/秒 (8K) |
+
+[メモリ、ディスク、詳細](docs/DEEPSEEK41.md) · [リリースノート](https://github.com/Niko1221/Strata/releases)
+
+</details>
+
+<a id="the-other-sizes"></a>
+
+どれが動くかわからない場合は、[お使いのパソコンに合うモデルを選ぶ](docs/MODELS.md#pick-by-memory)。
 
 ## インストール
 
-3つの方法から1つ選んでください。どれも同じエンジンを起動し、同じモデルを使います。
+<a id="option-a-the-strata-app"></a>
 
-### 方法A: Strata アプリ
+### デスクトップアプリ
 
-いちばん簡単な方法です。エンジンはアプリに入っているので、インストールしてモデルを選べばチャットを始められます。お使いのOSとグラフィックスカードに合うファイルを
-[リリースページ](https://github.com/Niko1221/Strata/releases/latest)からダウンロードしてください。どれか分からない場合は、表の下の説明を見てください。
+**[Windows、Linux、Mac 用の Strata をダウンロード →](https://github.com/Niko1221/Strata/releases/latest)**
 
-| OS | グラフィックスカード | ダウンロードするファイル |
-| --- | --- | --- |
-| **Windows 10 / 11** | NVIDIA RTX、ドライバー 580 以降 | [`Strata-0.2.0-beta-windows-cuda13.exe`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-windows-cuda13.exe) |
-| | NVIDIA、古いカード、またはドライバーが 580 より古い場合 | [`Strata-0.2.0-beta-windows-cuda12.exe`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-windows-cuda12.exe) |
-| | AMD Radeon RX 9000 シリーズまたは Radeon AI PRO R9700 | [`Strata-0.2.0-beta-windows-hip.exe`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-windows-hip.exe) |
-| **Linux** | NVIDIA RTX、ドライバー 580 以降 | [`Strata-0.2.0-beta-linux-nvidia-cuda13.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-nvidia-cuda13.AppImage) |
-| | NVIDIA、古いカード、またはドライバーが 580 より古い場合 | [`Strata-0.2.0-beta-linux-nvidia-cuda12.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-nvidia-cuda12.AppImage) |
-| | AMD Radeon RX 9000 シリーズまたは Radeon AI PRO R9700 | [`Strata-0.2.0-beta-linux-amd-rx9070.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-amd-rx9070.AppImage) |
-| | AMD Radeon RX 7000 シリーズ | [`Strata-0.2.0-beta-linux-amd-rx7900.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-amd-rx7900.AppImage) |
-| **Mac**（Apple Silicon、macOS 15 以降） | 内蔵 | [`Strata-0.2.0-beta-mac.dmg`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-mac.dmg) |
+アプリをインストールし、モデルを選んで、チャットを始めましょう。インストーラーはシステムごとに1つです。初回起動時に、アプリがお使いのグラフィックスカード用のエンジンをダウンロードします。[インストーラーのヘルプ](docs/INSTALL.md#the-app)。
 
-**迷ったときは:** NVIDIA の場合、ドライバーがバージョン 580 以降なら `cuda13`、それより古ければ `cuda12` を選びます。`cuda12` は古いカードと古いドライバー向けです。
-`hip` と `amd` のファイルは AMD のカード用です。それ以外の AMD カード（RX 6000、または Windows の RX 7000）には、まだ用意されたアプリがありません。
-[AMD のカード](docs/AMD_HIP.md)を見てください。
+<sub>ファイル: `Strata-0.2.9-windows-x64-setup.exe` · `Strata-0.2.9-linux-x86_64.AppImage` · `Strata-0.2.9-macos-arm64.dmg`</sub>
 
-そのあとの手順:
+<p align="center">
+  <img src="docs/media/app-chat.png" width="900" alt="チャットとライブのコードプレビューを並べて表示した Strata デスクトップアプリ">
+  <br><sub>チャット、ファイル、ライブプレビューを1つのウィンドウで。</sub>
+</p>
 
-- **Windows:** `.exe` を実行します。ユーザー単位でインストールされ、管理者権限は不要です。「Windows によってPCが保護されました」と表示されたら、
-  **詳細情報**を選び、**実行**を選んでください（インストーラーにはまだコード署名がありません）。
-- **Linux:** ファイルを実行可能にして（`chmod +x`）起動します。FUSE 2 が必要です。`sudo apt install libfuse2`（Ubuntu 22.04）
-  または `libfuse2t64`（Ubuntu 24.04 以降）を実行してください。
-- **Mac:** `.dmg` を開き、Strata を「アプリケーション」にドラッグします。
+<a id="option-b-the-terminal-one-line"></a>
 
-最初の画面で、アプリがPCを調べて合うモデルをすすめます。インストールを押してください。モデルは大きく（約40〜70 GB）、中断しても続きからダウンロードできます。
-ウィンドウを閉じると、Strata とエンジンが止まります。
+### ターミナルアプリ
 
-### 方法B: ターミナル（1行）
+ターミナルのほうが好みですか？ Strata をインストールして、**`strata launch`** を実行します。
 
-ターミナル版は `strata` コマンドです。スクリプトやサーバー、AI エージェント向けです。
+<details open>
+<summary><b>インストールコマンド</b></summary>
 
-Linux と Mac:
+**Linux / Mac**
 
 ```sh
-curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh | sh
+curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh
 ```
 
-Windows（PowerShell）:
+**Windows PowerShell**
 
 ```powershell
 irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex
 ```
 
-スクリプトはPCを調べ、ターミナル版をダウンロードし、SHA-256 を検証して、ホームフォルダに展開します。管理者権限は不要です。Windows では、終わったら
-新しいターミナルを開いてください。そのあと Strata を起動します。
+Windows では、インストール後に新しいターミナルを開きます。そのあと:
 
 ```sh
 strata launch
 ```
 
-質問は1つずつ表示されます。モデル、コンテキスト、画像、接続を許可する相手の順です。そのあと、お使いのグラフィックスカード用のエンジン
-（署名付きで、使う前にテスト起動します）とモデルをダウンロードして、サーバーを開始します。スクリプトや AI エージェントからは、フラグを使います。
-
-```sh
-strata launch --model q2_0 --yes --no-tui
-```
-
-実行前にインストールスクリプトを読みたい場合は、先に `curl -fsSL <address> -o install.sh` でダウンロードし、内容を確認してから
-`sh install.sh` を実行してください。すべての画面とフラグは [docs/TERMINAL_LAUNCH.md](docs/TERMINAL_LAUNCH.md) にあります。
-
-### 方法C: AI にセットアップを任せる
-
-Claude Code、Cursor、Codex、GitHub Copilot などのコーディングアシスタントに、次の文を貼り付けます。
-
-```text
-Set up Strata on this PC for me: https://github.com/Niko1221/Strata - follow docs/AI_SETUP.md in that repository.
-```
-
-AI はグラフィックスカード、RAM、ディスクを調べ、合うモデルを選んで、インストールと起動をし、アプリの接続方法を教えてくれます。
-AI ツールは [MCP サーバー](docs/MCP_SERVER.md)を通じて、Strata のインストール、起動、停止もできます。
-
-自分でビルドしたい方は[ソースからビルド](#ソースからビルド)を見てください。
-
-## モデル
-
-アプリと `strata launch` は、メモリ量に合うモデルをすすめます。モデルは1つで、圧縮の度合いが違う複数のサイズがあります。
-小さいサイズは速く、大きいサイズは少し賢くなります。
-
-### メモリが少ないなら Gyro
-
-[Gyro](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF)（agentionai 製）は、このモデルをいちばん小さく動かせる方法です。
-
-| サイズ | 必要なメモリ（RAM + VRAM） | ダウンロード | 内容 |
-| --- | ---: | ---: | --- |
-| **Gyro-S** | 27.6 GB | 58.5 GB | ほかのサイズが入らないPC向け。品質は IQ2_XS より下がります。 |
-| **Gyro-M** | 35 GB | 92.0 GB | 品質は IQ3_XXS 程度で、GPUメモリの使用量は約20%少なくなります。12 GBのカードと R9700 では、回答の書き出しが Q2_0 より17〜21%遅くなります。 |
-
-Gyro は NVIDIA と AMD のカードで動きます（AMD は実験的）。Intel Arc と Mac では動きません。詳細と測定結果は
-[docs/GYRO.md](docs/GYRO.md) にあります。`strata launch --model gyro-s` で起動します。
-
-### ほかのサイズ
-
-| メモリ（RAM + VRAM） | 選ぶモデル | 備考 |
-| --- | --- | --- |
-| **32 GB** | **Gyro-S**、またはコード向けの **[Coder](docs/MODELS.md#coder)** | Coder はRAM 32 GBが必要で、エキスパートを半分だけ保持するため、コード以外は弱くなります |
-| **40 GB** | **[Swift 1.5](docs/MODELS.md#swift-15)** IQ2_XS（39.2 GB）、または **Gyro-M**（35 GB） | Swift は答える前に考える時間が短くなります。Gyro-M は品質が IQ3_XXS に近いものの、回答の書き出しは Q2_0 より17〜21%遅くなります |
-| **48 GB** | **IQ3_XXS**（47.0 GB） | 遅くなりますが、品質は上がります |
-| **64 GB** | **IQ3_S**（54.8 GB）、オリジナルまたは Swift 1.5 | いちばん遅く、いちばん高品質です。公開されているテストでは完全版と同等です |
-| **96 GB 以上** | Unsloth の **UD-IQ4_XS**（RAM 約72 GB）から **Q8_0**（約136 GB）まで、4〜8ビット | 完全版に近づきます。RAM が足りないと、Strata は一部を SSD から読むため、ずっと遅くなります |
-
-表の行より RAM が少なくても動くことがあります。Strata は自動で[低RAMモード](docs/MODELS.md#a-big-graphics-card-and-little-ram)に切り替わります。
-速度は落ち、グラフィックスカードが小さいとさらに大きく落ちます。
-
-そのほかの選択肢:
-
-- **[Swift 1.5](docs/MODELS.md#swift-15)** はファインチューン版で、答える前に考える時間が短くなります。品質と RAM の必要量はほぼ同じです。
-- **[NVFP4](docs/NVFP4.md)** は NVIDIA カード向けの NVIDIA 製4ビット版です。すべてのエキスパートを RAM に置くには、約80 GBの RAM が必要です。
-- **[Qwen3.6-35B-A3B](docs/QWEN36.md)** は、より小さい別のモデルです。画像を読め、複数のリクエストに同時に答えられます。
-- **[OrcaRouter の Uncensored IQ3_XXS](docs/MODELS.md#orcarouter-uncensored-iq3_xxs)** は手動で設定します。
-
-すべてのサイズ、ダウンロード、どの構成で何が動くかは [docs/MODELS.md](docs/MODELS.md) にあります。
-
-## どのくらい速い？
-
-12 GBのグラフィックスカード（RTX 5070、Ryzen 5 7600、RAM 64 GB）での数値です。ほかのカードの結果は
-[各モデルの速度](docs/MODELS.md#how-fast-is-each-size)、[コミュニティの結果](docs/COMMUNITY_BENCHMARKS.md)を見てください。
-
-| モデル | 回答が出る速さ | プロンプトを読む速さ |
-| --- | --- | --- |
-| **Q2_0** | `████████████` 94 tokens/s | `████████████` 2,650 tokens/s |
-| **IQ2_XS** | `██████████░░` 79 tokens/s | `█████████░░░` 2,090 tokens/s |
-| **IQ3_XXS** | `████████░░░░` 62 tokens/s | `████████░░░░` 1,750 tokens/s |
-| **IQ3_S** | `███████░░░░░` 53 tokens/s | `███████░░░░░` 1,620 tokens/s |
-| **Coder** | `███████░░░░░` 55 tokens/s | `██████████░░` 2,180 tokens/s |
-
-1トークンは英単語の約¾にあたるので、毎秒60トークンは読む速さより速くなります。「プロンプトを読む速さ」は、長い文書やコード、チャット履歴を Strata が取り込む速さです。
-
-16 GBの AMD カード（RX 9070 XT、Ryzen 9 3900X、RAM 47 GB）での測定値:
-
-| モデル | 回答が出る速さ | プロンプトを読む速さ |
-| --- | --- | --- |
-| **Q2_0** | `████████░░░░` 60 tokens/s | `█████░░░░░░░` 1,160 tokens/s |
-| **IQ2_XS** | `███████░░░░░` 52 tokens/s | `█████░░░░░░░` 1,110 tokens/s |
-| **Coder** | `██████░░░░░░` 44 tokens/s | `██████░░░░░░` 1,420 tokens/s |
-
-バーは2つの表で同じ目盛りです。VRAM が多いカードほど速くなり、RTX 3090（24 GB）なら毎秒100〜140トークンほどになるはずです。各数値のエンジンのバージョンは
-[DETAILS.md](docs/DETAILS.md#speed-measured) にあります。
-
-## 使い方
-
-### アプリで
-
-アプリには、**チャット**、モデルとGPU・CPU・RAMの状態を見る**モニター**、**モデル**ページ、**設定**があります。チャットはPC上のフォルダで作業できます。
-**手動**モードでは、ファイルを変更したりコマンドを実行したりする前に確認します。`/loop 10m <やること>` と入力すると、チャットを開いている間、メッセージを10分ごとに繰り返し送ります。
-
-チャットは DuckDuckGo（または Bing）でウェブ検索ができ、アカウントは不要です。**設定、ツール**で検索キーを追加することもできます。
-検索は、PCの外に何かを送る唯一の機能で、送られるのは検索語です。
-
-2つのモデルを動かすには、**複数のモデルを実行**をオンにして、それぞれのモデルに同じメーカーのカードを1枚ずつ割り当てます。
-
-<p align="center"><img src="docs/media/runpagoda.png" width="900" alt="The Strata app's Monitor tab next to a coding agent"><br>
-<sub>Strata アプリの<b>モニター</b>（左）と、動画の塔の庭園をコーディングエージェントが書いているところ（右）</sub></p>
-
-### ターミナルで
-
-```sh
-strata launch                                  # ガイド付きの画面: モデル、コンテキスト、画像、アクセス、そして開始
-strata launch --model q2_0 --yes --no-tui     # 質問なし: 開始し、アドレスを表示して戻る
-strata launch --plan --model q2_0              # 実行内容を表示するだけで、何も変更しない
-strata launch --status                         # 今、何が動いているか
-strata launch --stop                           # 停止する
-strata monitor --url http://127.0.0.1:8080     # 速度、GPU、メモリ、リクエストを見る
-strata update --check                          # 新しいエンジンがあるか確認（strata update でインストール）
-strata doctor                                  # インストール済みのエンジンファイルを調べる
-```
-
-`strata --help` ですべてのコマンドを確認できます。起動とサーバーの稼働では、何もダウンロードしません。ダウンロードするのは、インストール、
-`strata launch`（モデルを選んだとき）、`strata update` だけです。スマートフォンや別のPCから Strata に接続するには、
-`strata launch --access lan` を使います。API キーが作られ、キーがない状態ではネットワーク上で起動しません。`--open` を付けない限り、ブラウザは開きません。
-ガイド: [docs/TERMINAL_LAUNCH.md](docs/TERMINAL_LAUNCH.md)。クライアント全体: [docs/TERMINAL.md](docs/TERMINAL.md)。
-
-### AI エージェントと使う
-
-エージェントは、方法Bの1行コマンドで Strata をインストールし、
-`strata launch --model NAME --yes --no-tui` を実行します。手順、フラグ、終了コードは [docs/AI_SETUP.md](docs/AI_SETUP.md) に、
-リポジトリのルールは [AGENTS.md](AGENTS.md) にあります。
-
-### ほかのアプリをつなぐ
-
-| アプリの種類 | ベース URL |
-| --- | --- |
-| OpenAI 互換（ほとんどのアプリとエージェント） | `http://127.0.0.1:8080/v1`（API キーもモデル名も何でも可） |
-| Anthropic API（Claude Code など） | `http://127.0.0.1:8080`、`/v1` は付けません。これらのアプリは `/v1/messages` を自分で付けます。Claude Code: `ANTHROPIC_BASE_URL=http://127.0.0.1:8080` |
-| OpenAI Responses API（Codex CLI） | `http://127.0.0.1:8080/v1/responses`（[設定方法](docs/DETAILS.md#the-responses-api-and-codex-cli)） |
-
-`strata connect` は、OpenCode、Codex CLI、Claude Code、oh-my-pi、pi、Hermes Agent、OpenClaw の正確な設定を表示します。
-`strata connect opencode --write` は、確認したうえでファイルを書き込み、バックアップを残します。
-
-### 画像
-
-画像を読めるモデルでは、画像は初期設定でオンです。チャットに画像を添付または貼り付けるか、アプリから送ってください。
-グラフィックスカードが24 GB未満のときは、画像リーダーがプロセッサで動きます（画像1枚につき数秒、カードのメモリは使いません）。24 GB以上のときはグラフィックスカードで動きます。
-このルールは NVIDIA と AMD で同じです。画像はモデルごとにオフにでき、`--vision off`、`--vision gpu`、`--vision cpu` でリーダーを選べます。
-
-このルールの根拠となる数値です。Radeon AI PRO R9700 では、カードのリーダーは260トークンの画像に57 ms、プロセッサのリーダーは3.1秒かかりました。
-16 GBのカード（Tesla P100 と RTX A4000、Linux）では、カードのリーダーを使うとテキストの速度が3〜5%下がりました。
-本来モデルが使う約1.4 GBをリーダーが占めるためです。Mac にはまだ画像リーダーがありません。
-
-### 知っておくと便利なこと
-
-- 思考のレベル（**off、low、medium、high**）は、チャットのメニューか、お使いのアプリの「reasoning effort」で選びます。off がいちばん速くなります。
-- Strata は初期設定では、一度に1つのリクエストに答えます。同時に複数処理するには、`strata launch` で `--parallel N` を使うか、設定に
-  `"parallel": 2` を書きます（[BATCHING.md](docs/BATCHING.md)）。12 GBのカードでは、1つずつの回答が遅くなります。
-- Strata はチャットの最初のメッセージを全文読みます。30,000トークンあたり約1分かかります。続きのメッセージは数秒で始まります。
-- チャットの保存場所と API 全体: [docs/INSTALL.md](docs/INSTALL.md#where-things-are-stored)、[docs/DETAILS.md](docs/DETAILS.md#using-it)。
-
-## ソースからビルド
-
-<details>
-<summary>リポジトリから Windows、Linux、Mac 用にビルドする</summary>
-
-[Strata をダウンロード](https://github.com/Niko1221/Strata/archive/refs/heads/main.zip)して展開するか、`git clone` します。
-**Windows:** `START-HERE.bat` をダブルクリックします。**Linux:** Strata フォルダで `./setup.sh` を実行します。
-
-**Mac（Apple Silicon、macOS 15 以降）:** 最初に一度、`xcode-select --install` で Apple のコマンドラインツールをインストールします
-（Xcode 本体は不要です）。Strata フォルダでターミナルを開き、`./setup.sh` を実行します。Mac 用エンジンをお使いの Mac 上でビルドし
-（約7分）、同じ質問をして、モデルをダウンロードし、起動します。2回目以降は `./setup.sh` ですぐに起動します。
-お使いの Mac に合うサイズは [docs/MAC.md](docs/MAC.md) を見てください。
-
-インストーラーはカードを見つけて、合うエンジンを設定します。どのモデルとサイズにするか、コンテキストをどれだけにするか（モデルが一度に覚えておけるテキストの量）、
-画像を読ませるかを聞かれます。おすすめの答えでよければ Enter を押します。そのあとモデル（約70 GB）をダウンロードして起動します。
-ダウンロードが止まったら、もう一度実行すると続きから再開します。ブラウザで `http://127.0.0.1:8080` の Strata ページが開きます。
-
-> モデルの起動中は、PCが1〜3分ほど（初回がいちばん長い）遅くなったり、応答しなくなったりすることがあります。Strata は35〜55 GBをRAMに読み込み、
-> その一部をグラフィックスカード用に固定するためです。ウィンドウを閉じずに待ってください。
-
-次回からは `START-HERE.bat`（または `./setup.sh`）をもう一度実行するだけです。すぐに起動し、同じものを2回ダウンロードすることはありません。ウィンドウを閉じるとモデルが止まります。
-`UPDATE.bat`（`./update.sh`）は、起動せずに Strata を更新します。更新、Docker、複数のカード、ファイルの保存先、すべてのオプションは
-[docs/INSTALL.md](docs/INSTALL.md) にあります。
-
-PCの性能を測るには、`BENCH.bat`（`./bench.sh`）を実行します。5〜10分かかり、共有できるレポートが作られます
-（[方法](docs/COMMUNITY_BENCHMARKS.md#run-the-benchmark)）。
-
-**オプション: モデル全体がRAMに入るとき、1枚のカードをさらに速くする。** RubenTorney による、自分でオンにする2つの設定です（#1904、#1905）。
-グラフィックスカードが1枚で、RAM がすべてのエキスパートを保持できるときに効果があります。たとえば64 GBのPCでの Q2_0 や IQ3_XXS です。
-Strata のデータフォルダにある `strata-<model>.json`（[場所](docs/INSTALL.md#where-things-are-stored)）を開いて、次を追加します。
-
-- `"args"` のリストに `"--adapt-async", "1"` を追加します。エキスパートキャッシュが、回答を止めずに補助スレッドで更新されます。
-  RTX 5070（Windows、Q2_0）での測定: デコードが4〜5%、コードや長い文書では7〜10%速くなりました。回答は初期設定と少し違うことがありますが、実行ごとの結果は変わりません。
-- `"env"` ブロックに `"STRATA_PIN_BY_NEED": "1"` を追加します（Windows）。Windows ではグラフィックスカード用に固定できる RAM が半分ほどしかありません。
-  この設定は、カードが最初に必要とするエキスパートを優先して固定します。RTX 5070 での測定: プロンプトの読み取りが4.4%速くなりました。
-
-```json
-"args": [ ..., "--adapt-async", "1" ],
-"env": { "STRATA_PIN_BY_NEED": "1" }
-```
-
-変更したら Strata を再起動してください。元に戻すには、2つの項目を削除します。
+画面の案内に従って、モデルをダウンロードして起動します。[ターミナルガイド](docs/TERMINAL_LAUNCH.md)。
 
 </details>
 
-## 仕組み
+<p align="center">
+  <img src="docs/media/terminal-monitor.png" width="900" alt="モデルの動作、速度、メモリ、最近のリクエストを表示する Strata ターミナルアプリ">
+  <br><sub>動作中のモデルとハードウェアの状態を確認できます。</sub>
+</p>
 
-このようなモデルは、ふつう数百GBのグラフィックスメモリを持つサーバーで動きます。お使いのグラフィックスカードは12〜24 GBです。Strata は、PC全体で作業を分担して、モデルを収めます。
-図書館にたとえてみます。
+<a id="build-from-source"></a>
 
-- モデルは、24,576人の小さな専門家（「エキスパート」）からなるチームです。24,576冊の参考書のようなものです。1つの単語に必要なのは、そのうち10冊だけです。
-- **グラフィックスカードは机です。** 小さくて速く、最もよく使う約4,000冊が開いて置いてあります。
-- **RAM は閲覧室の書棚です。** 24,576冊すべてがここにあります。単語に必要な本が机になければ、プロセッサがすぐに書棚から読み、その間もカードは作業を続けます。
-- **SSD は書庫です。** 29 GBの参照テーブルがしまってあります。モデルは単語ごとにその数行だけを読むので、RAM に置いておく必要はありません。
+[ソースからビルド](docs/SOURCE_INSTALL.md) · [Docker](docs/DOCKER.md) · [インストールガイド（全文）](docs/INSTALL.md)
 
-<p align="center"><img src="docs/media/how-it-works.svg" width="860" alt="The model's 24,576 experts: the busiest on the graphics card, all of them in RAM, a lookup table on the SSD"></p>
+<a id="what-you-need"></a>
 
-小さな助手が、次の数単語も予想します。大きなモデルがそれをまとめて確認し、正しいものだけを残します。答えは同じで、1.6〜1.8倍早く返ります。
-長い文章は、一度に最大8,192トークンの大きな塊で、毎秒1,000トークンを超える速さで読みます。
+## ハードウェア
 
-<p align="center"><img src="docs/media/guess-and-check.svg" width="860" alt="A small helper guesses the next words; the big model checks them all at once and keeps the right ones"></p>
+| 対応ハードウェア | ガイド |
+| --- | --- |
+| **NVIDIA GeForce RTX 20 / 30 / 40 / 50 シリーズ** | [NVIDIA のセットアップ](docs/INSTALL.md#what-you-need) |
+| **AMD Radeon RX 7700 / 7800 / 7900、RX 9060 / 9070、AI PRO R9700** | [AMD のセットアップ](docs/AMD_HIP.md) |
+| **AMD Radeon RX 6800 / 6900 · 試験的** | [RX 6000 のセットアップ](docs/AMD_HIP.md#rdna2-gfx1030) |
+| **Intel Arc · Linux** | [Intel のセットアップ](docs/INTEL_ARC.md) |
+| **Apple Silicon · M1 以降** | [Mac のセットアップ](docs/MAC.md) |
+| **AMD Ryzen AI Max · Strix Halo** | [Strix Halo のセットアップ](docs/STRIX_HALO.md) |
 
-詳しい説明は [docs/HOW_IT_WORKS.md](docs/HOW_IT_WORKS.md) にあります。各部分と数値は
-[詳細](docs/DETAILS.md#how-it-works)と[論文](docs/paper/Strata-Paper.pdf)を見てください。
+<a id="using-it"></a>
 
-## うまくいかないとき
+## ツール
 
-- **Strata を初めて起動したときに、PCが固まりました。** モデルを RAM に読み込んでいます。ウィンドウを閉じずに待ってください。10分たっても固まったままなら、
-  PCを再起動し、ほかのプログラムを閉じてからもう一度試すか、小さいサイズを選んでください。
-- **ダウンロードやインストールの途中で止まりました。** アプリか `strata launch` をもう一度起動するか、`START-HERE.bat`（または
-  `./setup.sh`）をもう一度実行してください。止まったところから再開します。
-- **とても遅い、ディスクのランプが点滅し続ける、または「エンジンが予期せず停止しました」と表示される。** PCの空き RAM が足りません。
-  ほかのプログラムを閉じるか（ブラウザはメモリを多く使います）、Q2_0 や IQ2_XS のような小さいサイズを選んでください。
-- **このPCに合うエンジンがないと表示される。** アプリでは、**設定、エンジン**を開いて**エンジンを更新**を押します。ターミナルでは
-  `strata update` を実行します。`strata doctor` で、どのエンジンファイルがインストールされているか分かります。
-- **ポート 8080 はすでに使われていると表示される。** Strata がすでに動いています。ウィンドウを探してください。
+**Claude Code · Codex CLI · OpenCode · oh-my-pi · pi.dev · Hermes Agent · OpenClaw**。OpenAI 互換と Anthropic 互換の API を通じて、ほかのツールも使えます。
 
-そのほかの問題と対処法は [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) にあります。それでも解決しない場合は、
-[issue](https://github.com/Niko1221/Strata/issues) を作成してください。アプリでは、**設定、エンジン、診断、ログを見る、ログを保存**で作られるファイルを添付します。
-ターミナルでは、`strata doctor` の出力を貼り付けます。ソースから動かしている場合は、Strata フォルダの `strata-<model>.log` を添付してください。
-セキュリティ上の問題は、非公開で報告してください: [SECURITY.md](SECURITY.md)。
+**`strata connect`** を実行すると、お使いのツールの設定方法が表示されます。[接続ガイド](docs/TERMINAL_LAUNCH.md#connect-your-apps-strata-connect)。
 
-## クレジットとライセンス
+<a id="guides"></a>
+<a id="how-fast-is-it"></a>
+<a id="how-does-it-work"></a>
+<a id="something-went-wrong"></a>
 
-モデルは Qwen チームの [Qwen3.8-Flash-Next](https://huggingface.co/Qwen/Qwen3.8-Flash-Next) です。圧縮は
-[ISTA-DASLab](https://huggingface.co/ISTA-DASLab/Qwen3.8-Flash-Next-GSQ-RCO-GGUF)、UkisAI（Swift 1.5）、agentionai（Gyro）、
-Unsloth が行いました。Strata は [llama.cpp / ggml](https://github.com/ggml-org/llama.cpp) の一部を使っています。すべてのクレジットは
-[docs/HOW_IT_WORKS.md](docs/HOW_IT_WORKS.md#credits) にあります。Strata は [MIT ライセンス](LICENSE)のオープンソースです。一部のコンポーネントと
-すべてのモデルには、それぞれのライセンスがあります（[該当するもの](docs/HOW_IT_WORKS.md#license)）。
+## ヘルプ
 
-## コントリビューション
+[すべてのガイド](docs) · [トラブルシューティング](docs/TROUBLESHOOTING.md) · [不具合を報告](https://github.com/Niko1221/Strata/issues/new/choose) ·
+[ベンチマーク](docs/COMMUNITY_BENCHMARKS.md) · [仕組み](docs/HOW_IT_WORKS.md) · [貢献する](CONTRIBUTING.md)
 
-バグを見つけた、変更やベンチマークを送りたい、という方は、先に [CONTRIBUTING.md](CONTRIBUTING.md) を読んでください。
-ほかの人があなたの成果を確認できるように、何を書くべきかが説明してあります。
+## Strata を支援する
 
-## Strata を応援する
+**ローカル AI をみんなに開かれたものに。** コーヒー1杯が、開発と、より多くのハードウェアでのテストの支えになります。
 
-Strata は無料で、MIT ライセンスです。私が入手できるハードウェアで開発とテストをしています。お使いのPCで快適に動いたなら、コーヒー1杯分の支援は、
-新しいカードのテストと、報告いただいた不具合の修正を続ける助けになります。無理のない範囲で大丈夫です。使って、気づいたことを報告してもらえるだけでも同じように助かります。
+<a href="https://buymeacoffee.com/strataengine"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me a Coffee: Strata を支援する" height="48"></a>
 
-<a href="https://buymeacoffee.com/strataengine"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="50"></a>
+[MIT ライセンス](LICENSE) · [クレジットとモデルのライセンス](docs/HOW_IT_WORKS.md#credits) · [プライバシー](docs/SAFETY.md)
 
-Strata のスポンサーに関心がある方は、[GitHub](https://github.com/Niko1221) から連絡してください。
+<a id="option-c-let-your-ai-set-it-up"></a>
+
+<sub>AI ツールと自動リーダー向け: <a href="AGENTS.md">技術リファレンス</a> · <a href="docs/AI_SETUP.md">セットアップ手順</a></sub>
+
+**スポンサー、ハードウェア提携、共同開発のご相談:** [[email protected]](mailto:[email protected]).

README.md

@@ -1,390 +1,195 @@
 <p align="center">
   <picture>
     <source media="(prefers-color-scheme: dark)" srcset="apps/host/public/brand/strata-lockup-dark.svg">
-    <img src="apps/host/public/brand/strata-lockup-light.svg" alt="Strata" width="380">
+    <img src="apps/host/public/brand/strata-lockup-light.svg" alt="Strata" width="340">
   </picture>
 </p>
 
-<p align="center"><b>English</b> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.es.md">Español</a> · <a href="README.pt-BR.md">Português</a></p>
-
-<h3 align="center">Run a state-of-the-art model on your own gaming PC</h3>
-
-<p align="center">Support for NVIDIA, AMD, Intel · Windows, Linux, Mac · free and open source</p>
+<h3 align="center">Run powerful AI on your own computer.</h3>
+<p align="center">Chat, code and work with images, locally.</p>
 
 <p align="center">
-  <a href="https://github.com/Niko1221/Strata/releases"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?include_prereleases&label=release" alt="Latest release"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="MIT license"></a>
-  <a href="https://github.com/Niko1221/Strata/stargazers"><img src="https://img.shields.io/github/stars/Niko1221/Strata?style=flat" alt="GitHub stars"></a>
+  <a href="#models">Models</a> · <a href="#install"><b>Install</b></a> ·
+  <a href="#hardware">Hardware</a> · <a href="#tools">Tools</a> ·
+  <a href="#help">Help</a> · <a href="#support-strata">Support</a>
 </p>
 
-<p align="center"><a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4"><img src="docs/media/pagoda-preview.webp" width="720" alt="A voxel pagoda garden that Strata's model wrote, running in the browser"></a><br>
-<sub>A voxel pagoda garden, 1 shot prompt running on an RTX 5070 with Strata (IQ3_S, 128K context) ·
-<a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4">full video (49 s)</a></sub></p>
+<p align="center">
+  <a href="https://github.com/Niko1221/Strata/releases/latest"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?label=download&color=0ab887" alt="Download Strata"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="MIT license"></a>
+  <a href="https://buymeacoffee.com/strataengine"><img src="https://img.shields.io/badge/Buy_me_a_coffee-FFDD00?logo=buymeacoffee&logoColor=000" alt="Support Strata on Buy Me a Coffee"></a>
+</p>
 
-Strata runs **[Qwen3.8-Flash-Next](https://huggingface.co/Qwen/Qwen3.8-Flash-Next)**, a 125-billion-parameter model that
-normally needs a server, on a normal PC. It chats, writes code, reads pictures and works with your apps and coding
-agents. Your chats and files stay on your PC.
+<p align="center"><sub><b>English</b> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.es.md">Español</a> · <a href="README.pt-BR.md">Português</a> · <a href="README.pl.md">Polski</a></sub></p>
 
-**New here?** Check [what you need](#what-you-need), then [install the app](#option-a-the-strata-app).
+**Free, open source, and yours to run.** Use Strata on your desktop or with your favorite coding tools. No account needed.
 
-- **Runs on a gaming PC.** 32 GB of RAM and graphics memory together is enough to start.
-- **Works with your tools.** It speaks the OpenAI and Anthropic APIs, so Claude Code, Codex CLI, OpenCode and other agents connect to it.
-- **Reads pictures.** They are on by default.
-- **Free.** MIT license, no account, no cloud.
-- **Private.** No telemetry. What Strata downloads, when it uses the internet and how it checks downloads is in [docs/SAFETY.md](docs/SAFETY.md).
+## Models
 
-Version 0.2.0-beta · engine 0.1.45.3
+We recommend **ISTA-DASLab first**, then **Unsloth** and other providers, where a compatible model fits.
 
-## What you need
+<details>
+<summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.8-Flash-Next</b></summary>
 
-**You need at least 32 GB of RAM and graphics memory (VRAM) together.** On a Mac or a Ryzen AI Max, that is the unified
-memory. More memory gives a bigger model or a faster one.
-
-- A 32 GB PC with a 12-16 GB card runs the Coder.
-- 64 GB of RAM runs every size.
-
-| Your computer | Details |
+| Provider | Choices |
 | --- | --- |
-| **NVIDIA** GeForce RTX 20, 30, 40, 50 series (12 GB or more) | Install the app or the Terminal. |
-| **AMD** Radeon RX 6800 and newer, Radeon AI PRO R9700 (12 GB or more) | [AMD cards](docs/AMD_HIP.md) |
-| **Intel** Arc | [Intel Arc](docs/INTEL_ARC.md), [Intel engine](docs/INTEL.md) |
-| **Apple Silicon Mac** (M1 or newer, macOS 15 or newer) | [Mac](docs/MAC.md) |
-| **AMD Ryzen AI Max (Strix Halo)** and other unified-memory systems | [Strix Halo](docs/STRIX_HALO.md) |
-| Older cards and processors | [Older GPUs](docs/OLDER_GPUS.md), [Older CPUs](docs/INSTALL.md#older-cpus-experimental) |
+| **ISTA-DASLab · recommended** | Q2\_0, IQ2\_XS, IQ3\_XXS, IQ3\_S. [Coder: IQ1\_M](docs/MODELS.md#coder) for coding. |
+| **Unsloth** | UD-IQ4\_XS, UD-Q4\_K\_XL, UD-Q5\_K\_XL, UD-Q6\_K\_XL, Q8\_0 |
+| **Gyro · agentionai** | [Gyro-S, Gyro-M](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF). Lower memory use but slower. |
+| **Other options** | [Swift 1.5](docs/MODELS.md#swift-15), [NVFP4](docs/NVFP4.md), [OrcaRouter](docs/ORCA.md) |
 
-Also needed:
+[Compare sizes, memory needs and compatibility](docs/MODELS.md).
 
-- about 80 GB of free disk (an SSD makes the first start much faster)
-- Windows 10 / 11, Linux or macOS
-- a current graphics driver
+</details>
 
-Two or three cards of the same make can share a model ([multi-GPU](docs/MULTI_GPU.md)). Strata never splits a model across
-NVIDIA and AMD cards. Full list: [docs/INSTALL.md](docs/INSTALL.md#what-you-need).
+<details>
+<summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.6-35B-A3B</b></summary>
+
+**Unsloth:** UD-Q4_K_XL, UD-Q6_K_XL, Q8_0. These are the currently documented packs for this model.
+
+[Model guide and compatibility](docs/QWEN36.md).
+
+</details>
+
+<details>
+<summary><img src="docs/media/models/deepseek.svg" width="22" alt="" align="middle"> &nbsp;<b>DeepSeekV4.1-Flash-1017</b></summary>
+
+In the **desktop app** and the **Terminal**. What does not fit in memory is read from your SSD, so it needs a lot of free
+disk space.
+
+| Set (ISTA-DAS) | Download | Free disk needed |
+| --- | ---: | ---: |
+| 1.75 bpw | 239 GB | about 245 GB |
+| 2.00 bpw | 257 GB | about 265 GB |
+| 2.25 bpw | 274 GB | about 280 GB |
+| ISTA-DAS Coder (half of the experts removed) | 191 GB | about 197 GB |
+
+Runs on NVIDIA RTX 30, 40 and 50 series (Windows and Linux), AMD Radeon AI PRO R9700 (Linux), AMD Ryzen AI Max — Strix Halo
+(Windows), and Apple Silicon Macs with 64 GB or more, text only ([Mac](docs/DEEPSEEK_MAC.md)). Setup downloads the files and the DeepSeek engine, then starts the model.
+
+```sh
+strata launch --family deepseek41 --model ist-das-2.00bpw --plan
+```
+
+Measured with the 2.00 bpw set on Strata 0.2.5 (Strix Halo: 0.2.7). Output is the speed of the answer, prompt is how fast Strata reads your input.
+
+| Hardware | Output | Prompt |
+| --- | ---: | ---: |
+| RTX 5070 12 GB, 64 GB RAM | 4 to 6 tokens/s | about 110 tokens/s (4K) |
+| RTX 3060 12 GB, 46 GB RAM | 9 to 11 tokens/s | about 155 tokens/s (4K) |
+| 1x Radeon AI PRO R9700, 251 GB RAM | 21 to 25 tokens/s | 320 to 360 tokens/s (8K) |
+| 4x Radeon AI PRO R9700 | 74 to 77 tokens/s | 400 to 450 tokens/s (8K) |
+| Ryzen AI Max+ 395 (Strix Halo), 128 GB unified | 19 to 21 tokens/s (code), 11 (chat) | 87 tokens/s (4K), 125 tokens/s (8K) |
+
+[Memory, disk and details](docs/DEEPSEEK41.md) · [Release notes](https://github.com/Niko1221/Strata/releases)
+
+</details>
+
+<a id="the-other-sizes"></a>
+
+Not sure what fits? [Choose a model for your computer](docs/MODELS.md#pick-by-memory).
 
 ## Install
 
-Pick one option. They all start the same engine and use the same models.
+<a id="option-a-the-strata-app"></a>
 
-### Option A: the Strata app
+### Desktop app
 
-The easiest way. The app has the engine inside: install it, pick a model, chat. Download the file for your system and
-graphics card from the [releases page](https://github.com/Niko1221/Strata/releases/latest). Not sure which one? See the
-line under the table.
+**[Download Strata for Windows, Linux or Mac →](https://github.com/Niko1221/Strata/releases/latest)**
 
-| System | Your graphics card | File to download |
-| --- | --- | --- |
-| **Windows 10 / 11** | NVIDIA RTX, driver 580 or newer | [`Strata-0.2.0-beta-windows-cuda13.exe`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-windows-cuda13.exe) |
-| | NVIDIA, older card or driver older than 580 | [`Strata-0.2.0-beta-windows-cuda12.exe`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-windows-cuda12.exe) |
-| | AMD Radeon RX 9000 series or Radeon AI PRO R9700 | [`Strata-0.2.0-beta-windows-hip.exe`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-windows-hip.exe) |
-| **Linux** | NVIDIA RTX, driver 580 or newer | [`Strata-0.2.0-beta-linux-nvidia-cuda13.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-nvidia-cuda13.AppImage) |
-| | NVIDIA, older card or driver older than 580 | [`Strata-0.2.0-beta-linux-nvidia-cuda12.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-nvidia-cuda12.AppImage) |
-| | AMD Radeon RX 9000 series or Radeon AI PRO R9700 | [`Strata-0.2.0-beta-linux-amd-rx9070.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-amd-rx9070.AppImage) |
-| | AMD Radeon RX 7000 series | [`Strata-0.2.0-beta-linux-amd-rx7900.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-amd-rx7900.AppImage) |
-| **Mac** (Apple Silicon, macOS 15 or newer) | built in | [`Strata-0.2.0-beta-mac.dmg`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-mac.dmg) |
+Install the app, choose a model, and start chatting. There is one installer for each system. On first start the app
+downloads the engine for your graphics card. [Help with the installer](docs/INSTALL.md#the-app).
 
-**If you are unsure:** for NVIDIA, take `cuda13` if your driver is version 580 or newer, otherwise `cuda12`. `cuda12` is
-for older cards and older drivers. The `hip` and `amd` files are for AMD cards. Other AMD cards (RX 6000, or RX 7000 on
-Windows) have no ready-made app yet: see [AMD cards](docs/AMD_HIP.md).
+<sub>Files: `Strata-0.2.9-windows-x64-setup.exe` · `Strata-0.2.9-linux-x86_64.AppImage` · `Strata-0.2.9-macos-arm64.dmg`</sub>
 
-Then:
+<p align="center">
+  <img src="docs/media/app-chat.png" width="900" alt="Strata desktop app with a chat and live code preview side by side">
+  <br><sub>Chat, files and a live preview in one window.</sub>
+</p>
 
-- **Windows:** run the `.exe`. It installs for your user and needs no administrator rights. If Windows says "Windows
-  protected your PC", choose **More info**, then **Run anyway** (the installer is not code-signed yet).
-- **Linux:** make the file runnable (`chmod +x`) and start it. It needs FUSE 2: `sudo apt install libfuse2` (Ubuntu 22.04)
-  or `libfuse2t64` (Ubuntu 24.04 and newer).
-- **Mac:** open the `.dmg` and drag Strata onto Applications.
+<a id="option-b-the-terminal-one-line"></a>
 
-On the first screen the app reads your PC and recommends a model that fits. Press install. The model is a big download
-(about 40-70 GB) and continues where it stopped if it is interrupted. Closing the window stops Strata and the engine.
+### Terminal app
 
-### Option B: the Terminal (one line)
+Prefer the terminal? Install Strata, then run **`strata launch`**.
 
-The Terminal is the `strata` command, for scripts, servers and AI agents.
+<details open>
+<summary><b>Install commands</b></summary>
 
-Linux and Mac:
+**Linux / Mac**
 
 ```sh
-curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh | sh
+curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh
 ```
 
-Windows (PowerShell):
+**Windows PowerShell**
 
 ```powershell
 irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex
 ```
 
-The script checks your PC, downloads the Terminal, verifies its SHA-256 and unpacks it into your home folder. It needs no
-administrator rights. On Windows, open a new terminal window afterwards. Then start Strata:
+On Windows, open a new terminal afterwards. Then:
 
 ```sh
 strata launch
 ```
 
-It asks one question at a time: model, context, pictures, who may connect. Then it downloads the engine for your graphics
-card (signed, and test-started before use) and the model, and starts serving. For scripts and AI agents, use flags:
-
-```sh
-strata launch --model q2_0 --yes --no-tui
-```
-
-To read the install script before it runs, download it first with `curl -fsSL <address> -o install.sh`, read it, then run
-`sh install.sh`. All screens and flags: [docs/TERMINAL_LAUNCH.md](docs/TERMINAL_LAUNCH.md).
-
-### Option C: let your AI set it up
-
-Paste this into Claude Code, Cursor, Codex, GitHub Copilot or another coding assistant:
-
-```text
-Set up Strata on this PC for me: https://github.com/Niko1221/Strata - follow docs/AI_SETUP.md in that repository.
-```
-
-It checks your graphics card, RAM and disk, picks the model that fits, installs and starts it, and tells you how to
-connect your apps. AI tools can also install, start and stop Strata through its [MCP server](docs/MCP_SERVER.md).
-
-Prefer to build it yourself? See [Build from source](#build-from-source).
-
-## Models
-
-The app and `strata launch` recommend a model for your memory. It is one model in several sizes, compressed more or less.
-Smaller sizes are faster. Larger sizes are a bit smarter.
-
-### Low on memory? Try Gyro
-
-[Gyro](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF) (by agentionai) is the smallest way to run this model.
-
-| Size | Memory it needs (RAM + VRAM) | Download | What it is |
-| --- | ---: | ---: | --- |
-| **Gyro-S** | 27.6 GB | 58.5 GB | For PCs that fit nothing else. Quality is lower than IQ2_XS. |
-| **Gyro-M** | 35 GB | 92.0 GB | About IQ3_XXS quality with about 20% less GPU memory. It writes answers 17-21% slower than Q2_0 on a 12 GB card and on an R9700. |
-
-Gyro runs on NVIDIA and AMD cards (AMD is experimental), not on Intel Arc or the Mac. Details and measurements:
-[docs/GYRO.md](docs/GYRO.md). Start it with `strata launch --model gyro-s`.
-
-### The other sizes
-
-| Your memory (RAM + VRAM) | Take | Notes |
-| --- | --- | --- |
-| **32 GB** | **Gyro-S**, or the **[Coder](docs/MODELS.md#coder)** for code | The Coder needs 32 GB of RAM and keeps half of the experts, so it is weaker outside code |
-| **40 GB** | **[Swift 1.5](docs/MODELS.md#swift-15)** IQ2_XS (39.2 GB), or **Gyro-M** (35 GB) | Swift thinks for a shorter time before it answers. Gyro-M is close to IQ3_XXS in quality, but it writes answers 17-21% slower than Q2_0 |
-| **48 GB** | **IQ3_XXS** (47.0 GB) | Slower, better |
-| **64 GB** | **IQ3_S** (54.8 GB), the original or Swift 1.5 | The slowest, the best: it matches the full model on the published tests |
-| **96 GB or more** | Unsloth's **UD-IQ4_XS** (about 72 GB of RAM) to **Q8_0** (about 136 GB), 4 to 8 bit | Closer to the full model. With less RAM, Strata reads part of them from the SSD, which is much slower |
-
-Less RAM than a row says can still work: Strata switches to its
-[low-RAM mode](docs/MODELS.md#a-big-graphics-card-and-little-ram) by itself. Expect it to be slower, and much slower
-with a small graphics card.
-
-More choices:
-
-- **[Swift 1.5](docs/MODELS.md#swift-15)** is a fine-tune that thinks for a shorter time before it answers, at about the same quality and RAM.
-- **[NVFP4](docs/NVFP4.md)** is NVIDIA's 4-bit version for NVIDIA cards. It needs about 80 GB of RAM to keep every expert in RAM.
-- **[Qwen3.6-35B-A3B](docs/QWEN36.md)** is a smaller, different model that reads pictures and can answer several requests at once.
-- **[OrcaRouter's Uncensored IQ3_XXS](docs/MODELS.md#orcarouter-uncensored-iq3_xxs)** is set up by hand.
-
-Every size, download and what fits where: [docs/MODELS.md](docs/MODELS.md).
-
-## How fast is it?
-
-Based on a 12 GB graphics card (RTX 5070, Ryzen 5 7600, 64 GB RAM). See results from other cards:
-[speed of each model](docs/MODELS.md#how-fast-is-each-size), [community results](docs/COMMUNITY_BENCHMARKS.md).
-
-| Model | Answers appear at | Reads your prompt at |
-| --- | --- | --- |
-| **Q2_0** | `████████████` 94 tokens/s | `████████████` 2,650 tokens/s |
-| **IQ2_XS** | `██████████░░` 79 tokens/s | `█████████░░░` 2,090 tokens/s |
-| **IQ3_XXS** | `████████░░░░` 62 tokens/s | `████████░░░░` 1,750 tokens/s |
-| **IQ3_S** | `███████░░░░░` 53 tokens/s | `███████░░░░░` 1,620 tokens/s |
-| **Coder** | `███████░░░░░` 55 tokens/s | `██████████░░` 2,180 tokens/s |
-
-A token is about ¾ of a word, so 60 tokens per second is faster than you can read. "Reads your prompt" is how fast Strata
-takes in a long document, code or chat history.
-
-Measured on a 16 GB AMD card (RX 9070 XT, Ryzen 9 3900X, 47 GB RAM):
-
-| Model | Answers appear at | Reads your prompt at |
-| --- | --- | --- |
-| **Q2_0** | `████████░░░░` 60 tokens/s | `█████░░░░░░░` 1,160 tokens/s |
-| **IQ2_XS** | `███████░░░░░` 52 tokens/s | `█████░░░░░░░` 1,110 tokens/s |
-| **Coder** | `██████░░░░░░` 44 tokens/s | `██████░░░░░░` 1,420 tokens/s |
-
-The bars use one scale for both tables. A card with more VRAM is faster: an RTX 3090 (24 GB) should write about 100-140
-tokens per second. The engine version behind each number is in [DETAILS.md](docs/DETAILS.md#speed-measured).
-
-## Using it
-
-### In the app
-
-The app has a **Chat**, a **Monitor** of the model and your GPU, CPU and RAM, a **Models** page and **Settings**. The chat
-can work in a folder on your PC. In **Manual** mode it asks before it changes a file or runs a command. Type
-`/loop 10m <what to do>` to repeat a message every 10 minutes while the chat is open.
-
-The chat can search the web with DuckDuckGo (or Bing), with no account. You can add a search key under **Settings, Tools**.
-Search is the one feature that sends something off your PC, the search words.
-
-To run two models, turn on **Run multiple models** and give each model its own card of the same make.
-
-<p align="center"><img src="docs/media/runpagoda.png" width="900" alt="The Strata app's Monitor tab next to a coding agent"><br>
-<sub>The Strata app's <b>Monitor</b> (left) while a coding agent writes the pagoda garden from the video (right)</sub></p>
-
-### In the Terminal
-
-```sh
-strata launch                                  # guided screens: model, context, pictures, access, then serve
-strata launch --model q2_0 --yes --no-tui     # no questions: serve, print the address, return
-strata launch --plan --model q2_0              # show what would happen; nothing changes
-strata launch --status                         # what is being served now
-strata launch --stop                           # stop it
-strata monitor --url http://127.0.0.1:8080     # watch speed, GPU, memory and requests
-strata update --check                          # is there a new engine? (strata update installs it)
-strata doctor                                  # check the installed engine files
-```
-
-`strata --help` lists everything. Starting and serving never download anything. Only the install, `strata launch` (when
-you choose a model) and `strata update` do. To reach Strata from your phone or another PC, use
-`strata launch --access lan`. It makes an API key and will not start on a network without one. No browser opens unless
-you add `--open`. Guide: [docs/TERMINAL_LAUNCH.md](docs/TERMINAL_LAUNCH.md). Whole client: [docs/TERMINAL.md](docs/TERMINAL.md).
-
-### With AI agents
-
-An agent installs Strata with the one-line command in Option B and runs
-`strata launch --model NAME --yes --no-tui`. The steps, flags and exit codes are in [docs/AI_SETUP.md](docs/AI_SETUP.md),
-and the repository rules are in [AGENTS.md](AGENTS.md).
-
-### Connect your other apps
-
-| App type | Base URL |
-| --- | --- |
-| OpenAI-compatible (most apps and agents) | `http://127.0.0.1:8080/v1` (any API key, any model name) |
-| Anthropic API (Claude Code and others) | `http://127.0.0.1:8080`, without `/v1`. These apps add `/v1/messages` themselves. Claude Code: `ANTHROPIC_BASE_URL=http://127.0.0.1:8080` |
-| OpenAI Responses API (Codex CLI) | `http://127.0.0.1:8080/v1/responses` ([setup](docs/DETAILS.md#the-responses-api-and-codex-cli)) |
-
-`strata connect` prints the exact settings for OpenCode, Codex CLI, Claude Code, oh-my-pi, pi, Hermes Agent and OpenClaw.
-`strata connect opencode --write` writes the file after asking and keeps a backup.
-
-### Pictures
-
-Pictures are on by default for models that can read them. Attach or paste a picture in the chat, or send it from your app.
-The picture reader runs on the processor when your graphics card has less than 24 GB (a few seconds per picture, nothing
-taken from the card's memory) and on the graphics card from 24 GB. The rule is the same for NVIDIA and AMD. Turn pictures
-off per model, or choose the reader with `--vision off`, `--vision gpu` or `--vision cpu`.
-
-The numbers behind the rule: on a Radeon AI PRO R9700 the card's reader took 57 ms for a 260-token picture and the
-processor's took 3.1 s. On 16 GB cards (Tesla P100 and RTX A4000, Linux) the card's reader cost 3-5% of text speed,
-because it holds about 1.4 GB that the model would use otherwise. The Mac has no picture reader yet.
-
-### Good to know
-
-- Choose the thinking level (**off, low, medium or high**) in the chat menu or in your app's "reasoning effort". Off is fastest.
-- Strata answers one request at a time by default. For several at once, use `--parallel N` in `strata launch` or
-  `"parallel": 2` in the config ([BATCHING.md](docs/BATCHING.md)). On a 12 GB card this makes each answer slower.
-- Strata reads the first message of a chat in full, about 1 minute per 30,000 tokens. Follow-up messages start in seconds.
-- Where your chats are stored and the whole API: [docs/INSTALL.md](docs/INSTALL.md#where-things-are-stored), [docs/DETAILS.md](docs/DETAILS.md#using-it).
-
-## Build from source
-
-<details>
-<summary>Windows, Linux and Mac from the repository</summary>
-
-[Download Strata](https://github.com/Niko1221/Strata/archive/refs/heads/main.zip) and unzip it, or `git clone` it.
-**Windows:** double-click `START-HERE.bat`. **Linux:** run `./setup.sh` in the Strata folder.
-
-**Mac (Apple Silicon, macOS 15 or newer):** install Apple's Command Line Tools once with `xcode-select --install`
-(Xcode itself is not needed). Open Terminal in the Strata folder and run `./setup.sh`. It builds the Mac engine on your
-Mac (about 7 minutes), asks the same questions, downloads the model and starts it. Next time, `./setup.sh` starts it
-right away. Which size fits your Mac: [docs/MAC.md](docs/MAC.md).
-
-The installer finds your card and sets up the right engine. It asks which model and size, how much context (how much text
-the model keeps in mind) and whether it should read pictures. Press Enter for the recommended answer. Then it downloads the
-model (about 70 GB) and starts it. If the download stops, run it again and it continues. Your browser opens the Strata
-page at `http://127.0.0.1:8080`.
-
-> While the model starts, your PC can be slow or stop responding for 1-3 minutes (longest the first time). Strata loads
-> 35-55 GB into your RAM and locks part of it for the graphics card. Wait, and don't close the window.
-
-Next time, run `START-HERE.bat` (or `./setup.sh`) again. It starts right away and downloads nothing twice. Close its
-window to stop the model. `UPDATE.bat` (`./update.sh`) updates Strata without starting it. Updating, Docker, several cards,
-where the files go and every option: [docs/INSTALL.md](docs/INSTALL.md).
-
-To measure your PC, run `BENCH.bat` (`./bench.sh`). It takes 5-10 minutes and writes a report you can share
-([how](docs/COMMUNITY_BENCHMARKS.md#run-the-benchmark)).
-
-**Optional: more speed on one card when the whole model fits in RAM.** Two opt-in settings by RubenTorney (#1904, #1905).
-They help when you run one graphics card and your RAM holds every expert, for example Q2_0 or IQ3_XXS on a 64 GB PC. Open
-`strata-<model>.json` in the Strata data folder ([where](docs/INSTALL.md#where-things-are-stored)) and add:
-
-- `"--adapt-async", "1"` to the `"args"` list. The expert cache then updates on a helper thread instead of pausing the
-  answer. Measured on an RTX 5070 (Windows, Q2_0): +4-5% decode, +7-10% on code and long documents. Answers can differ
-  slightly from the default and stay the same from run to run.
-- `"STRATA_PIN_BY_NEED": "1"` in the `"env"` block (Windows). Windows can lock only about half the RAM for the graphics
-  card, and this locks the experts the card needs first. Measured on the RTX 5070: +4.4% prompt reading.
-
-```json
-"args": [ ..., "--adapt-async", "1" ],
-"env": { "STRATA_PIN_BY_NEED": "1" }
-```
-
-Restart Strata after the change. To undo, remove the two entries.
+Follow the prompts to download and start a model. [Terminal guide](docs/TERMINAL_LAUNCH.md).
 
 </details>
 
-## How does it work?
+<p align="center">
+  <img src="docs/media/terminal-monitor.png" width="900" alt="Strata terminal app showing model activity, speed, memory and recent requests">
+  <br><sub>Watch your model and hardware while it runs.</sub>
+</p>
 
-Models like this one usually run on servers with hundreds of gigabytes of graphics memory. Your graphics card has
-12-24 GB. Strata makes the model fit by sharing the work across your whole PC. Picture a library.
+<a id="build-from-source"></a>
 
-- The model is a team of 24,576 small specialists ("experts"), like 24,576 reference books. Each word needs only 10 of them.
-- **Your graphics card is the desk.** It is small and fast. The roughly 4,000 books used most often lie open on it.
-- **Your RAM is the shelves in the reading room.** All 24,576 books are there. When a word needs a book that is not on the
-  desk, your processor reads it from the shelf at once, while the card keeps working.
-- **Your SSD is the archive.** It holds a 29 GB lookup table. The model reads a few rows of it per word, so it does not
-  need to sit in RAM.
+[Build from source](docs/SOURCE_INSTALL.md) · [Docker](docs/DOCKER.md) · [Full install guide](docs/INSTALL.md)
 
-<p align="center"><img src="docs/media/how-it-works.svg" width="860" alt="The model's 24,576 experts: the busiest on the graphics card, all of them in RAM, a lookup table on the SSD"></p>
+<a id="what-you-need"></a>
 
-A small helper also guesses the next few words. The big model checks all of them at once and keeps the right ones. You get
-the same answer, 1.6-1.8x sooner. Long texts are read in big pieces, up to 8,192 tokens at a time, at over 1,000 tokens
-per second.
+## Hardware
 
-<p align="center"><img src="docs/media/guess-and-check.svg" width="860" alt="A small helper guesses the next words; the big model checks them all at once and keeps the right ones"></p>
+| Supported hardware | Guide |
+| --- | --- |
+| **NVIDIA GeForce RTX 20 / 30 / 40 / 50 series** | [NVIDIA setup](docs/INSTALL.md#what-you-need) |
+| **AMD Radeon RX 7700 / 7800 / 7900, RX 9060 / 9070, AI PRO R9700** | [AMD setup](docs/AMD_HIP.md) |
+| **AMD Radeon RX 6800 / 6900 · experimental** | [RX 6000 setup](docs/AMD_HIP.md#rdna2-gfx1030) |
+| **Intel Arc · Linux** | [Intel setup](docs/INTEL_ARC.md) |
+| **Apple Silicon · M1 or newer** | [Mac setup](docs/MAC.md) |
+| **AMD Ryzen AI Max · Strix Halo** | [Strix Halo setup](docs/STRIX_HALO.md) |
+| **NVIDIA DGX Spark · Linux** | [DGX Spark setup](docs/DGX_SPARK_LINUX.md) |
 
-The longer explanation: [docs/HOW_IT_WORKS.md](docs/HOW_IT_WORKS.md). Every part and its numbers:
-[the details](docs/DETAILS.md#how-it-works) and the [paper](docs/paper/Strata-Paper.pdf).
+<a id="using-it"></a>
 
-## Something went wrong?
+## Tools
 
-- **My PC froze the first time Strata started.** It loads the model into RAM. Wait, and don't close the window. Still
-  frozen after 10 minutes? Restart the PC, close other programs and try again, or pick a smaller size.
-- **It stopped while downloading or installing.** Start the app or `strata launch` again, or run `START-HERE.bat` (or
-  `./setup.sh`) again. It continues where it stopped.
-- **It is very slow, the disk light keeps blinking, or it says "the engine stopped unexpectedly".** Your PC does not have
-  enough free RAM. Close other programs (browsers use a lot), or pick a smaller size such as Q2_0 or IQ2_XS.
-- **It says there is no engine for this PC.** In the app, open **Settings, Engine** and press **Update engine**. In the
-  Terminal, run `strata update`. `strata doctor` shows which engine files are installed.
-- **It says port 8080 is already in use.** Strata is already running. Look for its window.
+**Claude Code · Codex CLI · OpenCode · oh-my-pi · pi.dev · Hermes Agent · OpenClaw**, and more through the OpenAI- and Anthropic-compatible APIs.
 
-More problems and fixes: [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md). Still stuck? Open an
-[issue](https://github.com/Niko1221/Strata/issues). In the app, attach the file from **Settings, Engine, Diagnostics, View
-logs, Save logs**. In the Terminal, paste the output of `strata doctor`. From source, attach `strata-<model>.log` from the
-Strata folder. For a security problem, report it privately: [SECURITY.md](SECURITY.md).
+Run **`strata connect`** to see setup instructions for your tool. [Connection guide](docs/TERMINAL_LAUNCH.md#connect-your-apps-strata-connect).
 
-## Credits and license
+<a id="guides"></a>
+<a id="how-fast-is-it"></a>
+<a id="how-does-it-work"></a>
+<a id="something-went-wrong"></a>
 
-The model is [Qwen3.8-Flash-Next](https://huggingface.co/Qwen/Qwen3.8-Flash-Next) by the Qwen team. It was compressed by
-[ISTA-DASLab](https://huggingface.co/ISTA-DASLab/Qwen3.8-Flash-Next-GSQ-RCO-GGUF), UkisAI (Swift 1.5), agentionai (Gyro)
-and Unsloth. Strata uses parts of [llama.cpp / ggml](https://github.com/ggml-org/llama.cpp). All credits:
-[docs/HOW_IT_WORKS.md](docs/HOW_IT_WORKS.md#credits). Strata is open source under the [MIT License](LICENSE). A few parts and
-every model have their own licenses ([which ones](docs/HOW_IT_WORKS.md#license)).
+## Help
 
-## Contributing
-
-Found a bug, or want to send a change or a benchmark? Read [CONTRIBUTING.md](CONTRIBUTING.md) first. It says what to
-include so that others can check your work.
+[All guides](docs) · [Troubleshooting](docs/TROUBLESHOOTING.md) · [Report a bug](https://github.com/Niko1221/Strata/issues/new/choose) ·
+[Benchmarks](docs/COMMUNITY_BENCHMARKS.md) · [How it works](docs/HOW_IT_WORKS.md) · [Contribute](CONTRIBUTING.md)
 
 ## Support Strata
 
-Strata is free and MIT-licensed. I build it and test it on whatever hardware I can get. If it runs well on your PC, a coffee helps
-me keep testing new cards and fixing what you report. No pressure. Using it and reporting what you find helps just as much.
+**Help keep local AI open to everyone.** A coffee helps fund development and testing on more hardware.
 
-<a href="https://buymeacoffee.com/strataengine"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="50"></a>
+<a href="https://buymeacoffee.com/strataengine"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me a Coffee: support Strata" height="48"></a>
+
+[MIT license](LICENSE) · [Credits and model licenses](docs/HOW_IT_WORKS.md#credits) · [Privacy](docs/SAFETY.md)
+
+<a id="option-c-let-your-ai-set-it-up"></a>
+
+<sub>For AI tools and automated readers: <a href="AGENTS.md">technical reference</a> · <a href="docs/AI_SETUP.md">setup instructions</a>.</sub>
+
+**Sponsorships, hardware partnerships or collaborations:** [[email protected]](mailto:[email protected]).
 
-Interested in sponsoring Strata? Contact me via [GitHub](https://github.com/Niko1221).

README.pl.md

@@ -0,0 +1,192 @@
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="apps/host/public/brand/strata-lockup-dark.svg">
+    <img src="apps/host/public/brand/strata-lockup-light.svg" alt="Strata" width="340">
+  </picture>
+</p>
+
+<h3 align="center">Uruchom potężną sztuczną inteligencję na własnym komputerze.</h3>
+<p align="center">Rozmawiaj, programuj i pracuj z obrazami — lokalnie.</p>
+
+<p align="center">
+  <a href="#modele">Modele</a> · <a href="#instalacja"><b>Instalacja</b></a> ·
+  <a href="#sprzęt">Sprzęt</a> · <a href="#narzędzia">Narzędzia</a> ·
+  <a href="#pomoc">Pomoc</a> · <a href="#wesprzyj-stratę">Wsparcie</a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/Niko1221/Strata/releases/latest"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?label=download&color=0ab887" alt="Pobierz Stratę"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="Licencja MIT"></a>
+  <a href="https://buymeacoffee.com/strataengine"><img src="https://img.shields.io/badge/Buy_me_a_coffee-FFDD00?logo=buymeacoffee&logoColor=000" alt="Wesprzyj Stratę na Buy Me a Coffee"></a>
+</p>
+
+<p align="center"><sub><a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.es.md">Español</a> · <a href="README.pt-BR.md">Português</a> · <b>Polski</b></sub></p>
+
+**Bezpłatna, z otwartym kodem źródłowym i do uruchomienia u siebie.** Używaj Straty na swoim komputerze albo razem z ulubionymi narzędziami do programowania. Konto nie jest potrzebne.
+
+## Modele
+
+Najpierw polecamy **ISTA-DASLab**, potem **Unsloth** i innych dostawców — o ile zgodny model mieści się w pamięci.
+
+<details>
+<summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.8-Flash-Next</b></summary>
+
+| Dostawca | Do wyboru |
+| --- | --- |
+| **ISTA-DASLab · polecany** | Q2\_0, IQ2\_XS, IQ3\_XXS, IQ3\_S. [Coder: IQ1\_M](docs/MODELS.md#coder) do programowania. |
+| **Unsloth** | UD-IQ4\_XS, UD-Q4\_K\_XL, UD-Q5\_K\_XL, UD-Q6\_K\_XL, Q8\_0 |
+| **Gyro · agentionai** | [Gyro-S, Gyro-M](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF). Zużywa mniej pamięci, ale działa wolniej. |
+| **Inne opcje** | [Swift 1.5](docs/MODELS.md#swift-15), [NVFP4](docs/NVFP4.md), [OrcaRouter](docs/ORCA.md) |
+
+[Porównaj rozmiary, wymagania pamięciowe i zgodność](docs/MODELS.md).
+
+</details>
+
+<details>
+<summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.6-35B-A3B</b></summary>
+
+**Unsloth:** UD-Q4_K_XL, UD-Q6_K_XL, Q8_0. To obecnie udokumentowane pakiety dla tego modelu.
+
+[Przewodnik po modelu i zgodność](docs/QWEN36.md).
+
+</details>
+
+<details>
+<summary><img src="docs/media/models/deepseek.svg" width="22" alt="" align="middle"> &nbsp;<b>DeepSeekV4.1-Flash-1017</b></summary>
+
+W **aplikacji na komputer** i w **Terminalu**. To, co nie mieści się w pamięci, jest czytane z dysku SSD, więc potrzebujesz
+dużo wolnego miejsca na dysku.
+
+| Zestaw (ISTA-DAS) | Do pobrania | Potrzebne wolne miejsce |
+| --- | ---: | ---: |
+| 1.75 bpw | 239 GB | około 245 GB |
+| 2.00 bpw | 257 GB | około 265 GB |
+| 2.25 bpw | 274 GB | około 280 GB |
+
+Działa na kartach NVIDIA RTX serii 30, 40 i 50 (Windows i Linux), AMD Radeon AI PRO R9700 (Linux) oraz AMD Ryzen AI Max — Strix Halo
+(Windows). Instalacja pobiera pliki i silnik DeepSeek, a potem uruchamia model.
+
+```sh
+strata launch --family deepseek41 --model ist-das-2.00bpw --plan
+```
+
+Zmierzone na zestawie 2.00 bpw w Strata 0.2.5 (Strix Halo: 0.2.7). „Wyjście” to szybkość odpowiedzi, „prompt” — jak szybko Strata czyta twój tekst.
+
+| Sprzęt | Wyjście | Prompt |
+| --- | ---: | ---: |
+| RTX 5070 12 GB, 64 GB RAM | 4–6 tokenów/s | około 110 tokenów/s (4K) |
+| RTX 3060 12 GB, 46 GB RAM | 9–11 tokenów/s | około 155 tokenów/s (4K) |
+| 1x Radeon AI PRO R9700, 251 GB RAM | 21–25 tokenów/s | 320–360 tokenów/s (8K) |
+| 4x Radeon AI PRO R9700 | 74–77 tokenów/s | 400–450 tokenów/s (8K) |
+| Ryzen AI Max+ 395 (Strix Halo), 128 GB pamięci współdzielonej | 19–21 tokenów/s (kod), 11 (czat) | 87 tokenów/s (4K), 125 tokenów/s (8K) |
+
+[Pamięć, dysk i szczegóły](docs/DEEPSEEK41.md) · [Informacje o wydaniach](https://github.com/Niko1221/Strata/releases)
+
+</details>
+
+<a id="the-other-sizes"></a>
+
+Nie wiesz, co się zmieści? [Wybierz model do swojego komputera](docs/MODELS.md#pick-by-memory).
+
+## Instalacja
+
+<a id="option-a-the-strata-app"></a>
+
+### Aplikacja na komputer
+
+**[Pobierz Stratę dla Windows, Linuxa lub Maca →](https://github.com/Niko1221/Strata/releases/latest)**
+
+Zainstaluj aplikację, wybierz model i zacznij rozmawiać. Dla każdego systemu jest jeden instalator. Przy pierwszym
+uruchomieniu aplikacja pobiera silnik dla twojej karty graficznej. [Pomoc z instalatorem](docs/INSTALL.md#the-app).
+
+<sub>Pliki: `Strata-0.2.9-windows-x64-setup.exe` · `Strata-0.2.9-linux-x86_64.AppImage` · `Strata-0.2.9-macos-arm64.dmg`</sub>
+
+<p align="center">
+  <img src="docs/media/app-chat.png" width="900" alt="Aplikacja Strata na komputer: czat i podgląd kodu na żywo obok siebie">
+  <br><sub>Czat, pliki i podgląd na żywo w jednym oknie.</sub>
+</p>
+
+<a id="option-b-the-terminal-one-line"></a>
+
+### Aplikacja Terminal
+
+Wolisz terminal? Zainstaluj Stratę, a potem uruchom **`strata launch`**.
+
+<details open>
+<summary><b>Polecenia instalacji</b></summary>
+
+**Linux / Mac**
+
+```sh
+curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh
+```
+
+**Windows PowerShell**
+
+```powershell
+irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex
+```
+
+W Windows otwórz potem nowe okno terminala. Następnie:
+
+```sh
+strata launch
+```
+
+Postępuj zgodnie z podpowiedziami, aby pobrać i uruchomić model. [Przewodnik po Terminalu](docs/TERMINAL_LAUNCH.md).
+
+</details>
+
+<p align="center">
+  <img src="docs/media/terminal-monitor.png" width="900" alt="Aplikacja Terminal Straty pokazująca aktywność modelu, szybkość, pamięć i ostatnie zapytania">
+  <br><sub>Obserwuj model i sprzęt w trakcie pracy.</sub>
+</p>
+
+<a id="build-from-source"></a>
+
+[Budowanie ze źródeł](docs/SOURCE_INSTALL.md) · [Docker](docs/DOCKER.md) · [Pełny przewodnik instalacji](docs/INSTALL.md)
+
+<a id="what-you-need"></a>
+
+## Sprzęt
+
+| Obsługiwany sprzęt | Przewodnik |
+| --- | --- |
+| **NVIDIA GeForce RTX serii 20 / 30 / 40 / 50** | [Konfiguracja NVIDIA](docs/INSTALL.md#what-you-need) |
+| **AMD Radeon RX 7700 / 7800 / 7900, RX 9060 / 9070, AI PRO R9700** | [Konfiguracja AMD](docs/AMD_HIP.md) |
+| **AMD Radeon RX 6800 / 6900 · eksperymentalnie** | [Konfiguracja RX 6000](docs/AMD_HIP.md#rdna2-gfx1030) |
+| **Intel Arc · Linux** | [Konfiguracja Intel](docs/INTEL_ARC.md) |
+| **Apple Silicon · M1 lub nowszy** | [Konfiguracja Mac](docs/MAC.md) |
+| **AMD Ryzen AI Max · Strix Halo** | [Konfiguracja Strix Halo](docs/STRIX_HALO.md) |
+
+<a id="using-it"></a>
+
+## Narzędzia
+
+**Claude Code · Codex CLI · OpenCode · oh-my-pi · pi.dev · Hermes Agent · OpenClaw** i inne — przez API zgodne z OpenAI i Anthropic.
+
+Uruchom **`strata connect`**, aby zobaczyć instrukcję konfiguracji dla swojego narzędzia. [Przewodnik po połączeniach](docs/TERMINAL_LAUNCH.md#connect-your-apps-strata-connect).
+
+<a id="guides"></a>
+<a id="how-fast-is-it"></a>
+<a id="how-does-it-work"></a>
+<a id="something-went-wrong"></a>
+
+## Pomoc
+
+[Wszystkie przewodniki](docs) · [Rozwiązywanie problemów](docs/TROUBLESHOOTING.md) · [Zgłoś błąd](https://github.com/Niko1221/Strata/issues/new/choose) ·
+[Testy wydajności](docs/COMMUNITY_BENCHMARKS.md) · [Jak to działa](docs/HOW_IT_WORKS.md) · [Współtworzenie](CONTRIBUTING.md)
+
+## Wesprzyj Stratę
+
+**Pomóż zachować lokalną sztuczną inteligencję otwartą dla wszystkich.** Kawa pomaga finansować rozwój i testy na większej liczbie sprzętu.
+
+<a href="https://buymeacoffee.com/strataengine"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me a Coffee: wesprzyj Stratę" height="48"></a>
+
+[Licencja MIT](LICENSE) · [Podziękowania i licencje modeli](docs/HOW_IT_WORKS.md#credits) · [Prywatność](docs/SAFETY.md)
+
+<a id="option-c-let-your-ai-set-it-up"></a>
+
+<sub>Dla narzędzi AI i automatycznych czytników: <a href="AGENTS.md">dokumentacja techniczna</a> · <a href="docs/AI_SETUP.md">instrukcja instalacji</a>.</sub>
+
+**Sponsoring, partnerstwa sprzętowe i współpraca:** [[email protected]](mailto:[email protected]).

README.pt-BR.md

@@ -1,389 +1,188 @@
 <p align="center">
   <picture>
     <source media="(prefers-color-scheme: dark)" srcset="apps/host/public/brand/strata-lockup-dark.svg">
-    <img src="apps/host/public/brand/strata-lockup-light.svg" alt="Strata" width="380">
+    <img src="apps/host/public/brand/strata-lockup-light.svg" alt="Strata" width="340">
   </picture>
 </p>
 
-<p align="center"><a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.es.md">Español</a> · <b>Português</b></p>
-
-<h3 align="center">Rode um modelo de ponta no seu próprio PC gamer</h3>
-
-<p align="center">Suporte a NVIDIA, AMD, Intel · Windows, Linux, Mac · gratuito e de código aberto</p>
+<h3 align="center">IA poderosa no seu próprio computador.</h3>
+<p align="center">Converse, programe e trabalhe com imagens, localmente.</p>
 
 <p align="center">
-  <a href="https://github.com/Niko1221/Strata/releases"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?include_prereleases&label=release" alt="Latest release"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="MIT license"></a>
-  <a href="https://github.com/Niko1221/Strata/stargazers"><img src="https://img.shields.io/github/stars/Niko1221/Strata?style=flat" alt="GitHub stars"></a>
+  <a href="#modelos">Modelos</a> · <a href="#instalação"><b>Instalação</b></a> ·
+  <a href="#hardware">Hardware</a> · <a href="#ferramentas">Ferramentas</a> ·
+  <a href="#ajuda">Ajuda</a> · <a href="#apoie-o-strata">Apoiar</a>
 </p>
 
-<p align="center"><a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4"><img src="docs/media/pagoda-preview.webp" width="720" alt="A voxel pagoda garden that Strata's model wrote, running in the browser"></a><br>
-<sub>Um jardim de pagodes em voxels, gerado com um único prompt, rodando numa RTX 5070 com o Strata (IQ3_S, contexto de 128K) ·
-<a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4">vídeo completo (49 s)</a></sub></p>
+<p align="center">
+  <a href="https://github.com/Niko1221/Strata/releases/latest"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?label=download&color=0ab887" alt="Baixar o Strata"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="Licença MIT"></a>
+  <a href="https://buymeacoffee.com/strataengine"><img src="https://img.shields.io/badge/Buy_me_a_coffee-FFDD00?logo=buymeacoffee&logoColor=000" alt="Apoie o Strata no Buy Me a Coffee"></a>
+</p>
 
-O Strata roda o **[Qwen3.8-Flash-Next](https://huggingface.co/Qwen/Qwen3.8-Flash-Next)**, um modelo de 125 bilhões de parâmetros que
-normalmente precisa de um servidor, num PC comum. Ele conversa, escreve código, lê imagens e funciona com os seus aplicativos e
-agentes de programação. Suas conversas e arquivos ficam no seu PC.
+<p align="center"><sub><a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.es.md">Español</a> · <b>Português</b> · <a href="README.pl.md">Polski</a></sub></p>
 
-**Primeira vez aqui?** Veja [o que você precisa](#o-que-você-precisa) e depois [instale o app](#opção-a-o-app-strata).
+**Gratuito, de código aberto e seu para executar.** Use o Strata no desktop ou com suas ferramentas de programação favoritas. Não precisa de conta.
 
-- **Roda num PC gamer.** 32 GB somando memória RAM e memória da placa de vídeo já bastam para começar.
-- **Funciona com as suas ferramentas.** Ele fala as APIs da OpenAI e da Anthropic, então Claude Code, Codex CLI, OpenCode e outros agentes se conectam a ele.
-- **Lê imagens.** Já vêm ativadas.
-- **Gratuito.** Licença MIT, sem conta, sem nuvem.
-- **Privado.** Sem telemetria. O que o Strata baixa, quando usa a internet e como confere os downloads está em [docs/SAFETY.md](docs/SAFETY.md).
+## Modelos
 
-Versão 0.2.0-beta · mecanismo 0.1.45.3
+Recomendamos **primeiro a ISTA-DASLab**, depois a **Unsloth** e outros provedores, quando um modelo compatível cabe na memória.
 
-## O que você precisa
+<details>
+<summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.8-Flash-Next</b></summary>
 
-**Você precisa de pelo menos 32 GB somando a memória RAM e a memória da placa de vídeo (VRAM).** Num Mac ou num Ryzen AI Max, isso é a
-memória unificada. Mais memória permite um modelo maior ou mais rápido.
-
-- Um PC de 32 GB com uma placa de 12 a 16 GB roda o Coder.
-- 64 GB de RAM rodam todos os tamanhos.
-
-| Seu computador | Detalhes |
+| Provedor | Opções |
 | --- | --- |
-| **NVIDIA** GeForce RTX série 20, 30, 40, 50 (12 GB ou mais) | Instale o app ou o Terminal. |
-| **AMD** Radeon RX 6800 e mais novas, Radeon AI PRO R9700 (12 GB ou mais) | [Placas AMD](docs/AMD_HIP.md) |
-| **Intel** Arc | [Intel Arc](docs/INTEL_ARC.md), [mecanismo Intel](docs/INTEL.md) |
-| **Mac com Apple Silicon** (M1 ou mais novo, macOS 15 ou mais novo) | [Mac](docs/MAC.md) |
-| **AMD Ryzen AI Max (Strix Halo)** e outros sistemas de memória unificada | [Strix Halo](docs/STRIX_HALO.md) |
-| Placas e processadores mais antigos | [GPUs antigas](docs/OLDER_GPUS.md), [CPUs antigas](docs/INSTALL.md#older-cpus-experimental) |
+| **ISTA-DASLab · recomendado** | Q2\_0, IQ2\_XS, IQ3\_XXS, IQ3\_S. [Coder: IQ1\_M](docs/MODELS.md#coder) para programar. |
+| **Unsloth** | UD-IQ4\_XS, UD-Q4\_K\_XL, UD-Q5\_K\_XL, UD-Q6\_K\_XL, Q8\_0 |
+| **Gyro · agentionai** | [Gyro-S, Gyro-M](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF). Usa menos memória, mas é mais lento. |
+| **Outras opções** | [Swift 1.5](docs/MODELS.md#swift-15), [NVFP4](docs/NVFP4.md), [OrcaRouter](docs/ORCA.md) |
 
-Você também precisa de:
+[Compare tamanhos, necessidades de memória e compatibilidade](docs/MODELS.md).
 
-- cerca de 80 GB de espaço livre no disco (um SSD deixa a primeira inicialização bem mais rápida)
-- Windows 10 / 11, Linux ou macOS
-- um driver de vídeo atualizado
+</details>
 
-Duas ou três placas da mesma marca podem dividir um modelo ([multi-GPU](docs/MULTI_GPU.md)). O Strata nunca divide um modelo entre
-placas NVIDIA e AMD. Lista completa: [docs/INSTALL.md](docs/INSTALL.md#what-you-need).
+<details>
+<summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.6-35B-A3B</b></summary>
+
+**Unsloth:** UD-Q4_K_XL, UD-Q6_K_XL, Q8_0. Esses são os pacotes documentados atualmente para este modelo.
+
+[Guia do modelo e compatibilidade](docs/QWEN36.md).
+
+</details>
+
+<details>
+<summary><img src="docs/media/models/deepseek.svg" width="22" alt="" align="middle"> &nbsp;<b>DeepSeekV4.1-Flash-1017</b></summary>
+
+No **aplicativo de desktop** e no **Terminal**. O que não cabe na memória é lido do seu SSD, por isso é preciso muito espaço livre em disco.
+
+| Conjunto (ISTA-DAS) | Download | Espaço livre necessário |
+| --- | ---: | ---: |
+| 1.75 bpw | 239 GB | cerca de 245 GB |
+| 2.00 bpw | 257 GB | cerca de 265 GB |
+| 2.25 bpw | 274 GB | cerca de 280 GB |
+
+Roda em NVIDIA RTX 30, 40 e 50 (Windows e Linux) e em AMD Radeon AI PRO R9700 (Linux). A instalação baixa os arquivos e o motor do DeepSeek e depois inicia o modelo.
+
+```sh
+strata launch --family deepseek41 --model ist-das-2.00bpw --plan
+```
+
+Medido com o conjunto de 2.00 bpw no Strata 0.2.5. “Saída” é a velocidade da resposta; “Prompt” é a rapidez com que o Strata lê o seu texto.
+
+| Hardware | Saída | Prompt |
+| --- | ---: | ---: |
+| RTX 5070 12 GB, 64 GB de RAM | 4 a 6 tokens/s | cerca de 110 tokens/s (4K) |
+| RTX 3060 12 GB, 46 GB de RAM | 9 a 11 tokens/s | cerca de 155 tokens/s (4K) |
+| 1x Radeon AI PRO R9700, 251 GB de RAM | 21 a 25 tokens/s | 320 a 360 tokens/s (8K) |
+| 4x Radeon AI PRO R9700 | 74 a 77 tokens/s | 400 a 450 tokens/s (8K) |
+
+[Memória, disco e detalhes](docs/DEEPSEEK41.md) · [Notas da versão](https://github.com/Niko1221/Strata/releases)
+
+</details>
+
+<a id="the-other-sizes"></a>
+
+Não sabe o que cabe? [Escolha um modelo para o seu computador](docs/MODELS.md#pick-by-memory).
 
 ## Instalação
 
-Escolha uma opção. Todas iniciam o mesmo mecanismo e usam os mesmos modelos.
+<a id="option-a-the-strata-app"></a>
 
-### Opção A: o app Strata
+### Aplicativo de desktop
 
-O jeito mais fácil. O app já traz o mecanismo: instale, escolha um modelo e converse. Baixe o arquivo para o seu sistema e a sua
-placa de vídeo na [página de releases](https://github.com/Niko1221/Strata/releases/latest). Não sabe qual? Veja a explicação
-logo abaixo da tabela.
+**[Baixar o Strata para Windows, Linux ou Mac →](https://github.com/Niko1221/Strata/releases/latest)**
 
-| Sistema | Sua placa de vídeo | Arquivo para baixar |
-| --- | --- | --- |
-| **Windows 10 / 11** | NVIDIA RTX, driver 580 ou mais novo | [`Strata-0.2.0-beta-windows-cuda13.exe`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-windows-cuda13.exe) |
-| | NVIDIA, placa mais antiga ou driver anterior ao 580 | [`Strata-0.2.0-beta-windows-cuda12.exe`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-windows-cuda12.exe) |
-| | AMD Radeon série RX 9000 ou Radeon AI PRO R9700 | [`Strata-0.2.0-beta-windows-hip.exe`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-windows-hip.exe) |
-| **Linux** | NVIDIA RTX, driver 580 ou mais novo | [`Strata-0.2.0-beta-linux-nvidia-cuda13.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-nvidia-cuda13.AppImage) |
-| | NVIDIA, placa mais antiga ou driver anterior ao 580 | [`Strata-0.2.0-beta-linux-nvidia-cuda12.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-nvidia-cuda12.AppImage) |
-| | AMD Radeon série RX 9000 ou Radeon AI PRO R9700 | [`Strata-0.2.0-beta-linux-amd-rx9070.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-amd-rx9070.AppImage) |
-| | AMD Radeon série RX 7000 | [`Strata-0.2.0-beta-linux-amd-rx7900.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-amd-rx7900.AppImage) |
-| **Mac** (Apple Silicon, macOS 15 ou mais novo) | integrada | [`Strata-0.2.0-beta-mac.dmg`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-mac.dmg) |
+Instale o aplicativo, escolha um modelo e comece a conversar. Há um instalador por sistema. Na primeira vez que abre, o aplicativo baixa o motor da sua placa de vídeo. [Ajuda com o instalador](docs/INSTALL.md#the-app).
 
-**Se você estiver em dúvida:** para NVIDIA, use `cuda13` se o seu driver for a versão 580 ou mais nova, e `cuda12` nos outros casos. O `cuda12`
-serve para placas e drivers mais antigos. Os arquivos `hip` e `amd` são para placas AMD. Outras placas AMD (RX 6000, ou RX 7000 no
-Windows) ainda não têm app pronto: veja [Placas AMD](docs/AMD_HIP.md).
+<sub>Arquivos: `Strata-0.2.9-windows-x64-setup.exe` · `Strata-0.2.9-linux-x86_64.AppImage` · `Strata-0.2.9-macos-arm64.dmg`</sub>
 
-Depois:
+<p align="center">
+  <img src="docs/media/app-chat.png" width="900" alt="Aplicativo de desktop do Strata com um chat e uma prévia do código ao vivo lado a lado">
+  <br><sub>Chat, arquivos e prévia ao vivo em uma só janela.</sub>
+</p>
 
-- **Windows:** execute o `.exe`. Ele instala só para o seu usuário e não pede direitos de administrador. Se o Windows disser "O Windows
-  protegeu o computador", escolha **Mais informações** e depois **Executar assim mesmo** (o instalador ainda não tem assinatura de código).
-- **Linux:** torne o arquivo executável (`chmod +x`) e inicie. É preciso ter o FUSE 2: `sudo apt install libfuse2` (Ubuntu 22.04)
-  ou `libfuse2t64` (Ubuntu 24.04 e mais novos).
-- **Mac:** abra o `.dmg` e arraste o Strata para Aplicativos.
+<a id="option-b-the-terminal-one-line"></a>
 
-Na primeira tela, o app lê o seu PC e recomenda um modelo que caiba nele. Clique em instalar. O modelo é um download grande
-(cerca de 40 a 70 GB) e continua de onde parou se for interrompido. Fechar a janela encerra o Strata e o mecanismo.
+### Aplicativo de Terminal
 
-### Opção B: o Terminal (uma linha)
+Prefere o terminal? Instale o Strata e execute **`strata launch`**.
 
-O Terminal é o comando `strata`, para scripts, servidores e agentes de IA.
+<details open>
+<summary><b>Comandos de instalação</b></summary>
 
-Linux e Mac:
+**Linux / Mac**
 
 ```sh
-curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh | sh
+curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh
 ```
 
-Windows (PowerShell):
+**Windows PowerShell**
 
 ```powershell
 irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex
 ```
 
-O script confere o seu PC, baixa o Terminal, verifica o SHA-256 e descompacta na sua pasta pessoal. Não precisa de direitos de
-administrador. No Windows, abra uma nova janela do terminal depois. Então inicie o Strata:
+No Windows, abra um novo terminal depois. Em seguida:
 
 ```sh
 strata launch
 ```
 
-Ele faz uma pergunta por vez: modelo, contexto, imagens, quem pode se conectar. Depois baixa o mecanismo para a sua placa de vídeo
-(assinada e testada antes do uso) e o modelo, e começa a servir. Em scripts e agentes de IA, use flags:
-
-```sh
-strata launch --model q2_0 --yes --no-tui
-```
-
-Para ler o script de instalação antes de executá-lo, baixe-o primeiro com `curl -fsSL <address> -o install.sh`, leia e então rode
-`sh install.sh`. Todas as telas e flags: [docs/TERMINAL_LAUNCH.md](docs/TERMINAL_LAUNCH.md).
-
-### Opção C: deixe a sua IA configurar
-
-Cole isto no Claude Code, Cursor, Codex, GitHub Copilot ou outro assistente de programação:
-
-```text
-Set up Strata on this PC for me: https://github.com/Niko1221/Strata - follow docs/AI_SETUP.md in that repository.
-```
-
-Ele confere a sua placa de vídeo, a RAM e o disco, escolhe o modelo que cabe, instala e inicia, e diz como conectar os seus
-aplicativos. Ferramentas de IA também podem instalar, iniciar e parar o Strata pelo [servidor MCP](docs/MCP_SERVER.md) dele.
-
-Prefere compilar por conta própria? Veja [Compilar a partir do código-fonte](#compilar-a-partir-do-código-fonte).
-
-## Modelos
-
-O app e o `strata launch` recomendam um modelo para a sua memória. É um único modelo em vários tamanhos, mais ou menos comprimidos.
-Os tamanhos menores são mais rápidos. Os maiores são um pouco mais inteligentes.
-
-### Pouca memória? Experimente o Gyro
-
-O [Gyro](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF) (da agentionai) é a menor forma de rodar este modelo.
-
-| Tamanho | Memória necessária (RAM + VRAM) | Download | O que é |
-| --- | ---: | ---: | --- |
-| **Gyro-S** | 27,6 GB | 58,5 GB | Para PCs onde nenhum outro tamanho cabe. A qualidade é menor que a do IQ2_XS. |
-| **Gyro-M** | 35 GB | 92,0 GB | Qualidade próxima à do IQ3_XXS, com cerca de 20% menos memória da GPU. Ele escreve as respostas 17 a 21% mais devagar que o Q2_0 numa placa de 12 GB e numa R9700. |
-
-O Gyro roda em placas NVIDIA e AMD (AMD é experimental), e não roda em Intel Arc nem no Mac. Detalhes e medições:
-[docs/GYRO.md](docs/GYRO.md). Inicie com `strata launch --model gyro-s`.
-
-### Os outros tamanhos
-
-| Sua memória (RAM + VRAM) | Escolha | Observações |
-| --- | --- | --- |
-| **32 GB** | **Gyro-S**, ou o **[Coder](docs/MODELS.md#coder)** para código | O Coder precisa de 32 GB de RAM e mantém metade dos experts, então é mais fraco fora de código |
-| **40 GB** | **[Swift 1.5](docs/MODELS.md#swift-15)** IQ2_XS (39,2 GB), ou **Gyro-M** (35 GB) | O Swift pensa por menos tempo antes de responder. O Gyro-M chega perto do IQ3_XXS em qualidade, mas escreve as respostas 17 a 21% mais devagar que o Q2_0 |
-| **48 GB** | **IQ3_XXS** (47,0 GB) | Mais lento, melhor |
-| **64 GB** | **IQ3_S** (54,8 GB), o original ou o Swift 1.5 | O mais lento, o melhor: empata com o modelo completo nos testes publicados |
-| **96 GB ou mais** | **UD-IQ4_XS** da Unsloth (cerca de 72 GB de RAM) até **Q8_0** (cerca de 136 GB), de 4 a 8 bits | Mais perto do modelo completo. Com menos RAM, o Strata lê parte deles do SSD, o que é bem mais lento |
-
-Com menos RAM do que a linha indica, ainda pode funcionar: o Strata muda sozinho para o
-[modo de pouca RAM](docs/MODELS.md#a-big-graphics-card-and-little-ram). Espere mais lentidão, e muito mais com uma placa de vídeo pequena.
-
-Mais opções:
-
-- **[Swift 1.5](docs/MODELS.md#swift-15)** é um ajuste fino que pensa por menos tempo antes de responder, com qualidade e RAM parecidas.
-- **[NVFP4](docs/NVFP4.md)** é a versão de 4 bits da NVIDIA para placas NVIDIA. Precisa de cerca de 80 GB de RAM para manter todos os experts na RAM.
-- **[Qwen3.6-35B-A3B](docs/QWEN36.md)** é outro modelo, menor, que lê imagens e pode atender vários pedidos ao mesmo tempo.
-- **[Uncensored IQ3_XXS da OrcaRouter](docs/MODELS.md#orcarouter-uncensored-iq3_xxs)** é configurado manualmente.
-
-Todos os tamanhos, downloads e o que cabe em cada configuração: [docs/MODELS.md](docs/MODELS.md).
-
-## Qual é a velocidade?
-
-Com base numa placa de vídeo de 12 GB (RTX 5070, Ryzen 5 7600, 64 GB de RAM). Veja resultados de outras placas:
-[velocidade de cada modelo](docs/MODELS.md#how-fast-is-each-size), [resultados da comunidade](docs/COMMUNITY_BENCHMARKS.md).
-
-| Modelo | As respostas aparecem a | Lê o seu prompt a |
-| --- | --- | --- |
-| **Q2_0** | `████████████` 94 tokens/s | `████████████` 2.650 tokens/s |
-| **IQ2_XS** | `██████████░░` 79 tokens/s | `█████████░░░` 2.090 tokens/s |
-| **IQ3_XXS** | `████████░░░░` 62 tokens/s | `████████░░░░` 1.750 tokens/s |
-| **IQ3_S** | `███████░░░░░` 53 tokens/s | `███████░░░░░` 1.620 tokens/s |
-| **Coder** | `███████░░░░░` 55 tokens/s | `██████████░░` 2.180 tokens/s |
-
-Um token equivale a cerca de ¾ de palavra, então 60 tokens por segundo é mais rápido do que você lê. "Lê o seu prompt" é a velocidade com que o Strata
-absorve um documento longo, um código ou um histórico de conversa.
-
-Medido numa placa AMD de 16 GB (RX 9070 XT, Ryzen 9 3900X, 47 GB de RAM):
-
-| Modelo | As respostas aparecem a | Lê o seu prompt a |
-| --- | --- | --- |
-| **Q2_0** | `████████░░░░` 60 tokens/s | `█████░░░░░░░` 1.160 tokens/s |
-| **IQ2_XS** | `███████░░░░░` 52 tokens/s | `█████░░░░░░░` 1.110 tokens/s |
-| **Coder** | `██████░░░░░░` 44 tokens/s | `██████░░░░░░` 1.420 tokens/s |
-
-As barras usam a mesma escala nas duas tabelas. Uma placa com mais VRAM é mais rápida: uma RTX 3090 (24 GB) deve escrever cerca de 100 a 140
-tokens por segundo. A versão do mecanismo por trás de cada número está em [DETAILS.md](docs/DETAILS.md#speed-measured).
-
-## Como usar
-
-### No app
-
-O app tem um **Chat**, um **Monitor** do modelo e da sua GPU, CPU e RAM, uma página de **Modelos** e as **Configurações**. O chat
-pode trabalhar numa pasta do seu PC. No modo **Manual**, ele pergunta antes de alterar um arquivo ou executar um comando. Digite
-`/loop 10m <o que fazer>` para repetir uma mensagem a cada 10 minutos enquanto o chat estiver aberto.
-
-O chat pode pesquisar na web com o DuckDuckGo (ou o Bing), sem conta. Você pode adicionar uma chave de busca em **Configurações, Ferramentas**.
-A busca é o único recurso que envia algo para fora do seu PC: os termos da pesquisa.
-
-Para rodar dois modelos, ative **Executar vários modelos** e dê a cada modelo a sua própria placa da mesma marca.
-
-<p align="center"><img src="docs/media/runpagoda.png" width="900" alt="The Strata app's Monitor tab next to a coding agent"><br>
-<sub>O <b>Monitor</b> do app Strata (à esquerda) enquanto um agente de programação escreve o jardim de pagodes do vídeo (à direita)</sub></p>
-
-### No Terminal
-
-```sh
-strata launch                                  # telas guiadas: modelo, contexto, imagens, acesso e depois servir
-strata launch --model q2_0 --yes --no-tui     # sem perguntas: serve, mostra o endereço e volta
-strata launch --plan --model q2_0              # mostra o que aconteceria; nada muda
-strata launch --status                         # o que está sendo servido agora
-strata launch --stop                           # para o serviço
-strata monitor --url http://127.0.0.1:8080     # acompanha velocidade, GPU, memória e requisições
-strata update --check                          # há um mecanismo novo? (strata update instala)
-strata doctor                                  # confere os arquivos do mecanismo instalada
-```
-
-`strata --help` lista tudo. Iniciar e servir nunca baixam nada. Só a instalação, o `strata launch` (quando você
-escolhe um modelo) e o `strata update` baixam. Para acessar o Strata do celular ou de outro PC, use
-`strata launch --access lan`. Ele cria uma chave de API e não inicia numa rede sem uma. Nenhum navegador abre, a menos que
-você adicione `--open`. Guia: [docs/TERMINAL_LAUNCH.md](docs/TERMINAL_LAUNCH.md). Cliente completo: [docs/TERMINAL.md](docs/TERMINAL.md).
-
-### Com agentes de IA
-
-Um agente instala o Strata com o comando de uma linha da Opção B e executa
-`strata launch --model NAME --yes --no-tui`. Os passos, as flags e os códigos de saída estão em [docs/AI_SETUP.md](docs/AI_SETUP.md),
-e as regras do repositório estão em [AGENTS.md](AGENTS.md).
-
-### Conecte os seus outros aplicativos
-
-| Tipo de aplicativo | URL base |
-| --- | --- |
-| Compatível com OpenAI (a maioria dos apps e agentes) | `http://127.0.0.1:8080/v1` (qualquer chave de API, qualquer nome de modelo) |
-| API da Anthropic (Claude Code e outros) | `http://127.0.0.1:8080`, sem `/v1`. Esses aplicativos adicionam `/v1/messages` sozinhos. Claude Code: `ANTHROPIC_BASE_URL=http://127.0.0.1:8080` |
-| OpenAI Responses API (Codex CLI) | `http://127.0.0.1:8080/v1/responses` ([configuração](docs/DETAILS.md#the-responses-api-and-codex-cli)) |
-
-`strata connect` mostra as configurações exatas para OpenCode, Codex CLI, Claude Code, oh-my-pi, pi, Hermes Agent e OpenClaw.
-`strata connect opencode --write` grava o arquivo depois de perguntar e mantém um backup.
-
-### Imagens
-
-As imagens vêm ativadas nos modelos que sabem lê-las. Anexe ou cole uma imagem no chat, ou envie pelo seu aplicativo.
-O leitor de imagens roda no processador quando a sua placa de vídeo tem menos de 24 GB (alguns segundos por imagem, sem tirar nada
-da memória da placa) e roda na placa de vídeo a partir de 24 GB. A regra é a mesma para NVIDIA e AMD. Desative as imagens
-por modelo, ou escolha o leitor com `--vision off`, `--vision gpu` ou `--vision cpu`.
-
-Os números por trás da regra: numa Radeon AI PRO R9700, o leitor da placa levou 57 ms para uma imagem de 260 tokens e o do
-processador levou 3,1 s. Em placas de 16 GB (Tesla P100 e RTX A4000, Linux), o leitor da placa custou de 3 a 5% da velocidade do texto,
-porque ocupa cerca de 1,4 GB que o modelo usaria de outra forma. O Mac ainda não tem leitor de imagens.
-
-### Bom saber
-
-- Escolha o nível de raciocínio (**off, low, medium ou high**) no menu do chat ou no "reasoning effort" do seu aplicativo. Off é o mais rápido.
-- Por padrão, o Strata responde a um pedido por vez. Para vários ao mesmo tempo, use `--parallel N` no `strata launch` ou
-  `"parallel": 2` na configuração ([BATCHING.md](docs/BATCHING.md)). Numa placa de 12 GB, isso deixa cada resposta mais lenta.
-- O Strata lê a primeira mensagem de uma conversa por inteiro, cerca de 1 minuto a cada 30.000 tokens. As mensagens seguintes começam em segundos.
-- Onde ficam as suas conversas e a API completa: [docs/INSTALL.md](docs/INSTALL.md#where-things-are-stored), [docs/DETAILS.md](docs/DETAILS.md#using-it).
-
-## Compilar a partir do código-fonte
-
-<details>
-<summary>Windows, Linux e Mac a partir do repositório</summary>
-
-[Baixe o Strata](https://github.com/Niko1221/Strata/archive/refs/heads/main.zip) e descompacte, ou use `git clone`.
-**Windows:** dê dois cliques em `START-HERE.bat`. **Linux:** execute `./setup.sh` na pasta do Strata.
-
-**Mac (Apple Silicon, macOS 15 ou mais novo):** instale uma vez as Command Line Tools da Apple com `xcode-select --install`
-(o Xcode em si não é necessário). Abra o Terminal na pasta do Strata e execute `./setup.sh`. Ele compila o mecanismo do Mac no seu
-Mac (cerca de 7 minutos), faz as mesmas perguntas, baixa o modelo e inicia. Da próxima vez, `./setup.sh` inicia
-na hora. Qual tamanho cabe no seu Mac: [docs/MAC.md](docs/MAC.md).
-
-O instalador encontra a sua placa e configura o mecanismo certo. Ele pergunta qual modelo e tamanho, quanto contexto (quanto texto
-o modelo mantém em mente) e se deve ler imagens. Pressione Enter para aceitar a resposta recomendada. Depois ele baixa o
-modelo (cerca de 70 GB) e inicia. Se o download parar, execute de novo e ele continua. O navegador abre a página do Strata em
-`http://127.0.0.1:8080`.
-
-> Enquanto o modelo inicia, o seu PC pode ficar lento ou parar de responder por 1 a 3 minutos (mais tempo na primeira vez). O Strata carrega
-> de 35 a 55 GB na sua RAM e trava parte dela para a placa de vídeo. Espere e não feche a janela.
-
-Da próxima vez, execute `START-HERE.bat` (ou `./setup.sh`) de novo. Ele inicia na hora e não baixa nada duas vezes. Feche a janela
-dele para parar o modelo. `UPDATE.bat` (`./update.sh`) atualiza o Strata sem iniciá-lo. Atualização, Docker, várias placas,
-onde ficam os arquivos e todas as opções: [docs/INSTALL.md](docs/INSTALL.md).
-
-Para medir o seu PC, execute `BENCH.bat` (`./bench.sh`). Leva de 5 a 10 minutos e gera um relatório que você pode compartilhar
-([como](docs/COMMUNITY_BENCHMARKS.md#run-the-benchmark)).
-
-**Opcional: mais velocidade numa placa quando o modelo inteiro cabe na RAM.** Duas configurações opcionais do RubenTorney (#1904, #1905).
-Elas ajudam quando você usa uma placa de vídeo e a sua RAM comporta todos os experts, por exemplo Q2_0 ou IQ3_XXS num PC de 64 GB. Abra
-`strata-<model>.json` na pasta de dados do Strata ([onde fica](docs/INSTALL.md#where-things-are-stored)) e adicione:
-
-- `"--adapt-async", "1"` à lista `"args"`. O cache de experts passa a ser atualizado numa thread auxiliar, em vez de pausar a
-  resposta. Medido numa RTX 5070 (Windows, Q2_0): +4 a 5% na geração, +7 a 10% em código e documentos longos. As respostas podem diferir
-  um pouco do padrão e continuam iguais de uma execução para outra.
-- `"STRATA_PIN_BY_NEED": "1"` no bloco `"env"` (Windows). O Windows só consegue travar cerca de metade da RAM para a placa
-  de vídeo, e isso trava primeiro os experts de que a placa precisa. Medido na RTX 5070: +4,4% na leitura do prompt.
-
-```json
-"args": [ ..., "--adapt-async", "1" ],
-"env": { "STRATA_PIN_BY_NEED": "1" }
-```
-
-Reinicie o Strata depois da alteração. Para desfazer, remova as duas entradas.
+Siga as instruções para baixar e iniciar um modelo. [Guia do Terminal](docs/TERMINAL_LAUNCH.md).
 
 </details>
 
-## Como funciona?
+<p align="center">
+  <img src="docs/media/terminal-monitor.png" width="900" alt="Aplicativo de Terminal do Strata mostrando a atividade do modelo, a velocidade, a memória e as solicitações recentes">
+  <br><sub>Acompanhe seu modelo e seu hardware enquanto ele roda.</sub>
+</p>
 
-Modelos como este costumam rodar em servidores com centenas de gigabytes de memória de vídeo. A sua placa de vídeo tem
-12 a 24 GB. O Strata faz o modelo caber dividindo o trabalho entre o PC inteiro. Imagine uma biblioteca.
+<a id="build-from-source"></a>
 
-- O modelo é uma equipe de 24.576 pequenos especialistas ("experts"), como 24.576 livros de consulta. Cada palavra precisa de apenas 10 deles.
-- **A sua placa de vídeo é a mesa.** Ela é pequena e rápida. Os cerca de 4.000 livros mais usados ficam abertos nela.
-- **A sua RAM são as estantes da sala de leitura.** Os 24.576 livros estão lá. Quando uma palavra precisa de um livro que não está na
-  mesa, o seu processador lê da estante na hora, enquanto a placa continua trabalhando.
-- **O seu SSD é o arquivo.** Ele guarda uma tabela de consulta de 29 GB. O modelo lê algumas linhas dela por palavra, então ela não
-  precisa ficar na RAM.
+[Compilar a partir do código-fonte](docs/SOURCE_INSTALL.md) · [Docker](docs/DOCKER.md) · [Guia de instalação completo](docs/INSTALL.md)
 
-<p align="center"><img src="docs/media/how-it-works.svg" width="860" alt="The model's 24,576 experts: the busiest on the graphics card, all of them in RAM, a lookup table on the SSD"></p>
+<a id="what-you-need"></a>
 
-Um pequeno ajudante também adivinha as próximas palavras. O modelo grande confere todas de uma vez e fica com as certas. Você recebe
-a mesma resposta, de 1,6 a 1,8 vez mais rápido. Textos longos são lidos em blocos grandes, de até 8.192 tokens por vez, a mais de 1.000 tokens
-por segundo.
+## Hardware
 
-<p align="center"><img src="docs/media/guess-and-check.svg" width="860" alt="A small helper guesses the next words; the big model checks them all at once and keeps the right ones"></p>
+| Hardware compatível | Guia |
+| --- | --- |
+| **NVIDIA GeForce RTX 20 / 30 / 40 / 50** | [Instalação para NVIDIA](docs/INSTALL.md#what-you-need) |
+| **AMD Radeon RX 7700 / 7800 / 7900, RX 9060 / 9070, AI PRO R9700** | [Instalação para AMD](docs/AMD_HIP.md) |
+| **AMD Radeon RX 6800 / 6900 · experimental** | [Instalação para RX 6000](docs/AMD_HIP.md#rdna2-gfx1030) |
+| **Intel Arc · Linux** | [Instalação para Intel](docs/INTEL_ARC.md) |
+| **Apple Silicon · M1 ou mais novo** | [Instalação para Mac](docs/MAC.md) |
+| **AMD Ryzen AI Max · Strix Halo** | [Instalação para Strix Halo](docs/STRIX_HALO.md) |
 
-A explicação mais longa: [docs/HOW_IT_WORKS.md](docs/HOW_IT_WORKS.md). Cada parte e seus números:
-[os detalhes](docs/DETAILS.md#how-it-works) e o [artigo](docs/paper/Strata-Paper.pdf).
+<a id="using-it"></a>
 
-## Algo deu errado?
+## Ferramentas
 
-- **Meu PC travou na primeira vez que o Strata iniciou.** Ele carrega o modelo na RAM. Espere e não feche a janela. Ainda
-  travado depois de 10 minutos? Reinicie o PC, feche outros programas e tente de novo, ou escolha um tamanho menor.
-- **Parou durante o download ou a instalação.** Abra o app ou o `strata launch` de novo, ou execute `START-HERE.bat` (ou
-  `./setup.sh`) outra vez. Ele continua de onde parou.
-- **Está muito lento, a luz do disco não para de piscar, ou aparece "o mecanismo parou inesperadamente".** O seu PC não tem
-  RAM livre suficiente. Feche outros programas (os navegadores usam muita), ou escolha um tamanho menor, como Q2_0 ou IQ2_XS.
-- **Diz que não há mecanismo para este PC.** No app, abra **Configurações, Mecanismo** e clique em **Atualizar mecanismo**. No
-  Terminal, execute `strata update`. O `strata doctor` mostra quais arquivos do mecanismo estão instalados.
-- **Diz que a porta 8080 já está em uso.** O Strata já está rodando. Procure a janela dele.
+**Claude Code · Codex CLI · OpenCode · oh-my-pi · pi.dev · Hermes Agent · OpenClaw**, e outras, pelas APIs compatíveis com OpenAI e Anthropic.
 
-Mais problemas e soluções: [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md). Ainda sem resolver? Abra uma
-[issue](https://github.com/Niko1221/Strata/issues). No app, anexe o arquivo de **Configurações, Mecanismo, Diagnóstico, Ver
-registros, Salvar logs**. No Terminal, cole a saída de `strata doctor`. Se estiver rodando pelo código-fonte, anexe o `strata-<model>.log` da pasta do
-Strata. Para um problema de segurança, informe em particular: [SECURITY.md](SECURITY.md).
+Execute **`strata connect`** para ver as instruções da sua ferramenta. [Guia de conexão](docs/TERMINAL_LAUNCH.md#connect-your-apps-strata-connect).
 
-## Créditos e licença
+<a id="guides"></a>
+<a id="how-fast-is-it"></a>
+<a id="how-does-it-work"></a>
+<a id="something-went-wrong"></a>
 
-O modelo é o [Qwen3.8-Flash-Next](https://huggingface.co/Qwen/Qwen3.8-Flash-Next), da equipe Qwen. Ele foi comprimido por
-[ISTA-DASLab](https://huggingface.co/ISTA-DASLab/Qwen3.8-Flash-Next-GSQ-RCO-GGUF), UkisAI (Swift 1.5), agentionai (Gyro)
-e Unsloth. O Strata usa partes do [llama.cpp / ggml](https://github.com/ggml-org/llama.cpp). Todos os créditos:
-[docs/HOW_IT_WORKS.md](docs/HOW_IT_WORKS.md#credits). O Strata é de código aberto sob a [Licença MIT](LICENSE). Algumas partes e
-todos os modelos têm licenças próprias ([quais](docs/HOW_IT_WORKS.md#license)).
+## Ajuda
 
-## Contribuindo
-
-Encontrou um bug, ou quer enviar uma alteração ou um benchmark? Leia primeiro o [CONTRIBUTING.md](CONTRIBUTING.md). Ele diz o que
-incluir para que outras pessoas possam conferir o seu trabalho.
+[Todos os guias](docs) · [Solução de problemas](docs/TROUBLESHOOTING.md) · [Relatar um bug](https://github.com/Niko1221/Strata/issues/new/choose) ·
+[Benchmarks](docs/COMMUNITY_BENCHMARKS.md) · [Como funciona](docs/HOW_IT_WORKS.md) · [Contribuir](CONTRIBUTING.md)
 
 ## Apoie o Strata
 
-O Strata é gratuito e tem licença MIT. Eu o desenvolvo e testo em todo hardware que consigo arranjar. Se ele roda bem no seu PC, um café me ajuda
-a continuar testando placas novas e corrigindo o que você relatar. Sem pressão. Usar e relatar o que encontrar ajuda tanto quanto.
+**Ajude a manter a IA local aberta para todos.** Um café ajuda a financiar o desenvolvimento e os testes em mais hardware.
 
-<a href="https://buymeacoffee.com/strataengine"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="50"></a>
+<a href="https://buymeacoffee.com/strataengine"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me a Coffee: apoie o Strata" height="48"></a>
 
-Quer patrocinar o Strata? Fale comigo pelo [GitHub](https://github.com/Niko1221).
+[Licença MIT](LICENSE) · [Créditos e licenças dos modelos](docs/HOW_IT_WORKS.md#credits) · [Privacidade](docs/SAFETY.md)
+
+<a id="option-c-let-your-ai-set-it-up"></a>
+
+<sub>Para ferramentas de IA e leitores automáticos: <a href="AGENTS.md">referência técnica</a> · <a href="docs/AI_SETUP.md">instruções de instalação</a>.</sub>
+
+**Patrocínios, parcerias de hardware ou colaborações:** [[email protected]](mailto:[email protected]).

README.zh-CN.md

@@ -1,376 +1,188 @@
 <p align="center">
   <picture>
     <source media="(prefers-color-scheme: dark)" srcset="apps/host/public/brand/strata-lockup-dark.svg">
-    <img src="apps/host/public/brand/strata-lockup-light.svg" alt="Strata" width="380">
+    <img src="apps/host/public/brand/strata-lockup-light.svg" alt="Strata" width="340">
   </picture>
 </p>
 
-<p align="center"><a href="README.md">English</a> · <b>简体中文</b> · <a href="README.ja.md">日本語</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.es.md">Español</a> · <a href="README.pt-BR.md">Português</a></p>
-
-<h3 align="center">在你自己的游戏电脑上运行最先进的模型</h3>
-
-<p align="center">支持 NVIDIA、AMD、Intel · Windows、Linux、Mac · 免费开源</p>
+<h3 align="center">在你自己的电脑上运行强大的 AI。</h3>
+<p align="center">本地聊天、写代码、处理图片。</p>
 
 <p align="center">
-  <a href="https://github.com/Niko1221/Strata/releases"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?include_prereleases&label=release" alt="Latest release"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="MIT license"></a>
-  <a href="https://github.com/Niko1221/Strata/stargazers"><img src="https://img.shields.io/github/stars/Niko1221/Strata?style=flat" alt="GitHub stars"></a>
+  <a href="#模型">模型</a> · <a href="#安装"><b>安装</b></a> ·
+  <a href="#硬件">硬件</a> · <a href="#工具">工具</a> ·
+  <a href="#帮助">帮助</a> · <a href="#支持-strata">支持</a>
 </p>
 
-<p align="center"><a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4"><img src="docs/media/pagoda-preview.webp" width="720" alt="A voxel pagoda garden that Strata's model wrote, running in the browser"></a><br>
-<sub>一座体素宝塔花园，由一条提示词一次生成，在装有 RTX 5070 的电脑上用 Strata 运行（IQ3_S，128K 上下文） ·
-<a href="https://github.com/Niko1221/Strata/releases/download/v0.1.10/Pagoda.mp4">完整视频（49 秒）</a></sub></p>
+<p align="center">
+  <a href="https://github.com/Niko1221/Strata/releases/latest"><img src="https://img.shields.io/github/v/release/Niko1221/Strata?label=download&color=0ab887" alt="下载 Strata"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/Niko1221/Strata" alt="MIT 许可证"></a>
+  <a href="https://buymeacoffee.com/strataengine"><img src="https://img.shields.io/badge/Buy_me_a_coffee-FFDD00?logo=buymeacoffee&logoColor=000" alt="在 Buy Me a Coffee 上支持 Strata"></a>
+</p>
 
-Strata 运行 **[Qwen3.8-Flash-Next](https://huggingface.co/Qwen/Qwen3.8-Flash-Next)**。这是一个 1250 亿参数的模型，
-通常需要服务器才能跑，现在用普通电脑就行。它能聊天、写代码、看图片，也能配合你的应用和编程智能体使用。
-你的聊天记录和文件都留在你自己的电脑上。
+<p align="center"><sub><a href="README.md">English</a> · <b>简体中文</b> · <a href="README.ja.md">日本語</a> · <a href="README.de.md">Deutsch</a> · <a href="README.fr.md">Français</a> · <a href="README.es.md">Español</a> · <a href="README.pt-BR.md">Português</a> · <a href="README.pl.md">Polski</a></sub></p>
 
-**第一次用？** 先看[硬件要求](#硬件要求)，再[安装应用](#方式-astrata-应用)。
+**免费、开源，由你自己运行。** 在桌面上使用 Strata，或搭配你喜欢的编程工具。无需账号。
 
-- **游戏电脑就能跑。** 内存和显存加起来有 32 GB 就可以开始。
-- **能接入你的工具。** 支持 OpenAI 和 Anthropic 的 API，Claude Code、Codex CLI、OpenCode 等智能体都能连上。
-- **能看图片。** 默认开启。
-- **免费。** MIT 许可证，不用注册账号，不走云端。
-- **隐私。** 没有遥测。Strata 下载什么、什么时候联网、如何校验下载内容，都写在 [docs/SAFETY.md](docs/SAFETY.md)。
+## 模型
 
-版本 0.2.0-beta · 引擎 0.1.45.3
+我们**首先推荐 ISTA-DASLab**，其次是 **Unsloth** 和其他提供方，前提是有内存放得下的兼容模型。
 
-## 硬件要求
+<details>
+<summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.8-Flash-Next</b></summary>
 
-**内存和显存（VRAM）加起来至少要有 32 GB。** Mac 和 Ryzen AI Max 上指的是统一内存。内存越大，能跑的模型越大，
-或者速度越快。
-
-- 32 GB 内存加一张 12-16 GB 显存的显卡，可以跑 Coder。
-- 64 GB 内存可以跑所有尺寸。
-
-| 你的电脑 | 说明 |
+| 提供方 | 可选项 |
 | --- | --- |
-| **NVIDIA** GeForce RTX 20、30、40、50 系列（12 GB 及以上） | 安装应用或终端版即可。 |
-| **AMD** Radeon RX 6800 及更新型号、Radeon AI PRO R9700（12 GB 及以上） | [AMD 显卡](docs/AMD_HIP.md) |
-| **Intel** Arc | [Intel Arc](docs/INTEL_ARC.md)、[Intel 引擎](docs/INTEL.md) |
-| **Apple 芯片 Mac**（M1 及更新，macOS 15 及以上） | [Mac](docs/MAC.md) |
-| **AMD Ryzen AI Max（Strix Halo）** 及其他统一内存系统 | [Strix Halo](docs/STRIX_HALO.md) |
-| 较旧的显卡和处理器 | [旧显卡](docs/OLDER_GPUS.md)、[旧处理器](docs/INSTALL.md#older-cpus-experimental) |
+| **ISTA-DASLab · 推荐** | Q2\_0, IQ2\_XS, IQ3\_XXS, IQ3\_S。[Coder：IQ1\_M](docs/MODELS.md#coder)，适合写代码。 |
+| **Unsloth** | UD-IQ4\_XS, UD-Q4\_K\_XL, UD-Q5\_K\_XL, UD-Q6\_K\_XL, Q8\_0 |
+| **Gyro · agentionai** | [Gyro-S, Gyro-M](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF)。占用内存更少，但速度更慢。 |
+| **其他选项** | [Swift 1.5](docs/MODELS.md#swift-15), [NVFP4](docs/NVFP4.md), [OrcaRouter](docs/ORCA.md) |
 
-另外还需要：
+[比较大小、内存需求和兼容性](docs/MODELS.md)。
 
-- 约 80 GB 的可用磁盘空间（用固态硬盘，首次启动会快很多）
-- Windows 10 / 11、Linux 或 macOS
-- 较新的显卡驱动
+</details>
 
-同一品牌的两三张显卡可以共同运行一个模型（[多显卡](docs/MULTI_GPU.md)）。Strata 不会把一个模型拆到 NVIDIA 和 AMD
-显卡上。完整列表见 [docs/INSTALL.md](docs/INSTALL.md#what-you-need)。
+<details>
+<summary><img src="docs/media/models/qwen.svg" width="22" alt="" align="middle"> &nbsp;<b>Qwen3.6-35B-A3B</b></summary>
+
+**Unsloth:** UD-Q4_K_XL, UD-Q6_K_XL, Q8_0。这些是目前文档中收录的该模型的版本。
+
+[模型指南和兼容性](docs/QWEN36.md)。
+
+</details>
+
+<details>
+<summary><img src="docs/media/models/deepseek.svg" width="22" alt="" align="middle"> &nbsp;<b>DeepSeekV4.1-Flash-1017</b></summary>
+
+可在**桌面应用**和**终端**中使用。内存放不下的部分会从 SSD 读取，所以需要大量空闲磁盘空间。
+
+| 版本（ISTA-DAS） | 下载大小 | 所需空闲磁盘 |
+| --- | ---: | ---: |
+| 1.75 bpw | 239 GB | 约245 GB |
+| 2.00 bpw | 257 GB | 约265 GB |
+| 2.25 bpw | 274 GB | 约280 GB |
+
+支持 NVIDIA RTX 30、40 和 50 系列（Windows 和 Linux），以及 AMD Radeon AI PRO R9700（Linux）。安装程序会下载模型文件和 DeepSeek 引擎，然后启动模型。
+
+```sh
+strata launch --family deepseek41 --model ist-das-2.00bpw --plan
+```
+
+以下为 Strata 0.2.5 上 2.00 bpw 版本的实测结果。“输出”是回答的速度，“提示词”是 Strata 读取你输入内容的速度。
+
+| 硬件 | 输出 | 提示词 |
+| --- | ---: | ---: |
+| RTX 5070 12 GB, 64 GB 内存 | 4 到 6 tokens/s | 约 110 tokens/s（4K） |
+| RTX 3060 12 GB, 46 GB 内存 | 9 到 11 tokens/s | 约 155 tokens/s（4K） |
+| 1x Radeon AI PRO R9700, 251 GB 内存 | 21 到 25 tokens/s | 320 到 360 tokens/s (8K) |
+| 4x Radeon AI PRO R9700 | 74 到 77 tokens/s | 400 到 450 tokens/s (8K) |
+
+[内存、磁盘和详细信息](docs/DEEPSEEK41.md) · [发行说明](https://github.com/Niko1221/Strata/releases)
+
+</details>
+
+<a id="the-other-sizes"></a>
+
+不确定哪个放得下？[为你的电脑选择模型](docs/MODELS.md#pick-by-memory)。
 
 ## 安装
 
-三种方式任选一种。它们启动的是同一个引擎，用的是同样的模型。
+<a id="option-a-the-strata-app"></a>
 
-### 方式 A：Strata 应用
+### 桌面应用
 
-最简单的方式。应用内置引擎：安装、选模型、开始聊天。请根据你的系统和显卡，从
-[发布页](https://github.com/Niko1221/Strata/releases/latest)下载对应的文件。不确定选哪个？看表格下面那一段。
+**[下载适用于 Windows、Linux 或 Mac 的 Strata →](https://github.com/Niko1221/Strata/releases/latest)**
 
-| 系统 | 你的显卡 | 要下载的文件 |
-| --- | --- | --- |
-| **Windows 10 / 11** | NVIDIA RTX，驱动 580 或更新 | [`Strata-0.2.0-beta-windows-cuda13.exe`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-windows-cuda13.exe) |
-| | NVIDIA，较旧的显卡，或驱动低于 580 | [`Strata-0.2.0-beta-windows-cuda12.exe`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-windows-cuda12.exe) |
-| | AMD Radeon RX 9000 系列或 Radeon AI PRO R9700 | [`Strata-0.2.0-beta-windows-hip.exe`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-windows-hip.exe) |
-| **Linux** | NVIDIA RTX，驱动 580 或更新 | [`Strata-0.2.0-beta-linux-nvidia-cuda13.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-nvidia-cuda13.AppImage) |
-| | NVIDIA，较旧的显卡，或驱动低于 580 | [`Strata-0.2.0-beta-linux-nvidia-cuda12.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-nvidia-cuda12.AppImage) |
-| | AMD Radeon RX 9000 系列或 Radeon AI PRO R9700 | [`Strata-0.2.0-beta-linux-amd-rx9070.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-amd-rx9070.AppImage) |
-| | AMD Radeon RX 7000 系列 | [`Strata-0.2.0-beta-linux-amd-rx7900.AppImage`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-linux-amd-rx7900.AppImage) |
-| **Mac**（Apple 芯片，macOS 15 及以上） | 内置 | [`Strata-0.2.0-beta-mac.dmg`](https://github.com/Niko1221/Strata/releases/latest/download/Strata-0.2.0-beta-mac.dmg) |
+安装应用，选择模型，就可以开始聊天。每个系统只有一个安装程序。首次启动时，应用会下载适合你显卡的引擎。[安装程序帮助](docs/INSTALL.md#the-app)。
 
-**不确定时：** NVIDIA 显卡的驱动版本在 580 及以上就选 `cuda13`，否则选 `cuda12`。`cuda12` 适用于较旧的显卡和驱动。
-`hip` 和 `amd` 的文件是给 AMD 显卡用的。其他 AMD 显卡（RX 6000，或 Windows 上的 RX 7000）目前还没有现成的应用，
-请看 [AMD 显卡](docs/AMD_HIP.md)。
+<sub>文件: `Strata-0.2.9-windows-x64-setup.exe` · `Strata-0.2.9-linux-x86_64.AppImage` · `Strata-0.2.9-macos-arm64.dmg`</sub>
 
-然后：
+<p align="center">
+  <img src="docs/media/app-chat.png" width="900" alt="Strata 桌面应用，聊天和实时代码预览并排显示">
+  <br><sub>聊天、文件和实时预览都在一个窗口里。</sub>
+</p>
 
-- **Windows：** 运行 `.exe`。它只为当前用户安装，不需要管理员权限。如果 Windows 提示“Windows 已保护你的电脑”，
-  点击**更多信息**，再点**仍要运行**（安装程序还没有代码签名）。
-- **Linux：** 给文件加上可执行权限（`chmod +x`），然后启动。需要 FUSE 2：`sudo apt install libfuse2`（Ubuntu 22.04），
-  或 `libfuse2t64`（Ubuntu 24.04 及更新）。
-- **Mac：** 打开 `.dmg`，把 Strata 拖到“应用程序”。
+<a id="option-b-the-terminal-one-line"></a>
 
-第一个界面里，应用会检测你的电脑，并推荐合适的模型。点击安装即可。模型很大，要下载约 40-70 GB，中断后会从断点继续。
-关闭窗口会同时停止 Strata 和引擎。
+### 终端应用
 
-### 方式 B：终端（一行命令）
+更喜欢终端？安装 Strata，然后运行 **`strata launch`**。
 
-终端版就是 `strata` 命令，适合脚本、服务器和 AI 智能体。
+<details open>
+<summary><b>安装命令</b></summary>
 
-Linux 和 Mac：
+**Linux / Mac**
 
 ```sh
-curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh | sh
+curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh
 ```
 
-Windows（PowerShell）：
+**Windows PowerShell**
 
 ```powershell
 irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex
 ```
 
-脚本会检查你的电脑，下载终端版，校验 SHA-256，然后解压到你的用户目录。不需要管理员权限。在 Windows 上，装完后请
-打开一个新的终端窗口。然后启动 Strata：
+在 Windows 上，安装后请打开一个新的终端。然后运行：
 
 ```sh
 strata launch
 ```
 
-它会一次问一个问题：模型、上下文、图片、允许谁连接。接着为你的显卡下载引擎（已签名，使用前会先试启动），再下载
-模型，并开始提供服务。在脚本和 AI 智能体里，请使用参数：
-
-```sh
-strata launch --model q2_0 --yes --no-tui
-```
-
-如果想在运行前先看看安装脚本，先用 `curl -fsSL <address> -o install.sh` 下载，读完后再用 `sh install.sh` 运行。
-所有界面和参数见 [docs/TERMINAL_LAUNCH.md](docs/TERMINAL_LAUNCH.md)。
-
-### 方式 C：让你的 AI 来安装
-
-把下面这段话粘贴到 Claude Code、Cursor、Codex、GitHub Copilot 或其他编程助手里：
-
-```text
-Set up Strata on this PC for me: https://github.com/Niko1221/Strata - follow docs/AI_SETUP.md in that repository.
-```
-
-它会检查你的显卡、内存和磁盘，选出合适的模型，完成安装和启动，并告诉你怎么连接你的应用。AI 工具也可以通过 Strata 的
-[MCP 服务器](docs/MCP_SERVER.md)安装、启动和停止 Strata。
-
-想自己动手编译？请看[从源码构建](#从源码构建)。
-
-## 模型
-
-应用和 `strata launch` 会按你的内存推荐模型。它是同一个模型的几种尺寸，压缩程度不同。尺寸小的更快，尺寸大的稍微更聪明一点。
-
-### 内存不够？试试 Gyro
-
-[Gyro](https://huggingface.co/agentionai/Qwen3.8-Flash-Next-Gyro-GGUF)（作者 agentionai）是运行这个模型占用最小的方式。
-
-| 尺寸 | 所需内存（RAM + VRAM） | 下载大小 | 说明 |
-| --- | ---: | ---: | --- |
-| **Gyro-S** | 27.6 GB | 58.5 GB | 给其他尺寸都放不下的电脑。质量低于 IQ2_XS。 |
-| **Gyro-M** | 35 GB | 92.0 GB | 质量约相当于 IQ3_XXS，显存占用少约 20%。在 12 GB 显卡和 R9700 上，输出回答比 Q2_0 慢 17-21%。 |
-
-Gyro 可在 NVIDIA 和 AMD 显卡上运行（AMD 为实验性支持），不支持 Intel Arc 和 Mac。详情和测试数据：
-[docs/GYRO.md](docs/GYRO.md)。用 `strata launch --model gyro-s` 启动。
-
-### 其他尺寸
-
-| 你的内存（RAM + VRAM） | 选择 | 备注 |
-| --- | --- | --- |
-| **32 GB** | **Gyro-S**，写代码可选 **[Coder](docs/MODELS.md#coder)** | Coder 需要 32 GB 内存，只保留一半的专家，所以代码以外的能力较弱 |
-| **40 GB** | **[Swift 1.5](docs/MODELS.md#swift-15)** IQ2_XS（39.2 GB），或 **Gyro-M**（35 GB） | Swift 回答前思考的时间更短。Gyro-M 的质量接近 IQ3_XXS，但输出回答比 Q2_0 慢 17-21% |
-| **48 GB** | **IQ3_XXS**（47.0 GB） | 更慢，更好 |
-| **64 GB** | **IQ3_S**（54.8 GB），原版或 Swift 1.5 | 最慢，最好：在公开测试中与完整模型持平 |
-| **96 GB 及以上** | Unsloth 的 **UD-IQ4_XS**（约 72 GB 内存）到 **Q8_0**（约 136 GB），4 到 8 位 | 更接近完整模型。内存不足时，Strata 会从固态硬盘读取一部分，速度会慢很多 |
-
-内存比这一行写的少，也可能能用：Strata 会自动切换到[低内存模式](docs/MODELS.md#a-big-graphics-card-and-little-ram)。
-速度会变慢，显卡较小时会慢得多。
-
-更多选择：
-
-- **[Swift 1.5](docs/MODELS.md#swift-15)** 是微调版本，回答前思考的时间更短，质量和内存占用大致相同。
-- **[NVFP4](docs/NVFP4.md)** 是 NVIDIA 为 NVIDIA 显卡提供的 4 位版本。要把所有专家放进内存，需要约 80 GB 内存。
-- **[Qwen3.6-35B-A3B](docs/QWEN36.md)** 是另一个更小的模型，能看图片，还能同时回答多个请求。
-- **[OrcaRouter 的 Uncensored IQ3_XXS](docs/MODELS.md#orcarouter-uncensored-iq3_xxs)** 需要手动设置。
-
-所有尺寸、下载大小，以及各种配置能跑什么：[docs/MODELS.md](docs/MODELS.md)。
-
-## 速度如何？
-
-以下数据基于 12 GB 显卡（RTX 5070、Ryzen 5 7600、64 GB 内存）。其他显卡的结果见：
-[各模型的速度](docs/MODELS.md#how-fast-is-each-size)、[社区测试结果](docs/COMMUNITY_BENCHMARKS.md)。
-
-| 模型 | 回答输出速度 | 读取提示词速度 |
-| --- | --- | --- |
-| **Q2_0** | `████████████` 94 tokens/s | `████████████` 2,650 tokens/s |
-| **IQ2_XS** | `██████████░░` 79 tokens/s | `█████████░░░` 2,090 tokens/s |
-| **IQ3_XXS** | `████████░░░░` 62 tokens/s | `████████░░░░` 1,750 tokens/s |
-| **IQ3_S** | `███████░░░░░` 53 tokens/s | `███████░░░░░` 1,620 tokens/s |
-| **Coder** | `███████░░░░░` 55 tokens/s | `██████████░░` 2,180 tokens/s |
-
-一个 token 约等于 ¾ 个英文单词，所以每秒 60 个 token 比你阅读的速度还快。“读取提示词”指 Strata 吸收长文档、代码或聊天历史的速度。
-
-在 16 GB 的 AMD 显卡上测得的结果（RX 9070 XT、Ryzen 9 3900X、47 GB 内存）：
-
-| 模型 | 回答输出速度 | 读取提示词速度 |
-| --- | --- | --- |
-| **Q2_0** | `████████░░░░` 60 tokens/s | `█████░░░░░░░` 1,160 tokens/s |
-| **IQ2_XS** | `███████░░░░░` 52 tokens/s | `█████░░░░░░░` 1,110 tokens/s |
-| **Coder** | `██████░░░░░░` 44 tokens/s | `██████░░░░░░` 1,420 tokens/s |
-
-两张表的进度条使用同一个比例。显存更大的显卡更快：RTX 3090（24 GB）每秒大约能输出 100-140 个 token。每个数字对应的引擎版本见
-[DETAILS.md](docs/DETAILS.md#speed-measured)。
-
-## 使用方法
-
-### 在应用里
-
-应用包含**聊天**、显示模型以及 GPU、CPU 和内存状态的**监控**、**模型**页面和**设置**。聊天可以在你电脑上的某个文件夹里工作。
-在**手动**模式下，修改文件或运行命令之前它会先询问你。输入 `/loop 10m <要做的事>`，在聊天保持打开期间每 10 分钟重复发送一次消息。
-
-聊天可以用 DuckDuckGo（或 Bing）搜索网页，不需要账号。你也可以在**设置，工具**里添加搜索密钥。搜索是唯一会把内容发出电脑的功能，
-发出的就是搜索词。
-
-要同时运行两个模型，请打开**运行多个模型**，并为每个模型分配同一品牌的单独一张显卡。
-
-<p align="center"><img src="docs/media/runpagoda.png" width="900" alt="The Strata app's Monitor tab next to a coding agent"><br>
-<sub>Strata 应用的<b>监控</b>（左），右边是编程智能体正在写视频里的宝塔花园</sub></p>
-
-### 在终端里
-
-```sh
-strata launch                                  # 引导界面：模型、上下文、图片、访问方式，然后开始服务
-strata launch --model q2_0 --yes --no-tui     # 不提问：开始服务，打印地址，然后返回
-strata launch --plan --model q2_0              # 显示将要执行的操作；不做任何更改
-strata launch --status                         # 当前正在提供什么服务
-strata launch --stop                           # 停止服务
-strata monitor --url http://127.0.0.1:8080     # 查看速度、GPU、内存和请求
-strata update --check                          # 有新引擎吗？（strata update 会安装它）
-strata doctor                                  # 检查已安装的引擎文件
-```
-
-`strata --help` 会列出所有命令。启动和提供服务时不会下载任何东西。只有安装、`strata launch`（在你选择模型时）和
-`strata update` 会下载。要从手机或另一台电脑访问 Strata，请使用 `strata launch --access lan`。它会生成一个 API 密钥，
-没有密钥就不会在网络上启动。除非你加上 `--open`，否则不会打开浏览器。指南：[docs/TERMINAL_LAUNCH.md](docs/TERMINAL_LAUNCH.md)。
-完整的客户端说明：[docs/TERMINAL.md](docs/TERMINAL.md)。
-
-### 配合 AI 智能体
-
-智能体用方式 B 中的一行命令安装 Strata，然后运行 `strata launch --model NAME --yes --no-tui`。步骤、参数和退出码见
-[docs/AI_SETUP.md](docs/AI_SETUP.md)，仓库规则见 [AGENTS.md](AGENTS.md)。
-
-### 连接你的其他应用
-
-| 应用类型 | 基础 URL |
-| --- | --- |
-| 兼容 OpenAI（大多数应用和智能体） | `http://127.0.0.1:8080/v1`（API 密钥和模型名称随便填） |
-| Anthropic API（Claude Code 等） | `http://127.0.0.1:8080`，不带 `/v1`。这些应用会自己加上 `/v1/messages`。Claude Code：`ANTHROPIC_BASE_URL=http://127.0.0.1:8080` |
-| OpenAI Responses API（Codex CLI） | `http://127.0.0.1:8080/v1/responses`（[设置方法](docs/DETAILS.md#the-responses-api-and-codex-cli)） |
-
-`strata connect` 会打印 OpenCode、Codex CLI、Claude Code、oh-my-pi、pi、Hermes Agent 和 OpenClaw 的具体设置。
-`strata connect opencode --write` 会在询问后写入配置文件，并保留备份。
-
-### 图片
-
-能看图片的模型默认开启图片功能。在聊天里附加或粘贴图片，或者从你的应用发送图片。显卡的显存小于 24 GB 时，读图由处理器完成
-（每张图片几秒钟，不占用显卡的显存）；显存达到 24 GB 时，由显卡完成。NVIDIA 和 AMD 的规则相同。你可以按模型关闭图片功能，
-也可以用 `--vision off`、`--vision gpu` 或 `--vision cpu` 选择读图方式。
-
-这条规则背后的数据：在 Radeon AI PRO R9700 上，显卡读一张 260 token 的图片用了 57 ms，处理器用了 3.1 秒。在 16 GB 的显卡
-（Tesla P100 和 RTX A4000，Linux）上，用显卡读图会让文字速度下降 3-5%，因为它占用约 1.4 GB 显存，否则这部分会被模型使用。
-Mac 目前还没有读图功能。
-
-### 使用须知
-
-- 在聊天菜单或你的应用的“reasoning effort”里选择思考级别（**off、low、medium 或 high**）。off 最快。
-- Strata 默认一次回答一个请求。要同时处理多个，请在 `strata launch` 中使用 `--parallel N`，或在配置里写
-  `"parallel": 2`（[BATCHING.md](docs/BATCHING.md)）。在 12 GB 显卡上，这会让每个回答变慢。
-- Strata 会完整读取聊天的第一条消息，每 30,000 个 token 约需 1 分钟。之后的消息几秒钟就开始。
-- 聊天记录存放的位置和完整的 API：[docs/INSTALL.md](docs/INSTALL.md#where-things-are-stored)、[docs/DETAILS.md](docs/DETAILS.md#using-it)。
-
-## 从源码构建
-
-<details>
-<summary>从仓库构建 Windows、Linux 和 Mac 版本</summary>
-
-[下载 Strata](https://github.com/Niko1221/Strata/archive/refs/heads/main.zip)并解压，或者用 `git clone` 获取。
-**Windows：** 双击 `START-HERE.bat`。**Linux：** 在 Strata 文件夹里运行 `./setup.sh`。
-
-**Mac（Apple 芯片，macOS 15 及以上）：** 先用 `xcode-select --install` 安装一次 Apple 的命令行工具（不需要完整的 Xcode）。
-在 Strata 文件夹里打开终端，运行 `./setup.sh`。它会在你的 Mac 上构建 Mac 引擎（约 7 分钟），问同样的问题，下载模型并启动。
-下次运行 `./setup.sh` 会直接启动。你的 Mac 适合哪个尺寸：[docs/MAC.md](docs/MAC.md)。
-
-安装程序会找到你的显卡，并设置合适的引擎。它会问你用哪个模型和尺寸、上下文多长（模型能记住多少文字），以及是否要读取图片。
-直接按回车就是推荐的选择。然后它会下载模型（约 70 GB）并启动。如果下载中断，再运行一次就会继续。浏览器会打开
-`http://127.0.0.1:8080` 上的 Strata 页面。
-
-> 模型启动期间，你的电脑可能会变慢，或者在 1-3 分钟内没有响应（第一次最久）。Strata 会把 35-55 GB 加载到内存里，并锁定其中一部分
-> 给显卡使用。请等待，不要关闭窗口。
-
-下次再运行 `START-HERE.bat`（或 `./setup.sh`）会立即启动，不会重复下载。关闭它的窗口就能停止模型。`UPDATE.bat`
-（`./update.sh`）只更新 Strata，不启动。更新、Docker、多显卡、文件存放位置和所有选项：[docs/INSTALL.md](docs/INSTALL.md)。
-
-要测试你的电脑，运行 `BENCH.bat`（`./bench.sh`）。需要 5-10 分钟，并生成一份可以分享的报告
-（[方法](docs/COMMUNITY_BENCHMARKS.md#run-the-benchmark)）。
-
-**可选：整个模型都放得进内存时，让单卡更快。** 这是 RubenTorney 提供的两个需要手动开启的设置（#1904、#1905）。
-当你只用一张显卡，并且内存装得下所有专家时，它们会有帮助，例如在 64 GB 的电脑上跑 Q2_0 或 IQ3_XXS。打开 Strata 数据文件夹里的
-`strata-<model>.json`（[位置](docs/INSTALL.md#where-things-are-stored)），然后添加：
-
-- 在 `"args"` 列表中加入 `"--adapt-async", "1"`。这样专家缓存会在辅助线程上更新，不会让回答暂停。在 RTX 5070
-  （Windows，Q2_0）上测得：解码快 4-5%，代码和长文档快 7-10%。回答可能与默认设置略有不同，但每次运行的结果保持一致。
-- 在 `"env"` 块中加入 `"STRATA_PIN_BY_NEED": "1"`（Windows）。Windows 只能为显卡锁定大约一半的内存，
-  这个设置会优先锁定显卡最先需要的专家。在 RTX 5070 上测得：读取提示词快 4.4%。
-
-```json
-"args": [ ..., "--adapt-async", "1" ],
-"env": { "STRATA_PIN_BY_NEED": "1" }
-```
-
-修改后请重启 Strata。要撤销，删除这两项即可。
+按提示下载并启动模型。[终端指南](docs/TERMINAL_LAUNCH.md)。
 
 </details>
 
-## 工作原理
+<p align="center">
+  <img src="docs/media/terminal-monitor.png" width="900" alt="Strata 终端应用，显示模型活动、速度、内存和最近的请求">
+  <br><sub>模型运行时，随时查看模型和硬件状态。</sub>
+</p>
 
-这类模型通常运行在有几百 GB 显存的服务器上。你的显卡只有 12-24 GB。Strata 把工作分给整台电脑，让模型装得下。
-可以把它想成一座图书馆。
+<a id="build-from-source"></a>
 
-- 模型是一个由 24,576 位小专家（“experts”）组成的团队，好比 24,576 本参考书。每个词只需要其中 10 本。
-- **你的显卡是书桌。** 它小而快。最常用的大约 4,000 本书摊开放在上面。
-- **你的内存是阅览室的书架。** 24,576 本书都在这里。某个词需要一本不在书桌上的书时，处理器会立刻从书架上取来读，显卡则继续工作。
-- **你的固态硬盘是档案室。** 里面存着一张 29 GB 的查找表。模型每个词只读其中几行，所以不用常驻内存。
+[从源码构建](docs/SOURCE_INSTALL.md) · [Docker](docs/DOCKER.md) · [完整安装指南](docs/INSTALL.md)
 
-<p align="center"><img src="docs/media/how-it-works.svg" width="860" alt="The model's 24,576 experts: the busiest on the graphics card, all of them in RAM, a lookup table on the SSD"></p>
+<a id="what-you-need"></a>
 
-另外有一个小助手会猜接下来的几个词。大模型一次检查所有猜测，保留正确的部分。得到的答案不变，但快了 1.6-1.8 倍。
-长文本按大块读取，一次最多 8,192 个 token，速度超过每秒 1,000 个 token。
+## 硬件
 
-<p align="center"><img src="docs/media/guess-and-check.svg" width="860" alt="A small helper guesses the next words; the big model checks them all at once and keeps the right ones"></p>
+| 支持的硬件 | 指南 |
+| --- | --- |
+| **NVIDIA GeForce RTX 20 / 30 / 40 / 50 系列** | [NVIDIA 安装](docs/INSTALL.md#what-you-need) |
+| **AMD Radeon RX 7700 / 7800 / 7900、RX 9060 / 9070、AI PRO R9700** | [AMD 安装](docs/AMD_HIP.md) |
+| **AMD Radeon RX 6800 / 6900 · 实验性** | [RX 6000 安装](docs/AMD_HIP.md#rdna2-gfx1030) |
+| **Intel Arc · Linux** | [Intel 安装](docs/INTEL_ARC.md) |
+| **Apple Silicon · M1 或更新** | [Mac 安装](docs/MAC.md) |
+| **AMD Ryzen AI Max · Strix Halo** | [Strix Halo 安装](docs/STRIX_HALO.md) |
 
-更详细的解释：[docs/HOW_IT_WORKS.md](docs/HOW_IT_WORKS.md)。每个部分和它的数据：
-[详细说明](docs/DETAILS.md#how-it-works)和[论文](docs/paper/Strata-Paper.pdf)。
+<a id="using-it"></a>
 
-## 出问题了？
+## 工具
 
-- **第一次启动 Strata 时我的电脑卡住了。** 它在把模型加载到内存。请等待，不要关闭窗口。10 分钟后还是卡住？重启电脑，
-  关闭其他程序后再试，或者选一个更小的尺寸。
-- **下载或安装时中断了。** 重新启动应用或 `strata launch`，或者再运行一次 `START-HERE.bat`（或 `./setup.sh`）。
-  它会从中断的地方继续。
-- **非常慢、硬盘灯一直闪，或者提示“引擎意外停止”。** 你的电脑可用内存不够。关闭其他程序（浏览器很占内存），
-  或者选一个更小的尺寸，比如 Q2_0 或 IQ2_XS。
-- **提示这台电脑没有可用的引擎。** 在应用里打开**设置，引擎**，点击**更新引擎**。在终端里运行 `strata update`。
-  `strata doctor` 会显示已安装哪些引擎文件。
-- **提示 8080 端口已被占用。** Strata 已经在运行了。找一下它的窗口。
+**Claude Code · Codex CLI · OpenCode · oh-my-pi · pi.dev · Hermes Agent · OpenClaw**，也可以通过兼容 OpenAI 和 Anthropic 的 API 使用更多工具。
 
-更多问题和解决办法：[docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)。还是解决不了？请提交
-[issue](https://github.com/Niko1221/Strata/issues)。在应用里，附上**设置，引擎，诊断，查看日志，保存日志**得到的文件。
-在终端里，粘贴 `strata doctor` 的输出。从源码运行时，附上 Strata 文件夹里的 `strata-<model>.log`。
-如果是安全问题，请私下报告：[SECURITY.md](SECURITY.md)。
+运行 **`strata connect`**，查看你所用工具的设置方法。[连接指南](docs/TERMINAL_LAUNCH.md#connect-your-apps-strata-connect)。
 
-## 致谢与许可证
+<a id="guides"></a>
+<a id="how-fast-is-it"></a>
+<a id="how-does-it-work"></a>
+<a id="something-went-wrong"></a>
 
-模型是 Qwen 团队的 [Qwen3.8-Flash-Next](https://huggingface.co/Qwen/Qwen3.8-Flash-Next)。压缩工作由
-[ISTA-DASLab](https://huggingface.co/ISTA-DASLab/Qwen3.8-Flash-Next-GSQ-RCO-GGUF)、UkisAI（Swift 1.5）、agentionai（Gyro）
-和 Unsloth 完成。Strata 使用了 [llama.cpp / ggml](https://github.com/ggml-org/llama.cpp) 的部分代码。全部致谢：
-[docs/HOW_IT_WORKS.md](docs/HOW_IT_WORKS.md#credits)。Strata 以 [MIT 许可证](LICENSE)开源。少数部分和所有模型有各自的许可证
-（[具体是哪些](docs/HOW_IT_WORKS.md#license)）。
+## 帮助
 
-## 参与贡献
-
-发现了 bug，或者想提交修改或基准测试结果？请先阅读 [CONTRIBUTING.md](CONTRIBUTING.md)。其中说明了需要附上哪些内容，
-方便其他人核实你的工作。
+[全部指南](docs) · [故障排查](docs/TROUBLESHOOTING.md) · [报告问题](https://github.com/Niko1221/Strata/issues/new/choose) ·
+[基准测试](docs/COMMUNITY_BENCHMARKS.md) · [工作原理](docs/HOW_IT_WORKS.md) · [参与贡献](CONTRIBUTING.md)
 
 ## 支持 Strata
 
-Strata 免费，采用 MIT 许可证。我在能拿到的各种硬件上开发和测试它。如果它在你的电脑上跑得不错，请我喝杯咖啡，能帮我继续测试新显卡、
-修复你们反馈的问题。不用有压力。使用它并反馈你的发现，同样很有帮助。
+**帮助本地 AI 保持开放。** 一杯咖啡能帮助我们在更多硬件上开发和测试。
 
-<a href="https://buymeacoffee.com/strataengine"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="50"></a>
+<a href="https://buymeacoffee.com/strataengine"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me a Coffee：支持 Strata" height="48"></a>
 
-有兴趣赞助 Strata？请通过 [GitHub](https://github.com/Niko1221) 联系我。
+[MIT 许可证](LICENSE) · [致谢和模型许可证](docs/HOW_IT_WORKS.md#credits) · [隐私](docs/SAFETY.md)
+
+<a id="option-c-let-your-ai-set-it-up"></a>
+
+<sub>面向 AI 工具和自动阅读器： <a href="AGENTS.md">技术参考</a> · <a href="docs/AI_SETUP.md">安装说明</a></sub>
+
+**赞助、硬件合作或其他合作：** [[email protected]](mailto:[email protected]).

SECURITY.md

@@ -23,8 +23,9 @@ this PC only. The details and every setting are in [docs/DETAILS.md](docs/DETAIL
 - **Where it listens.** `127.0.0.1` by default. `--host 0.0.0.0` (or `"host"` in `strata-<model>.json`) opens it to
   your network, and the server then warns when no API key is set.
 - **API key.** `"api_key"` in the run config (or `STRATA_API_KEY`) is required on `/v1/*` and on every endpoint
-  that shows the model's state, requests or answers (`/status`, `/metrics`, `/settings`, `/mcp`, `/props`, `/slots`,
-  `/api/requests`, `/config`) and on every `POST`. It is compared in constant time. Set one before you open the
+  that shows the model's state, requests or answers (`/status`, `/metrics`, `/metrics/prometheus`, `/settings`,
+  `/mcp`, `/props`, `/slots`, `/api/requests`, `/config`) and on every `POST`. It is compared in constant time.
+  Set one before you open the
   server to your network or put a tunnel in front of it.
 - **Host check (DNS rebinding, 0.1.38).** Without an API key the server answers only requests whose `Host` is a name
   it knows (`localhost`, an IP address, the address it listens on and, when it listens beyond this PC, this PC's
@@ -74,7 +75,7 @@ the model. The section above is about the engine's HTTP server. This is what the
 The Terminal installs with one line:
 
 ```sh
-curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh | sh
+curl -fsSL https://github.com/Niko1221/Strata/releases/latest/download/install.sh -o install.sh && sh install.sh
 irm https://github.com/Niko1221/Strata/releases/latest/download/install.ps1 | iex
 ```
 

START-HERE.bat

@@ -2,6 +2,8 @@
 rem Strata for Windows: the first run installs everything and starts the model; later runs just start it.
 rem Needs only an NVIDIA or AMD graphics driver. Python is installed for your user account if it is missing (no admin needed).
 setlocal
+rem Python reads and writes text as UTF-8, not in the Windows code page (cp1251, cp866, ...): a folder or user name with Cyrillic or other letters stays intact (#3202).
+set "PYTHONUTF8=1"
 title Strata
 cd /d "%~dp0"
 rem A bundled Python runtime (the python\ folder of the terminal archive) is used when it is there: nothing to find,

apps/desktop/package.json

@@ -1,7 +1,7 @@
 {
   "name": "strata-desktop",
   "productName": "Strata",
-  "version": "0.2.0-beta",
+  "version": "0.2.10",
   "private": true,
   "description": "Strata Desktop - local AI, tuned to one model.",
   "scripts": {

apps/desktop/scripts/harness-budget.mjs

@@ -0,0 +1,52 @@
+/** Strata's output-budget correction for the staged pi-ai copy. */
+import { createHash } from 'node:crypto';
+import { lstatSync, readFileSync, realpathSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+
+export const HARNESS_BUDGET_PATCH = Object.freeze({
+  id: 'strata-pi-ai-context-safety-v2',
+  package: '@earendil-works/pi-ai',
+  version: '1.1.0',
+  file: 'node_modules/@earendil-works/pi-ai/dist/api/simple-options.js',
+  beforeSha256: '9b3cc0ae6daa86fdc050bc0cb0f3f986401e64ccddbde6757183c9f8ad411be2',
+});
+
+const sha256 = bytes => createHash('sha256').update(bytes).digest('hex');
+const oldClamp = 'const available = model.contextWindow - estimateContextTokens(context).tokens - CONTEXT_SAFETY_TOKENS;';
+// Small windows also need room after tool results; a fixed margin must not
+// consume all remaining estimated space. Keep the old 64K+ calculation.
+const newClamp = `const remaining = model.contextWindow - estimateContextTokens(context).tokens;
+    const safety = model.contextWindow >= 65536 ? CONTEXT_SAFETY_TOKENS
+        : Math.min(CONTEXT_SAFETY_TOKENS, Math.floor(model.contextWindow / 16), Math.max(0, Math.floor(remaining / 2)));
+    const available = remaining - safety;`;
+
+/**
+ * Patch only a flattened, disposable staged Harness. Returns the BUNDLE.json
+ * provenance entry; the caller records it when writing the bundle manifest.
+ * A repeat application or any unknown package/source fails before writing.
+ */
+export function patchStagedHarnessBudget(stagedRoot) {
+  const fail = message => { throw new Error(`Harness output-budget patch: ${message}`); };
+  const root = realpathSync(resolve(stagedRoot));
+  const packageDir = join(root, 'node_modules', '@earendil-works', 'pi-ai');
+  const target = join(root, HARNESS_BUDGET_PATCH.file);
+  let manifest, before;
+  try {
+    manifest = JSON.parse(readFileSync(join(packageDir, 'package.json'), 'utf8'));
+    // Flattening must have removed links; never write through a shared source file.
+    if (realpathSync(target) !== target || !lstatSync(target).isFile() || lstatSync(target).nlink !== 1)
+      fail('expected an unlinked staged module');
+    before = readFileSync(target);
+  } catch (error) {
+    fail(`cannot read a standalone staged pi-ai dependency (${error.message})`);
+  }
+  if (manifest?.name !== HARNESS_BUDGET_PATCH.package || manifest?.version !== HARNESS_BUDGET_PATCH.version)
+    fail('expected @earendil-works/pi-ai 1.1.0; review the patch before staging a different dependency');
+  if (sha256(before) !== HARNESS_BUDGET_PATCH.beforeSha256)
+    fail('unexpected simple-options.js SHA-256; review the dependency source before staging');
+  const source = before.toString('utf8');
+  if (source.split(oldClamp).length !== 2) fail('expected exactly one known context clamp');
+  const after = Buffer.from(source.replace(oldClamp, newClamp));
+  writeFileSync(target, after);
+  return { ...HARNESS_BUDGET_PATCH, afterSha256: sha256(after) };
+}

apps/desktop/scripts/stage-harness.mjs

@@ -19,6 +19,7 @@ import { join, relative, resolve, sep } from 'node:path';
 import { createHash } from 'node:crypto';
 import { flattenPnpm } from './flatten-pnpm.mjs';
 import { isOtherOsBinaryFolder, missingHarnessImports } from './harness-prune.mjs';
+import { patchStagedHarnessBudget } from './harness-budget.mjs';
 
 const args = process.argv.slice(2);
 const opt = (name, fallback) => { const i = args.indexOf(`--${name}`); return i >= 0 ? args[i + 1] : fallback; };
@@ -144,6 +145,9 @@ function prune(dir) {
 }
 prune(out);
 
+// Strata's provenance-recorded output-budget correction applies only to this copy.
+const patches = [patchStagedHarnessBudget(out)];
+
 // --- licence: the MIT text and the third-party notices travel with the files ---------------------------------------------
 for (const name of ['LICENSE', 'THIRD_PARTY_NOTICES.md']) {
   if (existsSync(join(src, name))) cpSync(join(src, name), join(out, name));
@@ -156,6 +160,7 @@ const total = size(out);
 writeFileSync(join(out, 'BUNDLE.json'), JSON.stringify({
   component: 'deepseek-harness', version: cli.version, commit, license: 'MIT', platform, node: process.version,
   bytes: total.bytes, files: total.files, entry: 'apps/cli/lib/bin.js', builtAt: new Date().toISOString(),
+  patches,
   note: 'Pruned production install (pnpm deploy --prod). No package manager runs on the user\'s PC.',
 }, null, 2));
 

apps/desktop/src-tauri/Cargo.lock

@@ -349,6 +349,12 @@ version = "1.5.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "1fd0f2584146f6f2ef48085050886acf353beff7305ebd1ae69500e27c67f64b"
 
+[[package]]
+name = "byteorder-lite"
+version = "0.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8f1fe948ff07f4bd06c30984e69f5b4899c516a3ef74f34df92a2df2ab535495"
+
 [[package]]
 name = "bytes"
 version = "1.12.1"
@@ -1755,6 +1761,19 @@ dependencies = [
  "icu_properties",
 ]
 
+[[package]]
+name = "image"
+version = "0.25.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "85ab80394333c02fe689eaf900ab500fbd0c2213da414687ebf995a65d5a6104"
+dependencies = [
+ "bytemuck",
+ "byteorder-lite",
+ "moxcms",
+ "num-traits",
+ "png 0.18.1",
+]
+
 [[package]]
 name = "indexmap"
 version = "1.9.3"
@@ -2097,6 +2116,20 @@ version = "0.4.34"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "f9f8bd3e56ce4dfc153cf470fffbfa98c7620958b312ca5c3a4b8d5181fd13c6"
 
+[[package]]
+name = "mac-notification-sys"
+version = "0.6.15"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fd604973958ddcc11b561193c0fb96ba146506ef2f231ef2e7c35fd2cbc9beca"
+dependencies = [
+ "cc",
+ "log",
+ "objc2",
+ "objc2-foundation",
+ "time",
+ "uuid",
+]
+
 [[package]]
 name = "markup5ever"
 version = "0.39.0"
@@ -2166,6 +2199,16 @@ dependencies = [
  "windows-sys 0.61.2",
 ]
 
+[[package]]
+name = "moxcms"
+version = "0.8.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bb85c154ba489f01b25c0d36ae69a87e4a1c73a72631fc6c0eb6dde34a73e44b"
+dependencies = [
+ "num-traits",
+ "pxfm",
+]
+
 [[package]]
 name = "muda"
 version = "0.20.0"
@@ -2229,6 +2272,20 @@ version = "1.0.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "650eef8c711430f1a879fdd01d4745a7deea475becfb90269c06775983bbf086"
 
+[[package]]
+name = "notify-rust"
+version = "4.18.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4587364a9a0074333429b3df75a30a205340c56a536ca3eb6ca0e59b87bbf8af"
+dependencies = [
+ "futures-lite",
+ "log",
+ "mac-notification-sys",
+ "serde",
+ "tauri-winrt-notification",
+ "zbus",
+]
+
 [[package]]
 name = "num-conv"
 version = "0.2.2"
@@ -2757,6 +2814,15 @@ version = "0.2.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "4a6394b9e965e73d0a289ee54f589087e2c676aedf60885baf52c76b771e4958"
 
+[[package]]
+name = "ppv-lite86"
+version = "0.2.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "85eae3c4ed2f50dcfe72643da4befc30deadb458a9b590d720cde2f2b1e97da9"
+dependencies = [
+ "zerocopy",
+]
+
 [[package]]
 name = "precomputed-hash"
 version = "0.1.1"
@@ -2825,6 +2891,12 @@ dependencies = [
  "unicode-ident",
 ]
 
+[[package]]
+name = "pxfm"
+version = "0.1.30"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d55d956fa96f5ec02be2e13af0e20391a5aa83d6a074e3ad368959d0fab299ea"
+
 [[package]]
 name = "quick-xml"
 version = "0.42.0"
@@ -2855,6 +2927,35 @@ version = "6.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "f8dcc9c7d52a811697d2151c701e0d08956f92b0e24136cf4cf27b57a6a0d9bf"
 
+[[package]]
+name = "rand"
+version = "0.9.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b9ef1d0d795eb7d84685bca4f72f3649f064e6641543d3a8c415898726a57b41"
+dependencies = [
+ "rand_chacha",
+ "rand_core",
+]
+
+[[package]]
+name = "rand_chacha"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d3022b5f1df60f26e1ffddd6c66e8aa15de382ae63b3a0c1bfc0e4d3e3f325cb"
+dependencies = [
+ "ppv-lite86",
+ "rand_core",
+]
+
+[[package]]
+name = "rand_core"
+version = "0.9.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "76afc826de14238e6e8c374ddcc1fa19e374fd8dd986b0d2af0d02377261d83c"
+dependencies = [
+ "getrandom 0.3.4",
+]
+
 [[package]]
 name = "raw-window-handle"
 version = "0.6.2"
@@ -3524,13 +3625,14 @@ checksum = "ff7589a1859b09232522bb9edf076ca7fcf14ded96685d3fa629db73023ffbb7"
 
 [[package]]
 name = "strata-desktop"
-version = "0.2.0-beta"
+version = "0.2.10"
 dependencies = [
  "gtk",
  "serde",
  "serde_json",
  "tauri",
  "tauri-build",
+ "tauri-plugin-notification",
  "tauri-plugin-shell",
  "tauri-plugin-single-instance",
  "tauri-plugin-updater",
@@ -3755,6 +3857,7 @@ dependencies = [
  "gtk",
  "heck 0.5.0",
  "http",
+ "image",
  "jni 0.21.1",
  "libc",
  "log",
@@ -3869,6 +3972,26 @@ dependencies = [
  "walkdir",
 ]
 
+[[package]]
+name = "tauri-plugin-notification"
+version = "2.7.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b939d7b19c8af1381a72ef8474b3aba2b56c1ddac2c23f0c8e96abbcf86b198b"
+dependencies = [
+ "log",
+ "notify-rust",
+ "rand",
+ "serde",
+ "serde_json",
+ "serde_repr",
+ "tauri",
+ "tauri-plugin",
+ "thiserror 2.0.21",
+ "time",
+ "url",
+ "zbus",
+]
+
 [[package]]
 name = "tauri-plugin-shell"
 version = "2.5.0"
@@ -4042,6 +4165,17 @@ dependencies = [
  "toml 1.1.8+spec-1.1.0",
 ]
 
+[[package]]
+name = "tauri-winrt-notification"
+version = "0.8.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f37a6c354fd28fc9e322ed9bd47e3959576dad28c9d58ea1cf888cce1c7ccb36"
+dependencies = [
+ "thiserror 2.0.21",
+ "windows",
+ "windows-version",
+]
+
 [[package]]
 name = "tempfile"
 version = "3.27.0"
@@ -5332,6 +5466,26 @@ dependencies = [
  "serde",
 ]
 
+[[package]]
+name = "zerocopy"
+version = "0.8.63"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e5fe1f8f1b06191a00962174c61aa5005e0bb391a6d80d07e24d115c01a92ed8"
+dependencies = [
+ "zerocopy-derive",
+]
+
+[[package]]
+name = "zerocopy-derive"
+version = "0.8.63"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "863ad3ac83293fb4d740aedbfdc9240dd8d1a50c1099acd76ce80ce7c7230c7f"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.119",
+]
+
 [[package]]
 name = "zerofrom"
 version = "0.1.8"

apps/desktop/src-tauri/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "strata-desktop"
-version = "0.2.0-beta"
+version = "0.2.10"
 description = "Strata Desktop — local AI, tuned to one model."
 edition = "2021"
 rust-version = "1.77"
@@ -15,8 +15,10 @@ webkit2gtk = "2.0"
 tauri-build = { version = "2", features = [] }
 
 [dependencies]
-tauri = { version = "2", features = [] }
+tauri = { version = "2", features = ["tray-icon", "image-png"] }
 tauri-plugin-shell = "2"
+# Desktop notifications for an approval that waits (#3477); the tray icon above is Tauri's own.
+tauri-plugin-notification = "2"
 tauri-plugin-updater = "2"
 tauri-plugin-single-instance = "2"
 serde = { version = "1", features = ["derive"] }

apps/desktop/src-tauri/gen/schemas/acl-manifests.json

@@ -1 +1 @@
-{"core":{"default_permission":{"identifier":"default","description":"Default core plugins set.","permissions":["core:path:default","core:event:default","core:window:default","core:webview:default","core:app:default","core:image:default","core:resources:default","core:menu:default","core:tray:default"]},"permissions":{},"permission_sets":{},"global_scope_schema":null},"core:app":{"default_permission":{"identifier":"default","description":"Default permissions for the plugin.","permissions":["allow-version","allow-name","allow-tauri-version","allow-identifier","allow-bundle-type","allow-register-listener","allow-remove-listener","allow-supports-multiple-windows"]},"permissions":{"allow-app-hide":{"identifier":"allow-app-hide","description":"Enables the app_hide command without any pre-configured scope.","commands":{"allow":["app_hide"],"deny":[]}},"allow-app-show":{"identifier":"allow-app-show","description":"Enables the app_show command without any pre-configured scope.","commands":{"allow":["app_show"],"deny":[]}},"allow-bundle-type":{"identifier":"allow-bundle-type","description":"Enables the bundle_type command without any pre-configured scope.","commands":{"allow":["bundle_type"],"deny":[]}},"allow-default-window-icon":{"identifier":"allow-default-window-icon","description":"Enables the default_window_icon command without any pre-configured scope.","commands":{"allow":["default_window_icon"],"deny":[]}},"allow-exit":{"identifier":"allow-exit","description":"Enables the exit command without any pre-configured scope.","commands":{"allow":["exit"],"deny":[]}},"allow-fetch-data-store-identifiers":{"identifier":"allow-fetch-data-store-identifiers","description":"Enables the fetch_data_store_identifiers command without any pre-configured scope.","commands":{"allow":["fetch_data_store_identifiers"],"deny":[]}},"allow-identifier":{"identifier":"allow-identifier","description":"Enables the identifier command without any pre-configured scope.","commands":{"allow":["identifier"],"deny":[]}},"allow-name":{"identifier":"allow-name","description":"Enables the name command without any pre-configured scope.","commands":{"allow":["name"],"deny":[]}},"allow-register-listener":{"identifier":"allow-register-listener","description":"Enables the register_listener command without any pre-configured scope.","commands":{"allow":["register_listener"],"deny":[]}},"allow-remove-data-store":{"identifier":"allow-remove-data-store","description":"Enables the remove_data_store command without any pre-configured scope.","commands":{"allow":["remove_data_store"],"deny":[]}},"allow-remove-listener":{"identifier":"allow-remove-listener","description":"Enables the remove_listener command without any pre-configured scope.","commands":{"allow":["remove_listener"],"deny":[]}},"allow-set-app-theme":{"identifier":"allow-set-app-theme","description":"Enables the set_app_theme command without any pre-configured scope.","commands":{"allow":["set_app_theme"],"deny":[]}},"allow-set-dock-visibility":{"identifier":"allow-set-dock-visibility","description":"Enables the set_dock_visibility command without any pre-configured scope.","commands":{"allow":["set_dock_visibility"],"deny":[]}},"allow-supports-multiple-windows":{"identifier":"allow-supports-multiple-windows","description":"Enables the supports_multiple_windows command without any pre-configured scope.","commands":{"allow":["supports_multiple_windows"],"deny":[]}},"allow-tauri-version":{"identifier":"allow-tauri-version","description":"Enables the tauri_version command without any pre-configured scope.","commands":{"allow":["tauri_version"],"deny":[]}},"allow-version":{"identifier":"allow-version","description":"Enables the version command without any pre-configured scope.","commands":{"allow":["version"],"deny":[]}},"deny-app-hide":{"identifier":"deny-app-hide","description":"Denies the app_hide command without any pre-configured scope.","commands":{"allow":[],"deny":["app_hide"]}},"deny-app-show":{"identifier":"deny-app-show","description":"Denies the app_show command without any pre-configured scope.","commands":{"allow":[],"deny":["app_show"]}},"deny-bundle-type":{"identifier":"deny-bundle-type","description":"Denies the bundle_type command without any pre-configured scope.","commands":{"allow":[],"deny":["bundle_type"]}},"deny-default-window-icon":{"identifier":"deny-default-window-icon","description":"Denies the default_window_icon command without any pre-configured scope.","commands":{"allow":[],"deny":["default_window_icon"]}},"deny-exit":{"identifier":"deny-exit","description":"Denies the exit command without any pre-configured scope.","commands":{"allow":[],"deny":["exit"]}},"deny-fetch-data-store-identifiers":{"identifier":"deny-fetch-data-store-identifiers","description":"Denies the fetch_data_store_identifiers command without any pre-configured scope.","commands":{"allow":[],"deny":["fetch_data_store_identifiers"]}},"deny-identifier":{"identifier":"deny-identifier","description":"DenLine truncated
+{"core":{"default_permission":{"identifier":"default","description":"Default core plugins set.","permissions":["core:path:default","core:event:default","core:window:default","core:webview:default","core:app:default","core:image:default","core:resources:default","core:menu:default","core:tray:default"]},"permissions":{},"permission_sets":{},"global_scope_schema":null},"core:app":{"default_permission":{"identifier":"default","description":"Default permissions for the plugin.","permissions":["allow-version","allow-name","allow-tauri-version","allow-identifier","allow-bundle-type","allow-register-listener","allow-remove-listener","allow-supports-multiple-windows"]},"permissions":{"allow-app-hide":{"identifier":"allow-app-hide","description":"Enables the app_hide command without any pre-configured scope.","commands":{"allow":["app_hide"],"deny":[]}},"allow-app-show":{"identifier":"allow-app-show","description":"Enables the app_show command without any pre-configured scope.","commands":{"allow":["app_show"],"deny":[]}},"allow-bundle-type":{"identifier":"allow-bundle-type","description":"Enables the bundle_type command without any pre-configured scope.","commands":{"allow":["bundle_type"],"deny":[]}},"allow-default-window-icon":{"identifier":"allow-default-window-icon","description":"Enables the default_window_icon command without any pre-configured scope.","commands":{"allow":["default_window_icon"],"deny":[]}},"allow-exit":{"identifier":"allow-exit","description":"Enables the exit command without any pre-configured scope.","commands":{"allow":["exit"],"deny":[]}},"allow-fetch-data-store-identifiers":{"identifier":"allow-fetch-data-store-identifiers","description":"Enables the fetch_data_store_identifiers command without any pre-configured scope.","commands":{"allow":["fetch_data_store_identifiers"],"deny":[]}},"allow-identifier":{"identifier":"allow-identifier","description":"Enables the identifier command without any pre-configured scope.","commands":{"allow":["identifier"],"deny":[]}},"allow-name":{"identifier":"allow-name","description":"Enables the name command without any pre-configured scope.","commands":{"allow":["name"],"deny":[]}},"allow-register-listener":{"identifier":"allow-register-listener","description":"Enables the register_listener command without any pre-configured scope.","commands":{"allow":["register_listener"],"deny":[]}},"allow-remove-data-store":{"identifier":"allow-remove-data-store","description":"Enables the remove_data_store command without any pre-configured scope.","commands":{"allow":["remove_data_store"],"deny":[]}},"allow-remove-listener":{"identifier":"allow-remove-listener","description":"Enables the remove_listener command without any pre-configured scope.","commands":{"allow":["remove_listener"],"deny":[]}},"allow-set-app-theme":{"identifier":"allow-set-app-theme","description":"Enables the set_app_theme command without any pre-configured scope.","commands":{"allow":["set_app_theme"],"deny":[]}},"allow-set-dock-visibility":{"identifier":"allow-set-dock-visibility","description":"Enables the set_dock_visibility command without any pre-configured scope.","commands":{"allow":["set_dock_visibility"],"deny":[]}},"allow-supports-multiple-windows":{"identifier":"allow-supports-multiple-windows","description":"Enables the supports_multiple_windows command without any pre-configured scope.","commands":{"allow":["supports_multiple_windows"],"deny":[]}},"allow-tauri-version":{"identifier":"allow-tauri-version","description":"Enables the tauri_version command without any pre-configured scope.","commands":{"allow":["tauri_version"],"deny":[]}},"allow-version":{"identifier":"allow-version","description":"Enables the version command without any pre-configured scope.","commands":{"allow":["version"],"deny":[]}},"deny-app-hide":{"identifier":"deny-app-hide","description":"Denies the app_hide command without any pre-configured scope.","commands":{"allow":[],"deny":["app_hide"]}},"deny-app-show":{"identifier":"deny-app-show","description":"Denies the app_show command without any pre-configured scope.","commands":{"allow":[],"deny":["app_show"]}},"deny-bundle-type":{"identifier":"deny-bundle-type","description":"Denies the bundle_type command without any pre-configured scope.","commands":{"allow":[],"deny":["bundle_type"]}},"deny-default-window-icon":{"identifier":"deny-default-window-icon","description":"Denies the default_window_icon command without any pre-configured scope.","commands":{"allow":[],"deny":["default_window_icon"]}},"deny-exit":{"identifier":"deny-exit","description":"Denies the exit command without any pre-configured scope.","commands":{"allow":[],"deny":["exit"]}},"deny-fetch-data-store-identifiers":{"identifier":"deny-fetch-data-store-identifiers","description":"Denies the fetch_data_store_identifiers command without any pre-configured scope.","commands":{"allow":[],"deny":["fetch_data_store_identifiers"]}},"deny-identifier":{"identifier":"deny-identifier","description":"DenLine truncated

apps/desktop/src-tauri/gen/schemas/desktop-schema.json

@@ -2426,6 +2426,216 @@
           "const": "core:window:deny-unminimize",
           "markdownDescription": "Denies the unminimize command without any pre-configured scope."
         },
+        {
+          "description": "This permission set configures which\nnotification features are by default exposed.\n\n#### Granted Permissions\n\nIt allows all notification related features.\n\n\n#### This default permission set includes:\n\n- `allow-is-permission-granted`\n- `allow-request-permission`\n- `allow-notify`\n- `allow-register-action-types`\n- `allow-register-listener`\n- `allow-remove-listener`\n- `allow-cancel`\n- `allow-get-pending`\n- `allow-remove-active`\n- `allow-get-active`\n- `allow-check-permissions`\n- `allow-show`\n- `allow-batch`\n- `allow-list-channels`\n- `allow-delete-channel`\n- `allow-create-channel`\n- `allow-permission-state`",
+          "type": "string",
+          "const": "notification:default",
+          "markdownDescription": "This permission set configures which\nnotification features are by default exposed.\n\n#### Granted Permissions\n\nIt allows all notification related features.\n\n\n#### This default permission set includes:\n\n- `allow-is-permission-granted`\n- `allow-request-permission`\n- `allow-notify`\n- `allow-register-action-types`\n- `allow-register-listener`\n- `allow-remove-listener`\n- `allow-cancel`\n- `allow-get-pending`\n- `allow-remove-active`\n- `allow-get-active`\n- `allow-check-permissions`\n- `allow-show`\n- `allow-batch`\n- `allow-list-channels`\n- `allow-delete-channel`\n- `allow-create-channel`\n- `allow-permission-state`"
+        },
+        {
+          "description": "Enables the batch command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:allow-batch",
+          "markdownDescription": "Enables the batch command without any pre-configured scope."
+        },
+        {
+          "description": "Enables the cancel command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:allow-cancel",
+          "markdownDescription": "Enables the cancel command without any pre-configured scope."
+        },
+        {
+          "description": "Enables the check_permissions command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:allow-check-permissions",
+          "markdownDescription": "Enables the check_permissions command without any pre-configured scope."
+        },
+        {
+          "description": "Enables the create_channel command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:allow-create-channel",
+          "markdownDescription": "Enables the create_channel command without any pre-configured scope."
+        },
+        {
+          "description": "Enables the delete_channel command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:allow-delete-channel",
+          "markdownDescription": "Enables the delete_channel command without any pre-configured scope."
+        },
+        {
+          "description": "Enables the get_active command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:allow-get-active",
+          "markdownDescription": "Enables the get_active command without any pre-configured scope."
+        },
+        {
+          "description": "Enables the get_pending command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:allow-get-pending",
+          "markdownDescription": "Enables the get_pending command without any pre-configured scope."
+        },
+        {
+          "description": "Enables the is_permission_granted command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:allow-is-permission-granted",
+          "markdownDescription": "Enables the is_permission_granted command without any pre-configured scope."
+        },
+        {
+          "description": "Enables the list_channels command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:allow-list-channels",
+          "markdownDescription": "Enables the list_channels command without any pre-configured scope."
+        },
+        {
+          "description": "Enables the notify command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:allow-notify",
+          "markdownDescription": "Enables the notify command without any pre-configured scope."
+        },
+        {
+          "description": "Enables the permission_state command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:allow-permission-state",
+          "markdownDescription": "Enables the permission_state command without any pre-configured scope."
+        },
+        {
+          "description": "Enables the register_action_types command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:allow-register-action-types",
+          "markdownDescription": "Enables the register_action_types command without any pre-configured scope."
+        },
+        {
+          "description": "Enables the register_listener command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:allow-register-listener",
+          "markdownDescription": "Enables the register_listener command without any pre-configured scope."
+        },
+        {
+          "description": "Enables the remove_active command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:allow-remove-active",
+          "markdownDescription": "Enables the remove_active command without any pre-configured scope."
+        },
+        {
+          "description": "Enables the remove_listener command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:allow-remove-listener",
+          "markdownDescription": "Enables the remove_listener command without any pre-configured scope."
+        },
+        {
+          "description": "Enables the request_permission command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:allow-request-permission",
+          "markdownDescription": "Enables the request_permission command without any pre-configured scope."
+        },
+        {
+          "description": "Enables the show command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:allow-show",
+          "markdownDescription": "Enables the show command without any pre-configured scope."
+        },
+        {
+          "description": "Denies the batch command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:deny-batch",
+          "markdownDescription": "Denies the batch command without any pre-configured scope."
+        },
+        {
+          "description": "Denies the cancel command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:deny-cancel",
+          "markdownDescription": "Denies the cancel command without any pre-configured scope."
+        },
+        {
+          "description": "Denies the check_permissions command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:deny-check-permissions",
+          "markdownDescription": "Denies the check_permissions command without any pre-configured scope."
+        },
+        {
+          "description": "Denies the create_channel command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:deny-create-channel",
+          "markdownDescription": "Denies the create_channel command without any pre-configured scope."
+        },
+        {
+          "description": "Denies the delete_channel command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:deny-delete-channel",
+          "markdownDescription": "Denies the delete_channel command without any pre-configured scope."
+        },
+        {
+          "description": "Denies the get_active command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:deny-get-active",
+          "markdownDescription": "Denies the get_active command without any pre-configured scope."
+        },
+        {
+          "description": "Denies the get_pending command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:deny-get-pending",
+          "markdownDescription": "Denies the get_pending command without any pre-configured scope."
+        },
+        {
+          "description": "Denies the is_permission_granted command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:deny-is-permission-granted",
+          "markdownDescription": "Denies the is_permission_granted command without any pre-configured scope."
+        },
+        {
+          "description": "Denies the list_channels command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:deny-list-channels",
+          "markdownDescription": "Denies the list_channels command without any pre-configured scope."
+        },
+        {
+          "description": "Denies the notify command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:deny-notify",
+          "markdownDescription": "Denies the notify command without any pre-configured scope."
+        },
+        {
+          "description": "Denies the permission_state command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:deny-permission-state",
+          "markdownDescription": "Denies the permission_state command without any pre-configured scope."
+        },
+        {
+          "description": "Denies the register_action_types command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:deny-register-action-types",
+          "markdownDescription": "Denies the register_action_types command without any pre-configured scope."
+        },
+        {
+          "description": "Denies the register_listener command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:deny-register-listener",
+          "markdownDescription": "Denies the register_listener command without any pre-configured scope."
+        },
+        {
+          "description": "Denies the remove_active command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:deny-remove-active",
+          "markdownDescription": "Denies the remove_active command without any pre-configured scope."
+        },
+        {
+          "description": "Denies the remove_listener command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:deny-remove-listener",
+          "markdownDescription": "Denies the remove_listener command without any pre-configured scope."
+        },
+        {
+          "description": "Denies the request_permission command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:deny-request-permission",
+          "markdownDescription": "Denies the request_permission command without any pre-configured scope."
+        },
+        {
+          "description": "Denies the show command without any pre-configured scope.",
+          "type": "string",
+          "const": "notification:deny-show",
+          "markdownDescription": "Denies the show command without any pre-configured scope."
+        },
         {
           "description": "This permission set configures which\nshell functionality is exposed by default.\n\n#### Granted Permissions\n\nIt allows to use the `open` functionality with a reasonable\nscope pre-configured. It will allow opening `http(s)://`,\n`tel:` and `mailto:` links.\n\n#### This default permission set includes:\n\n- `allow-open`",
           "type": "string",
@@ -2491,6 +2701,60 @@
           "type": "string",
           "const": "shell:deny-stdin-write",
           "markdownDescription": "Denies the stdin_write command without any pre-configured scope."
+        },
+        {
+          "description": "This permission set configures which kind of\nupdater functions are exposed to the frontend.\n\n#### Granted Permissions\n\nThe full workflow from checking for updates to installing them\nis enabled.\n\n\n#### This default permission set includes:\n\n- `allow-check`\n- `allow-download`\n- `allow-install`\n- `allow-download-and-install`",
+          "type": "string",
+          "const": "updater:default",
+          "markdownDescription": "This permission set configures which kind of\nupdater functions are exposed to the frontend.\n\n#### Granted Permissions\n\nThe full workflow from checking for updates to installing them\nis enabled.\n\n\n#### This default permission set includes:\n\n- `allow-check`\n- `allow-download`\n- `allow-install`\n- `allow-download-and-install`"
+        },
+        {
+          "description": "Enables the check command without any pre-configured scope.",
+          "type": "string",
+          "const": "updater:allow-check",
+          "markdownDescription": "Enables the check command without any pre-configured scope."
+        },
+        {
+          "description": "Enables the download command without any pre-configured scope.",
+          "type": "string",
+          "const": "updater:allow-download",
+          "markdownDescription": "Enables the download command without any pre-configured scope."
+        },
+        {
+          "description": "Enables the download_and_install command without any pre-configured scope.",
+          "type": "string",
+          "const": "updater:allow-download-and-install",
+          "markdownDescription": "Enables the download_and_install command without any pre-configured scope."
+        },
+        {
+          "description": "Enables the install command without any pre-configured scope.",
+          "type": "string",
+          "const": "updater:allow-install",
+          "markdownDescription": "Enables the install command without any pre-configured scope."
+        },
+        {
+          "description": "Denies the check command without any pre-configured scope.",
+          "type": "string",
+          "const": "updater:deny-check",
+          "markdownDescription": "Denies the check command without any pre-configured scope."
+        },
+        {
+          "description": "Denies the download command without any pre-configured scope.",
+          "type": "string",
+          "const": "updater:deny-download",
+          "markdownDescription": "Denies the download command without any pre-configured scope."
+        },
+        {
+          "description": "Denies the download_and_install command without any pre-configured scope.",
+          "type": "string",
+          "const": "updater:deny-download-and-install",
+          "markdownDescription": "Denies the download_and_install command without any pre-configured scope."
+        },
+        {
+          "description": "Denies the install command without any pre-configured scope.",
+          "type": "string",
+          "const": "updater:deny-install",
+          "markdownDescription": "Denies the install command without any pre-configured scope."
         }
       ]
     },

apps/desktop/src-tauri/nsis/installer.nsi

@@ -168,7 +168,8 @@ VIAddVersionKey "ProductVersion" "${VERSION}"
 !define MUI_LANGDLL_REGISTRY_KEY "${MANUPRODUCTKEY}"
 !define MUI_LANGDLL_REGISTRY_VALUENAME "Installer Language"
 
-; Strata's look and words: the app's light surface and ink, short copy, no directory page, straight on to the progress.
+; Strata's look and words: the app's light surface and ink, short copy. The install folder page is shown on a first or manual install (#3186 #3190: C: can be short on space) and
+; skipped in an update (passive), which goes on into the folder the earlier install wrote to the registry.
 !define MUI_BGCOLOR "F9FAFB"
 !define MUI_TEXTCOLOR "171B1E"
 !define MUI_INSTFILESPAGE_PROGRESSBAR "smooth"
@@ -421,8 +422,19 @@ Function PageLeaveReinstall
   reinst_done:
 FunctionEnd
 
-; 5. Choose install directory page
-!define MUI_PAGE_CUSTOMFUNCTION_PRE Skip
+; 5. Choose install directory page. The app is installed for this user only (no administrator), so the folder must be one the
+; user can write to: another drive (D:\Strata) or a folder in the profile, not Program Files. An update (passive: the app's own
+; updater) and a silent install skip it and keep the earlier folder (RestorePreviousInstallLocation).
+!ifdef MUI_PAGE_HEADER_TEXT
+  !undef MUI_PAGE_HEADER_TEXT
+!endif
+!ifdef MUI_PAGE_HEADER_SUBTEXT
+  !undef MUI_PAGE_HEADER_SUBTEXT
+!endif
+!define MUI_PAGE_HEADER_TEXT "Choose where to install Strata"
+!define MUI_PAGE_HEADER_SUBTEXT "Pick another drive if C: is short on space."
+!define MUI_DIRECTORYPAGE_TEXT_TOP "Strata is installed into this folder, for your user only (no administrator needed). Models and chats are stored separately, in the data folder you choose inside Strata."
+!define MUI_PAGE_CUSTOMFUNCTION_PRE SkipIfPassive
 !insertmacro MUI_PAGE_DIRECTORY
 
 ; 6. Start menu shortcut page
@@ -435,7 +447,15 @@ Var AppStartMenuFolder
 !endif
 !insertmacro MUI_PAGE_STARTMENU Application $AppStartMenuFolder
 
-; 7. Installation page
+; 7. Installation page (a page macro uses up the header texts, so they are set again here)
+!ifdef MUI_PAGE_HEADER_TEXT
+  !undef MUI_PAGE_HEADER_TEXT
+!endif
+!ifdef MUI_PAGE_HEADER_SUBTEXT
+  !undef MUI_PAGE_HEADER_SUBTEXT
+!endif
+!define MUI_PAGE_HEADER_TEXT "Installing Strata"
+!define MUI_PAGE_HEADER_SUBTEXT "Copying the app. You can keep working meanwhile."
 !insertmacro MUI_PAGE_INSTFILES
 
 ; 8. Finish page
@@ -681,6 +701,35 @@ SectionEnd
 !macroend
 ; STRATA-MIGRATE-END
 
+; STRATA-STOP-BEGIN
+; Stop what Strata itself started from the install folder (the app, its host, the node runtime, the engine) before files are removed:
+; a running copy keeps its files open, so the folder stayed behind after use. Only processes whose image path is inside INSTDIR are
+; stopped; this uninstaller's own process and any program elsewhere are left alone.
+!macro StrataStopOwnProcesses INSTALLDIR
+  System::Call 'kernel32::SetEnvironmentVariableW(w "STRATA_INSTDIR", w "${INSTALLDIR}")'
+  System::Call 'kernel32::GetCurrentProcessId()i.r9'
+  System::Call 'kernel32::SetEnvironmentVariableW(w "STRATA_SELFPID", w "$9")'
+  ; the installer is a 32-bit program, so plain powershell.exe is the 32-bit one, which cannot read the image path of a 64-bit process: use the 64-bit one
+  StrCpy $8 "$WINDIR\Sysnative\WindowsPowerShell\v1.0\powershell.exe"
+  IfFileExists $8 +2 0
+    StrCpy $8 "powershell.exe"
+  nsExec::Exec '"$8" -NoProfile -NonInteractive -ExecutionPolicy Bypass -Command "$$d = [IO.Path]::GetFullPath($$env:STRATA_INSTDIR).TrimEnd([char]92) + [char]92; $$ids = @(); $$ids += Get-Process -ErrorAction SilentlyContinue | Where-Object { $$_.Path -and [IO.Path]::GetFullPath($$_.Path).StartsWith($$d, [StringComparison]::OrdinalIgnoreCase) } | ForEach-Object { $$_.Id }; try { $$ids += Get-CimInstance Win32_Process -ErrorAction Stop | Where-Object { $$_.ExecutablePath -and [IO.Path]::GetFullPath($$_.ExecutablePath).StartsWith($$d, [StringComparison]::OrdinalIgnoreCase) } | ForEach-Object { $$_.ProcessId } } catch {}; $$ids | Sort-Object -Unique | Where-Object { $$_ -ne [int]$$env:STRATA_SELFPID } | ForEach-Object { Stop-Process -Id $$_ -Force -ErrorAction SilentlyContinue }; Start-Sleep -Milliseconds 1500"'
+  Pop $9
+!macroend
+; STRATA-STOP-END
+
+; STRATA-CLEAN-BEGIN
+; The app writes into its own folders while it runs (Python bytecode caches under control\, for one), and the file-by-file delete below does not know them,
+; so those folders stayed behind with a few dozen files. These four folders hold only what the installer put there and what the app made there;
+; user data is never in them (it lives in the data folder), and the install folder itself is still removed with a plain RMDir.
+!macro StrataRemoveAppFolders INSTALLDIR
+  RMDir /r "${INSTALLDIR}\control"
+  RMDir /r "${INSTALLDIR}\host"
+  RMDir /r "${INSTALLDIR}\node"
+  RMDir /r "${INSTALLDIR}\harness"
+!macroend
+; STRATA-CLEAN-END
+
 Section Install
   SetOutPath $INSTDIR
 
@@ -827,6 +876,7 @@ Section Uninstall
     !insertmacro NSIS_HOOK_PREUNINSTALL
   !endif
 
+  !insertmacro StrataStopOwnProcesses "$INSTDIR"
   !insertmacro CheckIfAppIsRunning "$INSTDIR\${MAINBINARYNAME}.exe" "${PRODUCTNAME}"
 
   ; Delete the app directory and its content from disk
@@ -859,6 +909,8 @@ Section Uninstall
   {{/each}}
 
 
+  !insertmacro StrataRemoveAppFolders "$INSTDIR"
+
   ; Delete uninstaller
   Delete "$INSTDIR\uninstall.exe"
 

apps/desktop/src-tauri/src/desktoplog.rs

@@ -8,11 +8,21 @@
 //!
 //! `strata-desktop --save-logs` puts the newest crash log, the tails of the newest shell logs and the engine server logs into one text file
 //! in the Downloads folder. The same pieces go into Settings > Engine > Diagnostics > Save logs (the host reads this folder).
+//!
+//! Windows and macOS (one process owns the host and the window) use the same folder and file names for what happens while the app starts:
+//! `init_startup` opens the run log first thing in `main`, before anything that can fail, and installs a panic hook; a start that fails
+//! (the host does not come up, the window cannot be made, any panic) ends in `startup_failed`: the reason goes into the run log and a
+//! `desktop-crash-` file, and the person sees a plain message box instead of a process that vanished with no trace. On Windows the folder
+//! is `%LOCALAPPDATA%\Strata\logs`, next to the components folder.
+
+// Linux uses the shell log, the crash log and --save-logs; Windows and macOS use the start-up half. Each side leaves the other unused.
+#![allow(dead_code)]
 
 use std::collections::VecDeque;
 use std::io::{BufRead, BufReader, Read, Write};
 use std::path::{Path, PathBuf};
-use std::sync::{Arc, Mutex};
+use std::sync::atomic::{AtomicBool, Ordering};
+use std::sync::{Arc, Mutex, OnceLock};
 use std::time::{Duration, SystemTime, UNIX_EPOCH};
 
 const KEEP: usize = 10;
@@ -23,6 +33,23 @@ pub fn data_dir() -> PathBuf {
     if let Some(dir) = std::env::var_os("STRATA_DESKTOP_DATA_DIR") {
         return PathBuf::from(dir);
     }
+    platform_data_dir()
+}
+
+/// Windows: `%LOCALAPPDATA%\Strata`, the folder the host and Control already use for the components and the install.
+#[cfg(windows)]
+fn platform_data_dir() -> PathBuf {
+    std::env::var_os("LOCALAPPDATA")
+        .map(PathBuf::from)
+        .filter(|p| p.is_absolute())
+        .or_else(|| std::env::var_os("USERPROFILE").map(|h| PathBuf::from(h).join("AppData").join("Local")))
+        .unwrap_or_else(std::env::temp_dir)
+        .join("Strata")
+}
+
+/// Linux and macOS: `$XDG_DATA_HOME/strata`, usually `~/.local/share/strata`.
+#[cfg(not(windows))]
+fn platform_data_dir() -> PathBuf {
     let base = std::env::var_os("XDG_DATA_HOME")
         .map(PathBuf::from)
         .filter(|p| p.is_absolute())
@@ -105,8 +132,11 @@ impl Log {
         log
     }
     pub fn line(&self, who: &str, text: &str) {
-        if let Some(f) = self.file.lock().unwrap().as_mut() {
-            let _ = writeln!(f, "[{who}] {text}");
+        // never panics: this runs inside the panic hook too
+        if let Ok(mut guard) = self.file.lock() {
+            if let Some(f) = guard.as_mut() {
+                let _ = writeln!(f, "[{who}] {text}");
+            }
         }
     }
 }
@@ -311,8 +341,180 @@ pub fn save_logs(out_dir: &Path) -> std::io::Result<PathBuf> {
     Ok(path)
 }
 
+// ---------------------------------------------------------------------------------------------------------------------------------
+// Start-up failures (Windows and macOS)
+// ---------------------------------------------------------------------------------------------------------------------------------
+
+/// The run log and whether a failure may show a message box. Set once, first thing in `main`.
+struct Run {
+    log: Log,
+    dialog: bool,
+}
+
+static RUN: OnceLock<Run> = OnceLock::new();
+/// One message box per run: a failure inside the panic hook and the abort that follows must not show two.
+static REPORTED: AtomicBool = AtomicBool::new(false);
+
+/// This run's log, once `init_startup` has opened it.
+pub fn run_log() -> Option<Log> {
+    RUN.get().map(|r| r.log.clone())
+}
+
+/// Open the run log and install the panic hook. Call it first in `main`: nothing that can fail runs before it. `dialog` is false for
+/// the self-test (no person to read a message box); `STRATA_NO_DIALOG` does the same for scripted runs.
+pub fn init_startup(dialog: bool) {
+    let dialog = dialog && std::env::var_os("STRATA_NO_DIALOG").is_none();
+    let log = Log::open();
+    log.line("shell", &system_line());
+    if RUN.set(Run { log, dialog }).is_ok() {
+        install_panic_hook();
+    }
+}
+
+/// "Windows 10.0.26300 (64-bit)" or the name of the system; one line for the log and the crash file.
+pub fn system_line() -> String {
+    format!("System: {} {}", std::env::consts::OS, system_version())
+}
+
+#[cfg(windows)]
+fn system_version() -> String {
+    #[repr(C)]
+    struct OsVersionInfo {
+        size: u32,
+        major: u32,
+        minor: u32,
+        build: u32,
+        platform: u32,
+        csd: [u16; 128],
+    }
+    #[link(name = "ntdll")]
+    extern "system" {
+        fn RtlGetVersion(info: *mut OsVersionInfo) -> i32;
+    }
+    let mut info = OsVersionInfo { size: std::mem::size_of::<OsVersionInfo>() as u32, major: 0, minor: 0, build: 0, platform: 0, csd: [0; 128] };
+    // RtlGetVersion reports the real version (GetVersionEx lies to apps without a manifest entry)
+    if unsafe { RtlGetVersion(&mut info) } == 0 {
+        format!("{}.{}.{}", info.major, info.minor, info.build)
+    } else {
+        "version unknown".into()
+    }
+}
+
+#[cfg(not(windows))]
+fn system_version() -> String {
+    first_line("/etc/os-release").unwrap_or_default()
+}
+
+/// What to tell a person, in plain words, for a technical reason. Always ends with the one next step.
+pub fn plain_reason(detail: &str) -> String {
+    let lower = detail.to_ascii_lowercase();
+    if lower.contains("webview2") || lower.contains("webview") {
+        "Strata shows its window with Microsoft's WebView2 component, and it could not be started. \
+         Update or repair \"Microsoft Edge WebView2 Runtime\" (Settings > Apps > Installed apps), or install it from \
+         https://go.microsoft.com/fwlink/p/?LinkId=2124703, then start Strata again."
+            .into()
+    } else if lower.contains("app host") || lower.contains("node runtime") || lower.contains("could not start the app host") {
+        "Strata's background program did not start. Security software may have blocked a file in the Strata folder. \
+         Allow the Strata folder in it (or reinstall Strata) and start Strata again."
+            .into()
+    } else {
+        "Strata stopped while it was starting. Starting it again may work; if it does not, please send us the log file named below.".into()
+    }
+}
+
+/// The text of the crash file for a failed start, as text (so it can be tested without a failure).
+pub fn startup_report(detail: &str, app_version: &str, log_path: Option<&Path>) -> String {
+    let mut t = String::new();
+    t.push_str("Strata app start failure\n========================\n\n");
+    t.push_str(&format!("When:     {} UTC\n", stamp(SystemTime::now())));
+    t.push_str(&format!("App:      Strata desktop {app_version}\n"));
+    t.push_str(&format!("{}\n", system_line()));
+    t.push_str(&format!("What:     {detail}\n"));
+    t.push_str(&format!("Meaning:  {}\n", plain_reason(detail)));
+    if let Some(p) = log_path {
+        t.push_str(&format!("\nFull log of this run: {}\n", p.display()));
+    }
+    t
+}
+
+/// Write the crash file of a failed start into `dir`; returns where it is.
+pub fn write_startup_failure(dir: &Path, detail: &str, log_path: Option<&Path>) -> Option<PathBuf> {
+    std::fs::create_dir_all(dir).ok()?;
+    prune(dir, "desktop-crash-", false);
+    let path = dir.join(format!("desktop-crash-{}.log", stamp(SystemTime::now())));
+    std::fs::write(&path, startup_report(detail, env!("CARGO_PKG_VERSION"), log_path)).ok()?;
+    Some(path)
+}
+
+/// The message box (Windows). Elsewhere the text goes to the terminal only.
+#[cfg(windows)]
+fn show_error(text: &str) {
+    use std::os::windows::ffi::OsStrExt;
+    #[link(name = "user32")]
+    extern "system" {
+        fn MessageBoxW(window: *mut std::ffi::c_void, text: *const u16, caption: *const u16, kind: u32) -> i32;
+    }
+    const MB_ICONERROR: u32 = 0x10;
+    const MB_SETFOREGROUND: u32 = 0x1_0000;
+    const MB_TOPMOST: u32 = 0x4_0000;
+    let wide = |s: &str| std::ffi::OsStr::new(s).encode_wide().chain(std::iter::once(0)).collect::<Vec<u16>>();
+    let (text, caption) = (wide(text), wide("Strata"));
+    unsafe {
+        MessageBoxW(std::ptr::null_mut(), text.as_ptr(), caption.as_ptr(), MB_ICONERROR | MB_SETFOREGROUND | MB_TOPMOST);
+    }
+}
+
+#[cfg(not(windows))]
+fn show_error(text: &str) {
+    eprintln!("[strata] {text}");
+}
+
+/// Record a failed start (run log and crash file) and tell the person. Runs inside the panic hook as well, so it cannot panic.
+fn report_failure(detail: &str) {
+    let Some(run) = RUN.get() else {
+        eprintln!("[strata] {detail}");
+        return;
+    };
+    run.log.line("shell", &format!("START FAILED: {detail}"));
+    let dir = logs_dir();
+    let saved = write_startup_failure(&dir, detail, run.log.path.as_deref());
+    if let Some(p) = &saved {
+        run.log.line("shell", &format!("The crash file is {}", p.display()));
+    }
+    if run.dialog && !REPORTED.swap(true, Ordering::SeqCst) {
+        let short: String = detail.chars().take(400).collect();
+        let place = saved.or_else(|| run.log.path.clone()).map(|p| p.display().to_string()).unwrap_or_else(|| dir.display().to_string());
+        show_error(&format!("Strata could not start.\n\n{}\n\nWhat happened: {short}\n\nA log was saved here, please send it to us:\n{place}", plain_reason(detail)));
+    }
+}
+
+/// A start that cannot go on: say why (log, crash file, message box) and end the process with a failure code. Never returns.
+pub fn startup_failed(detail: &str) -> ! {
+    report_failure(detail);
+    std::process::exit(1)
+}
+
+/// Every panic in the app (a Tauri setup error is one) ends in an abort with panic = "abort", which Windows reports as 0xc0000409 with
+/// nothing else. The hook runs before the abort: it writes what the panic said and where, and shows the message box.
+fn install_panic_hook() {
+    let previous = std::panic::take_hook();
+    std::panic::set_hook(Box::new(move |info| {
+        previous(info);
+        let message = if let Some(s) = info.payload().downcast_ref::<&str>() {
+            (*s).to_string()
+        } else if let Some(s) = info.payload().downcast_ref::<String>() {
+            s.clone()
+        } else {
+            "a panic without a message".to_string()
+        };
+        let place = info.location().map(|l| format!("{}:{}", l.file(), l.line())).unwrap_or_else(|| "an unknown place".into());
+        let thread = std::thread::current().name().unwrap_or("unnamed").to_string();
+        report_failure(&format!("the app stopped unexpectedly: {message} (at {place}, thread {thread})"));
+    }));
+}
+
 pub fn downloads_dir() -> PathBuf {
-    std::env::var_os("HOME").map(|h| PathBuf::from(h).join("Downloads")).unwrap_or_else(std::env::temp_dir)
+    std::env::var_os(if cfg!(windows) { "USERPROFILE" } else { "HOME" }).map(|h| PathBuf::from(h).join("Downloads")).unwrap_or_else(std::env::temp_dir)
 }
 
 #[cfg(test)]
@@ -371,4 +573,28 @@ mod tests {
         std::env::remove_var("STRATA_DESKTOP_DATA_DIR");
         let _ = std::fs::remove_dir_all(&dir);
     }
+    #[test]
+    fn a_failed_start_is_explained_in_plain_words_and_written_to_a_crash_file() {
+        let webview = plain_reason("Failed to setup app: error encountered during setup hook: WebView2 error: 0x8007139F");
+        assert!(webview.contains("WebView2") && webview.contains("go.microsoft.com"));
+        assert!(plain_reason("the Strata App Host did not become healthy at http://127.0.0.1:47831/api/health").contains("background program"));
+        assert!(plain_reason("something else").contains("log file"));
+        let dir = std::env::temp_dir().join(format!("strata-startlog-test-{}", std::process::id()));
+        let _ = std::fs::remove_dir_all(&dir);
+        let path = write_startup_failure(&dir, "the app stopped unexpectedly: boom (at main.rs:1, thread main)", Some(Path::new("/x/desktop-1.log"))).unwrap();
+        assert!(path.file_name().unwrap().to_string_lossy().starts_with("desktop-crash-"));
+        let text = std::fs::read_to_string(&path).unwrap();
+        for needle in ["boom", "main.rs:1", "/x/desktop-1.log", "0.2.0", "System:", "Meaning:"] {
+            assert!(text.contains(needle), "{needle}");
+        }
+        let _ = std::fs::remove_dir_all(&dir);
+    }
+
+    #[cfg(windows)]
+    #[test]
+    fn on_windows_the_logs_sit_in_the_local_app_data_strata_folder() {
+        let dir = platform_data_dir();
+        assert!(dir.ends_with("Strata"), "{}", dir.display());
+        assert!(system_version().split('.').count() == 3, "{}", system_version());
+    }
 }

apps/desktop/src-tauri/src/main.rs

@@ -38,8 +38,8 @@ use std::time::{Duration, Instant};
 use tauri::{Manager, WebviewUrl, WebviewWindowBuilder};
 
 mod updater;
-#[cfg(target_os = "linux")]
 mod desktoplog;
+mod shell;
 #[cfg(target_os = "linux")]
 mod supervisor;
 
@@ -253,13 +253,24 @@ fn pick_port() -> Result<u16, String> {
 /// launch starts with empty storage, as before).
 const PREFERRED_PORT: u16 = 47831;
 
+/// Set when the port the person (or the app) wanted was busy: "busy:<wanted>:<used>". The host gets it as STRATA_PORT_NOTICE and tells the
+/// person (the chats and settings saved on the page belong to the port, so a different port starts empty) (#3402).
+static PORT_NOTICE: std::sync::Mutex<Option<String>> = std::sync::Mutex::new(None);
+
 fn pick_stable_port() -> Result<u16, String> {
-    match TcpListener::bind(("127.0.0.1", PREFERRED_PORT)) {
+    // The person may have chosen a port in Settings (shell-prefs.json); otherwise the app's usual one.
+    let wanted = shell::wanted_port(&shell::read_prefs(), PREFERRED_PORT);
+    *PORT_NOTICE.lock().unwrap() = None;
+    match TcpListener::bind(("127.0.0.1", wanted)) {
         Ok(listener) => {
             drop(listener);
-            Ok(PREFERRED_PORT)
+            Ok(wanted)
+        }
+        Err(_) => {
+            let used = pick_port()?;
+            *PORT_NOTICE.lock().unwrap() = Some(shell::busy_notice(wanted, used));
+            Ok(used)
         }
-        Err(_) => pick_port(),
     }
 }
 
@@ -470,6 +481,9 @@ fn host_command(res: &Path, port: u16, shutdown_token: &str) -> Result<Command,
         .stderr(Stdio::inherit());
     apply_runtime_policy(&mut cmd, res);
     hide_console(&mut cmd);
+    if let Some(notice) = PORT_NOTICE.lock().unwrap().clone() {
+        cmd.env("STRATA_PORT_NOTICE", notice);
+    }
     // A user with the Strata API worker on a different port sets this; unset means the worker's
     // documented loopback default.
     if let Ok(url) = std::env::var("STRATA_SERVER_URL") {
@@ -491,9 +505,23 @@ fn start_host(app: &tauri::AppHandle) -> Result<u16, String> {
     *app.state::<ShutdownToken>().0.lock().unwrap() = Some(token);
 
     let node = node_binary(&res)?;
-    let child = cmd
+    // The host's lines go to the run log (a packaged Windows app has no console, so they were lost before).
+    let log = desktoplog::run_log();
+    if log.is_some() {
+        cmd.stdout(Stdio::piped()).stderr(Stdio::piped());
+    }
+    let mut child = cmd
         .spawn()
         .map_err(|e| format!("could not start the App Host on {}: {e}", node.display()))?;
+    if let Some(log) = log {
+        let ring = desktoplog::Ring::default();
+        if let Some(out) = child.stdout.take() {
+            desktoplog::tee(out, "host", false, ring.clone(), log.clone());
+        }
+        if let Some(err) = child.stderr.take() {
+            desktoplog::tee(err, "host", true, ring, log);
+        }
+    }
     *app.state::<HostProcess>().0.lock().unwrap() = Some(child);
     *app.state::<HostPort>().0.lock().unwrap() = Some(port);
 
@@ -529,6 +557,19 @@ fn stop_host(app: &tauri::AppHandle) {
     }
 }
 
+/// End the host at once, without the clean stop (a start that failed: there is nothing to drain).
+#[cfg(not(target_os = "linux"))]
+fn kill_host(app: &tauri::AppHandle) {
+    if let Some(state) = app.try_state::<HostProcess>() {
+        if let Ok(mut guard) = state.0.lock() {
+            if let Some(mut child) = guard.take() {
+                let _ = child.kill();
+                let _ = child.wait();
+            }
+        }
+    }
+}
+
 /// A clean stop first: the host stops, through Control, the engines this app started, then exits. Engines another client
 /// started (the Terminal) are not touched. If it does not finish in time the process is ended.
 fn stop_host_child(child: &mut Child, port: Option<u16>, token: Option<&str>) {
@@ -803,6 +844,10 @@ fn main() {
     // at the screen — the lesson from the Electron attempt, where a packaged app that never started
     // its host hung with no output at all.
     let args: Vec<String> = std::env::args().collect();
+    // Windows and macOS: the run log and the panic hook come first, before anything that can fail. A start that goes wrong then leaves a
+    // log, a crash file and a message box instead of a process that is gone with 0xc0000409 and nothing else (Linux: supervisor.rs).
+    #[cfg(not(target_os = "linux"))]
+    desktoplog::init_startup(self_test_path(&args).is_none());
     contain_app();
     #[cfg(target_os = "linux")]
     {
@@ -845,27 +890,53 @@ fn run_embedded() {
         }))
         .plugin(tauri_plugin_shell::init())
         .plugin(tauri_plugin_updater::Builder::new().build())
+        .plugin(tauri_plugin_notification::init())
         .manage(HostProcess(Mutex::new(None)))
         .manage(HostPort(Mutex::new(None)))
         .manage(ShutdownToken(Mutex::new(None)))
         .setup(|app| {
+            // A way to prove the safety net on a computer where the app starts fine (tests only): a panic at the place a setup error ends in.
+            if std::env::var_os("STRATA_DESKTOP_TEST_PANIC").is_some() {
+                panic!("STRATA_DESKTOP_TEST_PANIC is set: the app panics on purpose");
+            }
             let handle = app.handle().clone();
-            let port = start_host(&handle).map_err(|e| {
-                // A startup failure must be visible, not a blank window.
-                eprintln!("[strata] {e}");
-                Box::<dyn std::error::Error>::from(e)
-            })?;
-            let shell_token = handle.state::<ShutdownToken>().0.lock().unwrap().clone().unwrap_or_default();
-            open_window(app, port, &shell_token)?;
+            // A setup error would become a panic inside Tauri ("Failed to setup app"), and with panic = "abort" a crash with no message.
+            // A failed start is reported (log, crash file, message box) and ends the app here instead.
+            let port = match start_host(&handle) {
+                Ok(port) => port,
+                Err(e) => {
+                    kill_host(&handle);
+                    desktoplog::startup_failed(&e)
+                }
+            };
+            let shell_token = handle.state::<ShutdownToken>().0.lock().map(|t| t.clone().unwrap_or_default()).unwrap_or_default();
+            if let Err(e) = open_window(app, port, &shell_token) {
+                kill_host(&handle);
+                desktoplog::startup_failed(&format!("the Strata window could not be opened: {e}"))
+            }
             Ok(())
         })
         .on_window_event(|window, event| {
+            // "Minimise to tray" (Settings, off by default): closing the main window hides it and keeps Strata running in the tray; Quit in the
+            // tray menu ends it (#3477). If no tray could be made the window closes as before.
+            if let tauri::WindowEvent::CloseRequested { api, .. } = event {
+                if window.label() == "main" {
+                    let prefs = shell::read_prefs();
+                    if prefs.tray {
+                        api.prevent_close();
+                        shell::hide_to_tray(&window.app_handle().clone(), &prefs.language);
+                        if !shell::tray_exists(&window.app_handle().clone()) {
+                            let _ = window.destroy();
+                        }
+                    }
+                }
+            }
             if let tauri::WindowEvent::Destroyed = event {
                 stop_host(&window.app_handle().clone());
             }
         })
         .build(tauri::generate_context!())
-        .expect("error while building the Strata application")
+        .unwrap_or_else(|e| desktoplog::startup_failed(&format!("the Strata application could not be built: {e}")))
         .run(|app, event| {
             if let tauri::RunEvent::ExitRequested { .. } | tauri::RunEvent::Exit = event {
                 stop_host(app);

apps/desktop/src-tauri/src/shell.rs

@@ -0,0 +1,238 @@
+//! The shell's own choices and the two things the host asks of it besides updates (#3402, #3477).
+//!
+//! `<Strata data folder>/shell-prefs.json` is written by the App Host when the person changes a setting
+//! (`apps/host/server/shell-prefs.mjs`) and read here when Strata starts, before any page exists:
+//!
+//!   { "port": 0 | 1024..65535, "tray": false, "language": "en" }
+//!
+//! * `port`: the port the window's origin uses. 0 is the default, 47831. When the port is busy the shell takes a free one and tells the
+//!   host (`STRATA_PORT_NOTICE=busy:<wanted>:<used>`), which shows the person a warning: the chats and settings of the page are kept per
+//!   port, so a different port starts empty.
+//! * `tray`: closing the window hides it and keeps Strata running in the tray (Windows, macOS). The tray menu follows `language`.
+//! * `/shell/notify` on the loopback bridge shows a desktop notification (an approval is waiting) whether the window is open or hidden.
+
+use std::path::PathBuf;
+
+use serde_json::Value;
+
+#[derive(Clone, Debug, PartialEq, Eq)]
+pub struct Prefs {
+    pub port: u16,
+    pub tray: bool,
+    pub language: String,
+}
+
+impl Default for Prefs {
+    fn default() -> Self {
+        Prefs { port: 0, tray: false, language: "en".into() }
+    }
+}
+
+pub const LANGUAGES: [&str; 8] = ["en", "zh", "ja", "de", "es", "ru", "pt", "ko"];
+
+pub fn prefs_path() -> PathBuf {
+    crate::desktoplog::data_dir().join("shell-prefs.json")
+}
+
+/// The file's text as choices; anything missing or out of range is the default.
+pub fn parse_prefs(text: &str) -> Prefs {
+    let value: Value = serde_json::from_str(text.trim_start_matches('\u{feff}')).unwrap_or(Value::Null);
+    let port = value.get("port").and_then(Value::as_u64).filter(|p| (1024..=65535).contains(p)).unwrap_or(0) as u16;
+    let tray = value.get("tray").and_then(Value::as_bool).unwrap_or(false);
+    let language = value
+        .get("language")
+        .and_then(Value::as_str)
+        .filter(|l| LANGUAGES.contains(l))
+        .unwrap_or("en")
+        .to_string();
+    Prefs { port, tray, language }
+}
+
+pub fn read_prefs() -> Prefs {
+    std::fs::read_to_string(prefs_path()).map(|t| parse_prefs(&t)).unwrap_or_default()
+}
+
+/// The port to ask for: the person's choice, else the app's usual one.
+pub fn wanted_port(prefs: &Prefs, usual: u16) -> u16 {
+    if prefs.port != 0 { prefs.port } else { usual }
+}
+
+/// The notice the host shows when the wanted port was taken.
+pub fn busy_notice(wanted: u16, used: u16) -> String {
+    format!("busy:{wanted}:{used}")
+}
+
+/// `%41%20b` -> "A b" (a query value from the host). Bad escapes are kept as typed.
+pub fn percent_decode(text: &str) -> String {
+    let bytes = text.as_bytes();
+    let mut out = Vec::with_capacity(bytes.len());
+    let mut i = 0;
+    while i < bytes.len() {
+        if bytes[i] == b'%' && i + 2 < bytes.len() {
+            if let Some(v) = std::str::from_utf8(&bytes[i + 1..i + 3]).ok().and_then(|h| u8::from_str_radix(h, 16).ok()) {
+                out.push(v);
+                i += 3;
+                continue;
+            }
+        }
+        out.push(if bytes[i] == b'+' { b' ' } else { bytes[i] });
+        i += 1;
+    }
+    String::from_utf8_lossy(&out).into_owned()
+}
+
+/// The value of `key` in the query of a request path (`/shell/notify?title=..&body=..`).
+pub fn query_value(path: &str, key: &str) -> Option<String> {
+    let query = path.split_once('?')?.1;
+    query.split('&').find_map(|pair| {
+        let (k, v) = pair.split_once('=')?;
+        (k == key).then(|| percent_decode(v))
+    })
+}
+
+/// A short single-line text for a notification: no control characters, bounded.
+pub fn clean_text(text: &str, max: usize) -> String {
+    text.chars().filter(|c| !c.is_control()).take(max).collect::<String>().trim().to_string()
+}
+
+/// The tray menu: (open, quit, tooltip), in the app's language.
+pub fn tray_labels(language: &str) -> (&'static str, &'static str, &'static str) {
+    match language {
+        "zh" => ("打开 Strata", "退出 Strata", "Strata"),
+        "ja" => ("Strata を開く", "Strata を終了", "Strata"),
+        "de" => ("Strata öffnen", "Strata beenden", "Strata"),
+        "es" => ("Abrir Strata", "Salir de Strata", "Strata"),
+        "ru" => ("Открыть Strata", "Выйти из Strata", "Strata"),
+        "pt" => ("Abrir o Strata", "Sair do Strata", "Strata"),
+        "ko" => ("Strata 열기", "Strata 종료", "Strata"),
+        _ => ("Open Strata", "Quit Strata", "Strata"),
+    }
+}
+
+#[cfg(not(target_os = "linux"))]
+mod native {
+    use tauri::menu::{Menu, MenuItem};
+    use tauri::tray::{MouseButton, MouseButtonState, TrayIconBuilder, TrayIconEvent};
+    use tauri::{AppHandle, Manager};
+    use tauri_plugin_notification::NotificationExt;
+
+    const TRAY_ID: &str = "strata-tray";
+
+    fn show_main(app: &AppHandle) {
+        if let Some(window) = app.get_webview_window("main") {
+            let _ = window.unminimize();
+            let _ = window.show();
+            let _ = window.set_focus();
+        }
+    }
+
+    /// Hide the window and keep Strata running in the tray (made on the first need, with the menu in the app's language).
+    pub fn hide_to_tray(app: &AppHandle, language: &str) {
+        if app.tray_by_id(TRAY_ID).is_none() {
+            let (open, quit, tip) = super::tray_labels(language);
+            let built = (|| -> tauri::Result<()> {
+                let open_item = MenuItem::with_id(app, "open", open, true, None::<&str>)?;
+                let quit_item = MenuItem::with_id(app, "quit", quit, true, None::<&str>)?;
+                let menu = Menu::with_items(app, &[&open_item, &quit_item])?;
+                let mut builder = TrayIconBuilder::with_id(TRAY_ID)
+                    .tooltip(tip)
+                    .menu(&menu)
+                    .show_menu_on_left_click(false)
+                    .on_menu_event(|app, event| match event.id().as_ref() {
+                        "open" => show_main(app),
+                        "quit" => app.exit(0),
+                        _ => {}
+                    })
+                    .on_tray_icon_event(|tray, event| {
+                        if let TrayIconEvent::Click { button: MouseButton::Left, button_state: MouseButtonState::Up, .. } = event {
+                            show_main(tray.app_handle());
+                        }
+                    });
+                if let Some(icon) = app.default_window_icon() {
+                    builder = builder.icon(icon.clone());
+                }
+                builder.build(app)?;
+                Ok(())
+            })();
+            if built.is_err() {
+                // No tray could be made (a desktop without one): do not hide a window nobody could bring back.
+                return;
+            }
+        }
+        if let Some(window) = app.get_webview_window("main") {
+            let _ = window.hide();
+        }
+    }
+
+    pub fn tray_exists(app: &AppHandle) -> bool {
+        app.tray_by_id(TRAY_ID).is_some()
+    }
+
+    /// Show a desktop notification; a hidden or minimised window also asks for attention (the taskbar button flashes).
+    pub fn notify(app: &AppHandle, title: &str, body: &str) -> bool {
+        if title.is_empty() {
+            return false;
+        }
+        if let Some(window) = app.get_webview_window("main") {
+            let hidden = !window.is_visible().unwrap_or(true) || window.is_minimized().unwrap_or(false);
+            if hidden {
+                let _ = window.request_user_attention(Some(tauri::UserAttentionType::Informational));
+            }
+        }
+        app.notification().builder().title(title).body(body).show().is_ok()
+    }
+}
+
+#[cfg(not(target_os = "linux"))]
+pub use native::{hide_to_tray, notify, tray_exists};
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn the_file_gives_choices_and_anything_wrong_is_the_default() {
+        assert_eq!(parse_prefs(""), Prefs::default());
+        assert_eq!(parse_prefs("{ not json"), Prefs::default());
+        let p = parse_prefs(r#"{"port":47900,"tray":true,"language":"de"}"#);
+        assert_eq!((p.port, p.tray, p.language.as_str()), (47900, true, "de"));
+        assert_eq!(parse_prefs("\u{feff}{\"port\":47900}").port, 47900);
+        assert_eq!(parse_prefs(r#"{"port":80}"#).port, 0, "a port below 1024 is not used");
+        assert_eq!(parse_prefs(r#"{"port":70000}"#).port, 0);
+        assert_eq!(parse_prefs(r#"{"port":"47831"}"#).port, 0, "a text is not a number");
+        assert_eq!(parse_prefs(r#"{"tray":"yes","language":"xx"}"#), Prefs::default());
+    }
+
+    #[test]
+    fn the_wanted_port_is_the_choice_or_the_usual_one() {
+        assert_eq!(wanted_port(&Prefs::default(), 47831), 47831);
+        assert_eq!(wanted_port(&Prefs { port: 47900, ..Prefs::default() }, 47831), 47900);
+        assert_eq!(busy_notice(47831, 51234), "busy:47831:51234");
+    }
+
+    #[test]
+    fn query_values_are_decoded_and_bounded() {
+        let path = "/shell/notify?title=Strata%20needs%20your%20answer&body=a%20%26%20b%3F+ok";
+        assert_eq!(query_value(path, "title").as_deref(), Some("Strata needs your answer"));
+        assert_eq!(query_value(path, "body").as_deref(), Some("a & b? ok"));
+        assert_eq!(query_value(path, "missing"), None);
+        assert_eq!(query_value("/shell/notify", "title"), None);
+        assert_eq!(percent_decode("100%"), "100%");
+        assert_eq!(percent_decode("%zz%41"), "%zzA");
+        assert_eq!(percent_decode("%C3%A4"), "ä");
+        assert_eq!(clean_text("a\nb\u{7}c", 10), "abc");
+        assert_eq!(clean_text("abcdef", 3), "abc");
+    }
+
+    #[test]
+    fn every_language_has_tray_labels() {
+        for language in LANGUAGES {
+            let (open, quit, tip) = tray_labels(language);
+            assert!(!open.is_empty() && !quit.is_empty() && !tip.is_empty(), "{language}");
+            if language != "en" {
+                assert_ne!(open, tray_labels("en").0, "{language}");
+            }
+        }
+        assert_eq!(tray_labels("xx"), tray_labels("en"));
+    }
+}

apps/desktop/src-tauri/src/updater.rs

@@ -210,6 +210,16 @@ fn handle(mut stream: TcpStream, app: &AppHandle, token: &str, progress: &Arc<Mu
             respond(&mut stream, "202 Accepted", &progress.lock().unwrap().json());
         }
         ("GET", "/app-update/status") => respond(&mut stream, "200 OK", &progress.lock().unwrap().json()),
+        // The host asks for a desktop notification (an approval is waiting): title and body are in the query, bounded and cleaned here.
+        ("POST", p) if p.starts_with("/shell/notify") => {
+            let title = crate::shell::clean_text(&crate::shell::query_value(p, "title").unwrap_or_default(), 120);
+            let body = crate::shell::clean_text(&crate::shell::query_value(p, "body").unwrap_or_default(), 300);
+            #[cfg(not(target_os = "linux"))]
+            let shown = crate::shell::notify(app, &title, &body);
+            #[cfg(target_os = "linux")]
+            let shown = false;
+            respond(&mut stream, "200 OK", &serde_json::json!({ "shown": shown }))
+        }
         _ => respond(&mut stream, "404 Not Found", &serde_json::json!({ "error": "unknown route" })),
     }
 }

apps/desktop/tester/README-mac.txt.in

@@ -27,8 +27,7 @@ START IT
 
 Closing the window stops Strata and its engine.
 
-Pictures: this Mac build has no picture reader yet, so models read text only here. Picture input works on the Windows and
-Linux builds.
+Pictures: on by default. This Mac build reads them on the Mac's GPU (under a second for a small picture on an M4).
 
 
 @INCLUDE:common-gatekeeper-mac.txt@

apps/host/README.md

@@ -10,3 +10,15 @@ npm run preview:ui
 The built UI is included. To rebuild after source edits, run `npm run build`. `preview:ui` uses isolated simulated data; `npm run dev` connects the normal host.
 
 The previous project README is retained in [docs/README-historical.md](docs/README-historical.md). It contains older implementation status and is historical reference.
+
+## Languages
+
+The app speaks English, Chinese, Japanese, German, French, Spanish, Russian, Portuguese and Korean. The English text is the key: `src/locales/en.json`
+(with `fix-en.json`, `tune-en.json` and `tools-en.json`) holds every string, and each language has the same four files (`fr.json`, `fix-fr.json`, ...).
+
+- **A new string.** Write it with `tr("...")`, then add it to the English catalog (`node scripts/append-localization.mjs`, or the next `fx` number in
+  `scripts/make-fix-locales.py`). The language tests fail until every language has it.
+- **French.** `python scripts/fr_sync.py missing todo.tsv` lists the English strings that have no French yet, one per line (`id`, a tab, the text).
+  Translate the second column ("vous", short plain words, one next step; a lone `=` keeps the English), then `python scripts/fr_sync.py apply todo.tsv` merges it
+  (it also sets the French spacing before `: ; ? !` and the typographic apostrophe) and `python scripts/fr_sync.py check` confirms nothing is missing.
+- **Screenshots in a language.** `npm run build`, then `node scripts/language-shots.mjs fr <folder> models settings setup` (hermetic preview host, scratch profile, headless Chrome).

apps/host/docs/native-engine-handover.md

@@ -6,7 +6,7 @@ Implemented 14 October 2026 in the React/Node app under `backups/strata`.
 
 The default is one model at a time. First launch uses the visual `GuidedSetup` funnel: **Welcome → Your model → Prepare → Make it yours → Chat**. Welcome has animated vector artwork and one expert skip at the bottom. Model selection offers friendly version cards, context, RAM/VRAM inventory with an aggregate total, and an existing-folder browser. Unified CPU/GPU memory counts once. Memory verdicts are guidance: **May run slower** does not block selection or Continue. There is no compatibility alternatives panel or picture-reading question at this stage. The preparation screen confirms the download size before **Download model**, then shows engine-reported progress alongside a clickable Chat / Files / Your setup tour. Vision-capable families always prepare their mmproj/encoder files. Preparation does not load the model automatically.
 
-After preparation, users choose **Leave 20% for my work** or **Full performance**, and choose whether to **Read pictures when this model loads** (off initially). The optional longer native calibration measures engine settings for approximately 5–10 minutes. **Tune & start chatting** applies the resource and vision preferences, loads one model, performs a short benchmark, and completes setup only when that model is healthy. Chat opens automatically with starter prompts for a new user; selecting a prompt fills the composer without sending it. Progress, choices and operation IDs survive reloads. Finish later preserves the current stage and keeps completed files available.
+After preparation, users choose **Leave room for my work** or **Full performance**, and choose whether to **Read pictures when this model loads** (off initially). The optional longer native calibration measures engine settings for approximately 5–10 minutes. **Tune & start chatting** applies the resource and vision preferences, loads one model, performs a short benchmark, and completes setup only when that model is healthy. Chat opens automatically with starter prompts for a new user; selecting a prompt fills the composer without sending it. Progress, choices and operation IDs survive reloads. Finish later preserves the current stage and keeps completed files available.
 
 Normal Models shows Version, optional picture reading, context, Computer use and Load model. The resource preference can be changed here after onboarding. Image generation is a separate collapsed option. The selected model and context remain visible in the toolbar; saved setups and Manage models are available there. Local GGUF import is a secondary entry in Version. Imported models retain the existing metadata/shard validation and reference their files without copying them.
 

apps/host/index.html

@@ -3,7 +3,7 @@
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
-    <title>Strata — local AI, tuned to one model</title>
+    <title>Strata</title>
     <meta name="description" content="Strata runs one local model, tuned to your hardware." />
     <meta name="color-scheme" content="light dark" />
     <meta name="theme-color" content="#f9fafb" />

apps/host/package-lock.json

@@ -1,14 +1,15 @@
 {
   "name": "strata",
-  "version": "0.2.0-beta",
+  "version": "0.2.10",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "strata",
-      "version": "0.2.0-beta",
+      "version": "0.2.10",
       "dependencies": {
         "html-to-image": "^1.11.13",
+        "katex": "^0.19.0",
         "pdfjs-dist": "^6.4.299",
         "prismjs": "1.30.0",
         "react": "^19.1.0",
@@ -1608,6 +1609,15 @@
       ],
       "license": "CC-BY-4.0"
     },
+    "node_modules/commander": {
+      "version": "15.0.0",
+      "resolved": "https://registry.npmjs.org/commander/-/commander-15.0.0.tgz",
+      "integrity": "sha512-z67u4ZhzCL/Tydu1lJARtEZYWbWaN7oYLHbsuzocr6y4N6WZAagG3RQ4FW61V1/0+jImpj293XfrcYnd1qxtPg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=22.12.0"
+      }
+    },
     "node_modules/convert-source-map": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-2.0.0.tgz",
@@ -1781,6 +1791,22 @@
         "node": ">=6"
       }
     },
+    "node_modules/katex": {
+      "version": "0.19.0",
+      "resolved": "https://registry.npmjs.org/katex/-/katex-0.19.0.tgz",
+      "integrity": "sha512-v6Tznz3zJ7u3niRCoDTsumM2+HA2XXcCu+WAacCeHD2z3p9A9Ks987o5FzfTGBN0e8A0vjEgIDvLbICrXpdw/Q==",
+      "funding": [
+        "https://opencollective.com/katex",
+        "https://github.com/sponsors/katex"
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "commander": "^15.0.0"
+      },
+      "bin": {
+        "katex": "cli.js"
+      }
+    },
     "node_modules/lru-cache": {
       "version": "5.1.1",
       "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-5.1.1.tgz",

apps/host/package.json

@@ -1,7 +1,7 @@
 {
   "name": "strata",
   "private": true,
-  "version": "0.2.0-beta",
+  "version": "0.2.10",
   "type": "module",
   "description": "Strata \u2014 local AI, tuned to one model. Web shell + engine host.",
   "scripts": {
@@ -28,6 +28,7 @@
   },
   "dependencies": {
     "html-to-image": "^1.11.13",
+    "katex": "^0.19.0",
     "pdfjs-dist": "^6.4.299",
     "prismjs": "1.30.0",
     "react": "^19.1.0",

apps/host/scripts/agent-lost-e2e.mjs

@@ -0,0 +1,209 @@
+#!/usr/bin/env node
+/**
+ * AGENT-LOST end to end: a long single-file write through the real agent bridge, the real Harness and a real engine.
+ *
+ *   STRATA_HARNESS_DIR=<harness folder> node scripts/agent-lost-e2e.mjs [pagoda|long|cut ...]
+ *
+ * Scenarios (default: all)
+ *   pagoda  the owner's own prompt ("Write me a 100 voxel pagoda in one html file with garden."), thinking Medium, bypass mode
+ *   long    a deterministic long write: one file of N numbered lines (E2E_LINES, default 1800, about 22K tokens), thinking Off
+ *   mcp     Strata's own tool loop (serve runs an MCP tool itself): a call that finishes, and a call the reply is cut inside
+ *   raw     the model server alone: a reply cut inside a tool call, as the client receives it
+ *   cut     the same long write with the Harness told a small window (E2E_CUT_WINDOW, default 24000), so the reply budget is
+ *           about 7K tokens and the reply is cut inside the tool call: the turn must say so in words and the agent must carry on
+ *
+ * A model server that is already running is used when E2E_BASE_URL is set (nothing is started or stopped). Otherwise this
+ * starts serve/server.py as its own child with the engine named below and stops it by PID.
+ *
+ * Environment: E2E_ENGINE (strata executable), E2E_PACK, E2E_GGUF1, E2E_GGUF2, E2E_MTP, E2E_PROFILE, E2E_LIB (library folder),
+ * E2E_PORT (18590), E2E_WINDOW (65536), E2E_OUT (result folder), E2E_PYTHON.
+ *
+ * It prints one table and writes <E2E_OUT>/result.json with the frames summary of each scenario.
+ */
+import { spawn } from 'node:child_process';
+import { existsSync, mkdtempSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { createAgentBridge } from '../server/agent/agent-bridge.mjs';
+
+const REPO = join(import.meta.dirname, '..', '..', '..');
+const env = (name, fallback) => process.env[name] ?? fallback;
+const HOME = process.env.HOME ?? '';
+const PORT = Number(env('E2E_PORT', '18590'));
+const WINDOW = Number(env('E2E_WINDOW', '65536'));
+const EXISTING = process.env.E2E_BASE_URL ?? '';
+const PYTHON = env('E2E_PYTHON', 'python3');
+const OUT = env('E2E_OUT', mkdtempSync(join(tmpdir(), 'strata-agent-lost-')));
+const LINES = Number(env('E2E_LINES', '1100'));
+const REPEAT = Number(env('E2E_REPEAT', '1'));
+const TURN_S = Number(env('E2E_TURN_S', '900'));
+const wanted = process.argv.slice(2);
+const want = id => wanted.length === 0 || wanted.includes(id);
+mkdirSync(OUT, { recursive: true });
+
+if (!process.env.STRATA_HARNESS_DIR) { console.error('STRATA_HARNESS_DIR is not set'); process.exit(2); }
+const sleep = ms => new Promise(r => setTimeout(r, ms));
+
+let server = null, bridge = null;
+const finish = async (code) => {
+  try { await bridge?.close(); } catch { /* going away */ }
+  if (server?.pid) { try { process.kill(-server.pid, 'SIGTERM'); } catch { try { process.kill(server.pid, 'SIGTERM'); } catch { /* gone */ } } }
+  await sleep(1500);
+  console.log(`\nresult folder: ${OUT}`);
+  process.exit(code);
+};
+process.on('SIGINT', () => finish(130));
+process.on('SIGTERM', () => finish(143));
+
+if (!EXISTING) {
+  const pack = env('E2E_PACK', join(HOME, '026q/pack-iq3s'));
+  const g1 = env('E2E_GGUF1', join(HOME, 'models/IQ3_S/Qwen3.8-Flash-Next-GSQ-RCO-IQ3_S-00001-of-00002.gguf'));
+  const g2 = env('E2E_GGUF2', join(HOME, 'models/IQ3_S/Qwen3.8-Flash-Next-GSQ-RCO-IQ3_S-00002-of-00002.gguf'));
+  const mtp = env('E2E_MTP', join(HOME, 'pr1426/mtp-rt'));
+  const profile = env('E2E_PROFILE', join(HOME, 'bwm/cnt3/data/expert-profile.bin'));
+  const exe = env('E2E_ENGINE', join(HOME, 'agentlost/eng/strata'));
+  const lib = env('E2E_LIB', join(HOME, 'agentlost/eng'));
+  for (const f of [pack, g1, g2, mtp, exe]) if (!existsSync(f)) { console.error(`missing: ${f}`); process.exit(2); }
+  const config = join(OUT, 'server.json');
+  writeFileSync(config, JSON.stringify({
+    exe, args: ['--pack', pack, '--native', g1, '--ple-gguf', g2, ...(existsSync(profile) ? ['--expert-profile', profile] : []),
+      '--prefill', 'auto', '--spec-min-p', '0.5', '--mtp', mtp, '--max-context', String(WINDOW), '--kv', 'int8', '--expert-cache', 'auto', '--spec', '4',
+      ...(process.env.E2E_ENGINE_ARGS ? process.env.E2E_ENGINE_ARGS.split(' ').filter(Boolean) : [])],
+    cwd: REPO, tokenizer: join(pack, 'tokenizer'), model_name: 'qwen3.8-flash-next-iq3_s', log: join(OUT, 'engine.log'), lib_dirs: [lib], port: PORT, gpu: 0,
+    fit_max_tokens: true,
+    // Strata's own tool loop (serve/server.py run_with_mcp): one small MCP server, offered only to requests that ask for it (strata_mcp).
+    mcp_servers: { fake: { command: PYTHON, args: [join(REPO, 'serve', 'mcp_fake_server.py')] } },
+  }, null, 2));
+  server = spawn(PYTHON, ['serve/server.py', '--engine', 'strata', '--config', config, '--port', String(PORT), '--no-api-key', '--ready-file', join(OUT, 'ready.json')], {
+    cwd: REPO, env: { ...process.env, LD_LIBRARY_PATH: `${lib}:${process.env.LD_LIBRARY_PATH ?? ''}`, STRATA_DATA_DIR: join(OUT, 'data'), PYTHONPATH: `${join(REPO, 'tools')}:${REPO}` }, stdio: ['ignore', 'pipe', 'pipe'], detached: true,
+  });
+  const sink = [];
+  server.stdout.on('data', d => sink.push(String(d)));
+  server.stderr.on('data', d => sink.push(String(d)));
+  server.on('exit', code => { sink.push(`[server exited ${code}]`); server = null; writeFileSync(join(OUT, 'server.log'), sink.join('')); });
+}
+
+const base = EXISTING || `http://127.0.0.1:${PORT}`;
+let ready = false;
+for (let i = 0; i < 360 && !ready; i++) {
+  if (!EXISTING && !server) break;
+  try { ready = (await fetch(`${base}/health`, { signal: AbortSignal.timeout(2000) })).ok; } catch { /* still loading */ }
+  if (!ready) await sleep(2000);
+}
+if (!ready) { console.error('the engine did not become ready'); await finish(4); }
+const model = (await (await fetch(`${base}/v1/models`)).json()).data[0].id;
+console.log(`engine ready: ${model}`);
+
+const rows = [];
+const note = (id, ok, detail) => { rows.push({ id, ok, detail }); console.log(`${ok ? 'PASS' : 'FAIL'}  ${id}  ${detail}`); };
+
+/** The bridge for a window as the host would tell it (the engine's own window stays WINDOW). */
+function makeBridge(window, dir) {
+  mkdirSync(join(OUT, dir), { recursive: true });
+  return createAgentBridge({
+    dataDir: join(OUT, dir), env: process.env, startTimeoutMs: 180_000, log: l => console.log('   bridge:', l),
+    localInstances: () => [{ id: 'e2e', label: 'iq3_s', baseUrl: `${base}/v1`, modelId: model, context: window, slots: 1, key: '' }], connections: () => [],
+  });
+}
+bridge = makeBridge(WINDOW, 'agent');
+
+/** One agent turn; every frame is kept in a compact timeline so the live data path can be read afterwards. */
+async function turn(name, message, { thinking = 'Medium', mode = 'bypass', chatId = name } = {}) {
+  const workspace = join(OUT, 'ws-' + name);
+  mkdirSync(workspace, { recursive: true });
+  const frames = [];
+  const t0 = Date.now();
+  let timedOut = false;
+  const stopTimer = setTimeout(() => { timedOut = true; void bridge.stop(chatId).catch(() => {}); }, TURN_S * 1000);
+  await bridge.runTurn({ chatId, message, workspacePath: workspace, mode, thinking, onFrame: f => frames.push({ at: Date.now() - t0, f }) });
+  clearTimeout(stopTimer);
+  const seconds = (Date.now() - t0) / 1000;
+  const byType = {};
+  for (const { f } of frames) byType[f.type] = (byType[f.type] ?? 0) + 1;
+  const done = frames.map(x => x.f).filter(f => f.type === 'done').at(-1) ?? null;
+  const error = frames.map(x => x.f).filter(f => f.type === 'error').at(-1) ?? null;
+  const prepare = frames.map(x => x.f).filter(f => f.type === 'status' && (f.phase === 'preparing' || f.code === 'preparing-tool'));
+  const cards = frames.map(x => x.f).filter(f => f.type === 'agent-tool').map(f => f.tool);
+  const text = frames.map(x => x.f).filter(f => f.type === 'delta').map(f => f.text).join('');
+  const files = readdirSync(workspace).map(n => ({ name: n, bytes: statSync(join(workspace, n)).size }));
+  const cutNotes = frames.map(x => x.f).filter(f => f.type === 'delta' && f.noteReason === 'cut').map(f => f.text.trim());
+  const drafts = frames.map(x => x.f).filter(f => f.type === 'agent-tool-draft').map(f => f.draft);
+  const writes = drafts.filter(d => d.name === 'write' && d.bytes > 0);
+  const draftStats = { frames: drafts.length, writeFrames: writes.length, lastWrite: writes.filter(d => !d.done).at(-1) ? { target: writes.filter(d => !d.done).at(-1).target, bytes: writes.filter(d => !d.done).at(-1).bytes, lines: writes.filter(d => !d.done).at(-1).lines } : null, previewSample: writes.filter(d => !d.done).at(-1)?.preview.slice(-80) ?? null };
+  const writesDone = cards.filter(c => c.name === 'write' && c.state === 'done').length;
+  const summary = { name, seconds, timedOut, writesDone, cutNotes, draftStats, byType, done, error, files, cards: cards.map(c => ({ name: c.name, state: c.state, target: c.target })), prepareStatuses: prepare.length, firstPrepare: prepare[0] ?? null, lastPrepare: prepare.at(-1) ?? null, text: text.slice(-1200) };
+  writeFileSync(join(OUT, `turn-${name}.json`), JSON.stringify({ summary, frames: frames.slice(0, 4000) }, null, 1));
+  return { ...summary, frames, workspace };
+}
+
+const longPrompt = `Create the file big.txt in the current folder with the write tool, in ONE call. It must hold exactly ${LINES} lines. Line N is "N: " followed by one short true sentence about a different city of the world (a new city on every line, no repeats, no pattern). Write every line out yourself, do not use a script or a loop, and do not shorten it.`;
+
+if (want('raw')) {
+  // What the model server itself sends when a reply is cut inside a tool call (no Harness): the stream of tool_calls pieces, then finish_reason "length".
+  const body = { model, stream: true, max_tokens: Number(env('E2E_RAW_CAP', '700')), temperature: 0.6,
+    chat_template_kwargs: { enable_thinking: false },
+    tools: [{ type: 'function', function: { name: 'write', description: 'Write a file.', parameters: { type: 'object', properties: { file_path: { type: 'string' }, content: { type: 'string' } }, required: ['file_path', 'content'] } } }],
+    messages: [{ role: 'user', content: longPrompt }] };
+  const res = await fetch(`${base}/v1/chat/completions`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(body) });
+  const text = await res.text();
+  const events = text.split(String.fromCharCode(10)).filter(l => l.startsWith('data: {')).map(l => JSON.parse(l.slice(6)));
+  let args = '', name = '', content = '', finish = null, pieces = 0, ids = new Set();
+  for (const e of events) for (const c of e.choices ?? []) {
+    for (const tc of c.delta?.tool_calls ?? []) { pieces += 1; if (tc.id) ids.add(tc.id); if (tc.function?.name) name = tc.function.name; args += tc.function?.arguments ?? ''; }
+    content += c.delta?.content ?? '';
+    if (c.finish_reason) finish = c.finish_reason;
+  }
+  const usage = events.map(e => e.usage).filter(Boolean).at(-1);
+  writeFileSync(join(OUT, 'raw-sse.txt'), text);
+  note('raw: a reply cut inside a tool call reaches the client as pieces of the call and finish_reason length', finish === 'length' && name === 'write' && pieces > 5, `finish ${finish}; tool ${name}; ${pieces} call pieces, ${args.length} argument characters, closed JSON ${(() => { try { JSON.parse(args); return true; } catch { return false; } })()}; plain content ${JSON.stringify(content.slice(0, 80))}; ids ${ids.size}; usage ${JSON.stringify(usage)}`);
+}
+
+if (want('mcp')) {
+  // Strata's own tool loop: the server runs the MCP tool itself. A call that finishes is run; a call the reply is cut inside is announced and never run.
+  const ask = async (content, max_tokens) => {
+    const res = await fetch(`${base}/v1/chat/completions`, { method: 'POST', headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({ model, stream: true, strata_mcp: true, max_tokens, temperature: 0.6, chat_template_kwargs: { enable_thinking: false }, messages: [{ role: 'user', content }] }) });
+    const text = await res.text();
+    const events = text.split(String.fromCharCode(10)).filter(l => l.startsWith('data: {')).map(l => JSON.parse(l.slice(6)));
+    const mcp = events.map(e => e.strata_mcp).filter(Boolean);
+    const finish = events.flatMap(e => e.choices ?? []).map(c => c.finish_reason).filter(Boolean).at(-1);
+    const said = events.flatMap(e => e.choices ?? []).map(c => c.delta?.content ?? '').join('');
+    return { mcp, finish, said };
+  };
+  const ok = await ask('Use the fake__echo tool to echo the text "hello from the tool", then tell me what it returned.', 600);
+  note('mcp: a short call is run by the server and answered', ok.mcp.some(m => m.event === 'result' && m.ok) && ok.finish === 'stop', `events ${JSON.stringify(ok.mcp.map(m => m.event))}; finish ${ok.finish}; said ${JSON.stringify(ok.said.slice(-120))}`);
+  const cut = await ask('Use the fake__echo tool once. Its text must be the sentence "the quick brown fox jumps over the lazy dog" written out 300 times in a row, separated by spaces.', 300);
+  note('mcp: a call the reply is cut inside is announced and never run (#211), and the stream says length', cut.mcp.some(m => m.event === 'start') && !cut.mcp.some(m => m.event === 'call') && cut.finish === 'length', `events ${JSON.stringify(cut.mcp.map(m => m.event))}; finish ${cut.finish}; said ${JSON.stringify(cut.said.slice(0, 100))}`);
+}
+
+if (want('pagoda')) {
+  const t = await turn('pagoda', 'Write me a 100 voxel pagoda in one html file with garden.');
+  const html = t.files.find(f => /\.html?$/i.test(f.name));
+  console.log(`   pagoda: ${t.seconds.toFixed(0)} s, frames ${JSON.stringify(t.byType)}, done ${JSON.stringify(t.done && { finishReason: t.done.finishReason, tokensOut: t.done.tokensOut })}, files ${JSON.stringify(t.files)}`);
+  note('pagoda: a file was written or the turn says why not', !!html || /cut|too long|ran out|limit/i.test(t.text), `file ${html ? html.name + ' ' + html.bytes + ' B' : 'none'}; finish ${t.done?.finishReason}; text tail: ${JSON.stringify(t.text.slice(-240))}`);
+}
+if (want('long')) for (let rep = 1; rep <= REPEAT; rep++) {
+  const t = await turn(`long${rep}`, longPrompt, { thinking: 'Off' });
+  const f = t.files.find(x => x.name === 'big.txt');
+  const lines = f ? readFileSync(join(t.workspace, 'big.txt'), 'utf8').split(String.fromCharCode(10)).filter(Boolean).length : 0;
+  console.log(`   long${rep}: ${t.seconds.toFixed(0)} s, frames ${JSON.stringify(t.byType)}, done ${JSON.stringify(t.done && { finishReason: t.done.finishReason, tokensOut: t.done.tokensOut })}, draft ${JSON.stringify(t.draftStats)}, cut notes ${JSON.stringify(t.cutNotes)}`);
+  note(`long${rep}: big.txt written (${LINES} lines asked)`, lines >= LINES * 0.95 || t.writesDone > 0 || t.cutNotes.length > 0 && !!f, `file ${f ? f.bytes + ' B, ' + lines + ' lines' : 'none'}; finish ${t.done?.finishReason}; tokens out ${t.done?.tokensOut}; cards ${JSON.stringify(t.cards.filter(c => c.state !== 'running').map(c => c.name))}; writes done ${t.writesDone}; cut notes ${t.cutNotes.length}; draft frames ${t.draftStats.frames}`);
+  note(`long${rep}: the turn did not end silently`, !!f || t.cutNotes.length > 0 || t.text.trim().length > 0, `text tail ${JSON.stringify(t.text.slice(-160))}`);
+}
+
+if (want('cut')) {
+  // A small window told to the Harness (E2E_CUT_WINDOW, default 24000; the engine's own stays WINDOW) makes the reply budget about 7K tokens (raised to
+  // 12K by the fix), so the first reply is cut inside the tool call, as the pagoda's was at 19,660.
+  await bridge.close();
+  bridge = makeBridge(Number(env('E2E_CUT_WINDOW', '24000')), 'agent-cut');
+  const t = await turn('cut', longPrompt, { thinking: 'Off' });
+  const f = t.files.find(x => x.name === 'big.txt');
+  const lines = f ? readFileSync(join(t.workspace, 'big.txt'), 'utf8').split(String.fromCharCode(10)).filter(Boolean).length : 0;
+  console.log(`   cut: ${t.seconds.toFixed(0)} s, frames ${JSON.stringify(t.byType)}, done ${JSON.stringify(t.done && { finishReason: t.done.finishReason })}, files ${JSON.stringify(t.files)}, cut notes ${JSON.stringify(t.cutNotes)}, draft ${JSON.stringify(t.draftStats)}`);
+  note('cut: the chat said the reply was cut, in words', t.cutNotes.length > 0 && t.cutNotes.every(n => /length limit/.test(n)), JSON.stringify(t.cutNotes));
+  note('cut: the agent went on and the file exists', !!f, `file ${f ? f.bytes + ' B, ' + lines + ' lines' : 'none'}; finish ${t.done?.finishReason}`);
+}
+
+writeFileSync(join(OUT, 'result.json'), JSON.stringify(rows, null, 2));
+console.log('\n' + rows.map(r => `${r.ok ? 'PASS' : 'FAIL'}  ${r.id}`).join('\n'));
+await finish(rows.some(r => !r.ok) ? 1 : 0);

apps/host/scripts/audit-ui.mjs

@@ -16,10 +16,15 @@ import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..');
-const APP = join(ROOT, 'src/styles/app.css');
+const STYLE_DIR = join(ROOT, 'src/styles');
 const KIT_SRC = join(ROOT, '..', 'ui');
 const KIT_COPY = join(ROOT, 'src/styles/kit');
 
+/** The app's own stylesheets, in cascade order: the last one wins. */
+const APP_SHEETS = ['app.css', 'liquid.css']
+  .map((name) => ({ name, css: existsSync(join(STYLE_DIR, name)) ? readFileSync(join(STYLE_DIR, name), 'utf8') : null }))
+  .filter((sheet) => sheet.css !== null);
+
 const KIT_SCALES = {
   radius: new Set(['8px', '14px', '20px', '24px', '9999px', '999px', '50%', '6px', '10px', '12px', '15px', '16px', '2px', '1.5px', 'inherit', '0']),
   fontSize: new Set(['11px', '12px', '13px', '14px', '15px', '16px', '17px', '18px', '19px', '22px', '24px', '30px', '32px', '40px', 'inherit']),
@@ -66,9 +71,12 @@ const BLUR_ALLOWED = new Set([
   '.menu',
   '.telepop',
   '.scrim',
+  ".scrim[data-open='true']", // the same scrim, once it is showing
+  '.dialog-scrim', // the sheet's scrim: it frosts the whole working screen
   '.config-savebar', // floating commit controls
   '.mobile-bar', // compact navigation controls
   '.st-toast--toned',
+  '.nav', // the navigation layer over the ambient depth layer
 ]);
 
 /**
@@ -83,6 +91,7 @@ const ELEVATION_ALLOWED = new Set([
   '.app[data-nav-open=\'true\'] > .nav', // dismissible navigation sheet
   '.st-tab[aria-checked=\'true\']', // selected segmented control
   '.nav-new', // primary action affordance
+  '.nav-new.st-btn--primary', // the same affordance, with its accent recipe
   '.st-drawer.sheet',
   '.slashmenu',
   '.select__pop',
@@ -95,9 +104,12 @@ const ELEVATION_ALLOWED = new Set([
   // The jump-to-latest pill sits above a scrolling transcript, so it genuinely
   // overlaps moving content — the same test the other entries pass.
   '.jumplatest',
+  '.quote-selection', // the Quote button that floats beside selected words (#4785)
   '.st-btn--primary', // the accent fill's own lift
   '.st-slider::-webkit-slider-thumb', // a control affordance: the thumb needs to read against its track
   '.st-toggle::after', // same: the knob needs to read against its track
+  '.family-switch button[aria-selected="true"]', // a selected segmented control, like .st-tab
+  '.native-choice__col .native-resource-choice button[data-selected="true"]', // same
 ]);
 
 /**
@@ -110,25 +122,61 @@ const CAPSULE_CONTROLS = ['.st-btn', '.st-input', '.st-tab', '.navitem', '.navse
 /** Literal colours that are deliberate and documented. */
 const DOCUMENTED_LITERALS = ['#05261b', '#12c68e', '#0a7a55'];
 
+/**
+ * The only selector allowed to paint a gradient: the single ambient depth layer.
+ *
+ * The flat-surface rule exists so surfaces read as paper rather than decoration.
+ * Depth was the one thing it could not express, and the navigation material has
+ * nothing to sample over a flat fill. A fixed, two-field wash on the page — too
+ * quiet to read as a gradient at ~1.04:1 — is the smallest thing that makes the
+ * glass mean anything. It is body-only, it never moves, and both reduced-
+ * transparency gates remove it. See src/styles/liquid.css §1.
+ */
+const AMBIENT_SELECTORS = new Set(['body']);
+
 const failures = [];
 const notes = [];
 const fail = (file, line, message) => failures.push(`${file}:${line}  ${message}`);
 
-/* ------------------------------------------------------------ app.css ---- */
+/* ------------------------------------------------------------ app sheets -- */
 
-const css = readFileSync(APP, 'utf8');
-const lines = css.split('\n');
-let selector = '(top level)';
-let inKeyframes = false;
+/**
+ * Scan one app stylesheet for the design-system, motion and material rules.
+ *
+ * Run over every sheet in the cascade, not only app.css: a rule appended in a
+ * later file ships just the same, and the "audit palette" block that broke AA on
+ * the primary button survived precisely because it had never been scanned.
+ */
+function scanStylesheet(file, css) {
+  const lines = css.split('\n');
+  let selector = '(top level)';
+  let inKeyframes = false;
 
-lines.forEach((raw, i) => {
-  const line = raw.replace(/\/\*.*?\*\//g, '');
-  const n = i + 1;
+  lines.forEach((raw, i) => {
+    const line = raw.replace(/\/\*.*?\*\//g, '');
+    const n = i + 1;
 
-  const sel = line.match(/^([^@{}\s][^{}]*)\{$/);
+  // Selectors are usually indented inside a media query or a nested block, so
+  // the line is trimmed before it is recognised. Without this every indented
+  // rule was attributed to "(top level)", and the material and elevation
+  // allowlists — which match on the selector — rejected most of the file.
+  const sel = line.trim().match(/^([^@{}\s][^{}]*)\{$/);
   if (sel) selector = sel[1].trim();
-  if (/@keyframes/.test(line)) inKeyframes = true;
-  if (inKeyframes && /^\}/.test(line)) inKeyframes = false;
+  // A whole rule on one line (`a, b { … }`) never ends with `{`, so it used to
+  // be attributed to whatever rule ran before it — which is why a shadow on a
+  // segmented control was reported against `.menu .response-stats`. The rule's
+  // own selector is used for its declarations.
+  let selectorForLine = selector;
+  if (!sel && !inKeyframes) {
+    const inline = line.trim().match(/^([^@{}][^{}]*?)\s*\{/);
+    if (inline && /\}/.test(line)) selectorForLine = inline[1].trim();
+  }
+  // A one-line `@keyframes name { … }` opens and closes on the same line, so it
+  // must not switch the tracker on: it never sees a closing brace at column 0,
+  // and every rule after it was then treated as part of an animation — which
+  // disabled the one-line selector attribution above.
+  if (/@keyframes/.test(line) && !/\}/.test(line)) inKeyframes = true;
+  if (inKeyframes && /^\}/.test(raw)) inKeyframes = false;
 
   for (const [, prop, rawValue] of line.matchAll(/([a-z-]+)\s*:\s*([^;]+);/g)) {
     const value = rawValue.trim();
@@ -137,24 +185,24 @@ lines.forEach((raw, i) => {
     if (prop === 'border-radius') {
       for (const part of value.split(/\s+/)) {
         if (!KIT_SCALES.radius.has(part) && !part.startsWith('var(') && !part.includes('%')) {
-          fail('app.css', n, `off-scale radius "${part}" in ${selector}`);
+          fail(file, n, `off-scale radius "${part}" in ${selectorForLine}`);
         }
       }
     }
     if (prop === 'font-size' && !value.startsWith('var(') && !value.includes('clamp') && !KIT_SCALES.fontSize.has(value)) {
-      fail('app.css', n, `off-scale font-size "${value}" in ${selector}`);
+      fail(file, n, `off-scale font-size "${value}" in ${selectorForLine}`);
     }
     if (prop === 'box-shadow' && !KIT_SCALES.shadow.some((re) => re.test(value))) {
-      fail('app.css', n, `shadow is not a kit token: "${value}" in ${selector}`);
+      fail(file, n, `shadow is not a kit token: "${value}" in ${selectorForLine}`);
     }
-    if (/gradient|radial|conic/.test(value) && prop.startsWith('background')) {
-      fail('app.css', n, `gradient in ${selector} — the system is flat`);
+    if (/gradient|radial|conic/.test(value) && prop.startsWith('background') && !AMBIENT_SELECTORS.has(selector)) {
+      fail(file, n, `gradient in ${selectorForLine} — the system is flat`);
     }
     if (/^(color|background|background-color|border-color)$/.test(prop)) {
       const literals = value.match(/#[0-9a-fA-F]{3,8}\b|rgba?\([^)]*\)/g);
       if (literals && !value.includes('data:image') && !value.includes('currentColor')
           && !DOCUMENTED_LITERALS.some((d) => value.includes(d))) {
-        fail('app.css', n, `literal colour "${value}" in ${selector} — use a token`);
+        fail(file, n, `literal colour "${value}" in ${selectorForLine} — use a token`);
       }
     }
 
@@ -163,57 +211,70 @@ lines.forEach((raw, i) => {
     // Values must be a --st-material-* token: that is what collapses the blur
     // under reduced transparency, so gating cannot be forgotten.
     if (prop === 'backdrop-filter' || prop === '-webkit-backdrop-filter') {
-      if (!/^var\(--st-material-(thin|regular|thick)\)$/.test(value) && !(selector === '.scrim' && value === 'none !important')) {
-        fail('app.css', n, `blur must use a --st-material-* token (it carries the gating): "${value}"`);
+      if (!/^var\(--st-material-(thin|regular|thick)\)( !important)?$/.test(value) && !(selector === '.scrim' && value === 'none !important')) {
+        fail(file, n, `blur must use a --st-material-* token (it carries the gating): "${value}"`);
       }
-      if (!BLUR_ALLOWED.has(selector)) {
-        fail('app.css', n, `material on "${selector}", which is not an approved surface — it does not overlay moving content`);
+      if (!BLUR_ALLOWED.has(selectorForLine)) {
+        fail(file, n, `material on "${selectorForLine}", which is not an approved surface — it does not overlay moving content`);
       }
     }
-    if (prop === 'box-shadow' && /var\(--st-sh-(card|bar|pop)\)/.test(value) && !ELEVATION_ALLOWED.has(selector)) {
-      fail('app.css', n, `elevation shadow on "${selector}" — shadows are reserved for surfaces that overlap content`);
+    if (prop === 'box-shadow' && /var\(--st-sh-(card|bar|pop)\)/.test(value) && !ELEVATION_ALLOWED.has(selectorForLine)) {
+      fail(file, n, `elevation shadow on "${selectorForLine}" — shadows are reserved for surfaces that overlap content`);
     }
 
     if (prop === 'transition') {
       if (/^\d/.test(value) || /(^|[\s,])\d+m?s\b/.test(value)) {
-        fail('app.css', n, `raw duration in transition — use a --st-t-* token: "${value}"`);
+        fail(file, n, `raw duration in transition — use a --st-t-* token: "${value}"`);
       }
       for (const part of value.split(',')) {
         const prop0 = part.trim().split(/\s+/)[0];
         if (LAYOUT_PROPS.includes(prop0)) {
-          fail('app.css', n, `transition on layout property "${prop0}" in ${selector}`);
+          fail(file, n, `transition on layout property "${prop0}" in ${selectorForLine}`);
         }
       }
     }
     if (prop === 'transition-property') {
       for (const p of value.split(',').map((v) => v.trim())) {
-        if (LAYOUT_PROPS.includes(p)) fail('app.css', n, `transition on layout property "${p}" in ${selector}`);
+        if (LAYOUT_PROPS.includes(p)) fail(file, n, `transition on layout property "${p}" in ${selectorForLine}`);
       }
     }
     if (prop === 'animation' || prop === 'animation-name') {
       const name = value.match(/^(st-[a-z-]+)/)?.[1];
       const infinite = /infinite/.test(value);
       if (infinite && name && !INFINITE_OK.has(name)) {
-        fail('app.css', n, `looping animation "${name}" is not on the allowlist — nothing loops while idle`);
+        fail(file, n, `looping animation "${name}" is not on the allowlist — nothing loops while idle`);
       }
       const duration = value.match(/\b(\d+(?:\.\d+)?m?s)\b/)?.[1];
       if (duration && !LOOP_DURATION_OK.has(duration)) {
-        fail('app.css', n, `raw animation duration "${duration}" in ${selector} — use a --st-t-* token`);
+        fail(file, n, `raw animation duration "${duration}" in ${selectorForLine} — use a --st-t-* token`);
       }
     }
     if (prop === 'animation-duration' && /^\d/.test(value) && !LOOP_DURATION_OK.has(value)) {
-      fail('app.css', n, `raw animation-duration "${value}" in ${selector}`);
+      fail(file, n, `raw animation-duration "${value}" in ${selectorForLine}`);
     }
-  }
-});
+    }
+  });
+}
+
+for (const sheet of APP_SHEETS) scanStylesheet(sheet.name, sheet.css);
+
+const css = APP_SHEETS.find((sheet) => sheet.name === 'app.css')?.css ?? '';
+const allAppCss = APP_SHEETS.map((sheet) => sheet.css).join('\n');
 
 /* ------------------------------------------------- kit sync + motion scale -- */
 
 for (const file of ['tokens.css', 'components.css']) {
   const a = join(KIT_SRC, file);
   const b = join(KIT_COPY, file);
-  if (!existsSync(a) || !existsSync(b)) {
-    fail('kit', 0, `${file} missing on one side`);
+  // Some checkouts of this branch do not carry the design-kit source (apps/ui),
+  // only the synced copy. There is nothing to compare against then, so the check
+  // reports that instead of failing every run with a condition no one can fix.
+  if (!existsSync(a)) {
+    notes.push(`kit copy: ${file} has no source in this checkout — drift check skipped`);
+    continue;
+  }
+  if (!existsSync(b)) {
+    fail('kit', 0, `${file} missing from src/styles/kit — run npm run sync:kit`);
     continue;
   }
   // The sync rewrites @font-face URLs to absolute; everything else must match.
@@ -223,10 +284,11 @@ for (const file of ['tokens.css', 'components.css']) {
   }
 }
 
-// Which selectors have been given the capsule radius.
+// Which selectors have been given the capsule radius. Checked across the whole
+// cascade: a control is a capsule wherever the rule that says so lives.
 const capsuled = new Set();
 {
-  const rules = css.replace(/\/\*[\s\S]*?\*\//g, '');
+  const rules = allAppCss.replace(/\/\*[\s\S]*?\*\//g, '');
   for (const [, sel, body] of rules.matchAll(/([^{}]+)\{([^{}]*)\}/g)) {
     if (!/border-radius:\s*var\(--st-r-pill\)/.test(body)) continue;
     for (const part of sel.split(',')) capsuled.add(part.trim());
@@ -263,7 +325,7 @@ const referenced = new Set();
 for (const file of [...readdirSync(join(ROOT, 'src'), { recursive: true })].filter((f) => /\.tsx$/.test(String(f)))) {
   const full = join(ROOT, 'src', String(file));
   if (!statSync(full).isFile()) continue;
-  for (const m of readFileSync(full, 'utf8').matchAll(/name="([a-z-]+)"/g)) referenced.add(m[1]);
+  for (const m of readFileSync(full, 'utf8').matchAll(/<(?:Icon|IconBtn)\s[^>]*?\bname="([a-z-]+)"/g)) referenced.add(m[1]);
 }
 for (const name of referenced) {
   if (!symbols.has(name)) fail('src', 0, `icon "${name}" is referenced but not in the sprite — run npm run sync:kit`);

apps/host/scripts/browser.mjs

@@ -0,0 +1,54 @@
+/**
+ * Where the Chromium binary the probes drive actually lives.
+ *
+ * The probes launched a fixed macOS cache path, so on Windows and Linux they
+ * printed "No cached Chromium found" and every runtime gate (contrast, measure,
+ * luminance, motion) was skipped rather than run. Resolution is now a single
+ * place with the same order everywhere:
+ *
+ *   1. STRATA_CHROME — an explicit override, for a CI image or a second Chrome
+ *   2. the cached Playwright build (macOS, the original platforms)
+ *   3. an installed browser: Chrome, Edge, Chromium
+ *
+ * `requireChromium` exits with the harness message the scripts already used, so
+ * a machine with no browser at all still fails loudly instead of silently
+ * passing a gate.
+ */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+
+const PLAYWRIGHT_MAC = [
+  join(homedir(), 'Library/Caches/ms-playwright/chromium-1234/chrome-mac-arm64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing'),
+  join(homedir(), 'Library/Caches/ms-playwright/chromium_headless_shell-1234/chrome-headless-shell-mac-arm64/chrome-headless-shell'),
+];
+
+const INSTALLED = [
+  // Windows
+  'C:/Program Files/Google/Chrome/Application/chrome.exe',
+  'C:/Program Files (x86)/Google/Chrome/Application/chrome.exe',
+  'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe',
+  'C:/Program Files/Microsoft/Edge/Application/msedge.exe',
+  // macOS
+  '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+  '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
+  // Linux
+  '/usr/bin/google-chrome',
+  '/usr/bin/google-chrome-stable',
+  '/usr/bin/chromium',
+  '/usr/bin/chromium-browser',
+];
+
+export function findChromium() {
+  const candidates = [process.env.STRATA_CHROME, ...PLAYWRIGHT_MAC, ...INSTALLED].filter(Boolean);
+  return candidates.find((path) => existsSync(path)) ?? null;
+}
+
+export function requireChromium() {
+  const path = findChromium();
+  if (!path) {
+    console.error('No Chromium found. Set STRATA_CHROME, or install Chrome, Edge or Chromium.');
+    process.exit(2);
+  }
+  return path;
+}

apps/host/scripts/chat-growth-proxy.mjs

@@ -0,0 +1,26 @@
+// Throwaway: serves the demo host unchanged, except POST /api/chat/stream, which streams a long scripted reply (NDJSON frames like the real host).
+import http from 'node:http';
+const UP = Number(process.env.UP ?? 18791), PORT = Number(process.env.PORT ?? 18790);
+const TOK = Number(process.env.REPLY_TOKENS ?? 12000), REASON = Number(process.env.REASON_TOKENS ?? 3000), RATE = Number(process.env.RATE ?? 400);
+const sleep = ms => new Promise(r => setTimeout(r, ms));
+const para = i => `### Section ${i}\n\nThis is paragraph ${i} with **bold**, *italic*, \`inline code\` and a link [x](https://example.com/${i}). The measured value is about ${i} units and the results agree with the earlier runs, which is what we expected from the model.
+
+More prose follows here so that a paragraph looks like real writing and not like a stress pattern.\n\n- item one of ${i}\n- item two of ${i}\n\n\`\`\`python\ndef f_${i}(a, b):\n    total = a + b * ${i}\n    return total\n\`\`\`\n\n| a | b |\n|---|---|\n| ${i} | ${i * 2} |\n\n`;
+http.createServer(async (req, res) => {
+  if (req.method === 'POST' && req.url.startsWith('/api/chat/stream')) {
+    let raw = ''; for await (const c of req) raw += c;
+    res.writeHead(200, { 'content-type': 'application/x-ndjson' });
+    const w = o => res.write(JSON.stringify(o) + '\n');
+    w({ type: 'start', model: 'Mock', contextMax: 131072, requestId: 'r' + Date.now() });
+    let sent = 0, i = 0;
+    const per = Math.max(1, Math.round(RATE / 50));
+    while (sent < REASON) { w({ type: 'reasoning', text: 'thinking about step ' + (i++) + ' of the problem. '.repeat(1) }); sent += 9; if (sent % per < 9) await sleep(20); }
+    sent = 0; i = 0;
+    while (sent < TOK) { const p = para(i++); for (let k = 0; k < p.length; k += 24) { w({ type: 'delta', text: p.slice(k, k + 24) }); sent += 6; if ((sent / 6) % Math.max(1, Math.round(per / 2)) === 0) await sleep(10); } w({ type: 'stats', tokensOut: sent, tps: 90 }); }
+    w({ type: 'done', tokensIn: 100, tokensOut: sent, tps: 90, durationMs: 1000, usageSource: 'engine' });
+    return res.end();
+  }
+  const up = http.request({ host: '127.0.0.1', port: UP, path: req.url, method: req.method, headers: req.headers }, r => { res.writeHead(r.statusCode, r.headers); r.pipe(res); });
+  up.on('error', () => { res.writeHead(502); res.end(); });
+  req.pipe(up);
+}).listen(PORT, '127.0.0.1', () => console.log('proxy on', PORT));

apps/host/scripts/chat-growth.mjs

@@ -0,0 +1,57 @@
+// Measures the chat page's heap, DOM size and main-thread time per streamed reply. Needs a throwaway host (STRATA_REAL_ENGINE=0, port 18791), scripts/chat-growth-proxy.mjs (port 18790) and Chrome.
+import { chromium } from 'playwright-core';
+import { deflateSync } from 'node:zlib';
+import { randomBytes } from 'node:crypto';
+import { execSync } from 'node:child_process';
+const BASE = process.env.BASE ?? 'http://127.0.0.1:18790';
+const TURNS = Number(process.env.TURNS ?? 6), PICS = Number(process.env.PICS ?? 3), MON = process.env.MON !== '0';
+const crc = (() => { const t = new Int32Array(256).map((_, n) => { let c = n; for (let k = 0; k < 8; k++) c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1; return c; }); return b => { let c = -1; for (const x of b) c = t[(c ^ x) & 255] ^ (c >>> 8); return (c ^ -1) >>> 0; }; })();
+function png(w, h) {
+  const chunk = (type, data) => { const len = Buffer.alloc(4); len.writeUInt32BE(data.length); const body = Buffer.concat([Buffer.from(type), data]); const c = Buffer.alloc(4); c.writeUInt32BE(crc(body)); return Buffer.concat([len, body, c]); };
+  const raw = Buffer.alloc((w * 3 + 1) * h); for (let y = 0; y < h; y++) { raw[y * (w * 3 + 1)] = 0; randomBytes(w * 3).copy(raw, y * (w * 3 + 1) + 1); }
+  const ihdr = Buffer.alloc(13); ihdr.writeUInt32BE(w, 0); ihdr.writeUInt32BE(h, 4); ihdr[8] = 8; ihdr[9] = 2;
+  return Buffer.concat([Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]), chunk('IHDR', ihdr), chunk('IDAT', deflateSync(raw, { level: 1 })), chunk('IEND', Buffer.alloc(0))]);
+}
+const browser = await chromium.launch({ executablePath: 'C:/Program Files/Google/Chrome/Application/chrome.exe', headless: true, args: ['--enable-precise-memory-info', '--js-flags=--expose-gc'] });
+const ctx = await browser.newContext({ viewport: { width: 1400, height: 900 } });
+const page = await ctx.newPage();
+const cdp = await ctx.newCDPSession(page);
+await cdp.send('Performance.enable');
+await fetch(BASE + '/api/model-providers', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ kind: 'custom', provider: null, name: 'Mock model', baseUrl: 'http://127.0.0.1:18898/v1', protocol: 'openai-chat', apiKey: '', models: [{ id: 'mock-model', name: 'Mock model' }] }) });
+await page.goto(BASE + '/'); await page.waitForTimeout(1500);
+const skip = page.getByText('Go straight to the app'); await skip.waitFor({ timeout: 10000 }).catch(() => {}); if (await skip.count()) { await skip.click(); await page.waitForTimeout(800); }
+async function metrics(tag) {
+  await cdp.send('HeapProfiler.collectGarbage').catch(() => {});
+  const m = Object.fromEntries((await cdp.send('Performance.getMetrics')).metrics.map(x => [x.name, x.value]));
+  const dom = await cdp.send('Memory.getDOMCounters').catch(() => ({}));
+  const sess = await page.evaluate(() => { try { return (localStorage.getItem('strata.sessions.v1') ?? '').length; } catch { return -1; } });
+  console.log(`${tag.padEnd(22)} heap=${(m.JSHeapUsedSize / 1048576).toFixed(0)}MB total=${(m.JSHeapTotalSize / 1048576).toFixed(0)}MB nodes=${dom.nodes ?? m.Nodes} listeners=${dom.jsEventListeners ?? '-'} docs=${m.Documents} ls=${(sess / 1e6).toFixed(2)}M`);
+  return m.JSHeapUsedSize;
+}
+await page.locator('.chat-model-picker').first().click(); await page.locator('.model-picker-api').first().click(); await page.waitForTimeout(500);
+await metrics('start');
+const ta = page.locator('.composer textarea');
+for (let t = 1; t <= TURNS; t++) {
+  if (t <= PICS) {
+    const b64 = png(900, 900).toString('base64');
+    await page.evaluate(b64 => { const bytes = Uint8Array.from(atob(b64), c => c.charCodeAt(0)); const d = new DataTransfer(); d.items.add(new File([bytes], 'image.png', { type: 'image/png' })); document.querySelector('.composer textarea').dispatchEvent(new ClipboardEvent('paste', { clipboardData: d, bubbles: true, cancelable: true })); }, b64);
+    await page.waitForTimeout(600);
+  }
+  await ta.fill('turn ' + t + ' write a long answer'); 
+  await page.getByRole('button', { name: 'Send' }).click();
+  const t0 = Date.now();
+  let peak = 0; const cpu0 = (await cdp.send('Performance.getMetrics')).metrics.find(x => x.name === 'TaskDuration').value;
+  for (;;) {
+    await page.waitForTimeout(2000);
+    const m = Object.fromEntries((await cdp.send('Performance.getMetrics')).metrics.map(x => [x.name, x.value]));
+    peak = Math.max(peak, m.JSHeapUsedSize);
+    const busy = await page.getByRole('button', { name: /Stop/ }).count();
+    if (!busy || Date.now() - t0 > 240000) break;
+  }
+  const cpu1 = (await cdp.send('Performance.getMetrics')).metrics.find(x => x.name === 'TaskDuration').value;
+  console.log(`  turn ${t}: ${(Date.now() - t0) / 1000}s peak-heap=${(peak / 1048576).toFixed(0)}MB main-thread-busy=${(cpu1 - cpu0).toFixed(1)}s`);
+  await metrics('after turn ' + t);
+}
+if (MON) { await page.getByText('Monitor', { exact: true }).first().click().catch(() => console.log('no monitor link')); await page.waitForTimeout(25000); await metrics('monitor 25s'); }
+try { console.log(execSync('powershell -NoProfile -c "(Get-Process chrome | Measure-Object WorkingSet64 -Sum).Sum/1MB"').toString().trim(), 'MB chrome working set total'); } catch {}
+await browser.close();

apps/host/scripts/context-e2e.mjs

@@ -0,0 +1,182 @@
+#!/usr/bin/env node
+/**
+ * The context fixes against a REAL engine (not the scripted worker): Gyro-S at 64K on this PC, the agent bridge and the real Harness.
+ *
+ *   gpu + heavy locks held first (python phaseA-tests\lock.py acquire gpu "023-agent: context e2e", then heavy); one engine; nothing of the
+ *   installed app is used or touched: its model files are read, its Harness is copied (STRATA_HARNESS_DIR), data goes to a scratch folder.
+ *
+ *   node scripts/context-e2e.mjs                       (needs STRATA_HARNESS_DIR; see the E2E_* names below)
+ *
+ * It starts serve/server.py as ITS OWN child (foreground: this script waits for it and stops it by PID at the end or on a memory alarm),
+ * runs four scenarios and prints one table. Exit code 0 when every expectation held.
+ *
+ *   A  a message that can never fit (about 60K tokens in a 64K window) is refused in seconds, before the engine reads it
+ *   B  a chat of dense log messages grows past the window several times over: automatic compaction runs, nothing is refused
+ *   C  /compact at a high fill: summarises, says the figures; and a second /compact is answered in plain words
+ *   D  the needle: a fact from the first message is asked about at the end (reported, not asserted: it is the summary's quality)
+ */
+import { spawn, spawnSync } from 'node:child_process';
+import { existsSync, mkdtempSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { createAgentBridge } from '../server/agent/agent-bridge.mjs';
+import { countTokens } from '../server/agent/context-fit.mjs';
+
+const REPO = join(import.meta.dirname, '..', '..', '..');
+const env = (name, fallback) => process.env[name] ?? fallback;
+const DOCS = env('E2E_DOCS', 'C:\\Users\\AI-Server\\Documents\\Strata');
+const ENGINE = env('E2E_ENGINE', 'C:\\Users\\AI-Server\\Desktop\\Strata\\GitHub\\wt-023-int\\build-cuda\\strata.exe');
+const PROFILE = env('E2E_EXPERT_PROFILE', 'C:\\Users\\AI-Server\\AppData\\Local\\Programs\\Strata\\control\\data\\expert-profile.bin');
+const PYTHON = env('E2E_PYTHON', 'python');
+const PORT = Number(env('E2E_PORT', '18590'));
+const MIN_FREE_GB = Number(env('E2E_MIN_FREE_GB', '7'));
+const GGUF = join(DOCS, 'models', 'gyro-Gyro-S', 'Qwen3.8-Flash-Next-Gyro-S-TQ1_0.gguf');
+const CUDA_BIN = env('E2E_CUDA_BIN', 'C:\\Program Files\\NVIDIA GPU Computing Toolkit\\CUDA\\v13.0\\bin');
+const WINDOW = 65536;
+/** A model server that is already running (the scripted worker, to try this script without a GPU): nothing is started or stopped. */
+const EXISTING = process.env.E2E_BASE_URL ?? '';
+
+const sleep = ms => new Promise(r => setTimeout(r, ms));
+const freeGb = () => {
+  const out = spawnSync('powershell', ['-NoProfile', '-Command', '[math]::Round((Get-CimInstance Win32_OperatingSystem).FreePhysicalMemory/1MB,1)'], { encoding: 'utf8' }).stdout.trim();
+  return Number(out);
+};
+const rows = [];
+const note = (id, ok, detail) => { rows.push({ id, ok, detail }); console.log(`${ok ? 'PASS' : 'FAIL'}  ${id}  ${detail}`); };
+
+if (!process.env.STRATA_HARNESS_DIR) { console.error('STRATA_HARNESS_DIR is not set'); process.exit(2); }
+if (!EXISTING) for (const f of [ENGINE, GGUF]) if (!existsSync(f)) { console.error(`missing: ${f}`); process.exit(2); }
+if (!EXISTING && freeGb() < 20) { console.error(`only ${freeGb()} GB of RAM are free; wait for the other streams (lock.py status) and run again`); process.exit(2); }
+
+const scratch = mkdtempSync(join(tmpdir(), 'strata-ctx-e2e-'));
+const configFile = join(scratch, 'server.json');
+const logFile = join(scratch, 'server.log');
+const readyFile = join(scratch, 'ready.json');
+writeFileSync(configFile, JSON.stringify({
+  exe: ENGINE,
+  args: ['--pack', join(DOCS, 'packs', 'gyro-gyro-s'), '--native', GGUF, '--ple-gguf', GGUF, ...(existsSync(PROFILE) ? ['--expert-profile', PROFILE] : []),
+    '--prefill', 'auto', '--spec-min-p', '0.5', '--mtp', join(DOCS, 'mtp', 'rt'), '--max-context', String(WINDOW), '--kv', 'int8', '--pool-workers', '5',
+    '--expert-cache', 'auto', '--kv-resident', '32768', '--spec', '4', '--vram-reserve-mib', '1536'],
+  cwd: REPO, tokenizer: join(DOCS, 'packs', 'gyro-gyro-s', 'tokenizer'), model_name: 'qwen3.8-flash-next-gyro-gyro-s', log: join(scratch, 'engine.log'), lib_dirs: [], port: PORT, gpu: 0,
+}, null, 2));
+
+let server = null, bridge = null, alarm = null;
+const stopServer = () => {
+  if (server?.pid) spawnSync('taskkill', ['/T', '/F', '/PID', String(server.pid)], { stdio: 'ignore' });
+  server = null;
+};
+const finish = async (code) => {
+  clearInterval(alarm);
+  try { await bridge?.close(); } catch { /* going away */ }
+  stopServer();
+  await sleep(1500);
+  console.log(`\nscratch folder: ${scratch}`);
+  process.exit(code);
+};
+process.on('SIGINT', () => finish(130));
+
+if (!EXISTING) server = spawn(PYTHON, ['serve/server.py', '--engine', 'strata', '--config', configFile, '--port', String(PORT), '--no-api-key', '--ready-file', readyFile], {
+  cwd: REPO, env: { ...process.env, PATH: `${CUDA_BIN};${process.env.PATH}`, STRATA_DATA_DIR: join(scratch, 'data') }, stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true,
+});
+const sink = [];
+if (server) { server.stdout.on('data', d => sink.push(String(d))); server.stderr.on('data', d => sink.push(String(d))); server.on('exit', code => { sink.push(`[server exited ${code}]`); server = null; }); }
+// Memory alarm: this run must never be what freezes the PC. Under the floor the engine is stopped (by PID) and the run ends.
+if (!EXISTING) alarm = setInterval(() => { const free = freeGb(); if (free < MIN_FREE_GB) { console.error(`ALARM: ${free} GB of RAM free, stopping the engine`); finish(3); } }, 3000);
+alarm?.unref?.();
+
+const base = EXISTING || `http://127.0.0.1:${PORT}`;
+let ready = false;
+for (let i = 0; i < 120 && !ready; i++) {
+  if (!EXISTING && !server) break;
+  try { ready = (await fetch(`${base}/health`, { signal: AbortSignal.timeout(2000) })).ok; } catch { /* still loading */ }
+  if (!ready) await sleep(2000);
+}
+writeFileSync(logFile, sink.join(''));
+if (!ready) { console.error('the engine did not become ready:\n' + sink.join('').slice(-1500)); await finish(4); }
+const model = (await (await fetch(`${base}/v1/models`)).json()).data[0].id;
+console.log(`engine ready: ${model}, free RAM ${freeGb()} GB`);
+
+// ---------------------------------------------------------------------------------------------------------------- the pieces
+
+const line = i => `2026-10-22 13:${String(Math.floor(i / 60) % 60).padStart(2, '0')}:${String(i % 60).padStart(2, '0')} INFO svc-${i % 17} req=${(i * 2654435761 >>> 0).toString(16)} status=${200 + (i % 7) * 3} ms=${(i * 37) % 900} path=/api/v1/items/${(i * 7919) % 100000}`;
+const logText = (chars, from = 0, needle = '') => {
+  const out = [];
+  let n = 0, i = from;
+  while (n < chars) { const l = line(i++); out.push(l); n += l.length + 1; }
+  if (needle) out.splice(Math.floor(out.length / 2), 0, needle);
+  return out.join('\n');
+};
+const count = text => countTokens({ baseUrl: `${base}/v1`, model, text });
+
+const turnsOf = async (message) => {
+  const frames = [];
+  const t0 = Date.now();
+  await bridge.runTurn({ chatId: 'e2e', message, workspacePath: scratch, mode: 'bypass', thinking: 'Off', onFrame: f => frames.push(f) });
+  return { frames, seconds: (Date.now() - t0) / 1000, last: frames.at(-1) };
+};
+const textOf = frames => frames.filter(f => f.type === 'delta' && !f.noteReason).map(f => f.text).join('').trim();
+const noteOf = frames => frames.find(f => f.type === 'delta' && f.noteReason === 'compacted')?.text?.trim() ?? null;
+
+bridge = createAgentBridge({
+  dataDir: join(scratch, 'agent'), env: process.env, startTimeoutMs: 120_000, log: l => console.log('   bridge:', l),
+  localInstances: () => [{ id: 'e2e', label: 'Gyro-S', baseUrl: `${base}/v1`, modelId: model, context: WINDOW, slots: 1, key: '' }], connections: () => [],
+});
+mkdirSync(join(scratch, 'agent'), { recursive: true });
+
+// ---------------------------------------------------------------------------------------------------------------- A
+{
+  // Grow a log until the engine itself counts about 60K tokens.
+  let chars = 150_000, tokens = await count(logText(chars));
+  while (tokens && tokens < 58_000 && chars < 400_000) { chars = Math.round(chars * (60_000 / tokens)); tokens = await count(logText(chars)); }
+  const t = await turnsOf(logText(chars) + '\n\nWhat is the most common status?');
+  const refused = t.last.type === 'error' && t.last.code === 'CONTEXT_MESSAGE_TOO_LARGE';
+  note('A  too large is refused before it is read', refused && t.seconds < 15, `${chars} characters = ${tokens} tokens by the engine; answered in ${t.seconds.toFixed(1)} s; frame ${t.last.type}/${t.last.code ?? '-'}: ${String(t.last.message ?? '').slice(0, 110)}`);
+}
+
+// ---------------------------------------------------------------------------------------------------------------- B
+const needle = 'NOTE FROM OPS: the vault code is COBALT-27. Do not lose it.';
+const timeline = [];
+let notes = 0, refusedAny = false, peak = 0;
+{
+  for (let k = 0; k < 5; k++) {
+    const body = logText(34_000, k * 1000, k === 0 ? needle : '');
+    const t = await turnsOf(`${body}\n\nReply with the single word OK.`);
+    const note = noteOf(t.frames);
+    if (note) notes++;
+    if (t.last.type === 'error') refusedAny = true;
+    const used = t.last.contextTokens ?? 0;
+    peak = Math.max(peak, ...t.frames.filter(f => f.type === 'context').map(f => f.contextTokens), used);
+    timeline.push(`msg${k + 1}: ${t.last.type}${t.last.code ? '/' + t.last.code : ''} ${t.seconds.toFixed(0)} s context ${used} (${Math.round(100 * used / WINDOW)}%)${note ? ' [' + note.slice(0, 80) + ']' : ''}`);
+    console.log('   ' + timeline.at(-1));
+    if (t.last.type === 'error') break;
+  }
+  note('B  five dense messages (about 14K tokens each) in a 64K window: no error', !refusedAny, `peak context ${peak} of ${WINDOW}; ${notes} compaction note(s) in the chat`);
+  note('B  compaction ran and was announced', notes >= 1, timeline.join(' | '));
+}
+
+// ---------------------------------------------------------------------------------------------------------------- C
+{
+  const run = async (line) => { const frames = []; await bridge.compactCommand({ chatId: 'e2e', message: line, workspacePath: scratch, mode: 'bypass', choice: null, onFrame: f => frames.push(f) }); return frames; };
+  await turnsOf(`${logText(30_000, 90_000)}\n\nReply with the single word OK.`);
+  const t0 = Date.now();
+  const first = await run('/compact');
+  const said = first.find(f => f.type === 'delta');
+  const ok = said?.key === 'Older messages were summarized to make room. The chat was {0}% full and is now {1}% full.' && said.values[0] > said.values[1];
+  note('C  /compact summarises and states the figures', ok, `${((Date.now() - t0) / 1000).toFixed(0)} s: ${said?.text}`);
+  const second = await run('/compact');
+  const again = second.find(f => f.type === 'delta')?.text ?? '';
+  note('C  a second /compact is answered in plain words', /summarized|nothing|could not/i.test(again) && !/\{|400|invalid_request/.test(again), again);
+}
+
+// ---------------------------------------------------------------------------------------------------------------- D
+{
+  const t = await turnsOf('What was the vault code in the very first message? Answer with the code only.');
+  const answer = textOf(t.frames);
+  console.log(`D  needle after compaction: "${answer.slice(0, 80)}"  (${t.last.type})`);
+  rows.push({ id: 'D  the needle', ok: /COBALT-27/.test(answer), detail: `reported only: answer "${answer.slice(0, 80)}"` });
+}
+
+console.log('\n' + rows.map(r => `${r.ok ? 'PASS' : r.id.startsWith('D') ? 'INFO' : 'FAIL'}  ${r.id}${r.id.startsWith('D') ? `  ${r.detail}` : ''}`).join('\n'));
+const failed = rows.filter(r => !r.ok && !r.id.startsWith('D')).length;
+writeFileSync(join(scratch, 'result.json'), JSON.stringify(rows, null, 2));
+await finish(failed ? 1 : 0);

apps/host/scripts/contrast.mjs

@@ -19,13 +19,11 @@ import { chromium } from 'playwright-core';
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
+import { requireChromium } from './browser.mjs';
 
 const BASE = process.env.STRATA_URL ?? 'http://localhost:5199';
 
-const executablePath = [
-  join(homedir(), 'Library/Caches/ms-playwright/chromium-1234/chrome-mac-arm64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing'),
-  join(homedir(), 'Library/Caches/ms-playwright/chromium_headless_shell-1234/chrome-headless-shell-mac-arm64/chrome-headless-shell'),
-].find((p) => existsSync(p));
+const executablePath = requireChromium();
 
 if (!executablePath) {
   console.error('No cached Chromium found. Run `npm run shot -- x.png <url>` once to confirm the harness.');

apps/host/scripts/flow.mjs

@@ -7,11 +7,9 @@ import { chromium } from 'playwright-core';
 import { existsSync, mkdirSync } from 'node:fs';
 import { join, resolve } from 'node:path';
 import { homedir } from 'node:os';
+import { requireChromium } from './browser.mjs';
 
-const executablePath = [
-  join(homedir(), 'Library/Caches/ms-playwright/chromium-1234/chrome-mac-arm64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing'),
-  join(homedir(), 'Library/Caches/ms-playwright/chromium_headless_shell-1234/chrome-headless-shell-mac-arm64/chrome-headless-shell'),
-].find((p) => existsSync(p));
+const executablePath = requireChromium();
 
 const BASE = process.env.STRATA_URL ?? 'http://localhost:5199';
 const flow = process.argv[2] ?? 'chat';

apps/host/scripts/fr_sync.py

@@ -0,0 +1,156 @@
+"""French (fr) catalog tooling for the desktop app (#3970).
+
+The French texts live in src/locales/fr.json, fix-fr.json, tune-fr.json and tools-fr.json, next to the other languages.
+They are edited by hand (they are the translations, not generated), so a string added to an English catalog later has no
+French yet. This script lists and merges those. From apps/host:
+
+    python scripts/fr_sync.py missing [out.tsv]        write every English string that has no French yet
+    python scripts/fr_sync.py apply done.tsv           merge translations, rewrite the four fr files in English key order
+    python scripts/fr_sync.py check                    exit 1 if a French string is missing, empty or breaks a placeholder / tag
+
+The TSV has one string per line:  <id><TAB><text>.  In the text, a newline is written \\n and a backslash \\\\.
+In the "done" file a lone  =  means "keep the English text as it is" (class names, product names, file names).
+The id prefix picks the file:  s0001 -> fr.json, fx01 -> fix-fr.json, tune01 -> tune-fr.json, tl01 -> tools-fr.json.
+Use "vous", plain short words, a next step, and a no-break space (U+00A0) before : ; ? ! and inside guillemets.
+"""
+import json
+import re
+import sys
+from pathlib import Path
+
+LOCALES = Path(__file__).resolve().parent.parent / "src" / "locales"
+PAIRS = [("en.json", "fr.json"), ("fix-en.json", "fix-fr.json"), ("tune-en.json", "tune-fr.json"), ("tools-en.json", "tools-fr.json")]
+SLOT = re.compile(r"\{\d+\}")
+TAG = re.compile(r"</?[A-Za-z][^>]*>")
+
+
+def load(name):
+    path = LOCALES / name
+    return json.loads(path.read_text(encoding="utf-8")) if path.exists() else {}
+
+
+def file_of(identifier):
+    for en_name, fr_name in PAIRS:
+        if identifier in load(en_name):
+            return fr_name
+    raise SystemExit(f"unknown id {identifier}: it is in no English catalog")
+
+
+def escape(text):
+    return text.replace("\\", "\\\\").replace("\n", "\\n")
+
+
+def unescape(text):
+    out, i = [], 0
+    while i < len(text):
+        if text[i] == "\\" and i + 1 < len(text):
+            out.append({"n": "\n", "\\": "\\"}.get(text[i + 1], text[i + 1]))
+            i += 2
+        else:
+            out.append(text[i])
+            i += 1
+    return "".join(out)
+
+
+NBSP = " "
+
+
+def typography(text):
+    """French spacing and apostrophes, applied to every translated (not kept) string.
+    l'image -> l'image with a typographic apostrophe (also before a {0} slot); a no-break space before : ; ? ! % and inside the guillemets."""
+    text = re.sub(r"(?<=[A-Za-zÀ-ſ])'(?=[A-Za-zÀ-ſ{])", "’", text)
+    text = re.sub(r"(?<=\S) ([:;?!])", NBSP + r"\1", text)
+    text = re.sub(r"(?<=[\d}]) %", NBSP + "%", text)
+    text = re.sub("« ?", "«" + NBSP, text)
+    text = re.sub(" ?»", NBSP + "»", text)
+    return text
+
+
+def problems(identifier, source, text):
+    found = []
+    if not text.strip():
+        found.append("empty")
+    expected = [slot for slot in SLOT.findall(source) if not (identifier == "s2463" and slot == "{1}")]  # the tests allow this one to drop {1} (the plural suffix)
+    if sorted(expected) != sorted(SLOT.findall(text)):
+        found.append("placeholders differ")
+    if sorted(TAG.findall(source)) != sorted(TAG.findall(text)):
+        found.append("markup differs")
+    return found
+
+
+def missing():
+    todo = {}
+    for en_name, fr_name in PAIRS:
+        en, fr = load(en_name), load(fr_name)
+        for identifier, text in en.items():
+            if identifier not in fr:
+                todo[identifier] = text
+    return todo
+
+
+def main(argv):
+    command = argv[1] if len(argv) > 1 else ""
+    if command == "missing":
+        todo = missing()
+        lines = [f"{identifier}\t{escape(text)}" for identifier, text in todo.items()]
+        if len(argv) > 2:
+            Path(argv[2]).write_text("\n".join(lines) + ("\n" if lines else ""), encoding="utf-8")
+            print(f"{len(lines)} strings without French written to {argv[2]}")
+        else:
+            print("\n".join(lines))
+            print(f"{len(lines)} strings without French", file=sys.stderr)
+        return 0
+    if command == "apply" and len(argv) > 2:
+        incoming = {}
+        for number, line in enumerate(Path(argv[2]).read_text(encoding="utf-8").splitlines(), 1):
+            if not line.strip():
+                continue
+            if "\t" not in line:
+                raise SystemExit(f"{argv[2]}:{number}: no tab")
+            identifier, text = line.split("\t", 1)
+            incoming[identifier.strip()] = text
+        bad = 0
+        for en_name, fr_name in PAIRS:
+            en, fr = load(en_name), load(fr_name)
+            changed = False
+            for identifier, source in en.items():
+                if identifier in incoming:
+                    text = source if incoming[identifier] == "=" else typography(unescape(incoming[identifier]))
+                    for why in problems(identifier, source, text):
+                        print(f"{identifier}: {why}: {source!r} -> {text!r}")
+                        bad += 1
+                    fr[identifier] = text
+                    changed = True
+            if changed:
+                ordered = {identifier: fr[identifier] for identifier in en if identifier in fr}
+                (LOCALES / fr_name).write_text(json.dumps(ordered, ensure_ascii=False, indent=1 if en_name != "en.json" else 2) + "\n", encoding="utf-8")
+        unknown = [identifier for identifier in incoming if not any(identifier in load(en_name) for en_name, _ in PAIRS)]
+        for identifier in unknown:
+            print(f"{identifier}: not in any English catalog")
+            bad += 1
+        print(f"applied {len(incoming)} strings, {bad} problems")
+        return 1 if bad else 0
+    if command == "check":
+        bad = 0
+        for en_name, fr_name in PAIRS:
+            en, fr = load(en_name), load(fr_name)
+            for identifier, source in en.items():
+                if identifier not in fr:
+                    print(f"{fr_name}: {identifier} has no French yet: {source!r}")
+                    bad += 1
+                    continue
+                for why in problems(identifier, source, fr[identifier]):
+                    print(f"{fr_name}: {identifier}: {why}")
+                    bad += 1
+            for identifier in fr:
+                if identifier not in en:
+                    print(f"{fr_name}: {identifier} is not in {en_name}")
+                    bad += 1
+        print("French catalogs complete" if not bad else f"{bad} problems")
+        return 1 if bad else 0
+    print(__doc__)
+    return 2
+
+
+if __name__ == "__main__":
+    raise SystemExit(main(sys.argv))

apps/host/scripts/language-shots.mjs

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+/**
+ * Screenshots of the app screens in one interface language, from a hermetic preview host (simulated hardware and models,
+ * scratch profile, no engine, no weights). The browser is a throw-away headless Chrome profile.
+ *
+ *   node scripts/language-shots.mjs <lang> <outDir> [route ...]      (needs `npm run build` first)
+ *   example: node scripts/language-shots.mjs fr C:/Users/me/Desktop/fr-screens models settings setup
+ *
+ * Env: CHROME (path to Chrome/Edge), WIDTH (default 1280), HEIGHT (default 800).
+ */
+import { spawn } from 'node:child_process';
+import { chromium } from 'playwright-core';
+import { existsSync, mkdirSync, mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+
+const root = resolve(import.meta.dirname, '..');
+const [, , language = 'fr', outDir = 'language-shots', ...routes] = process.argv;
+const screens = routes.length ? routes : ['models', 'settings', 'setup'];
+if (!existsSync(join(root, 'dist/index.html'))) { console.error('Run npm run build first.'); process.exit(1); }
+const chrome = process.env.CHROME ?? ['C:/Program Files/Google/Chrome/Application/chrome.exe', 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe', '/usr/bin/google-chrome', '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome'].find(existsSync);
+if (!chrome) { console.error('No Chrome or Edge found; set CHROME.'); process.exit(1); }
+
+const home = mkdtempSync(join(tmpdir(), 'strata-language-shots-'));
+const hostPort = 8830 + Math.floor(Math.random() * 40), webPort = hostPort + 100;
+const scratch = { STRATA_HOME: home, STRATA_MODELS_DIR: join(home, 'models'), STRATA_WORKSPACE: home, STRATA_REAL_ENGINE: '0', STRATA_NATIVE_REPO: join(home, 'no-native-installation'),
+  STRATA_SETTINGS_FILE: join(home, 'app-settings.json'), STRATA_COMPONENTS_DIR: join(home, 'components'), LOCALAPPDATA: join(home, 'Local'), APPDATA: join(home, 'Roaming'),
+  XDG_DATA_HOME: join(home, 'xdg-data'), XDG_STATE_HOME: join(home, 'xdg-state'), XDG_CONFIG_HOME: join(home, 'xdg-config'), STRATA_PORT: String(hostPort) };
+const children = [];
+const run = (args, extra = {}) => { const child = spawn(process.execPath, args, { cwd: root, env: { ...process.env, ...scratch, ...extra }, stdio: 'ignore' }); children.push(child); return child; };
+const stop = () => { for (const child of children) { try { child.kill(); } catch {} } try { rmSync(home, { recursive: true, force: true }); } catch {} };
+process.on('exit', stop);
+
+run(['server/index.mjs']);
+for (let attempt = 0; ; attempt++) {
+  try { if ((await fetch(`http://127.0.0.1:${hostPort}/api/health`)).ok) break; } catch {}
+  if (attempt > 200) { console.error('The preview host did not start.'); process.exit(1); }
+  await new Promise(done => setTimeout(done, 150));
+}
+run(['tests/fixtures/onboarding-ui-host.mjs'], { STRATA_UI_PREVIEW: '1', STRATA_ONBOARDING_UPSTREAM: `http://127.0.0.1:${hostPort}`, STRATA_ONBOARDING_PORT: String(webPort), STRATA_ONBOARDING_START: 'ready', STRATA_ONBOARDING_SCENARIO: 'telemetry', STRATA_ONBOARDING_PREVIEW: '1' });
+for (let attempt = 0; ; attempt++) {
+  try { if ((await fetch(`http://127.0.0.1:${webPort}/`)).ok) break; } catch {}
+  if (attempt > 200) { console.error('The preview page did not start.'); process.exit(1); }
+  await new Promise(done => setTimeout(done, 150));
+}
+
+mkdirSync(resolve(outDir), { recursive: true });
+const browser = await chromium.launch({ executablePath: chrome, headless: true, args: ['--no-sandbox', '--disable-gpu', '--force-device-scale-factor=1'] });
+const page = await browser.newPage({ viewport: { width: Number(process.env.WIDTH ?? 1280), height: Number(process.env.HEIGHT ?? 800) }, deviceScaleFactor: 1 });
+await page.addInitScript(code => { try { localStorage.setItem('strata.prefs.v2', JSON.stringify({ language: code, onboardingSeen: true })); } catch {} }, language);
+const problems = [];
+page.on('pageerror', error => problems.push(`pageerror: ${error.message}`));
+for (const screen of screens) {
+  await page.goto(`http://127.0.0.1:${webPort}/#/${screen}`, { waitUntil: 'load' });
+  await page.reload({ waitUntil: 'load' });
+  await page.waitForTimeout(2500);
+  const file = join(resolve(outDir), `${language}-${screen}.png`);
+  await page.screenshot({ path: file });
+  console.log(`${screen}: ${file} (lang=${await page.evaluate(() => document.documentElement.lang)})`);
+}
+await browser.close();
+if (problems.length) console.log(problems.join('\n'));
+stop();
+process.exit(0);

apps/host/scripts/load-pictures-e2e.mjs

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+/**
+ * LOAD-PICS end to end: the Models page of a running host, driven in a real Chrome (DevTools protocol, no packages), pressing "Load model" on a model that is
+ * downloaded, with Read pictures on and the picture files not on the computer.
+ *
+ *   HOST_URL=http://127.0.0.1:18700 CHROME=/usr/bin/google-chrome OUT=/tmp/lp-out node scripts/load-pictures-e2e.mjs
+ *
+ * It looks at the page, presses the button, and writes down once per half second what the page shows (the progress card's words and bar, any dialog, the job's kind
+ * and state), until the job ends or LIMIT_S passes. It writes <OUT>/timeline.json and screenshots; the files on disk are checked by the shell script around it.
+ *
+ * Environment: HOST_URL (required), CHROME (default /usr/bin/google-chrome), OUT (default ./lp-out), LIMIT_S (default 900), CDP_PORT (default 9333),
+ * MODEL (the version's name on the page, default "High quality"), BUTTON (default "Load model").
+ */
+import { spawn } from 'node:child_process';
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+
+const HOST = process.env.HOST_URL;
+if (!HOST) { console.error('HOST_URL is required'); process.exit(2); }
+const CHROME = process.env.CHROME ?? '/usr/bin/google-chrome';
+const OUT = process.env.OUT ?? './lp-out';
+const LIMIT = Number(process.env.LIMIT_S ?? 900) * 1000;
+const PORT = Number(process.env.CDP_PORT ?? 9333);
+const BUTTON = process.env.BUTTON ?? 'Load model';
+mkdirSync(OUT, { recursive: true });
+const sleep = ms => new Promise(r => setTimeout(r, ms));
+const profile = mkdtempSync(join(tmpdir(), 'lp-chrome-'));
+const chrome = spawn(CHROME, ['--headless=new', '--no-sandbox', '--disable-gpu', `--remote-debugging-port=${PORT}`, `--user-data-dir=${profile}`, '--window-size=1400,1100', 'about:blank'], { stdio: 'ignore' });
+const finish = code => { try { chrome.kill('SIGTERM'); } catch { /* gone */ } setTimeout(() => { try { rmSync(profile, { recursive: true, force: true }); } catch { /* best effort */ } process.exit(code); }, 800); };
+process.on('SIGINT', () => finish(130)); process.on('SIGTERM', () => finish(143));
+
+async function target() {
+  for (let i = 0; i < 80; i++) {
+    try { const list = await (await fetch(`http://127.0.0.1:${PORT}/json/list`)).json(); const page = list.find(t => t.type === 'page'); if (page) return page.webSocketDebuggerUrl; } catch { /* not up yet */ }
+    await sleep(250);
+  }
+  throw new Error('Chrome did not start');
+}
+const ws = new WebSocket(await target());
+await new Promise((resolve, reject) => { ws.onopen = resolve; ws.onerror = () => reject(new Error('DevTools socket')); });
+let seq = 0; const waiting = new Map();
+ws.onmessage = event => { const message = JSON.parse(event.data); const w = waiting.get(message.id); if (w) { waiting.delete(message.id); message.error ? w.reject(new Error(message.error.message)) : w.resolve(message.result); } };
+const send = (method, params = {}) => new Promise((resolve, reject) => { const id = ++seq; waiting.set(id, { resolve, reject }); ws.send(JSON.stringify({ id, method, params })); });
+const run = async expression => { const r = await send('Runtime.evaluate', { expression, awaitPromise: true, returnByValue: true }); if (r.exceptionDetails) throw new Error(r.exceptionDetails.text + ' ' + (r.exceptionDetails.exception?.description ?? '')); return r.result.value; };
+const shot = async name => { const r = await send('Page.captureScreenshot', { format: 'png' }); writeFileSync(join(OUT, `${name}.png`), Buffer.from(r.data, 'base64')); };
+
+try {
+  await send('Page.enable');
+  await send('Page.navigate', { url: `${HOST}/#/models` });
+  // the page is up when the Load button is on it and enabled
+  const ready = `(() => { const b = [...document.querySelectorAll('button')].find(b => b.textContent.trim() === ${JSON.stringify(BUTTON)}); return !!b && !b.disabled; })()`;
+  let up = false;
+  for (let i = 0; i < 240 && !up; i++) { up = await run(ready).catch(() => false); if (!up) await sleep(500); }
+  if (!up) { await shot('never-ready'); throw new Error(`The "${BUTTON}" button never came up`); }
+  const before = await run(`(() => { const t = document.body.innerText; const box = document.querySelector('.native-image-reading input[type=checkbox]'); return { readPicturesOn: !!box && box.checked, offersFiles: t.includes('Picture reading needs a few more files'), downloadButton: [...document.querySelectorAll('button')].some(b => b.textContent.trim() === 'Download picture-reading files'), modelFiles: document.querySelector('.native-path')?.textContent ?? null, shownModel: document.querySelector('.native-version')?.innerText?.slice(0, 200) ?? null }; })()`);
+  await shot('1-before');
+  const baseDialogs = await run("document.querySelectorAll('[role=dialog], dialog[open]').length");   // dialogs the page always has (closed ones the app keeps mounted)
+  const clicked = await run(`(() => { const b = [...document.querySelectorAll('button')].find(b => b.textContent.trim() === ${JSON.stringify(BUTTON)}); b.click(); return true; })()`);
+  const started = Date.now();
+  const timeline = []; let last = '', shots = 0, ended = null;
+  while (Date.now() - started < LIMIT) {
+    const seen = await run(`(async () => {
+      const card = document.querySelector('.native-progress');
+      const state = await (await fetch('/api/native')).json();
+      const job = [...(state.jobs ?? [])].reverse()[0] ?? null;
+      return { card: card ? card.innerText.replace(/\\s+/g, ' ').trim() : null, dialogs: document.querySelectorAll('[role=dialog], dialog[open]').length - ${baseDialogs},
+        job: job && { startedAt: job.startedAt, kind: job.kind, state: job.state, summary: job.summary, error: job.error, details: job.details ?? null, bar: job.result?.install?.download ?? null },
+        instance: (state.instances ?? []).map(i => ({ status: i.status, vision: i.vision, note: i.picturesNote ?? null, gpus: i.gpus })),
+        note: [...document.querySelectorAll('.native-spill-note')].map(n => n.innerText.trim()), error: [...document.querySelectorAll('.inline-error, [role=alert]')].map(n => n.innerText.trim()).filter(Boolean) };
+    })()`);
+    const key = JSON.stringify([seen.card, seen.dialogs, seen.job?.kind, seen.job?.state, seen.job?.summary, seen.instance, seen.note, seen.error, Math.floor((seen.job?.bar?.percent ?? 0) / 25)]);
+    if (key !== last) { last = key; timeline.push({ t: +((Date.now() - started) / 1000).toFixed(1), ...seen }); if (seen.card && shots < 2 && seen.job?.state === 'running') await shot(`2-running-${++shots}`); }
+    if (seen.job && Date.parse(seen.job.startedAt) >= started - 2000 && seen.job.state !== 'running') { ended = seen.job.state; break; }
+    await sleep(500);
+  }
+  await sleep(1500);
+  await shot('3-after');
+  const after = await run(`(() => ({ text: [...document.querySelectorAll('.native-spill-note, .native-ready, .toast, [role=status]')].map(n => n.innerText.trim()).filter(Boolean), buttons: [...document.querySelectorAll('.native-model-actions button')].map(b => b.textContent.trim()), pictureOffer: document.body.innerText.includes('Picture reading needs a few more files') }))()`);
+  const posted = await run("fetch('/__fixture/posted').then(r => r.ok ? r.json() : null).catch(() => null)");   // only the UI-preview fixture keeps what the page posted
+  writeFileSync(join(OUT, 'timeline.json'), JSON.stringify({ clicked, posted, before, ended, seconds: +((Date.now() - started) / 1000).toFixed(1), timeline, after }, null, 1));
+  console.log(JSON.stringify({ ended, seconds: +((Date.now() - started) / 1000).toFixed(1), steps: timeline.length, before, after }));
+  finish(ended === 'done' ? 0 : 1);
+} catch (error) {
+  console.error(error.message);
+  writeFileSync(join(OUT, 'error.txt'), String(error.stack ?? error));
+  finish(2);
+}

apps/host/scripts/luminance.mjs

@@ -25,6 +25,7 @@ import { chromium } from 'playwright-core';
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
+import { requireChromium } from './browser.mjs';
 
 const BASE = process.env.STRATA_URL ?? 'http://localhost:5199';
 /** Anything at or above this projected area is "large". Roughly a 64×64 block. */
@@ -43,10 +44,7 @@ const MIN_THICKNESS = 32;
 /** Ceiling for the relative luminance of a large surface, in dark mode. */
 const CEILING = 0.15;
 
-const executablePath = [
-  join(homedir(), 'Library/Caches/ms-playwright/chromium-1234/chrome-mac-arm64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing'),
-  join(homedir(), 'Library/Caches/ms-playwright/chromium_headless_shell-1234/chrome-headless-shell-mac-arm64/chrome-headless-shell'),
-].find((p) => existsSync(p));
+const executablePath = requireChromium();
 
 if (!executablePath) {
   console.error('No cached Chromium found.');

apps/host/scripts/make-df2-locales.py

@@ -0,0 +1,197 @@
+"""Writes src/locales/df2-<lang>.json: the strings of the Drafting choice that came with the DFlash2 option (branch f-0291-df2-option): the plain-words
+paragraph under the dropdown, the three lines about the person's graphics card, the "not on this card" and "no internet" lines, and the SSD line of the
+This computer panel.
+Run from apps/host:  python scripts/make-df2-locales.py
+Every entry names all nine languages; the keys are df01.. in the order of S. df2-en.json is the English source. Placeholders ({0}) must be kept in every
+language. A separate file keeps this work from colliding with the other catalogs (the same reason pick-, tune-, tools-, fix-, gh-, ui- and engine- exist).
+The English lines of df03-df07 and df09 are also written in strata_control/drafting.py and strata_control/drafting_fetch.py; tests/drafting.test.mjs keeps the two the same."""
+import json
+import re
+from pathlib import Path
+
+LANGS = ["en", "zh", "ja", "de", "es", "ru", "pt", "ko", "fr"]
+S = []
+
+
+def add(en, zh, ja, de, es, ru, pt, ko, fr):
+    S.append(dict(en=en, zh=zh, ja=ja, de=de, es=es, ru=ru, pt=pt, ko=ko, fr=fr))
+
+
+add("MTP is the default. DFlash2 is another way to guess the next words ahead, for Qwen3.8-Flash-Next only. On an RTX PRO 5000 it was 7.8% faster than MTP "
+    "on 19 short prompts and 1.1% faster on long thinking, and faster on 21 of 23 prompts. On the short prompts the answers were identical.",
+    "默认使用 MTP。DFlash2 是另一种提前猜测后续词语的方式，仅适用于 Qwen3.8-Flash-Next。在 RTX PRO 5000 上，它在 19 个短提示上比 MTP 快 7.8%，在长篇思考上快 1.1%，"
+    "并且在 23 个提示中有 21 个更快。在短提示上，回答完全相同。",
+    "既定では MTP を使います。DFlash2 は次の語を先読みするもう一つの方法で、Qwen3.8-Flash-Next 専用です。RTX PRO 5000 では、短いプロンプト 19 件で MTP より 7.8% 速く、"
+    "長い思考では 1.1% 速く、23 件中 21 件で速くなりました。短いプロンプトでは回答が同一でした。",
+    "MTP ist die Voreinstellung. DFlash2 ist eine andere Art, die nächsten Wörter vorauszuraten, nur für Qwen3.8-Flash-Next. Auf einer RTX PRO 5000 war es bei 19 kurzen "
+    "Prompts 7,8 % schneller als MTP, bei langem Nachdenken 1,1 % schneller und bei 21 von 23 Prompts schneller. Bei den kurzen Prompts waren die Antworten identisch.",
+    "MTP es la opción predeterminada. DFlash2 es otra forma de adivinar las siguientes palabras por adelantado, solo para Qwen3.8-Flash-Next. En una RTX PRO 5000 fue un 7,8 % "
+    "más rápido que MTP en 19 prompts cortos y un 1,1 % más rápido en razonamientos largos, y más rápido en 21 de 23 prompts. En los prompts cortos las respuestas fueron idénticas.",
+    "По умолчанию используется MTP. DFlash2 — другой способ угадывать следующие слова наперёд, только для Qwen3.8-Flash-Next. На RTX PRO 5000 он был на 7,8 % быстрее MTP "
+    "на 19 коротких запросах и на 1,1 % быстрее на длинных рассуждениях, а на 21 из 23 запросов — быстрее. На коротких запросах ответы были идентичны.",
+    "MTP é o padrão. DFlash2 é outra forma de adivinhar as próximas palavras antecipadamente, só para o Qwen3.8-Flash-Next. Numa RTX PRO 5000 foi 7,8 % mais rápido que o MTP "
+    "em 19 prompts curtos e 1,1 % mais rápido em raciocínios longos, e mais rápido em 21 de 23 prompts. Nos prompts curtos as respostas foram idênticas.",
+    "기본값은 MTP입니다. DFlash2는 다음 단어를 미리 추측하는 또 다른 방식이며 Qwen3.8-Flash-Next 전용입니다. RTX PRO 5000에서 짧은 프롬프트 19개에서는 MTP보다 7.8% 빨랐고, "
+    "긴 사고 과정에서는 1.1% 빨랐으며, 23개 중 21개 프롬프트에서 더 빨랐습니다. 짧은 프롬프트에서는 답변이 동일했습니다.",
+    "MTP est le réglage par défaut. DFlash2 est une autre façon de deviner à l'avance les mots suivants, uniquement pour Qwen3.8-Flash-Next. Sur une RTX PRO 5000, il a été 7,8 % "
+    "plus rapide que MTP sur 19 prompts courts et 1,1 % plus rapide en réflexion longue, et plus rapide sur 21 prompts sur 23. Sur les prompts courts, les réponses étaient identiques.")
+add("It downloads about 1.2 GB once, works with one graphics card and one request at a time, and uses MTP otherwise.",
+    "它会一次性下载约 1.2 GB，仅在使用一张显卡且一次处理一个请求时有效，其他情况下使用 MTP。",
+    "約 1.2 GB を一度だけダウンロードします。グラフィックスカード 1 枚で一度に 1 件のリクエストを処理するときに動作し、それ以外では MTP を使います。",
+    "Es lädt einmalig etwa 1,2 GB herunter, funktioniert mit einer Grafikkarte und einer Anfrage zur Zeit und nutzt sonst MTP.",
+    "Descarga unos 1,2 GB una sola vez, funciona con una tarjeta gráfica y una solicitud a la vez, y en los demás casos usa MTP.",
+    "Один раз скачивает около 1,2 ГБ, работает с одной видеокартой и одним запросом за раз, в остальных случаях используется MTP.",
+    "Baixa cerca de 1,2 GB uma única vez, funciona com uma placa de vídeo e um pedido de cada vez, e nos outros casos usa o MTP.",
+    "약 1.2 GB를 한 번만 내려받으며, 그래픽 카드 한 장과 한 번에 하나의 요청에서 작동하고, 그 외에는 MTP를 사용합니다.",
+    "Il télécharge environ 1,2 Go une seule fois, fonctionne avec une carte graphique et une requête à la fois, et utilise MTP sinon.")
+add("On graphics cards like yours, DFlash2 was faster than MTP on some kinds of text and slower on others in our tests.",
+    "在与您类似的显卡上，我们的测试中 DFlash2 在某些类型的文本上比 MTP 快，在另一些上更慢。",
+    "お使いのようなグラフィックスカードでは、私たちのテストで DFlash2 は MTP より速い種類の文章と遅い種類の文章がありました。",
+    "Auf Grafikkarten wie Ihrer war DFlash2 in unseren Tests bei manchen Textarten schneller als MTP und bei anderen langsamer.",
+    "En tarjetas gráficas como la suya, en nuestras pruebas DFlash2 fue más rápido que MTP con algunos tipos de texto y más lento con otros.",
+    "На видеокартах, подобных вашей, в наших тестах DFlash2 был быстрее MTP на одних видах текста и медленнее на других.",
+    "Em placas de vídeo como a sua, nos nossos testes o DFlash2 foi mais rápido que o MTP em alguns tipos de texto e mais lento em outros.",
+    "고객님과 비슷한 그래픽 카드에서 저희 테스트 결과 DFlash2는 일부 유형의 글에서는 MTP보다 빨랐고 다른 유형에서는 더 느렸습니다.",
+    "Sur des cartes graphiques comme la vôtre, DFlash2 a été plus rapide que MTP sur certains types de texte et plus lent sur d'autres lors de nos tests.")
+add("On graphics cards like yours, DFlash2 was slower than MTP in our tests.",
+    "在与您类似的显卡上，我们的测试中 DFlash2 比 MTP 更慢。",
+    "お使いのようなグラフィックスカードでは、私たちのテストで DFlash2 は MTP より遅くなりました。",
+    "Auf Grafikkarten wie Ihrer war DFlash2 in unseren Tests langsamer als MTP.",
+    "En tarjetas gráficas como la suya, en nuestras pruebas DFlash2 fue más lento que MTP.",
+    "На видеокартах, подобных вашей, в наших тестах DFlash2 был медленнее MTP.",
+    "Em placas de vídeo como a sua, nos nossos testes o DFlash2 foi mais lento que o MTP.",
+    "고객님과 비슷한 그래픽 카드에서 저희 테스트 결과 DFlash2는 MTP보다 느렸습니다.",
+    "Sur des cartes graphiques comme la vôtre, DFlash2 a été plus lent que MTP lors de nos tests.")
+add("DFlash2 has not been tested on your graphics card yet.",
+    "DFlash2 尚未在您的显卡上测试过。",
+    "DFlash2 はまだお使いのグラフィックスカードでテストされていません。",
+    "DFlash2 wurde auf Ihrer Grafikkarte noch nicht getestet.",
+    "DFlash2 todavía no se ha probado en su tarjeta gráfica.",
+    "DFlash2 ещё не проверялся на вашей видеокарте.",
+    "O DFlash2 ainda não foi testado na sua placa de vídeo.",
+    "DFlash2는 아직 고객님의 그래픽 카드에서 테스트되지 않았습니다.",
+    "DFlash2 n'a pas encore été testé sur votre carte graphique.")
+add("Drafting: MTP (DFlash2 isn't available on this graphics card)",
+    "预测方式：MTP（DFlash2 不适用于这张显卡）",
+    "先読み：MTP（DFlash2 はこのグラフィックスカードでは使えません）",
+    "Vorausraten: MTP (DFlash2 ist auf dieser Grafikkarte nicht verfügbar)",
+    "Predicción: MTP (DFlash2 no está disponible en esta tarjeta gráfica)",
+    "Упреждающая генерация: MTP (DFlash2 недоступен на этой видеокарте)",
+    "Previsão: MTP (o DFlash2 não está disponível nesta placa de vídeo)",
+    "미리 추측: MTP (이 그래픽 카드에서는 DFlash2를 사용할 수 없습니다)",
+    "Anticipation : MTP (DFlash2 n'est pas disponible sur cette carte graphique)")
+add("There is no internet connection, so the DFlash2 drafter can't be downloaded now.",
+    "没有网络连接，因此现在无法下载 DFlash2 草稿模型。",
+    "インターネットに接続されていないため、今は DFlash2 のドラフターをダウンロードできません。",
+    "Es besteht keine Internetverbindung, deshalb kann der DFlash2-Drafter jetzt nicht heruntergeladen werden.",
+    "No hay conexión a internet, así que ahora no se puede descargar el borrador de DFlash2.",
+    "Нет подключения к интернету, поэтому сейчас нельзя скачать черновую модель DFlash2.",
+    "Não há ligação à internet, por isso não é possível transferir agora o rascunhador do DFlash2.",
+    "인터넷에 연결되어 있지 않아 지금은 DFlash2 드래프터를 내려받을 수 없습니다.",
+    "Il n'y a pas de connexion internet, le drafter DFlash2 ne peut donc pas être téléchargé pour le moment.")
+add("SSD: not needed",
+    "SSD：不需要", "SSD：不要", "SSD: nicht nötig", "SSD: no hace falta", "SSD: не нужен", "SSD: não é necessário", "SSD: 필요 없음", "SSD : pas nécessaire")
+
+add("DFlash2 answers one request at a time, so Strata set this model to one request at a time.",
+    "DFlash2 一次只处理一个请求，因此 Strata 将此模型设置为一次一个请求。",
+    "DFlash2 は一度に 1 件のリクエストしか処理しないため、Strata はこのモデルを一度に 1 件に設定しました。",
+    "DFlash2 beantwortet eine Anfrage nach der anderen, deshalb hat Strata dieses Modell auf eine Anfrage zur Zeit gestellt.",
+    "DFlash2 responde una solicitud a la vez, así que Strata configuró este modelo para una solicitud a la vez.",
+    "DFlash2 отвечает на один запрос за раз, поэтому Strata настроила эту модель на один запрос за раз.",
+    "O DFlash2 responde a um pedido de cada vez, por isso o Strata configurou este modelo para um pedido de cada vez.",
+    "DFlash2는 한 번에 하나의 요청만 처리하므로 Strata가 이 모델을 한 번에 하나의 요청으로 설정했습니다.",
+    "DFlash2 répond à une requête à la fois, Strata a donc réglé ce modèle sur une requête à la fois.")
+
+add("Drafting: off (no drafter is downloaded yet)",
+    "预测草稿：关闭（尚未下载任何草稿模型）",
+    "先読み：オフ（ドラフトモデルがまだダウンロードされていません）",
+    "Vorausraten: aus (noch kein Entwurfsbaustein heruntergeladen)",
+    "Predicción: desactivada (aún no hay ningún predictor descargado)",
+    "Предсказание: выключено (черновая модель ещё не скачана)",
+    "Previsão: desativada (nenhum preditor foi baixado ainda)",
+    "초안 예측: 꺼짐(초안 모델이 아직 내려받아지지 않았습니다)",
+    "Anticipation : désactivée (aucun module d'anticipation n'est encore téléchargé)")
+add("Drafting: DFlash2 (the MTP drafter isn't downloaded yet)",
+    "预测草稿：DFlash2（MTP 草稿模型尚未下载）",
+    "先読み：DFlash2（MTP のドラフトモデルはまだダウンロードされていません）",
+    "Vorausraten: DFlash2 (der MTP-Entwurfsbaustein ist noch nicht heruntergeladen)",
+    "Predicción: DFlash2 (el predictor de MTP aún no está descargado)",
+    "Предсказание: DFlash2 (черновая модель MTP ещё не скачана)",
+    "Previsão: DFlash2 (o preditor do MTP ainda não foi baixado)",
+    "초안 예측: DFlash2(MTP 초안 모델이 아직 내려받아지지 않았습니다)",
+    "Anticipation : DFlash2 (le module d'anticipation MTP n'est pas encore téléchargé)")
+add("Choosing DFlash2 downloads its drafter: about {0} GB, once.",
+    "选择 DFlash2 会下载它的草稿模型：约 {0} GB，只下载一次。",
+    "DFlash2 を選ぶと、そのドラフトモデルを一度だけダウンロードします（約 {0} GB）。",
+    "Wenn Sie DFlash2 wählen, wird sein Entwurfsbaustein heruntergeladen: etwa {0} GB, einmalig.",
+    "Elegir DFlash2 descarga su predictor: unos {0} GB, una sola vez.",
+    "Если выбрать DFlash2, будет скачана его черновая модель: около {0} ГБ, один раз.",
+    "Escolher o DFlash2 baixa o preditor dele: cerca de {0} GB, uma vez.",
+    "DFlash2를 고르면 그 초안 모델을 한 번 내려받습니다(약 {0}GB).",
+    "Choisir DFlash2 télécharge son module d'anticipation : environ {0} Go, une seule fois.")
+add("Choosing MTP downloads its drafter: about {0} GB, once.",
+    "选择 MTP 会下载它的草稿模型：约 {0} GB，只下载一次。",
+    "MTP を選ぶと、そのドラフトモデルを一度だけダウンロードします（約 {0} GB）。",
+    "Wenn Sie MTP wählen, wird sein Entwurfsbaustein heruntergeladen: etwa {0} GB, einmalig.",
+    "Elegir MTP descarga su predictor: unos {0} GB, una sola vez.",
+    "Если выбрать MTP, будет скачана его черновая модель: около {0} ГБ, один раз.",
+    "Escolher o MTP baixa o preditor dele: cerca de {0} GB, uma vez.",
+    "MTP를 고르면 그 초안 모델을 한 번 내려받습니다(약 {0}GB).",
+    "Choisir MTP télécharge son module d'anticipation : environ {0} Go, une seule fois.")
+add("The DFlash2 drafter could not be downloaded, so the model starts without a drafter. Loading the model…",
+    "无法下载 DFlash2 草稿模型，因此模型将不使用草稿模型启动。正在加载模型…",
+    "DFlash2 のドラフトモデルをダウンロードできなかったため、ドラフトモデルなしで起動します。モデルを読み込んでいます…",
+    "Der DFlash2-Entwurfsbaustein konnte nicht heruntergeladen werden, deshalb startet das Modell ohne Entwurfsbaustein. Das Modell wird geladen …",
+    "No se pudo descargar el predictor de DFlash2, así que el modelo arranca sin predictor. Cargando el modelo…",
+    "Не удалось скачать черновую модель DFlash2, поэтому модель запускается без черновой модели. Загружается модель…",
+    "Não foi possível baixar o preditor do DFlash2, então o modelo inicia sem preditor. Carregando o modelo…",
+    "DFlash2 초안 모델을 내려받지 못해 초안 모델 없이 시작합니다. 모델을 불러오는 중…",
+    "Le module d'anticipation DFlash2 n'a pas pu être téléchargé, le modèle démarre donc sans module d'anticipation. Chargement du modèle…")
+add("Downloading the MTP drafter…",
+    "正在下载 MTP 草稿模型…",
+    "MTP のドラフトモデルをダウンロードしています…",
+    "MTP-Entwurfsbaustein wird heruntergeladen …",
+    "Descargando el predictor de MTP…",
+    "Скачивается черновая модель MTP…",
+    "Baixando o preditor do MTP…",
+    "MTP 초안 모델을 내려받는 중…",
+    "Téléchargement du module d'anticipation MTP…")
+
+add("The MTP drafter could not be downloaded.",
+    "无法下载 MTP 草稿模型。",
+    "MTP のドラフトモデルをダウンロードできませんでした。",
+    "Der MTP-Entwurfsbaustein konnte nicht heruntergeladen werden.",
+    "No se pudo descargar el predictor de MTP.",
+    "Не удалось скачать черновую модель MTP.",
+    "Não foi possível baixar o preditor do MTP.",
+    "MTP 초안 모델을 내려받지 못했습니다.",
+    "Le module d'anticipation MTP n'a pas pu être téléchargé.")
+add("Drafting: MTP (DFlash2 didn't start)",
+    "预测草稿：MTP（DFlash2 未能启动）",
+    "先読み：MTP（DFlash2 は起動しませんでした）",
+    "Vorausraten: MTP (DFlash2 ist nicht gestartet)",
+    "Predicción: MTP (DFlash2 no arrancó)",
+    "Предсказание: MTP (DFlash2 не запустился)",
+    "Previsão: MTP (o DFlash2 não iniciou)",
+    "초안 예측: MTP(DFlash2가 시작되지 않았습니다)",
+    "Anticipation : MTP (DFlash2 n'a pas démarré)")
+here = Path(__file__).resolve().parent.parent / "src" / "locales"
+NBSP = " "
+
+
+def french(text):
+    text = re.sub(r"(?<=[A-Za-zÀ-ſ])'(?=[A-Za-zÀ-ſ{])", "’", text)
+    text = re.sub(r"(?<=\S) ([:;?!])", NBSP + r"\1", text)
+    text = re.sub(r"(?<=[\d}]) %", NBSP + "%", text)
+    return text
+
+
+for lang in LANGS:
+    data = {}
+    for i, entry in enumerate(S):
+        text = entry[lang]
+        assert sorted(re.findall(r"\{\d+\}", entry["en"])) == sorted(re.findall(r"\{\d+\}", text)), (lang, entry["en"], text)
+        data[f"df{i + 1:02d}"] = french(text) if lang == "fr" else text
+    with (here / f"df2-{lang}.json").open("w", encoding="utf-8", newline="\n") as handle:
+        handle.write(json.dumps(data, ensure_ascii=False, indent=1) + "\n")
+print("written", len(S), "strings in", len(LANGS), "languages")

apps/host/scripts/make-engine-locales.py

@@ -0,0 +1,226 @@
+"""Writes src/locales/engine-<lang>.json: the strings of Settings > Engine (the list of installed engines: switch, delete) and the words that now point to
+About for updating (branch f-0291-engine-tab).  Run from apps/host:  python scripts/make-engine-locales.py
+Every entry names all nine languages; the keys are et01.. in the order of S. engine-en.json is the English source. Placeholders ({0}, {1}) must be kept in
+every language. A separate file keeps this work from colliding with the other catalogs (the same reason tune-, tools-, fix-, gh- and ui- exist)."""
+import json
+import re
+from pathlib import Path
+
+LANGS = ["en", "zh", "ja", "de", "es", "ru", "pt", "ko", "fr"]
+S = []
+
+
+def add(en, zh, ja, de, es, ru, pt, ko, fr):
+    S.append(dict(en=en, zh=zh, ja=ja, de=de, es=es, ru=ru, pt=pt, ko=ko, fr=fr))
+
+
+# ---- the page
+add("Installed engines",
+    "已安装的引擎", "インストール済みのエンジン", "Installierte Engines", "Motores instalados", "Установленные движки", "Motores instalados", "설치된 엔진", "Moteurs installés")
+add("Switch to an older engine to test something, then switch back to the newest. Updating to the latest is in About.",
+    "切换到较旧的引擎来测试某些内容，然后再切换回最新的。更新到最新版本请前往“关于”。",
+    "古いエンジンに切り替えて試し、終わったら最新のエンジンに戻せます。最新版への更新は「情報」で行います。",
+    "Wechsle zu einer älteren Engine, um etwas zu testen, und danach zurück zur neuesten. Das Update auf die neueste Version findest du unter „Über“.",
+    "Cambia a un motor anterior para probar algo y vuelve después al más reciente. La actualización a la última versión está en «Acerca de».",
+    "Переключитесь на более старый движок, чтобы что-то проверить, а потом вернитесь на самый новый. Обновление до последней версии — в разделе «О программе».",
+    "Troque para um motor mais antigo para testar algo e depois volte ao mais recente. A atualização para a versão mais recente fica em «Sobre».",
+    "이전 엔진으로 바꿔 테스트한 뒤 다시 최신 엔진으로 돌아올 수 있습니다. 최신 버전으로의 업데이트는 '정보'에서 합니다.",
+    "Passez à un moteur plus ancien pour tester quelque chose, puis revenez au plus récent. La mise à jour vers la dernière version se trouve dans « À propos ».")
+add("Engines can be switched and deleted in the installed Strata app.",
+    "可以在已安装的 Strata 应用中切换和删除引擎。", "エンジンの切り替えと削除は、インストール済みの Strata アプリで行えます。",
+    "Engines lassen sich in der installierten Strata-App wechseln und löschen.", "Los motores se pueden cambiar y eliminar en la aplicación Strata instalada.",
+    "Переключать и удалять движки можно в установленном приложении Strata.", "Os motores podem ser trocados e excluídos no aplicativo Strata instalado.",
+    "엔진 전환과 삭제는 설치된 Strata 앱에서 할 수 있습니다.", "Les moteurs peuvent être changés et supprimés dans l'application Strata installée.")
+add("The installed engines couldn't be read. Try again in a moment.",
+    "无法读取已安装的引擎。请稍后重试。", "インストール済みのエンジンを読み取れませんでした。しばらくしてからもう一度お試しください。",
+    "Die installierten Engines konnten nicht gelesen werden. Versuche es gleich noch einmal.", "No se pudieron leer los motores instalados. Inténtalo de nuevo en un momento.",
+    "Не удалось прочитать список установленных движков. Попробуйте ещё раз через минуту.", "Não foi possível ler os motores instalados. Tente novamente em instantes.",
+    "설치된 엔진을 읽지 못했습니다. 잠시 후 다시 시도하세요.", "Les moteurs installés n'ont pas pu être lus. Réessayez dans un instant.")
+add("No engine is installed on this computer yet. Update in About downloads the right one.",
+    "此电脑上还没有安装引擎。在“关于”中点击更新即可下载合适的引擎。", "このコンピューターにはまだエンジンがありません。「情報」で更新すると、合ったものがダウンロードされます。",
+    "Auf diesem Computer ist noch keine Engine installiert. Das Update unter „Über“ lädt die passende herunter.",
+    "Todavía no hay ningún motor instalado en este equipo. Actualizar en «Acerca de» descarga el adecuado.",
+    "На этом компьютере ещё не установлен движок. Обновление в разделе «О программе» скачает подходящий.",
+    "Ainda não há nenhum motor instalado neste computador. Atualizar em «Sobre» baixa o adequado.",
+    "이 컴퓨터에는 아직 설치된 엔진이 없습니다. '정보'에서 업데이트하면 알맞은 엔진을 내려받습니다.",
+    "Aucun moteur n'est encore installé sur cet ordinateur. La mise à jour dans « À propos » télécharge le bon.")
+add("Engines take {0} on this computer.",
+    "引擎在此电脑上共占用 {0}。", "エンジンはこのコンピューターで {0} を使っています。", "Die Engines belegen auf diesem Computer {0}.", "Los motores ocupan {0} en este equipo.",
+    "Движки занимают на этом компьютере {0}.", "Os motores ocupam {0} neste computador.", "엔진이 이 컴퓨터에서 {0}을(를) 차지합니다.", "Les moteurs occupent {0} sur cet ordinateur.")
+add("Newest", "最新", "最新", "Neueste", "Más reciente", "Новейший", "Mais recente", "최신", "Le plus récent")
+add("Use this", "使用此引擎", "これを使う", "Diese verwenden", "Usar este", "Использовать", "Usar este", "이 엔진 사용", "Utiliser celui-ci")
+add("Qwen and other models",
+    "Qwen 及其他模型", "Qwen とその他のモデル", "Qwen und andere Modelle", "Qwen y otros modelos", "Qwen и другие модели", "Qwen e outros modelos", "Qwen 및 기타 모델", "Qwen et autres modèles")
+add("A running program is using this engine. Unload your models first.",
+    "有程序正在使用此引擎。请先卸载你的模型。", "実行中のプログラムがこのエンジンを使っています。先にモデルをアンロードしてください。",
+    "Ein laufendes Programm benutzt diese Engine. Entlade zuerst deine Modelle.", "Un programa en ejecución está usando este motor. Descarga primero tus modelos.",
+    "Этот движок используется работающей программой. Сначала выгрузите свои модели.", "Um programa em execução está usando este motor. Descarregue seus modelos primeiro.",
+    "실행 중인 프로그램이 이 엔진을 사용하고 있습니다. 먼저 모델을 언로드하세요.", "Un programme en cours utilise ce moteur. Déchargez d'abord vos modèles.")
+add("Engine {0} is now in use.",
+    "现在使用引擎 {0}。", "エンジン {0} を使用中です。", "Engine {0} wird jetzt verwendet.", "Ahora se usa el motor {0}.", "Теперь используется движок {0}.", "O motor {0} está em uso agora.",
+    "이제 엔진 {0}을(를) 사용합니다.", "Le moteur {0} est maintenant utilisé.")
+add("Engine {0} was deleted.",
+    "引擎 {0} 已删除。", "エンジン {0} を削除しました。", "Engine {0} wurde gelöscht.", "Se eliminó el motor {0}.", "Движок {0} удалён.", "O motor {0} foi excluído.",
+    "엔진 {0}을(를) 삭제했습니다.", "Le moteur {0} a été supprimé.")
+add("Use engine {0}?",
+    "使用引擎 {0}？", "エンジン {0} を使いますか？", "Engine {0} verwenden?", "¿Usar el motor {0}?", "Использовать движок {0}?", "Usar o motor {0}?", "엔진 {0}을(를) 사용할까요?", "Utiliser le moteur {0} ?")
+add("Use engine {0}",
+    "使用引擎 {0}", "エンジン {0} を使う", "Engine {0} verwenden", "Usar el motor {0}", "Использовать движок {0}", "Usar o motor {0}", "엔진 {0} 사용", "Utiliser le moteur {0}")
+add("Models you start from now on run on engine {0}. Your models and settings stay as they are. You can switch back at any time.",
+    "从现在起启动的模型将使用引擎 {0}。你的模型和设置保持不变。你可以随时切换回来。",
+    "これから起動するモデルはエンジン {0} で動きます。モデルと設定はそのままです。いつでも元に戻せます。",
+    "Modelle, die du ab jetzt startest, laufen mit Engine {0}. Deine Modelle und Einstellungen bleiben unverändert. Du kannst jederzeit zurückwechseln.",
+    "Los modelos que inicies a partir de ahora usarán el motor {0}. Tus modelos y ajustes no cambian. Puedes volver cuando quieras.",
+    "Модели, которые вы запустите с этого момента, будут работать на движке {0}. Ваши модели и настройки останутся как есть. Вернуться можно в любой момент.",
+    "Os modelos que você iniciar a partir de agora usarão o motor {0}. Seus modelos e ajustes continuam como estão. Você pode voltar quando quiser.",
+    "지금부터 시작하는 모델은 엔진 {0}에서 실행됩니다. 모델과 설정은 그대로 유지됩니다. 언제든 다시 바꿀 수 있습니다.",
+    "Les modèles que vous démarrez à partir de maintenant utilisent le moteur {0}. Vos modèles et réglages restent inchangés. Vous pouvez revenir en arrière à tout moment.")
+add("These models need a newer engine and may not start on it: {0}.",
+    "这些模型需要更新的引擎，在此引擎上可能无法启动：{0}。", "次のモデルはより新しいエンジンが必要で、このエンジンでは起動しない可能性があります：{0}。",
+    "Diese Modelle brauchen eine neuere Engine und starten damit eventuell nicht: {0}.", "Estos modelos necesitan un motor más reciente y puede que no arranquen con este: {0}.",
+    "Этим моделям нужен более новый движок, и на этом они могут не запуститься: {0}.", "Estes modelos precisam de um motor mais novo e podem não iniciar com este: {0}.",
+    "다음 모델은 더 새로운 엔진이 필요해 이 엔진에서는 시작되지 않을 수 있습니다: {0}.", "Ces modèles demandent un moteur plus récent et pourraient ne pas démarrer avec celui-ci : {0}.")
+add("A model is running. Unload it in Models first, then switch.",
+    "有模型正在运行。请先在“模型”中卸载它，然后再切换。", "モデルが実行中です。先に「モデル」でアンロードしてから切り替えてください。",
+    "Ein Modell läuft. Entlade es zuerst unter „Modelle“ und wechsle dann.", "Hay un modelo en ejecución. Descárgalo primero en «Modelos» y luego cambia.",
+    "Работает модель. Сначала выгрузите её в разделе «Модели», затем переключитесь.", "Há um modelo em execução. Descarregue-o primeiro em «Modelos» e depois troque.",
+    "모델이 실행 중입니다. 먼저 '모델'에서 언로드한 다음 전환하세요.", "Un modèle est en cours d'exécution. Déchargez-le d'abord dans « Modèles », puis changez de moteur.")
+add("Delete engine {0}?",
+    "删除引擎 {0}？", "エンジン {0} を削除しますか？", "Engine {0} löschen?", "¿Eliminar el motor {0}?", "Удалить движок {0}?", "Excluir o motor {0}?", "엔진 {0}을(를) 삭제할까요?", "Supprimer le moteur {0} ?")
+add("Keep engine", "保留引擎", "エンジンを残す", "Engine behalten", "Conservar motor", "Оставить движок", "Manter motor", "엔진 유지", "Garder le moteur")
+add("Delete engine", "删除引擎", "エンジンを削除", "Engine löschen", "Eliminar motor", "Удалить движок", "Excluir motor", "엔진 삭제", "Supprimer le moteur")
+add("This frees {0}. Your models and settings are kept.",
+    "这将释放 {0}。你的模型和设置会保留。", "{0} が空きます。モデルと設定はそのまま残ります。", "Das gibt {0} frei. Deine Modelle und Einstellungen bleiben erhalten.",
+    "Esto libera {0}. Tus modelos y ajustes se conservan.", "Это освободит {0}. Ваши модели и настройки сохранятся.", "Isso libera {0}. Seus modelos e ajustes são mantidos.",
+    "{0}의 공간이 확보됩니다. 모델과 설정은 그대로 유지됩니다.", "Cela libère {0}. Vos modèles et réglages sont conservés.")
+add("The newest engine can be downloaded again with Update in About.",
+    "最新的引擎可以在“关于”中通过更新重新下载。", "最新のエンジンは、「情報」の更新でもう一度ダウンロードできます。",
+    "Die neueste Engine lässt sich über das Update unter „Über“ erneut herunterladen.", "El motor más reciente se puede volver a descargar con Actualizar en «Acerca de».",
+    "Новейший движок можно скачать снова через обновление в разделе «О программе».", "O motor mais recente pode ser baixado de novo com Atualizar em «Sobre».",
+    "최신 엔진은 '정보'의 업데이트로 다시 내려받을 수 있습니다.", "Le moteur le plus récent peut être retéléchargé avec la mise à jour dans « À propos ».")
+add("Strata can only download the newest engine, so a deleted older engine can't be brought back.",
+    "Strata 只能下载最新的引擎，所以删除后无法找回较旧的引擎。", "Strata がダウンロードできるのは最新のエンジンだけなので、削除した古いエンジンは元に戻せません。",
+    "Strata kann nur die neueste Engine herunterladen. Eine gelöschte ältere Engine lässt sich deshalb nicht wiederherstellen.",
+    "Strata solo puede descargar el motor más reciente, así que un motor anterior eliminado no se puede recuperar.",
+    "Strata может скачать только новейший движок, поэтому удалённый старый движок вернуть нельзя.",
+    "O Strata só pode baixar o motor mais recente, então um motor antigo excluído não pode ser recuperado.",
+    "Strata는 최신 엔진만 내려받을 수 있으므로, 삭제한 이전 엔진은 되돌릴 수 없습니다.",
+    "Strata ne peut télécharger que le moteur le plus récent : un ancien moteur supprimé ne peut donc pas être récupéré.")
+
+# ---- why an engine cannot be used on this computer
+add("This engine was made for a different operating system.",
+    "此引擎是为其他操作系统制作的。", "このエンジンは別のオペレーティングシステム向けです。", "Diese Engine wurde für ein anderes Betriebssystem gebaut.",
+    "Este motor se creó para otro sistema operativo.", "Этот движок создан для другой операционной системы.", "Este motor foi feito para outro sistema operacional.",
+    "이 엔진은 다른 운영체제용입니다.", "Ce moteur a été conçu pour un autre système d'exploitation.")
+add("This engine was made for a different kind of graphics card than this computer has.",
+    "此引擎是为与这台电脑不同类型的显卡制作的。", "このエンジンは、このコンピューターとは別の種類のグラフィックスカード向けです。",
+    "Diese Engine wurde für eine andere Art von Grafikkarte gebaut als die in diesem Computer.", "Este motor se creó para un tipo de tarjeta gráfica distinto del de este equipo.",
+    "Этот движок создан для другого типа видеокарты, чем в этом компьютере.", "Este motor foi feito para um tipo de placa de vídeo diferente da deste computador.",
+    "이 엔진은 이 컴퓨터와 다른 종류의 그래픽 카드용입니다.", "Ce moteur a été conçu pour un autre type de carte graphique que celle de cet ordinateur.")
+add("This engine needs Strata {0} or newer.",
+    "此引擎需要 Strata {0} 或更新版本。", "このエンジンには Strata {0} 以降が必要です。", "Diese Engine braucht Strata {0} oder neuer.", "Este motor necesita Strata {0} o posterior.",
+    "Для этого движка нужна Strata {0} или новее.", "Este motor precisa do Strata {0} ou mais recente.", "이 엔진에는 Strata {0} 이상이 필요합니다.", "Ce moteur nécessite Strata {0} ou plus récent.")
+add("This engine doesn't support this computer's graphics card.",
+    "此引擎不支持这台电脑的显卡。", "このエンジンは、このコンピューターのグラフィックスカードに対応していません。", "Diese Engine unterstützt die Grafikkarte dieses Computers nicht.",
+    "Este motor no admite la tarjeta gráfica de este equipo.", "Этот движок не поддерживает видеокарту этого компьютера.", "Este motor não oferece suporte à placa de vídeo deste computador.",
+    "이 엔진은 이 컴퓨터의 그래픽 카드를 지원하지 않습니다.", "Ce moteur ne prend pas en charge la carte graphique de cet ordinateur.")
+add("This engine needs NVIDIA driver {0} or newer. This computer has {1}.",
+    "此引擎需要 NVIDIA 驱动 {0} 或更新版本。这台电脑的驱动是 {1}。", "このエンジンには NVIDIA ドライバー {0} 以降が必要です。このコンピューターは {1} です。",
+    "Diese Engine braucht den NVIDIA-Treiber {0} oder neuer. Dieser Computer hat {1}.", "Este motor necesita el controlador NVIDIA {0} o posterior. Este equipo tiene {1}.",
+    "Для этого движка нужен драйвер NVIDIA {0} или новее. На этом компьютере {1}.", "Este motor precisa do driver NVIDIA {0} ou mais recente. Este computador tem o {1}.",
+    "이 엔진에는 NVIDIA 드라이버 {0} 이상이 필요합니다. 이 컴퓨터는 {1}입니다.", "Ce moteur nécessite le pilote NVIDIA {0} ou plus récent. Cet ordinateur a le {1}.")
+add("Some of this engine's files are missing or changed, so it can't be started.",
+    "此引擎的部分文件缺失或已被更改，因此无法启动。", "このエンジンのファイルの一部が見つからないか変更されているため、起動できません。",
+    "Einige Dateien dieser Engine fehlen oder wurden verändert, deshalb lässt sie sich nicht starten.", "Faltan archivos de este motor o han cambiado, así que no se puede iniciar.",
+    "Часть файлов этого движка отсутствует или изменена, поэтому его нельзя запустить.", "Alguns arquivos deste motor estão ausentes ou foram alterados, então ele não pode ser iniciado.",
+    "이 엔진의 일부 파일이 없거나 변경되어 시작할 수 없습니다.", "Certains fichiers de ce moteur sont absents ou modifiés : il ne peut pas démarrer.")
+add("This engine's description is missing or damaged, so it can't be started.",
+    "此引擎的说明文件缺失或已损坏，因此无法启动。", "このエンジンの説明ファイルが見つからないか壊れているため、起動できません。",
+    "Die Beschreibung dieser Engine fehlt oder ist beschädigt, deshalb lässt sie sich nicht starten.", "Falta la descripción de este motor o está dañada, así que no se puede iniciar.",
+    "Описание этого движка отсутствует или повреждено, поэтому его нельзя запустить.", "A descrição deste motor está ausente ou danificada, então ele não pode ser iniciado.",
+    "이 엔진의 설명 파일이 없거나 손상되어 시작할 수 없습니다.", "La description de ce moteur est absente ou endommagée : il ne peut pas démarrer.")
+
+# ---- updating moved to About: the words that sent people to Settings > Engine
+add("Strata didn’t recognise an engine for this computer. The model will download, but it may not run until the right engine is installed (Settings → About).",
+    "Strata 未能识别这台电脑的引擎。模型会下载，但在安装合适的引擎之前可能无法运行（设置 → 关于）。",
+    "Strata はこのコンピューター用のエンジンを認識できませんでした。モデルはダウンロードされますが、合ったエンジンをインストールするまで動かない可能性があります（設定 → 情報）。",
+    "Strata hat für diesen Computer keine Engine erkannt. Das Modell wird heruntergeladen, läuft aber möglicherweise erst, wenn die passende Engine installiert ist (Einstellungen → Über).",
+    "Strata no reconoció ningún motor para este equipo. El modelo se descargará, pero puede que no funcione hasta que se instale el motor adecuado (Ajustes → Acerca de).",
+    "Strata не распознала движок для этого компьютера. Модель скачается, но может не запуститься, пока не установлен подходящий движок (Настройки → О программе).",
+    "O Strata não reconheceu um motor para este computador. O modelo será baixado, mas pode não funcionar até que o motor certo seja instalado (Configurações → Sobre).",
+    "Strata가 이 컴퓨터용 엔진을 인식하지 못했습니다. 모델은 내려받지만, 알맞은 엔진이 설치되기 전에는 실행되지 않을 수 있습니다(설정 → 정보).",
+    "Strata n’a pas reconnu de moteur pour cet ordinateur. Le modèle sera téléchargé, mais il risque de ne pas fonctionner tant que le bon moteur n’est pas installé (Réglages → À propos).")
+add("Strata didn’t recognise an engine for this computer. The model is downloaded, but it can’t run until the right engine is installed. Open Settings → About.",
+    "Strata 未能识别这台电脑的引擎。模型已下载，但在安装合适的引擎之前无法运行。请打开 设置 → 关于。",
+    "Strata はこのコンピューター用のエンジンを認識できませんでした。モデルはダウンロード済みですが、合ったエンジンをインストールするまで動きません。設定 → 情報 を開いてください。",
+    "Strata hat für diesen Computer keine Engine erkannt. Das Modell ist heruntergeladen, läuft aber erst, wenn die passende Engine installiert ist. Öffne Einstellungen → Über.",
+    "Strata no reconoció ningún motor para este equipo. El modelo está descargado, pero no puede funcionar hasta que se instale el motor adecuado. Abre Ajustes → Acerca de.",
+    "Strata не распознала движок для этого компьютера. Модель скачана, но не запустится, пока не установлен подходящий движок. Откройте Настройки → О программе.",
+    "O Strata não reconheceu um motor para este computador. O modelo foi baixado, mas não pode funcionar até que o motor certo seja instalado. Abra Configurações → Sobre.",
+    "Strata가 이 컴퓨터용 엔진을 인식하지 못했습니다. 모델은 내려받았지만, 알맞은 엔진이 설치되기 전에는 실행할 수 없습니다. 설정 → 정보를 여세요.",
+    "Strata n’a pas reconnu de moteur pour cet ordinateur. Le modèle est téléchargé, mais il ne peut pas fonctionner tant que le bon moteur n’est pas installé. Ouvrez Réglages → À propos.")
+add("Update the engine (Settings, About), then try again.",
+    "请更新引擎（设置，关于），然后重试。", "エンジンを更新して（設定、情報）、もう一度お試しください。", "Aktualisiere die Engine (Einstellungen, Über) und versuche es dann erneut.",
+    "Actualiza el motor (Ajustes, Acerca de) y vuelve a intentarlo.", "Обновите движок (Настройки, О программе) и попробуйте снова.", "Atualize o motor (Configurações, Sobre) e tente novamente.",
+    "엔진을 업데이트(설정, 정보)한 뒤 다시 시도하세요.", "Mettez le moteur à jour (Réglages, À propos), puis réessayez.")
+
+# ---- answers of the host (shown as they are, so each one is a catalog entry)
+add("A model is running, so nothing was changed. Unload the model in Models, then try again.",
+    "有模型正在运行，所以没有做任何更改。请先在“模型”中卸载模型，然后重试。", "モデルが実行中のため、何も変更していません。「モデル」でモデルをアンロードしてから、もう一度お試しください。",
+    "Ein Modell läuft, deshalb wurde nichts geändert. Entlade das Modell unter „Modelle“ und versuche es dann erneut.", "Hay un modelo en ejecución, así que no se cambió nada. Descarga el modelo en «Modelos» y vuelve a intentarlo.",
+    "Работает модель, поэтому ничего не изменено. Выгрузите модель в разделе «Модели» и попробуйте снова.", "Há um modelo em execução, então nada foi alterado. Descarregue o modelo em «Modelos» e tente novamente.",
+    "모델이 실행 중이라 아무것도 바뀌지 않았습니다. '모델'에서 모델을 언로드한 다음 다시 시도하세요.", "Un modèle est en cours d'exécution, rien n'a donc été modifié. Déchargez le modèle dans « Modèles », puis réessayez.")
+add("This is the engine in use. Switch to another one first, then delete it.",
+    "这是正在使用的引擎。请先切换到另一个引擎，再删除它。", "これは使用中のエンジンです。先に別のエンジンに切り替えてから削除してください。",
+    "Das ist die verwendete Engine. Wechsle zuerst zu einer anderen und lösche sie dann.", "Este es el motor en uso. Cambia primero a otro y luego elimínalo.",
+    "Это используемый движок. Сначала переключитесь на другой, затем удалите его.", "Este é o motor em uso. Troque primeiro para outro e depois exclua-o.",
+    "사용 중인 엔진입니다. 먼저 다른 엔진으로 전환한 다음 삭제하세요.", "C'est le moteur utilisé. Passez d'abord à un autre, puis supprimez-le.")
+add("A program is still using this engine, so it was not deleted. Unload your models and try again.",
+    "仍有程序在使用此引擎，所以没有删除。请卸载你的模型后重试。", "プログラムがまだこのエンジンを使っているため、削除しませんでした。モデルをアンロードしてから、もう一度お試しください。",
+    "Ein Programm benutzt diese Engine noch, deshalb wurde sie nicht gelöscht. Entlade deine Modelle und versuche es erneut.", "Un programa todavía usa este motor, así que no se eliminó. Descarga tus modelos y vuelve a intentarlo.",
+    "Этот движок ещё используется программой, поэтому он не удалён. Выгрузите модели и попробуйте снова.", "Um programa ainda está usando este motor, então ele não foi excluído. Descarregue seus modelos e tente novamente.",
+    "프로그램이 아직 이 엔진을 사용하고 있어 삭제하지 않았습니다. 모델을 언로드한 다음 다시 시도하세요.", "Un programme utilise encore ce moteur : il n'a pas été supprimé. Déchargez vos modèles, puis réessayez.")
+add("That engine is already gone. The list has been refreshed.",
+    "该引擎已经不存在。列表已刷新。", "そのエンジンはすでにありません。一覧を更新しました。", "Diese Engine ist schon nicht mehr da. Die Liste wurde aktualisiert.",
+    "Ese motor ya no está. La lista se ha actualizado.", "Этого движка уже нет. Список обновлён.", "Esse motor já não existe. A lista foi atualizada.", "해당 엔진은 이미 없습니다. 목록을 새로 고쳤습니다.", "Ce moteur n'existe déjà plus. La liste a été actualisée.")
+add("An update is running. Wait for it to finish, then try again.",
+    "正在进行更新。请等它完成后再试。", "更新を実行中です。終わるまで待ってから、もう一度お試しください。", "Ein Update läuft. Warte, bis es fertig ist, und versuche es dann erneut.",
+    "Hay una actualización en curso. Espera a que termine y vuelve a intentarlo.", "Идёт обновление. Дождитесь его окончания и попробуйте снова.", "Uma atualização está em andamento. Aguarde o fim e tente novamente.",
+    "업데이트가 진행 중입니다. 끝날 때까지 기다린 다음 다시 시도하세요.", "Une mise à jour est en cours. Attendez qu'elle se termine, puis réessayez.")
+add("This engine can't run on this computer, so nothing was changed.",
+    "此引擎无法在这台电脑上运行，所以没有做任何更改。", "このエンジンはこのコンピューターでは動かないため、何も変更していません。", "Diese Engine läuft auf diesem Computer nicht, deshalb wurde nichts geändert.",
+    "Este motor no puede funcionar en este equipo, así que no se cambió nada.", "Этот движок не может работать на этом компьютере, поэтому ничего не изменено.", "Este motor não pode funcionar neste computador, então nada foi alterado.",
+    "이 엔진은 이 컴퓨터에서 실행할 수 없어 아무것도 바뀌지 않았습니다.", "Ce moteur ne peut pas fonctionner sur cet ordinateur : rien n'a été modifié.")
+add("The engine wasn't deleted. Nothing else was changed.",
+    "引擎没有被删除。其他内容均未更改。", "エンジンは削除されませんでした。ほかには何も変更していません。", "Die Engine wurde nicht gelöscht. Sonst wurde nichts geändert.",
+    "El motor no se eliminó. No se cambió nada más.", "Движок не удалён. Больше ничего не изменено.", "O motor não foi excluído. Nada mais foi alterado.", "엔진이 삭제되지 않았습니다. 다른 것은 바뀌지 않았습니다.", "Le moteur n'a pas été supprimé. Rien d'autre n'a été modifié.")
+add("The engine wasn't switched. Nothing was changed.",
+    "引擎没有被切换。没有做任何更改。", "エンジンは切り替わりませんでした。何も変更していません。", "Die Engine wurde nicht gewechselt. Es wurde nichts geändert.",
+    "No se cambió el motor. No se modificó nada.", "Движок не переключён. Ничего не изменено.", "O motor não foi trocado. Nada foi alterado.", "엔진이 전환되지 않았습니다. 아무것도 바뀌지 않았습니다.", "Le moteur n'a pas été changé. Rien n'a été modifié.")
+add("Choose an engine from the list.",
+    "请从列表中选择一个引擎。", "一覧からエンジンを選んでください。", "Wähle eine Engine aus der Liste.", "Elige un motor de la lista.", "Выберите движок из списка.", "Escolha um motor da lista.", "목록에서 엔진을 선택하세요.", "Choisissez un moteur dans la liste.")
+add("A newer engine is already on this computer. Update switches to it; nothing is downloaded.",
+    "这台电脑上已经有更新的引擎。点击更新会切换到它，不会下载任何内容。", "このコンピューターにはすでに新しいエンジンがあります。更新するとそれに切り替わり、ダウンロードはされません。",
+    "Auf diesem Computer ist schon eine neuere Engine. Das Update wechselt zu ihr; es wird nichts heruntergeladen.", "Este equipo ya tiene un motor más reciente. Actualizar cambia a él; no se descarga nada.",
+    "На этом компьютере уже есть более новый движок. Обновление переключит на него; ничего не скачивается.", "Este computador já tem um motor mais novo. Atualizar troca para ele; nada é baixado.",
+    "이 컴퓨터에 이미 더 새로운 엔진이 있습니다. 업데이트하면 그 엔진으로 전환되며, 내려받는 것은 없습니다.", "Cet ordinateur a déjà un moteur plus récent. La mise à jour bascule dessus ; rien n'est téléchargé.")
+
+here = Path(__file__).resolve().parent.parent / "src" / "locales"
+NBSP = " "
+
+
+def french(text):
+    text = re.sub(r"(?<=[A-Za-zÀ-ſ])'(?=[A-Za-zÀ-ſ{])", "’", text)
+    text = re.sub(r"(?<=\S) ([:;?!])", NBSP + r"\1", text)
+    text = re.sub(r"(?<=[\d}]) %", NBSP + "%", text)
+    return text
+
+
+for lang in LANGS:
+    data = {}
+    for i, entry in enumerate(S):
+        text = entry[lang]
+        assert sorted(re.findall(r"\{\d+\}", entry["en"])) == sorted(re.findall(r"\{\d+\}", text)), (lang, entry["en"], text)
+        data[f"et{i + 1:02d}"] = french(text) if lang == "fr" else text
+    (here / f"engine-{lang}.json").write_text(json.dumps(data, ensure_ascii=False, indent=1) + "\n", encoding="utf-8")
+print("written", len(S), "strings in", len(LANGS), "languages")

apps/host/scripts/make-fix-locales.py

@@ -0,0 +1,385 @@
+"""Writes src/locales/fix-<lang>.json: the interface strings that had no key in the locale files (#3479, #3825) and the strings of the 0.2.4.3 bug fixes.
+Run from apps/host:  python scripts/make-fix-locales.py
+The keys are fx01.. in this order; fix-en.json is the English source. Placeholders ({0}, {1}) must be kept in every language."""
+import json
+from pathlib import Path
+
+EN = [
+    "will stop running and be removed.",
+    "Downloaded, not loaded. Open Models to load it.",
+    "{0} lines added, {1} removed",
+    "Edited {0} files",
+    "Drop files to add them",
+    "Pictures and text files",
+    "Keep goal",
+    "Remove goal",
+    "The assistant stops working towards it. Your chat and files stay as they are.",
+    "This model can read pictures, but the engine installed here does not include the picture reader yet, so Read pictures is off. Update the engine in Settings → About to turn it on.",
+    "Showing the values of your tuning '{0}'.",
+    "Your tuning '{0}' sets",
+    "was {0}",
+    "· {0} RAM",
+    "The message was not cancelled",
+    "Extra settings for the program",
+    "Draft it with AI",
+    "Thinking time",
+    "Writing time",
+    "tokens/s",
+    "% of context",
+    "This page asks for files from the internet, which the preview does not load, so it may look incomplete. View code shows exactly what was written.",
+    "Keep A",
+    "Keep B",
+    "Took",
+    "Variation",
+    "Changed",
+    "Nothing",
+    "Both versions are ready. Compare A and B, then keep one.",
+    "The assistant is still answering",
+    "Send your message when it has finished.",
+    "The message was not queued",
+    "Scroll to the latest message",
+    "Remove task",
+    "Start a new conversation; keep this one",
+    "Have the assistant write a plan first; nothing runs until you approve it",
+    "Search the web, read the pages and answer with sources",
+    "Copied",
+    "Response",
+    "Message",
+    "PDF added",
+    "Select the text and copy it with Ctrl+C.",
+    "{0} is in this chat. Ask about it in your next message.",
+]
+
+T = {
+"zh": [
+    "将停止运行并被移除。",
+    "已下载，尚未加载。打开“模型”页面来加载它。",
+    "新增 {0} 行，删除 {1} 行",
+    "已编辑 {0} 个文件",
+    "拖放文件即可添加",
+    "图片和文本文件",
+    "保留目标",
+    "移除目标",
+    "助手将不再朝这个目标工作。你的对话和文件保持不变。",
+    "此模型可以读取图片，但这里安装的引擎还不包含图片读取器，所以“读取图片”已关闭。请在“设置 → 关于”中更新引擎后再开启。",
+    "显示你的调优“{0}”的取值。",
+    "你的调优“{0}”设置了",
+    "原为 {0}",
+    "· {0} 内存",
+    "消息没有被取消",
+    "程序的额外设置",
+    "用 AI 起草",
+    "思考时间",
+    "写作时间",
+    "词元/秒",
+    "% 的上下文",
+    "此页面需要从互联网加载文件，预览不会加载这些文件，所以看起来可能不完整。“查看代码”会显示实际写入的内容。",
+    "保留 A",
+    "保留 B",
+    "用时",
+    "波动",
+    "已更改",
+    "无",
+    "两个版本都已就绪。比较 A 和 B，然后保留其中一个。",
+    "助手仍在回答",
+    "等它回答完再发送你的消息。",
+    "消息没有进入队列",
+    "滚动到最新消息",
+    "移除任务",
+    "开始新对话；保留当前这个",
+    "让助手先写一份计划；在你批准之前不会运行任何内容",
+    "搜索网络、阅读网页，并附上来源作答",
+    "已复制",
+    "回复",
+    "消息",
+    "已添加 PDF",
+    "请选中文字，然后按 Ctrl+C 复制。",
+    "{0} 已在此对话中。请在下一条消息里询问它。",
+],
+"ja": [
+    "は停止され、削除されます。",
+    "ダウンロード済みですが、読み込まれていません。「モデル」を開いて読み込んでください。",
+    "{0} 行追加、{1} 行削除",
+    "{0} 個のファイルを編集しました",
+    "ファイルをドロップして追加",
+    "画像とテキストファイル",
+    "目標を残す",
+    "目標を削除",
+    "アシスタントはこの目標に向けた作業をやめます。チャットとファイルはそのまま残ります。",
+    "このモデルは画像を読めますが、ここにインストールされているエンジンにはまだ画像リーダーが含まれていないため、「画像を読む」はオフです。設定 → 情報 でエンジンを更新するとオンにできます。",
+    "チューニング「{0}」の値を表示しています。",
+    "チューニング「{0}」が設定する項目",
+    "変更前: {0}",
+    "· {0} RAM",
+    "メッセージはキャンセルされませんでした",
+    "プログラムの追加設定",
+    "AI で下書きを作成",
+    "思考時間",
+    "執筆時間",
+    "トークン/秒",
+    "% のコンテキスト",
+    "このページはインターネット上のファイルを必要としますが、プレビューでは読み込まれないため、表示が不完全になることがあります。「コードを表示」で書かれた内容をそのまま確認できます。",
+    "A を残す",
+    "B を残す",
+    "所要時間",
+    "ばらつき",
+    "変更点",
+    "なし",
+    "両方のバージョンの準備ができました。A と B を比べて、どちらかを残してください。",
+    "アシスタントはまだ回答中です",
+    "回答が終わってからメッセージを送ってください。",
+    "メッセージは待機列に入りませんでした",
+    "最新のメッセージへスクロール",
+    "タスクを削除",
+    "新しい会話を始めます。今の会話は残ります",
+    "アシスタントにまず計画を書かせます。承認するまで何も実行されません",
+    "ウェブを検索し、ページを読み、出典付きで回答します",
+    "コピーしました",
+    "返信",
+    "メッセージ",
+    "PDF を追加しました",
+    "テキストを選択して Ctrl+C でコピーしてください。",
+    "{0} をこのチャットに追加しました。次のメッセージで質問してください。",
+],
+"de": [
+    "wird nicht mehr ausgeführt und entfernt.",
+    "Heruntergeladen, aber nicht geladen. Öffne „Modelle“, um es zu laden.",
+    "{0} Zeilen hinzugefügt, {1} entfernt",
+    "{0} Dateien bearbeitet",
+    "Dateien hier ablegen, um sie hinzuzufügen",
+    "Bilder und Textdateien",
+    "Ziel behalten",
+    "Ziel entfernen",
+    "Der Assistent arbeitet nicht mehr darauf hin. Dein Chat und deine Dateien bleiben unverändert.",
+    "Dieses Modell kann Bilder lesen, aber die hier installierte Engine enthält den Bildleser noch nicht, deshalb ist „Bilder lesen“ aus. Aktualisiere die Engine unter Einstellungen → Info, um es einzuschalten.",
+    "Zeigt die Werte deiner Abstimmung „{0}“.",
+    "Deine Abstimmung „{0}“ setzt",
+    "war {0}",
+    "· {0} RAM",
+    "Die Nachricht wurde nicht abgebrochen",
+    "Zusätzliche Einstellungen für das Programm",
+    "Mit KI entwerfen",
+    "Denkzeit",
+    "Schreibzeit",
+    "Token/s",
+    "% des Kontexts",
+    "Diese Seite lädt Dateien aus dem Internet, was die Vorschau nicht tut. Sie kann deshalb unvollständig aussehen. „Code anzeigen“ zeigt genau, was geschrieben wurde.",
+    "A behalten",
+    "B behalten",
+    "Dauer",
+    "Schwankung",
+    "Geändert",
+    "Nichts",
+    "Beide Versionen sind fertig. Vergleiche A und B und behalte eine.",
+    "Der Assistent antwortet noch",
+    "Sende deine Nachricht, wenn er fertig ist.",
+    "Die Nachricht wurde nicht eingereiht",
+    "Zur neuesten Nachricht scrollen",
+    "Aufgabe entfernen",
+    "Neue Unterhaltung beginnen; diese bleibt erhalten",
+    "Der Assistent schreibt zuerst einen Plan; nichts läuft, bis du ihn freigibst",
+    "Im Web suchen, die Seiten lesen und mit Quellen antworten",
+    "Kopiert",
+    "Antwort",
+    "Nachricht",
+    "PDF hinzugefügt",
+    "Markiere den Text und kopiere ihn mit Strg+C.",
+    "{0} ist in diesem Chat. Frag in deiner nächsten Nachricht danach.",
+],
+"es": [
+    "dejará de ejecutarse y se eliminará.",
+    "Descargado, pero no cargado. Abre Modelos para cargarlo.",
+    "{0} líneas añadidas, {1} eliminadas",
+    "{0} archivos editados",
+    "Suelta los archivos para añadirlos",
+    "Imágenes y archivos de texto",
+    "Mantener el objetivo",
+    "Quitar el objetivo",
+    "El asistente deja de trabajar en ello. Tu chat y tus archivos se quedan como están.",
+    "Este modelo puede leer imágenes, pero el motor instalado aquí aún no incluye el lector de imágenes, así que Leer imágenes está desactivado. Actualiza el motor en Ajustes → Acerca de para activarlo.",
+    "Se muestran los valores de tu ajuste «{0}».",
+    "Tu ajuste «{0}» establece",
+    "antes {0}",
+    "· {0} de RAM",
+    "El mensaje no se canceló",
+    "Ajustes adicionales del programa",
+    "Redactar con IA",
+    "Tiempo de pensar",
+    "Tiempo de escribir",
+    "tokens/s",
+    "% del contexto",
+    "Esta página pide archivos de internet, que la vista previa no carga, así que puede verse incompleta. Ver código muestra exactamente lo que se escribió.",
+    "Mantener A",
+    "Mantener B",
+    "Tardó",
+    "Variación",
+    "Cambiado",
+    "Nada",
+    "Las dos versiones están listas. Compara A y B y quédate con una.",
+    "El asistente sigue respondiendo",
+    "Envía tu mensaje cuando termine.",
+    "El mensaje no se puso en cola",
+    "Ir al último mensaje",
+    "Quitar tarea",
+    "Empieza una conversación nueva; esta se conserva",
+    "El asistente escribe primero un plan; no se ejecuta nada hasta que lo apruebes",
+    "Busca en la web, lee las páginas y responde con fuentes",
+    "Copiado",
+    "Respuesta",
+    "Mensaje",
+    "PDF añadido",
+    "Selecciona el texto y cópialo con Ctrl+C.",
+    "{0} está en este chat. Pregunta por él en tu próximo mensaje.",
+],
+"ru": [
+    "перестанет работать и будет удалена.",
+    "Скачана, но не загружена. Откройте «Модели», чтобы загрузить её.",
+    "Добавлено строк: {0}, удалено: {1}",
+    "Изменено файлов: {0}",
+    "Перетащите файлы сюда, чтобы добавить",
+    "Картинки и текстовые файлы",
+    "Оставить цель",
+    "Удалить цель",
+    "Ассистент перестанет работать над ней. Ваш чат и файлы останутся как есть.",
+    "Эта модель умеет читать картинки, но установленный здесь движок пока не содержит модуль чтения картинок, поэтому «Читать картинки» выключено. Обновите движок в разделе «Настройки → О программе», чтобы включить.",
+    "Показаны значения вашей настройки «{0}».",
+    "Ваша настройка «{0}» задаёт",
+    "было {0}",
+    "· {0} ОЗУ",
+    "Сообщение не было отменено",
+    "Дополнительные настройки программы",
+    "Набросать с помощью ИИ",
+    "Время размышления",
+    "Время написания",
+    "токенов/с",
+    "% контекста",
+    "Эта страница запрашивает файлы из интернета, а предпросмотр их не загружает, поэтому она может выглядеть неполной. «Показать код» показывает, что именно было написано.",
+    "Оставить A",
+    "Оставить B",
+    "Заняло",
+    "Разброс",
+    "Изменено",
+    "Ничего",
+    "Обе версии готовы. Сравните A и B и оставьте одну.",
+    "Ассистент ещё отвечает",
+    "Отправьте сообщение, когда он закончит.",
+    "Сообщение не поставлено в очередь",
+    "К последнему сообщению",
+    "Удалить задачу",
+    "Начать новый разговор; этот сохраняется",
+    "Ассистент сначала напишет план; ничего не запустится, пока вы его не одобрите",
+    "Искать в интернете, читать страницы и отвечать со ссылками на источники",
+    "Скопировано",
+    "Ответ",
+    "Сообщение",
+    "PDF добавлен",
+    "Выделите текст и скопируйте его клавишами Ctrl+C.",
+    "{0} добавлен в этот чат. Спросите о нём в следующем сообщении.",
+],
+"pt": [
+    "vai parar de funcionar e será removido.",
+    "Baixado, mas não carregado. Abra Modelos para carregá-lo.",
+    "{0} linhas adicionadas, {1} removidas",
+    "{0} arquivos editados",
+    "Solte os arquivos para adicioná-los",
+    "Imagens e arquivos de texto",
+    "Manter a meta",
+    "Remover a meta",
+    "O assistente deixa de trabalhar nela. Seu chat e seus arquivos continuam como estão.",
+    "Este modelo consegue ler imagens, mas o motor instalado aqui ainda não inclui o leitor de imagens, então Ler imagens está desligado. Atualize o motor em Configurações → Sobre para ligar.",
+    "Mostrando os valores do seu ajuste \"{0}\".",
+    "Seu ajuste \"{0}\" define",
+    "era {0}",
+    "· {0} de RAM",
+    "A mensagem não foi cancelada",
+    "Configurações extras do programa",
+    "Rascunhar com IA",
+    "Tempo de raciocínio",
+    "Tempo de escrita",
+    "tokens/s",
+    "% do contexto",
+    "Esta página pede arquivos da internet, que a visualização não carrega, então pode parecer incompleta. Ver código mostra exatamente o que foi escrito.",
+    "Manter A",
+    "Manter B",
+    "Levou",
+    "Variação",
+    "Alterado",
+    "Nada",
+    "As duas versões estão prontas. Compare A e B e mantenha uma.",
+    "O assistente ainda está respondendo",
+    "Envie sua mensagem quando ele terminar.",
+    "A mensagem não entrou na fila",
+    "Ir para a última mensagem",
+    "Remover tarefa",
+    "Começar uma nova conversa; esta continua salva",
+    "O assistente escreve um plano primeiro; nada roda até você aprovar",
+    "Pesquisar na web, ler as páginas e responder com fontes",
+    "Copiado",
+    "Resposta",
+    "Mensagem",
+    "PDF adicionado",
+    "Selecione o texto e copie com Ctrl+C.",
+    "{0} está neste chat. Pergunte sobre ele na próxima mensagem.",
+],
+"ko": [
+    "실행이 중지되고 제거됩니다.",
+    "다운로드했지만 아직 불러오지 않았습니다. 모델 화면을 열어 불러오세요.",
+    "{0}줄 추가, {1}줄 삭제",
+    "파일 {0}개 편집함",
+    "파일을 놓아서 추가하세요",
+    "그림과 텍스트 파일",
+    "목표 유지",
+    "목표 제거",
+    "어시스턴트가 이 목표를 향한 작업을 멈춥니다. 대화와 파일은 그대로 남습니다.",
+    "이 모델은 그림을 읽을 수 있지만, 여기에 설치된 엔진에는 아직 그림 읽기 기능이 없어서 '그림 읽기'가 꺼져 있습니다. 설정 → 정보에서 엔진을 업데이트하면 켤 수 있습니다.",
+    "튜닝 '{0}'의 값을 보여 줍니다.",
+    "튜닝 '{0}'이(가) 설정하는 항목",
+    "이전 값 {0}",
+    "· RAM {0}",
+    "메시지가 취소되지 않았습니다",
+    "프로그램 추가 설정",
+    "AI로 초안 작성",
+    "생각한 시간",
+    "작성한 시간",
+    "토큰/초",
+    "컨텍스트 %",
+    "이 페이지는 인터넷의 파일을 불러와야 하는데 미리보기는 이를 불러오지 않으므로 불완전하게 보일 수 있습니다. '코드 보기'에서 작성된 내용을 그대로 볼 수 있습니다.",
+    "A 유지",
+    "B 유지",
+    "걸린 시간",
+    "편차",
+    "변경됨",
+    "없음",
+    "두 버전이 모두 준비되었습니다. A와 B를 비교한 뒤 하나를 유지하세요.",
+    "어시스턴트가 아직 답하는 중입니다",
+    "답이 끝나면 메시지를 보내세요.",
+    "메시지가 대기열에 들어가지 않았습니다",
+    "최신 메시지로 이동",
+    "작업 제거",
+    "새 대화를 시작합니다. 이 대화는 그대로 둡니다",
+    "어시스턴트가 먼저 계획을 작성합니다. 승인하기 전에는 아무것도 실행되지 않습니다",
+    "웹을 검색하고 페이지를 읽어 출처와 함께 답합니다",
+    "복사했습니다",
+    "답변",
+    "메시지",
+    "PDF를 추가했습니다",
+    "텍스트를 선택한 뒤 Ctrl+C로 복사하세요.",
+    "{0}이(가) 이 채팅에 있습니다. 다음 메시지에서 물어보세요.",
+],
+}
+
+here = Path(__file__).resolve().parent.parent / "locales" if False else Path(__file__).resolve().parent.parent / "src" / "locales"
+
+
+def write(lang, values):
+    assert len(values) == len(EN), (lang, len(values), len(EN))
+    for source, text in zip(EN, values):
+        assert sorted(__import__("re").findall(r"\{\d+\}", source)) == sorted(__import__("re").findall(r"\{\d+\}", text)), (lang, source, text)
+    data = {f"fx{i + 1:02d}": text for i, text in enumerate(values)}
+    (here / f"fix-{lang}.json").write_text(json.dumps(data, ensure_ascii=False, indent=1) + "\n", encoding="utf-8")
+
+
+write("en", EN)
+for lang, values in T.items():
+    write(lang, values)
+print("written", len(EN), "strings in", len(T) + 1, "languages")

apps/host/scripts/make-gh-locales.py

@@ -0,0 +1,365 @@
+"""Writes src/locales/gh-<lang>.json: the interface strings of the 0.2.7 GitHub items done in f-027-gh-app (the Monitor's Power card #3628,
+approval notifications and the tray #3477, the finished-task sound #3586, the pinned port #3402, the interface size #3970).
+Run from apps/host:  python scripts/make-gh-locales.py
+The keys are gh01.. in this order; gh-en.json is the English source. Placeholders ({0}, {1}) must be kept in every language.
+A separate file keeps this work from colliding with the other catalogs (the same reason tune-, tools- and fix- exist)."""
+import json
+import re
+from pathlib import Path
+
+EN = [
+    "Energy since start",
+    "Cost since start",
+    "GPU fan",
+    "GPU clock",
+    "CPU temperature",
+    "SSD temperature",
+    "Electricity price",
+    "Price of one kilowatt-hour. The Monitor then shows what your graphics card has cost since Strata started. Leave it empty to hide the cost.",
+    "Price per kWh",
+    "Sound when work finishes",
+    "Plays a short sound when an answer or task that took a while is finished, or when Strata is in the background.",
+    "Play sound",
+    "Notify me when Strata needs an answer",
+    "In Manual mode, shows a desktop notification when the assistant waits for your approval and Strata is in the background.",
+    "Strata needs your answer",
+    "The assistant wants to use {0}. Open Strata to approve or deny.",
+    "a tool",
+    "Minimise to tray",
+    "Closing the window keeps Strata running in the tray, next to the clock. Choose Quit in the tray menu to stop it. Applies the next time Strata starts.",
+    "App port",
+    "The port Strata’s window and local address use. Leave it empty to let Strata choose (47831 when it is free). Applies the next time Strata starts.",
+    "Port (empty = automatic)",
+    "Using port {0} now.",
+    "Strata could not use its port",
+    "Port {0} is used by another program, so Strata started on port {1}. Chats and settings saved on port {0} are not shown until Strata can use it again. Close the other program and restart Strata.",
+    "Choose a port between 1024 and 65535, or leave it empty.",
+    "Makes all text, buttons and menus in Strata larger or smaller.",
+    "Energy and temperature readings",
+    "per kWh, in {0}",
+    "per kWh",
+    "Change currency",
+    "Automatic ({0})",
+    "Currency",
+    "less than {0}",
+]
+
+T = {
+"zh": [
+    "启动以来的能耗",
+    "启动以来的费用",
+    "GPU 风扇",
+    "GPU 频率",
+    "CPU 温度",
+    "SSD 温度",
+    "电价",
+    "每千瓦时的价格。监控页会据此显示 Strata 启动以来显卡用电的费用。留空则不显示费用。",
+    "每千瓦时价格",
+    "工作完成时的提示音",
+    "回答或耗时较长的任务完成时，或 Strata 在后台时，播放一段简短的提示音。",
+    "播放提示音",
+    "Strata 需要您答复时通知我",
+    "在手动模式下，当助手等待您批准而 Strata 在后台时，显示桌面通知。",
+    "Strata 需要您的答复",
+    "助手想使用 {0}。打开 Strata 以批准或拒绝。",
+    "一个工具",
+    "最小化到托盘",
+    "关闭窗口后，Strata 会继续在托盘（时钟旁边）运行。要停止它，请在托盘菜单中选择“退出”。下次启动 Strata 时生效。",
+    "应用端口",
+    "Strata 窗口和本地地址使用的端口。留空则由 Strata 自行选择（空闲时为 47831）。下次启动 Strata 时生效。",
+    "端口（留空 = 自动）",
+    "当前使用端口 {0}。",
+    "Strata 无法使用它的端口",
+    "端口 {0} 已被其他程序占用，因此 Strata 改用端口 {1} 启动。在端口 {0} 上保存的聊天和设置在 Strata 能再次使用该端口之前不会显示。请关闭其他程序并重新启动 Strata。",
+    "请选择 1024 到 65535 之间的端口，或留空。",
+    "让 Strata 中的所有文字、按钮和菜单变大或变小。",
+    "能耗和温度读数",
+    "每千瓦时，币种 {0}",
+    "每千瓦时",
+    "更改货币",
+    "自动（{0}）",
+    "货币",
+    "不足 {0}",
+],
+"ja": [
+    "起動後の消費電力量",
+    "起動後の電気代",
+    "GPU ファン",
+    "GPU クロック",
+    "CPU 温度",
+    "SSD 温度",
+    "電気料金",
+    "1キロワット時あたりの料金です。モニターに、Strata の起動後にグラフィックスカードが使った電気代が表示されます。空欄のままなら電気代は表示されません。",
+    "1 kWh あたりの料金",
+    "作業完了時の音",
+    "回答や時間のかかった作業が終わったとき、または Strata がバックグラウンドにあるときに、短い音を鳴らします。",
+    "音を鳴らす",
+    "Strata の返答が必要なときに通知する",
+    "手動モードで、アシスタントが承認を待っていて Strata がバックグラウンドにあるときに、デスクトップ通知を表示します。",
+    "Strata があなたの返答を待っています",
+    "アシスタントが {0} を使おうとしています。Strata を開いて承認または拒否してください。",
+    "ツール",
+    "トレイに最小化",
+    "ウィンドウを閉じても、Strata は時計の横のトレイで動き続けます。止めるには、トレイのメニューで「終了」を選びます。次に Strata を起動したときから有効になります。",
+    "アプリのポート",
+    "Strata のウィンドウとローカルアドレスが使うポートです。空欄なら Strata が選びます（空いていれば 47831）。次に Strata を起動したときから有効になります。",
+    "ポート（空欄 = 自動）",
+    "現在のポートは {0} です。",
+    "Strata は指定のポートを使えませんでした",
+    "ポート {0} は別のプログラムが使っているため、Strata はポート {1} で起動しました。ポート {0} に保存されたチャットと設定は、Strata が再びそのポートを使えるようになるまで表示されません。他のプログラムを閉じて Strata を再起動してください。",
+    "1024 から 65535 の間のポートを選ぶか、空欄にしてください。",
+    "Strata のすべての文字、ボタン、メニューを大きくしたり小さくしたりします。",
+    "消費電力量と温度の値",
+    "1 kWh あたり、通貨は {0}",
+    "1 kWh あたり",
+    "通貨を変更",
+    "自動（{0}）",
+    "通貨",
+    "{0} 未満",
+],
+"de": [
+    "Energie seit dem Start",
+    "Kosten seit dem Start",
+    "GPU-Lüfter",
+    "GPU-Takt",
+    "CPU-Temperatur",
+    "SSD-Temperatur",
+    "Strompreis",
+    "Preis einer Kilowattstunde. Der Monitor zeigt dann, was Ihre Grafikkarte seit dem Start von Strata gekostet hat. Leer lassen, um die Kosten auszublenden.",
+    "Preis pro kWh",
+    "Ton, wenn Arbeit fertig ist",
+    "Spielt einen kurzen Ton, wenn eine Antwort oder Aufgabe, die länger gedauert hat, fertig ist oder wenn Strata im Hintergrund läuft.",
+    "Ton abspielen",
+    "Benachrichtigen, wenn Strata eine Antwort braucht",
+    "Zeigt im manuellen Modus eine Desktop-Benachrichtigung, wenn der Assistent auf Ihre Freigabe wartet und Strata im Hintergrund läuft.",
+    "Strata braucht Ihre Antwort",
+    "Der Assistent möchte {0} verwenden. Öffnen Sie Strata, um zu erlauben oder abzulehnen.",
+    "ein Werkzeug",
+    "In den Infobereich minimieren",
+    "Beim Schließen des Fensters läuft Strata im Infobereich neben der Uhr weiter. Wählen Sie im Menü des Symbols „Beenden“, um es zu stoppen. Gilt ab dem nächsten Start von Strata.",
+    "App-Port",
+    "Der Port, den das Fenster und die lokale Adresse von Strata verwenden. Leer lassen, damit Strata ihn wählt (47831, wenn frei). Gilt ab dem nächsten Start von Strata.",
+    "Port (leer = automatisch)",
+    "Aktuell wird Port {0} verwendet.",
+    "Strata konnte seinen Port nicht verwenden",
+    "Port {0} wird von einem anderen Programm verwendet, daher wurde Strata auf Port {1} gestartet. Unter Port {0} gespeicherte Chats und Einstellungen werden nicht angezeigt, bis Strata ihn wieder verwenden kann. Schließen Sie das andere Programm und starten Sie Strata neu.",
+    "Wählen Sie einen Port zwischen 1024 und 65535 oder lassen Sie das Feld leer.",
+    "Macht alle Texte, Schaltflächen und Menüs in Strata größer oder kleiner.",
+    "Energie- und Temperaturwerte",
+    "pro kWh, in {0}",
+    "pro kWh",
+    "Währung ändern",
+    "Automatisch ({0})",
+    "Währung",
+    "weniger als {0}",
+],
+"es": [
+    "Energía desde el inicio",
+    "Coste desde el inicio",
+    "Ventilador de la GPU",
+    "Reloj de la GPU",
+    "Temperatura de la CPU",
+    "Temperatura del SSD",
+    "Precio de la electricidad",
+    "Precio de un kilovatio hora. El Monitor mostrará entonces lo que ha costado tu tarjeta gráfica desde que se inició Strata. Déjalo vacío para ocultar el coste.",
+    "Precio por kWh",
+    "Sonido al terminar el trabajo",
+    "Reproduce un sonido breve cuando termina una respuesta o tarea que tardó un rato, o cuando Strata está en segundo plano.",
+    "Reproducir sonido",
+    "Avisarme cuando Strata necesite una respuesta",
+    "En el modo manual, muestra una notificación de escritorio cuando el asistente espera tu aprobación y Strata está en segundo plano.",
+    "Strata necesita tu respuesta",
+    "El asistente quiere usar {0}. Abre Strata para aprobar o denegar.",
+    "una herramienta",
+    "Minimizar a la bandeja",
+    "Al cerrar la ventana, Strata sigue funcionando en la bandeja, junto al reloj. Elige Salir en el menú de la bandeja para detenerlo. Se aplica la próxima vez que se inicie Strata.",
+    "Puerto de la aplicación",
+    "El puerto que usan la ventana y la dirección local de Strata. Déjalo vacío para que Strata elija (47831 si está libre). Se aplica la próxima vez que se inicie Strata.",
+    "Puerto (vacío = automático)",
+    "Ahora se usa el puerto {0}.",
+    "Strata no pudo usar su puerto",
+    "El puerto {0} lo usa otro programa, así que Strata se inició en el puerto {1}. Los chats y ajustes guardados en el puerto {0} no se muestran hasta que Strata pueda volver a usarlo. Cierra el otro programa y reinicia Strata.",
+    "Elige un puerto entre 1024 y 65535, o déjalo vacío.",
+    "Hace más grandes o más pequeños todos los textos, botones y menús de Strata.",
+    "Lecturas de energía y temperatura",
+    "por kWh, en {0}",
+    "por kWh",
+    "Cambiar moneda",
+    "Automática ({0})",
+    "Moneda",
+    "menos de {0}",
+],
+"ru": [
+    "Энергия с запуска",
+    "Стоимость с запуска",
+    "Вентилятор GPU",
+    "Частота GPU",
+    "Температура CPU",
+    "Температура SSD",
+    "Цена электричества",
+    "Цена одного киловатт-часа. Тогда монитор покажет, во сколько видеокарта обошлась с запуска Strata. Оставьте поле пустым, чтобы скрыть стоимость.",
+    "Цена за кВт·ч",
+    "Звук по окончании работы",
+    "Проигрывает короткий звук, когда закончился долгий ответ или задача, а также когда Strata работает в фоне.",
+    "Проиграть звук",
+    "Уведомлять, когда Strata нужен ответ",
+    "В ручном режиме показывает уведомление на рабочем столе, когда помощник ждёт вашего подтверждения, а Strata работает в фоне.",
+    "Strata нужен ваш ответ",
+    "Помощник хочет использовать {0}. Откройте Strata, чтобы разрешить или отклонить.",
+    "инструмент",
+    "Сворачивать в трей",
+    "При закрытии окна Strata продолжает работать в трее рядом с часами. Чтобы остановить её, выберите «Выход» в меню значка. Действует со следующего запуска Strata.",
+    "Порт приложения",
+    "Порт, который используют окно и локальный адрес Strata. Оставьте поле пустым, чтобы Strata выбрала сама (47831, если свободен). Действует со следующего запуска Strata.",
+    "Порт (пусто = автоматически)",
+    "Сейчас используется порт {0}.",
+    "Strata не смогла использовать свой порт",
+    "Порт {0} занят другой программой, поэтому Strata запустилась на порту {1}. Чаты и настройки, сохранённые на порту {0}, не показываются, пока Strata не сможет снова его использовать. Закройте другую программу и перезапустите Strata.",
+    "Выберите порт от 1024 до 65535 или оставьте поле пустым.",
+    "Увеличивает или уменьшает весь текст, кнопки и меню в Strata.",
+    "Показания энергии и температуры",
+    "за кВт·ч, в валюте {0}",
+    "за кВт·ч",
+    "Сменить валюту",
+    "Автоматически ({0})",
+    "Валюта",
+    "меньше {0}",
+],
+"pt": [
+    "Energia desde o início",
+    "Custo desde o início",
+    "Ventoinha da GPU",
+    "Clock da GPU",
+    "Temperatura da CPU",
+    "Temperatura do SSD",
+    "Preço da eletricidade",
+    "Preço de um quilowatt-hora. O Monitor passa a mostrar quanto a sua placa de vídeo custou desde que o Strata iniciou. Deixe vazio para ocultar o custo.",
+    "Preço por kWh",
+    "Som ao terminar o trabalho",
+    "Toca um som curto quando uma resposta ou tarefa que demorou termina, ou quando o Strata está em segundo plano.",
+    "Tocar som",
+    "Avisar quando o Strata precisar de uma resposta",
+    "No modo manual, mostra uma notificação na área de trabalho quando o assistente espera sua aprovação e o Strata está em segundo plano.",
+    "O Strata precisa da sua resposta",
+    "O assistente quer usar {0}. Abra o Strata para aprovar ou negar.",
+    "uma ferramenta",
+    "Minimizar para a bandeja",
+    "Ao fechar a janela, o Strata continua em execução na bandeja, ao lado do relógio. Escolha Sair no menu da bandeja para encerrá-lo. Vale a partir da próxima vez que o Strata iniciar.",
+    "Porta do aplicativo",
+    "A porta usada pela janela e pelo endereço local do Strata. Deixe vazio para o Strata escolher (47831 quando estiver livre). Vale a partir da próxima vez que o Strata iniciar.",
+    "Porta (vazio = automático)",
+    "Usando a porta {0} agora.",
+    "O Strata não conseguiu usar a sua porta",
+    "A porta {0} está em uso por outro programa, então o Strata iniciou na porta {1}. Os chats e as configurações salvos na porta {0} não aparecem até o Strata poder usá-la de novo. Feche o outro programa e reinicie o Strata.",
+    "Escolha uma porta entre 1024 e 65535, ou deixe vazio.",
+    "Deixa todos os textos, botões e menus do Strata maiores ou menores.",
+    "Leituras de energia e temperatura",
+    "por kWh, em {0}",
+    "por kWh",
+    "Alterar moeda",
+    "Automática ({0})",
+    "Moeda",
+    "menos de {0}",
+],
+"ko": [
+    "시작 이후 에너지",
+    "시작 이후 비용",
+    "GPU 팬",
+    "GPU 클럭",
+    "CPU 온도",
+    "SSD 온도",
+    "전기 요금",
+    "1킬로와트시의 요금입니다. 모니터에 Strata를 시작한 뒤 그래픽 카드에 든 전기 요금이 표시됩니다. 비워 두면 비용을 표시하지 않습니다.",
+    "kWh당 요금",
+    "작업이 끝났을 때 소리",
+    "답변이나 오래 걸린 작업이 끝났을 때, 또는 Strata가 백그라운드에 있을 때 짧은 소리를 재생합니다.",
+    "소리 재생",
+    "Strata가 답을 필요로 할 때 알림",
+    "수동 모드에서 어시스턴트가 승인을 기다리고 Strata가 백그라운드에 있을 때 데스크톱 알림을 표시합니다.",
+    "Strata가 답을 기다리고 있습니다",
+    "어시스턴트가 {0}을(를) 사용하려고 합니다. Strata를 열어 승인하거나 거부하세요.",
+    "도구",
+    "트레이로 최소화",
+    "창을 닫아도 Strata는 시계 옆 트레이에서 계속 실행됩니다. 끝내려면 트레이 메뉴에서 '종료'를 선택하세요. 다음에 Strata를 시작할 때부터 적용됩니다.",
+    "앱 포트",
+    "Strata의 창과 로컬 주소가 사용하는 포트입니다. 비워 두면 Strata가 고릅니다(비어 있으면 47831). 다음에 Strata를 시작할 때부터 적용됩니다.",
+    "포트(비움 = 자동)",
+    "지금은 포트 {0}을(를) 사용 중입니다.",
+    "Strata가 지정한 포트를 사용할 수 없었습니다",
+    "포트 {0}을(를) 다른 프로그램이 사용 중이어서 Strata는 포트 {1}에서 시작했습니다. 포트 {0}에 저장된 채팅과 설정은 Strata가 다시 그 포트를 쓸 수 있을 때까지 표시되지 않습니다. 다른 프로그램을 닫고 Strata를 다시 시작하세요.",
+    "1024에서 65535 사이의 포트를 고르거나 비워 두세요.",
+    "Strata의 모든 글자, 버튼, 메뉴를 더 크게 또는 더 작게 만듭니다.",
+    "에너지 및 온도 측정값",
+    "kWh당, 통화 {0}",
+    "kWh당",
+    "통화 변경",
+    "자동({0})",
+    "통화",
+    "{0} 미만",
+],
+"fr": [
+    "Énergie depuis le démarrage",
+    "Coût depuis le démarrage",
+    "Ventilateur du GPU",
+    "Fréquence du GPU",
+    "Température du CPU",
+    "Température du SSD",
+    "Prix de l'électricité",
+    "Prix d'un kilowattheure. Le Moniteur affiche alors ce que votre carte graphique a coûté depuis le démarrage de Strata. Laissez vide pour masquer le coût.",
+    "Prix par kWh",
+    "Son à la fin du travail",
+    "Joue un court son quand une réponse ou une tâche qui a pris du temps est terminée, ou quand Strata est en arrière-plan.",
+    "Jouer le son",
+    "Me prévenir quand Strata a besoin d'une réponse",
+    "En mode manuel, affiche une notification sur le bureau quand l'assistant attend votre accord et que Strata est en arrière-plan.",
+    "Strata a besoin de votre réponse",
+    "L'assistant veut utiliser {0}. Ouvrez Strata pour accepter ou refuser.",
+    "un outil",
+    "Réduire dans la zone de notification",
+    "Fermer la fenêtre garde Strata actif dans la zone de notification, près de l'horloge. Choisissez Quitter dans le menu de l'icône pour l'arrêter. S'applique au prochain démarrage de Strata.",
+    "Port de l'application",
+    "Le port que la fenêtre et l'adresse locale de Strata utilisent. Laissez vide pour que Strata choisisse (47831 s'il est libre). S'applique au prochain démarrage de Strata.",
+    "Port (vide = automatique)",
+    "Port {0} utilisé en ce moment.",
+    "Strata n'a pas pu utiliser son port",
+    "Le port {0} est utilisé par un autre programme, donc Strata a démarré sur le port {1}. Les conversations et réglages enregistrés sur le port {0} ne s'affichent pas tant que Strata ne peut pas le réutiliser. Fermez l'autre programme et relancez Strata.",
+    "Choisissez un port entre 1024 et 65535, ou laissez vide.",
+    "Agrandit ou réduit tous les textes, boutons et menus de Strata.",
+    "Relevés d'énergie et de température",
+    "par kWh, en {0}",
+    "par kWh",
+    "Changer de devise",
+    "Automatique ({0})",
+    "Devise",
+    "moins de {0}",
+],
+}
+
+here = Path(__file__).resolve().parent.parent / "src" / "locales"
+
+
+NBSP = "\u00a0"
+
+
+def french(text):
+    """The same French spacing as scripts/fr_sync.py: a typographic apostrophe, a no-break space before : ; ? ! % and inside the guillemets."""
+    text = re.sub(r"(?<=[A-Za-z\u00c0-\u017f])'(?=[A-Za-z\u00c0-\u017f{])", "\u2019", text)
+    text = re.sub(r"(?<=\S) ([:;?!])", NBSP + r"\1", text)
+    text = re.sub(r"(?<=[\d}]) %", NBSP + "%", text)
+    return text
+
+
+def write(lang, values):
+    assert len(values) == len(EN), (lang, len(values), len(EN))
+    for source, text in zip(EN, values):
+        assert sorted(re.findall(r"\{\d+\}", source)) == sorted(re.findall(r"\{\d+\}", text)), (lang, source, text)
+    if lang == "fr":
+        values = [french(v) for v in values]
+    data = {f"gh{i + 1:02d}": text for i, text in enumerate(values)}
+    (here / f"gh-{lang}.json").write_text(json.dumps(data, ensure_ascii=False, indent=1) + "\n", encoding="utf-8")
+
+
+write("en", EN)
+for lang, values in T.items():
+    write(lang, values)
+print("written", len(EN), "strings in", len(T) + 1, "languages")

apps/host/scripts/make-gui-locales.py

@@ -0,0 +1,60 @@
+"""Writes src/locales/gui-<lang>.json: the strings of the GUI feedback round 2 (branch f-0291-gui-fb2): the new name and hint of the "Leave room for my work"
+choice (it keeps 5-8 GB of memory free; it was "Leave 20% for my work"), the memory-error sentence that names it, and the words of the compact files block
+("Delivered to", "Working folder", "{0} files").
+Run from apps/host:  python scripts/make-gui-locales.py
+Every entry names all nine languages; the keys are gf01.. in the order of S. gui-en.json is the English source. Placeholders ({0}) must be kept in every language.
+A separate file keeps this work from colliding with the other catalogs (the same reason pick-, tune-, tools-, fix-, gh-, ui-, engine- and df2- exist)."""
+import json
+import re
+from pathlib import Path
+
+LANGS = ["en", "zh", "ja", "de", "es", "ru", "pt", "ko", "fr"]
+S = []
+
+
+def add(en, zh, ja, de, es, ru, pt, ko, fr):
+    S.append(dict(en=en, zh=zh, ja=ja, de=de, es=es, ru=ru, pt=pt, ko=ko, fr=fr))
+
+
+add("Leave room for my work",
+    "为我的工作留出空间", "作業用の余裕を残す", "Platz für meine Arbeit lassen", "Dejar espacio para mi trabajo",
+    "Оставить запас для моей работы", "Deixar espaço para o meu trabalho", "내 작업을 위한 여유 남기기", "Garder de la place pour mon travail")
+add("Keeps 5-8 GB of memory free for other programs.",
+    "为其他程序保留 5-8 GB 空闲内存。", "他のプログラム用に 5～8 GB のメモリを空けておきます。", "Hält 5-8 GB Arbeitsspeicher für andere Programme frei.",
+    "Mantiene libres 5-8 GB de memoria para otros programas.", "Оставляет 5-8 ГБ памяти свободными для других программ.",
+    "Mantém 5-8 GB de memória livres para outros programas.", "다른 프로그램을 위해 메모리 5-8 GB를 비워 둡니다.", "Garde 5-8 Go de mémoire libres pour les autres programmes.")
+add("Close other programs and try again, or choose “Leave room for my work”. In Expert mode you can also turn on the low-RAM option, so part of the model is read from the SSD.",
+    "请关闭其他程序后重试，或选择“为我的工作留出空间”。在专家模式下，你还可以开启低内存选项，让部分模型从 SSD 读取。",
+    "他のプログラムを閉じてもう一度試すか、「作業用の余裕を残す」を選んでください。エキスパートモードでは低 RAM オプションをオンにして、モデルの一部を SSD から読み込むこともできます。",
+    "Schließen Sie andere Programme und versuchen Sie es erneut, oder wählen Sie „Platz für meine Arbeit lassen“. Im Expertenmodus können Sie außerdem die Option für wenig Arbeitsspeicher aktivieren, sodass ein Teil des Modells von der SSD gelesen wird.",
+    "Cierre otros programas e inténtelo de nuevo, o elija «Dejar espacio para mi trabajo». En el modo experto también puede activar la opción de poca RAM, para que una parte del modelo se lea desde el SSD.",
+    "Закройте другие программы и повторите попытку или выберите «Оставить запас для моей работы». В экспертном режиме можно также включить режим малого объёма ОЗУ, и часть модели будет читаться с SSD.",
+    "Feche outros programas e tente novamente, ou escolha “Deixar espaço para o meu trabalho”. No modo especialista, você também pode ativar a opção de pouca RAM, para que parte do modelo seja lida do SSD.",
+    "다른 프로그램을 닫고 다시 시도하거나 “내 작업을 위한 여유 남기기”를 선택하세요. 전문가 모드에서는 저RAM 옵션을 켜서 모델의 일부를 SSD에서 읽게 할 수도 있습니다.",
+    "Fermez les autres programmes et réessayez, ou choisissez « Garder de la place pour mon travail ». En mode expert, vous pouvez aussi activer l'option de faible RAM : une partie du modèle est alors lue depuis le SSD.")
+add("Delivered to",
+    "已交付到", "保存先", "Geliefert nach", "Entregado en", "Результат в", "Entregue em", "전달 위치", "Livré dans")
+add("Working folder",
+    "工作文件夹", "作業フォルダー", "Arbeitsordner", "Carpeta de trabajo", "Рабочая папка", "Pasta de trabalho", "작업 폴더", "Dossier de travail")
+add("{0} files",
+    "{0} 个文件", "{0} 個のファイル", "{0} Dateien", "{0} archivos", "Файлов: {0}", "{0} arquivos", "파일 {0}개", "{0} fichiers")
+here = Path(__file__).resolve().parent.parent / "src" / "locales"
+NBSP = " "
+
+
+def french(text):
+    text = re.sub(r"(?<=[A-Za-zÀ-ſ])'(?=[A-Za-zÀ-ſ{])", "’", text)
+    text = re.sub(r"(?<=\S) ([:;?!])", NBSP + r"\1", text)
+    text = re.sub(r"(?<=[\d}]) %", NBSP + "%", text)
+    return text
+
+
+for lang in LANGS:
+    data = {}
+    for i, entry in enumerate(S):
+        text = entry[lang]
+        assert sorted(re.findall(r"\{\d+\}", entry["en"])) == sorted(re.findall(r"\{\d+\}", text)), (lang, entry["en"], text)
+        data[f"gf{i + 1:02d}"] = french(text) if lang == "fr" else text
+    with (here / f"gui-{lang}.json").open("w", encoding="utf-8", newline="\n") as handle:
+        handle.write(json.dumps(data, ensure_ascii=False, indent=1) + "\n")
+print("written", len(S), "strings in", len(LANGS), "languages")

apps/host/scripts/make-pick-locales.py

@@ -0,0 +1,75 @@
+"""Writes src/locales/pick-<lang>.json: the strings of the model version list (VersionPicker), the code-block preview button and the This computer panel (branch f-0291-ui-fixes2).
+Run from apps/host:  python scripts/make-pick-locales.py
+Every entry names all nine languages; the keys are vp01.. in the order of S. pick-en.json is the English source. Placeholders ({0}, {1}) must be kept
+in every language. A separate file keeps this work from colliding with the other catalogs (the same reason tune-, tools-, fix-, gh-, ui- and engine- exist)."""
+import json
+import re
+from pathlib import Path
+
+LANGS = ["en", "zh", "ja", "de", "es", "ru", "pt", "ko", "fr"]
+S = []
+
+
+def add(en, zh, ja, de, es, ru, pt, ko, fr):
+    S.append(dict(en=en, zh=zh, ja=ja, de=de, es=es, ru=ru, pt=pt, ko=ko, fr=fr))
+
+
+add("{0} download",
+    "下载 {0}", "ダウンロード {0}", "{0} Download", "Descarga de {0}", "Загрузка {0}", "Download de {0}", "다운로드 {0}", "Téléchargement de {0}")
+add("Needs {0} of memory",
+    "需要 {0} 内存", "{0} のメモリーが必要", "Braucht {0} Speicher", "Necesita {0} de memoria", "Нужно {0} памяти", "Precisa de {0} de memória", "메모리 {0} 필요", "Nécessite {0} de mémoire")
+add("Needs {0} of memory and about {1} GB of disk",
+    "需要 {0} 内存和约 {1} GB 磁盘空间", "{0} のメモリーと約 {1} GB のディスク容量が必要", "Braucht {0} Speicher und etwa {1} GB Festplattenplatz", "Necesita {0} de memoria y unos {1} GB de disco",
+    "Нужно {0} памяти и около {1} ГБ на диске", "Precisa de {0} de memória e cerca de {1} GB de disco", "메모리 {0}와 디스크 약 {1} GB 필요", "Nécessite {0} de mémoire et environ {1} Go de disque")
+add("Fits",
+    "可以运行", "問題なく動きます", "Passt", "Cabe", "Помещается", "Cabe", "문제없이 실행됩니다", "Tient")
+add("Fits with SSD streaming",
+    "可以运行，部分内容从 SSD 读取", "SSD から読み込みながら動きます", "Passt mit SSD-Streaming", "Cabe con streaming desde el SSD", "Помещается с потоковой подгрузкой с SSD", "Cabe com streaming do SSD", "SSD 스트리밍으로 실행됩니다", "Tient avec streaming depuis le SSD")
+add("Doesn't fit",
+    "放不下", "収まりません", "Passt nicht", "No cabe", "Не помещается", "Não cabe", "맞지 않습니다", "Ne tient pas")
+add("Show details",
+    "显示详情", "詳細を表示", "Details anzeigen", "Mostrar detalles", "Показать подробности", "Mostrar detalhes", "자세히 보기", "Afficher les détails")
+add("Hide details",
+    "隐藏详情", "詳細を隠す", "Details ausblenden", "Ocultar detalles", "Скрыть подробности", "Ocultar detalhes", "자세히 숨기기", "Masquer les détails")
+add("{0} RAM + VRAM",
+    "{0} 内存 + 显存", "{0} の RAM + VRAM", "{0} RAM + VRAM", "{0} de RAM + VRAM", "{0} RAM + VRAM", "{0} de RAM + VRAM", "RAM + VRAM {0}", "{0} de RAM + VRAM")
+
+add("Close preview",
+    "关闭预览", "プレビューを閉じる", "Vorschau schließen", "Cerrar vista previa", "Закрыть предпросмотр", "Fechar pré-visualização", "미리보기 닫기", "Fermer l'aperçu")
+
+add("Free right now",
+    "当前可用", "現在の空き", "Gerade frei", "Libre ahora", "Свободно сейчас", "Livre agora", "지금 비어 있음", "Libre en ce moment")
+add("{0} free",
+    "可用 {0}", "空き {0}", "{0} frei", "{0} libres", "свободно {0}", "{0} livres", "{0} 사용 가능", "{0} libres")
+add("{0}: {1} free of {2}",
+    "{0}：{2} 中有 {1} 可用", "{0}：{2} のうち {1} が空き", "{0}: {1} frei von {2}", "{0}: {1} libres de {2}", "{0}: свободно {1} из {2}", "{0}: {1} livres de {2}", "{0}: {2} 중 {1} 사용 가능", "{0} : {1} libres sur {2}")
+add("It takes about",
+    "它大约占用", "使用量の目安", "Es belegt etwa", "Ocupa aproximadamente", "Занимает примерно", "Ocupa cerca de", "대략 사용하는 양", "Il occupe environ")
+add("Nothing. It fits in memory.",
+    "没有。它完全放得进内存。", "ありません。すべてメモリーに収まっています。", "Nichts. Es passt in den Speicher.", "Nada. Cabe en la memoria.", "Ничего. Всё помещается в память.", "Nada. Cabe na memória.", "없음. 메모리에 모두 들어갑니다.", "Rien. Tout tient en mémoire.")
+add("Reading from your SSD now: {0}",
+    "此刻正从 SSD 读取：{0}", "現在 SSD から読み込み中：{0}", "Gerade vom SSD gelesen: {0}", "Leyendo del SSD ahora: {0}", "Сейчас читается с SSD: {0}", "Lendo do SSD agora: {0}", "지금 SSD에서 읽는 중: {0}", "Lecture depuis le SSD en cours : {0}")
+add("This version would take about {0} of graphics memory and {1} of RAM.",
+    "这个版本大约会占用 {0} 显存和 {1} 内存。", "このバージョンはグラフィックスメモリーを約 {0}、RAM を約 {1} 使います。", "Diese Version würde etwa {0} Grafikspeicher und {1} RAM belegen.",
+    "Esta versión ocuparía aproximadamente {0} de memoria gráfica y {1} de RAM.", "Эта версия займёт примерно {0} видеопамяти и {1} оперативной памяти.", "Esta versão ocuparia cerca de {0} de memória gráfica e {1} de RAM.",
+    "이 버전은 그래픽 메모리 약 {0}와 RAM 약 {1}을 사용합니다.", "Cette version occuperait environ {0} de mémoire graphique et {1} de RAM.")
+
+here = Path(__file__).resolve().parent.parent / "src" / "locales"
+NBSP = " "
+
+
+def french(text):
+    text = re.sub(r"(?<=[A-Za-zÀ-ſ])'(?=[A-Za-zÀ-ſ{])", "’", text)
+    text = re.sub(r"(?<=\S) ([:;?!])", NBSP + r"\1", text)
+    text = re.sub(r"(?<=[\d}]) %", NBSP + "%", text)
+    return text
+
+
+for lang in LANGS:
+    data = {}
+    for i, entry in enumerate(S):
+        text = entry[lang]
+        assert sorted(re.findall(r"\{\d+\}", entry["en"])) == sorted(re.findall(r"\{\d+\}", text)), (lang, entry["en"], text)
+        data[f"vp{i + 1:02d}"] = french(text) if lang == "fr" else text
+    (here / f"pick-{lang}.json").write_text(json.dumps(data, ensure_ascii=False, indent=1) + "\n", encoding="utf-8")
+print("written", len(S), "strings in", len(LANGS), "languages")

apps/host/scripts/make-r3-locales.py

@@ -0,0 +1,67 @@
+"""Writes src/locales/r3-<lang>.json: the strings added by the owner's GUI feedback round 3 (branch f-0291-ui-r3).
+Run from apps/host:  python scripts/make-r3-locales.py
+Every entry names all nine languages; the keys are r3_01.. in the order of S. r3-en.json is the English source. Placeholders ({0}, {1}) must be kept in every
+language. A separate file keeps this work from colliding with the other catalogs (the same reason pick-, upd-, df2- and the others exist)."""
+import json
+import re
+from pathlib import Path
+
+LANGS = ["en", "zh", "ja", "de", "es", "ru", "pt", "ko", "fr"]
+S = []
+
+
+def add(en, zh, ja, de, es, ru, pt, ko, fr):
+    S.append(dict(en=en, zh=zh, ja=ja, de=de, es=es, ru=ru, pt=pt, ko=ko, fr=fr))
+
+
+# 2: the Read pictures row while the installed engine has no picture reader (a tooltip, not a paragraph)
+add("Needs an engine update",
+    "需要更新引擎", "エンジンの更新が必要です", "Braucht ein Engine-Update", "Necesita actualizar el motor", "Нужно обновить движок", "Precisa de uma atualização do motor", "엔진 업데이트가 필요합니다", "Nécessite une mise à jour du moteur")
+
+# 5: the one word the version list writes for a version that does not fully fit in memory
+add("SSD streaming · will run slower",
+    "SSD 流式读取 · 运行会更慢", "SSD ストリーミング · 動作は遅くなります", "SSD-Streaming · läuft langsamer", "Streaming desde el SSD · irá más lento", "Потоковая подгрузка с SSD · будет работать медленнее",
+    "Streaming do SSD · vai rodar mais devagar", "SSD 스트리밍 · 더 느리게 실행됩니다", "Streaming depuis le SSD · plus lent")
+
+# 6: the warning under the conversation context when a long context leaves little graphics memory for the model (nothing is refused or lowered)
+add("This much context takes about {0} GB of graphics memory and leaves little room for the model on this card. Strata will try it; if it does not start, choose a shorter context.",
+    "这么长的上下文大约占用 {0} GB 显存，留给模型的空间很少。Strata 会尝试运行；如果无法启动，请选择更短的上下文。",
+    "このコンテキストはグラフィックスメモリーを約 {0} GB 使い、このカードではモデルに残る余裕がわずかです。Strata は試しますが、起動しない場合はより短いコンテキストを選んでください。",
+    "So viel Kontext belegt etwa {0} GB Grafikspeicher und lässt auf dieser Karte wenig Platz für das Modell. Strata versucht es; startet es nicht, wähle einen kürzeren Kontext.",
+    "Este contexto ocupa unos {0} GB de memoria gráfica y deja poco espacio para el modelo en esta tarjeta. Strata lo intentará; si no arranca, elige un contexto más corto.",
+    "Такой контекст занимает около {0} ГБ видеопамяти и оставляет модели мало места на этой карте. Strata попробует запустить; если не получится, выберите контекст короче.",
+    "Esse contexto ocupa cerca de {0} GB de memória gráfica e deixa pouco espaço para o modelo nesta placa. O Strata vai tentar; se não iniciar, escolha um contexto menor.",
+    "이 정도의 컨텍스트는 그래픽 메모리를 약 {0} GB 사용하며 이 카드에서는 모델이 쓸 공간이 거의 남지 않습니다. Strata가 시도하지만 시작되지 않으면 더 짧은 컨텍스트를 선택하세요.",
+    "Ce contexte occupe environ {0} Go de mémoire graphique et laisse peu de place au modèle sur cette carte. Strata va essayer ; s'il ne démarre pas, choisissez un contexte plus court.")
+
+# 9: a chat that is working while the person is elsewhere (the ring on its row, and the model chip's line)
+add("Working · {0}",
+    "进行中 · {0}", "作業中 · {0}", "In Arbeit · {0}", "Trabajando · {0}", "В работе · {0}", "Trabalhando · {0}", "작업 중 · {0}", "En cours de travail · {0}")
+add("{0} chats working",
+    "{0} 个对话进行中", "{0} 件のチャットが作業中", "{0} Chats in Arbeit", "{0} chats trabajando", "В работе чатов: {0}", "{0} chats trabalhando", "대화 {0}개 작업 중", "{0} conversations en cours")
+
+# 10: the size line of a file being written
+add("{0} lines",
+    "{0} 行", "{0} 行", "{0} Zeilen", "{0} líneas", "{0} строк", "{0} linhas", "{0}줄", "{0} lignes")
+
+#@@MORE@@
+
+here = Path(__file__).resolve().parent.parent / "src" / "locales"
+NBSP = " "
+
+
+def french(text):
+    text = re.sub(r"(?<=[A-Za-zÀ-ſ])'(?=[A-Za-zÀ-ſ{])", "’", text)
+    text = re.sub(r"(?<=\S) ([:;?!])", NBSP + r"\1", text)
+    text = re.sub(r"(?<=[\d}]) %", NBSP + "%", text)
+    return text
+
+
+for lang in LANGS:
+    data = {}
+    for i, entry in enumerate(S):
+        text = entry[lang]
+        assert sorted(re.findall(r"\{\d+\}", entry["en"])) == sorted(re.findall(r"\{\d+\}", text)), (lang, entry["en"], text)
+        data[f"r3_{i + 1:02d}"] = french(text) if lang == "fr" else text
+    (here / f"r3-{lang}.json").write_text(json.dumps(data, ensure_ascii=False, indent=1) + "\n", encoding="utf-8")
+print("written", len(S), "strings in", len(LANGS), "languages")

apps/host/scripts/make-ui-locales.py

@@ -0,0 +1,249 @@
+"""Writes src/locales/ui-<lang>.json: the interface strings of the 0.2.10 interface changes (branch f-0291-ui).
+Run from apps/host:  python scripts/make-ui-locales.py
+Every entry names all nine languages; the keys are ui01.. in the order of S. ui-en.json is the English source. Placeholders ({0}, {1}) must be
+kept in every language. A separate file keeps this work from colliding with the other catalogs (the same reason tune-, tools-, fix- and gh- exist)."""
+import json
+import re
+from pathlib import Path
+
+LANGS = ["en", "zh", "ja", "de", "es", "ru", "pt", "ko", "fr"]
+S = []
+
+
+def add(**kw):
+    assert sorted(kw) == sorted(LANGS), sorted(set(LANGS) ^ set(kw))
+    S.append(kw)
+
+
+# #4725 the approval stays in view
+add(en="Waiting for your answer",
+    zh="等待你的回答", ja="あなたの返答を待っています", de="Wartet auf deine Antwort", es="Esperando tu respuesta",
+    ru="Ждёт вашего ответа", pt="Aguardando a sua resposta", ko="답변을 기다리는 중", fr="En attente de votre réponse")
+add(en="Waiting for your answer below",
+    zh="等待你在下方回答", ja="下で返答をお待ちしています", de="Wartet unten auf deine Antwort", es="Esperando tu respuesta abajo",
+    ru="Ждёт вашего ответа ниже", pt="Aguardando a sua resposta abaixo", ko="아래에서 답변을 기다리는 중", fr="En attente de votre réponse ci-dessous")
+
+# #4804 why Start tuning is greyed out
+add(en="Strata is still checking this model for saved tunings. Start tuning works as soon as that is done.",
+    zh="Strata 仍在检查此模型是否有已保存的调优。检查完成后即可开始调优。",
+    ja="Strata がこのモデルの保存済みチューニングを確認しています。確認が終わりしだい、チューニングを開始できます。",
+    de="Strata prüft dieses Modell noch auf gespeicherte Abstimmungen. Sobald das fertig ist, kannst du die Abstimmung starten.",
+    es="Strata todavía está comprobando si este modelo tiene ajustes guardados. Podrás empezar el ajuste en cuanto termine.",
+    ru="Strata ещё проверяет, есть ли у этой модели сохранённые настройки. Как только проверка закончится, можно будет запустить настройку.",
+    pt="O Strata ainda está verificando se este modelo tem ajustes salvos. Assim que terminar, você poderá iniciar o ajuste.",
+    ko="Strata가 이 모델의 저장된 최적화를 확인하는 중입니다. 확인이 끝나면 바로 최적화를 시작할 수 있습니다.",
+    fr="Strata vérifie encore si ce modèle a des optimisations enregistrées. Dès que c’est fini, vous pourrez lancer l’optimisation.")
+add(en="Strata could not read the tuning details for this model, so tuning cannot start. Close this window and open it again.",
+    zh="Strata 无法读取此模型的调优信息，因此无法开始调优。请关闭此窗口后重新打开。",
+    ja="Strata がこのモデルのチューニング情報を読み取れなかったため、チューニングを開始できません。このウィンドウを閉じて、もう一度開いてください。",
+    de="Strata konnte die Abstimmungsdaten dieses Modells nicht lesen, deshalb lässt sich die Abstimmung nicht starten. Schließe dieses Fenster und öffne es erneut.",
+    es="Strata no pudo leer los datos de ajuste de este modelo, así que el ajuste no puede empezar. Cierra esta ventana y ábrela de nuevo.",
+    ru="Strata не смогла прочитать данные настройки этой модели, поэтому настройку нельзя запустить. Закройте это окно и откройте его снова.",
+    pt="O Strata não conseguiu ler os dados de ajuste deste modelo, então o ajuste não pode começar. Feche esta janela e abra-a novamente.",
+    ko="Strata가 이 모델의 최적화 정보를 읽지 못해 최적화를 시작할 수 없습니다. 이 창을 닫았다가 다시 여세요.",
+    fr="Strata n’a pas pu lire les données d’optimisation de ce modèle, l’optimisation ne peut donc pas démarrer. Fermez cette fenêtre et rouvrez-la.")
+add(en="Checking for saved tunings\u2026",
+    zh="正在检查已保存的调优\u2026", ja="保存済みチューニングを確認しています\u2026", de="Gespeicherte Abstimmungen werden geprüft\u2026", es="Comprobando los ajustes guardados\u2026",
+    ru="Проверяем сохранённые настройки\u2026", pt="Verificando os ajustes salvos\u2026", ko="저장된 최적화를 확인하는 중\u2026", fr="Vérification des optimisations enregistrées\u2026")
+
+# #4802 the progress card
+add(en="Still working for {0}. You don't need to do anything.",
+    zh="仍在处理，已用时 {0}。你无需做任何操作。",
+    ja="処理中です（{0}経過）。操作は必要ありません。",
+    de="Läuft noch seit {0}. Du musst nichts tun.",
+    es="Sigue trabajando desde hace {0}. No tienes que hacer nada.",
+    ru="Всё ещё работает: {0}. От вас ничего не требуется.",
+    pt="Ainda trabalhando há {0}. Você não precisa fazer nada.",
+    ko="{0}째 작업 중입니다. 따로 할 일은 없습니다.",
+    fr="Toujours en cours depuis {0}. Vous n'avez rien à faire.")
+add(en="The buttons below wait until this finishes.",
+    zh="下方的按钮会在此操作完成后恢复可用。",
+    ja="この処理が終わるまで、下のボタンは使えません。",
+    de="Die Schaltflächen unten warten, bis das fertig ist.",
+    es="Los botones de abajo esperan a que esto termine.",
+    ru="Кнопки ниже подождут, пока это не закончится.",
+    pt="Os botões abaixo esperam até isto terminar.",
+    ko="아래 버튼은 이 작업이 끝날 때까지 기다립니다.",
+    fr="Les boutons ci-dessous attendent la fin de cette opération.")
+
+# #4798 two addresses
+add(en="API base URL on this computer",
+    zh="此电脑上的 API 基础地址", ja="このパソコンでの API ベース URL", de="API-Basis-URL auf diesem Computer", es="URL base de la API en este equipo",
+    ru="Базовый URL API на этом компьютере", pt="URL base da API neste computador", ko="이 컴퓨터의 API 기본 URL", fr="URL de base de l'API sur cet ordinateur")
+add(en="Address for other devices",
+    zh="其他设备使用的地址", ja="他のデバイス用のアドレス", de="Adresse für andere Geräte", es="Dirección para otros dispositivos",
+    ru="Адрес для других устройств", pt="Endereço para outros dispositivos", ko="다른 기기용 주소", fr="Adresse pour les autres appareils")
+add(en="Other devices use this address. It has its own port, separate from the one Strata's window uses, because only the model's API is shared on the network, not the app.",
+    zh="其他设备使用此地址。它有自己的端口，与 Strata 窗口使用的端口分开，因为网络上只共享模型的 API，而不是应用本身。",
+    ja="他のデバイスはこのアドレスを使います。ネットワークで共有されるのはモデルの API だけでアプリ本体ではないため、Strata のウィンドウが使うポートとは別のポートを使います。",
+    de="Andere Geräte verwenden diese Adresse. Sie hat einen eigenen Port, getrennt von dem des Strata-Fensters, weil im Netzwerk nur die API des Modells freigegeben wird, nicht die App.",
+    es="Los demás dispositivos usan esta dirección. Tiene su propio puerto, distinto del que usa la ventana de Strata, porque en la red solo se comparte la API del modelo, no la aplicación.",
+    ru="Другие устройства используют этот адрес. У него свой порт, отдельный от порта окна Strata, потому что в сети доступен только API модели, а не само приложение.",
+    pt="Os outros dispositivos usam este endereço. Ele tem a própria porta, separada da que a janela do Strata usa, porque só a API do modelo é compartilhada na rede, não o aplicativo.",
+    ko="다른 기기는 이 주소를 사용합니다. 네트워크에는 앱이 아니라 모델의 API만 공유되므로, Strata 창이 쓰는 포트와는 별도의 포트를 씁니다.",
+    fr="Les autres appareils utilisent cette adresse. Elle a son propre port, distinct de celui de la fenêtre de Strata, car seule l'API du modèle est partagée sur le réseau, pas l'application.")
+
+# #3723 Context memory and the out-of-graphics-memory reason
+add(en="INT8 is the standard: good quality and a medium amount of memory.",
+    zh="INT8 是标准选项：质量好，内存占用适中。",
+    ja="INT8 は標準の設定です。品質が良く、メモリ使用量は中程度です。",
+    de="INT8 ist der Standard: gute Qualität und mittlerer Speicherbedarf.",
+    es="INT8 es el estándar: buena calidad y un uso de memoria medio.",
+    ru="INT8 — стандартный вариант: хорошее качество и средний расход памяти.",
+    pt="INT8 é o padrão: boa qualidade e uso médio de memória.",
+    ko="INT8은 표준 설정입니다. 품질이 좋고 메모리 사용량은 보통입니다.",
+    fr="INT8 est le réglage standard : bonne qualité et une consommation de mémoire moyenne.")
+add(en="Q4 uses about half the memory of INT8, but is less precise on very long documents.",
+    zh="Q4 占用的内存约为 INT8 的一半，但在很长的文档上精度较低。",
+    ja="Q4 は INT8 の約半分のメモリで済みますが、非常に長い文書では精度が少し下がります。",
+    de="Q4 braucht etwa halb so viel Speicher wie INT8, ist aber bei sehr langen Dokumenten weniger genau.",
+    es="Q4 usa aproximadamente la mitad de memoria que INT8, pero es menos preciso con documentos muy largos.",
+    ru="Q4 занимает примерно вдвое меньше памяти, чем INT8, но менее точен на очень длинных документах.",
+    pt="Q4 usa cerca de metade da memória do INT8, mas é menos preciso em documentos muito longos.",
+    ko="Q4는 INT8의 약 절반 메모리를 쓰지만, 아주 긴 문서에서는 정밀도가 떨어집니다.",
+    fr="Q4 utilise environ moitié moins de mémoire que INT8, mais il est moins précis sur de très longs documents.")
+add(en="K8 / V4 uses about a quarter less memory than INT8 and is more precise than Q4. Prompts are 2 to 5% slower.",
+    zh="K8 / V4 比 INT8 约少占用四分之一的内存，精度高于 Q4。处理提示词会慢 2% 到 5%。",
+    ja="K8 / V4 は INT8 より約4分の1少ないメモリで済み、Q4 より精度が高い設定です。プロンプトの処理は 2〜5% 遅くなります。",
+    de="K8 / V4 braucht etwa ein Viertel weniger Speicher als INT8 und ist genauer als Q4. Prompts sind 2 bis 5 % langsamer.",
+    es="K8 / V4 usa aproximadamente una cuarta parte menos de memoria que INT8 y es más preciso que Q4. Los prompts son entre un 2 y un 5 % más lentos.",
+    ru="K8 / V4 занимает примерно на четверть меньше памяти, чем INT8, и точнее, чем Q4. Запросы обрабатываются на 2–5 % медленнее.",
+    pt="K8 / V4 usa cerca de um quarto a menos de memória que o INT8 e é mais preciso que o Q4. Os prompts ficam de 2 a 5 % mais lentos.",
+    ko="K8 / V4는 INT8보다 메모리를 약 4분의 1 적게 쓰고 Q4보다 정밀합니다. 프롬프트 처리는 2~5% 느려집니다.",
+    fr="K8 / V4 utilise environ un quart de mémoire en moins que INT8 et est plus précis que Q4. Les prompts sont 2 à 5 % plus lents.")
+add(en="The model did not fit in your graphics card’s memory.",
+    zh="模型放不进你的显卡显存。",
+    ja="モデルがグラフィックスカードのメモリに収まりませんでした。",
+    de="Das Modell hat nicht in den Speicher deiner Grafikkarte gepasst.",
+    es="El modelo no cabía en la memoria de tu tarjeta gráfica.",
+    ru="Модель не поместилась в память вашей видеокарты.",
+    pt="O modelo não coube na memória da sua placa de vídeo.",
+    ko="모델이 그래픽 카드 메모리에 들어가지 않았습니다.",
+    fr="Le modèle ne tenait pas dans la mémoire de votre carte graphique.")
+add(en="Lower the conversation context, or set Context memory to Q4 in Expert settings, then try again.",
+    zh="请调低对话上下文，或在专家设置中把“上下文内存”设为 Q4，然后重试。",
+    ja="会話のコンテキストを小さくするか、上級設定で「コンテキストメモリー」を Q4 にして、もう一度お試しください。",
+    de="Verkleinere den Gesprächskontext oder stelle in den Experteneinstellungen „Kontextspeicher“ auf Q4 und versuche es erneut.",
+    es="Reduce el contexto de la conversación o pon «Memoria de contexto» en Q4 en Ajustes expertos, y vuelve a intentarlo.",
+    ru="Уменьшите контекст разговора или установите «Память контекста» в Q4 в разделе «Экспертные настройки» и повторите попытку.",
+    pt="Reduza o contexto da conversa ou defina «Memória de contexto» como Q4 em Configurações avançadas e tente de novo.",
+    ko="대화 컨텍스트를 줄이거나 전문가 설정에서 ‘컨텍스트 메모리’를 Q4로 바꾼 뒤 다시 시도하세요.",
+    fr="Réduisez le contexte de la conversation, ou réglez « Mémoire de contexte » sur Q4 dans Réglages experts, puis réessayez.")
+
+# #4749 a message for a helper
+add(en="Message this helper",
+    zh="给这个助手发消息", ja="このヘルパーにメッセージを送る", de="Diesem Helfer schreiben", es="Escribir a este ayudante",
+    ru="Написать этому помощнику", pt="Enviar mensagem a este ajudante", ko="이 도우미에게 메시지 보내기", fr="Écrire à cet assistant")
+add(en="Message to {0}",
+    zh="发给 {0} 的消息", ja="{0} へのメッセージ", de="Nachricht an {0}", es="Mensaje para {0}",
+    ru="Сообщение для {0}", pt="Mensagem para {0}", ko="{0}에게 보낼 메시지", fr="Message pour {0}")
+add(en="Write to {0}\u2026",
+    zh="写给 {0}\u2026", ja="{0} に書く\u2026", de="An {0} schreiben\u2026", es="Escribe a {0}\u2026",
+    ru="Напишите {0}\u2026", pt="Escreva para {0}\u2026", ko="{0}에게 쓰기\u2026", fr="Écrire à {0}\u2026")
+add(en="Sent to {0}.",
+    zh="已发给 {0}。", ja="{0} に送りました。", de="An {0} gesendet.", es="Enviado a {0}.",
+    ru="Отправлено: {0}.", pt="Enviado para {0}.", ko="{0}에게 보냈습니다.", fr="Envoyé à {0}.")
+
+# #4783 a message while an answer is being written
+add(en="While an answer is being written",
+    zh="回答生成期间", ja="回答の作成中", de="Während eine Antwort geschrieben wird", es="Mientras se escribe una respuesta",
+    ru="Пока пишется ответ", pt="Enquanto uma resposta é escrita", ko="답변을 작성하는 동안", fr="Pendant qu'une réponse s'écrit")
+add(en="What Enter does when you send a message while the assistant is still answering.",
+    zh="助手仍在回答时，你发送消息后按回车会发生什么。", ja="アシスタントがまだ回答している間にメッセージを送ったとき、Enter で何が起こるかを選びます。",
+    de="Was die Eingabetaste bewirkt, wenn du eine Nachricht sendest, während der Assistent noch antwortet.",
+    es="Qué hace Intro cuando envías un mensaje mientras el asistente todavía está respondiendo.",
+    ru="Что делает Enter, когда вы отправляете сообщение, пока ассистент ещё отвечает.",
+    pt="O que o Enter faz quando você envia uma mensagem enquanto o assistente ainda está respondendo.",
+    ko="어시스턴트가 아직 답하는 중에 메시지를 보낼 때 Enter가 하는 일입니다.",
+    fr="Ce que fait Entrée quand vous envoyez un message pendant que l'assistant répond encore.")
+add(en="Wait for the answer",
+    zh="等回答完成", ja="回答が終わるまで待つ", de="Auf die Antwort warten", es="Esperar la respuesta",
+    ru="Дождаться ответа", pt="Esperar a resposta", ko="답변이 끝날 때까지 기다리기", fr="Attendre la réponse")
+add(en="Send after the answer",
+    zh="回答完成后再发送", ja="回答が終わってから送る", de="Nach der Antwort senden", es="Enviar después de la respuesta",
+    ru="Отправить после ответа", pt="Enviar depois da resposta", ko="답변이 끝난 뒤 보내기", fr="Envoyer après la réponse")
+add(en="Interrupt the answer",
+    zh="打断回答", ja="回答を中断する", de="Die Antwort unterbrechen", es="Interrumpir la respuesta",
+    ru="Прервать ответ", pt="Interromper a resposta", ko="답변 중단하기", fr="Interrompre la réponse")
+add(en="Enter sends it when the answer is done.",
+    zh="回答完成后，按回车即可发送。", ja="回答が終わったら Enter で送信されます。", de="Die Eingabetaste sendet sie, sobald die Antwort fertig ist.",
+    es="Intro lo envía cuando termina la respuesta.", ru="Enter отправит сообщение, когда ответ закончится.",
+    pt="O Enter envia quando a resposta terminar.", ko="답변이 끝나면 Enter로 보냅니다.", fr="Entrée l'envoie quand la réponse est terminée.")
+add(en="Enter stops the answer here and sends it now.",
+    zh="按回车会在此处停止回答并立即发送。", ja="Enter で回答をここで止めて、すぐに送信します。", de="Die Eingabetaste stoppt die Antwort hier und sendet die Nachricht sofort.",
+    es="Intro detiene la respuesta aquí y lo envía ahora.", ru="Enter остановит ответ здесь и сразу отправит сообщение.",
+    pt="O Enter para a resposta aqui e envia agora.", ko="Enter를 누르면 여기서 답변을 멈추고 바로 보냅니다.", fr="Entrée arrête la réponse ici et l'envoie tout de suite.")
+add(en="Waiting to send",
+    zh="等待发送", ja="送信待ち", de="Wartet auf das Senden", es="Esperando para enviar",
+    ru="Ждёт отправки", pt="Aguardando envio", ko="보내기 대기 중", fr="En attente d'envoi")
+add(en="Take back",
+    zh="撤回", ja="取り消す", de="Zurücknehmen", es="Retirar",
+    ru="Забрать обратно", pt="Desfazer", ko="되돌리기", fr="Reprendre")
+
+# #4785 quoting
+add(en="Quote",
+    zh="引用", ja="引用", de="Zitieren", es="Citar",
+    ru="Цитировать", pt="Citar", ko="인용", fr="Citer")
+add(en="Quoting the assistant",
+    zh="引用助手的话", ja="アシスタントの発言を引用", de="Zitat des Assistenten", es="Citando al asistente",
+    ru="Цитата ассистента", pt="Citando o assistente", ko="어시스턴트의 말을 인용", fr="Citation de l'assistant")
+add(en="Quoting you",
+    zh="引用你的话", ja="あなたの発言を引用", de="Zitat von dir", es="Citándote a ti",
+    ru="Ваша цитата", pt="Citando você", ko="내 말을 인용", fr="Citation de vous")
+add(en="Remove this quote",
+    zh="移除这条引用", ja="この引用を外す", de="Dieses Zitat entfernen", es="Quitar esta cita",
+    ru="Убрать эту цитату", pt="Remover esta citação", ko="이 인용 제거", fr="Retirer cette citation")
+add(en="Go to the quoted message",
+    zh="跳到被引用的消息", ja="引用元のメッセージへ移動", de="Zur zitierten Nachricht springen", es="Ir al mensaje citado",
+    ru="Перейти к цитируемому сообщению", pt="Ir para a mensagem citada", ko="인용한 메시지로 이동", fr="Aller au message cité")
+add(en="Quoted",
+    zh="引用", ja="引用", de="Zitiert", es="Citado",
+    ru="Цитата", pt="Citado", ko="인용됨", fr="Cité")
+add(en="Show or hide the rest of the quote",
+    zh="显示或隐藏引用的其余部分", ja="引用の続きを表示または非表示", de="Rest des Zitats ein- oder ausblenden", es="Mostrar u ocultar el resto de la cita",
+    ru="Показать или скрыть остальную часть цитаты", pt="Mostrar ou ocultar o resto da citação", ko="인용의 나머지 부분 보기 또는 숨기기", fr="Afficher ou masquer la suite de la citation")
+
+# #4244 the agent's own questions
+add(en="Skip",
+    zh="跳过", ja="スキップ", de="Überspringen", es="Omitir",
+    ru="Пропустить", pt="Pular", ko="건너뛰기", fr="Passer")
+add(en="The assistant has a question for you",
+    zh="助手有一个问题要问你", ja="アシスタントからの質問があります", de="Der Assistent hat eine Frage an dich", es="El asistente tiene una pregunta para ti",
+    ru="У ассистента есть вопрос к вам", pt="O assistente tem uma pergunta para você", ko="어시스턴트가 질문이 있습니다", fr="L'assistant a une question pour vous")
+add(en="Type your own answer",
+    zh="输入你自己的回答", ja="自分の答えを入力", de="Eigene Antwort eingeben", es="Escribe tu propia respuesta",
+    ru="Введите свой ответ", pt="Digite a sua própria resposta", ko="직접 답변 입력", fr="Saisissez votre propre réponse")
+add(en="Send answer",
+    zh="发送回答", ja="回答を送る", de="Antwort senden", es="Enviar respuesta",
+    ru="Отправить ответ", pt="Enviar resposta", ko="답변 보내기", fr="Envoyer la réponse")
+add(en="Questions for you",
+    zh="向你提问", ja="あなたへの質問", de="Fragen an dich", es="Preguntas para ti",
+    ru="Вопросы к вам", pt="Perguntas para você", ko="내게 하는 질문", fr="Questions pour vous")
+add(en="Lets the assistant stop and ask you a question, with answers to pick from, when it needs your decision.",
+    zh="当助手需要你做决定时，可以暂停并向你提问，并给出可选的答案。", ja="アシスタントがあなたの判断を必要とするとき、選択肢つきで質問できるようにします。",
+    de="Der Assistent kann anhalten und dir eine Frage mit Antworten zur Auswahl stellen, wenn er deine Entscheidung braucht.",
+    es="Permite que el asistente se detenga y te haga una pregunta, con respuestas para elegir, cuando necesita tu decisión.",
+    ru="Позволяет ассистенту остановиться и задать вам вопрос с вариантами ответа, когда ему нужно ваше решение.",
+    pt="Permite que o assistente pare e faça uma pergunta, com respostas para escolher, quando precisa da sua decisão.",
+    ko="어시스턴트가 결정이 필요할 때 멈추고 고를 수 있는 답과 함께 질문할 수 있게 합니다.",
+    fr="Permet à l'assistant de s'arrêter et de vous poser une question, avec des réponses à choisir, quand il a besoin de votre décision.")
+
+here = Path(__file__).resolve().parent.parent / "src" / "locales"
+NBSP = " "
+
+
+def french(text):
+    text = re.sub(r"(?<=[A-Za-zÀ-ſ])'(?=[A-Za-zÀ-ſ{])", "’", text)
+    text = re.sub(r"(?<=\S) ([:;?!])", NBSP + r"\1", text)
+    text = re.sub(r"(?<=[\d}]) %", NBSP + "%", text)
+    return text
+
+
+for lang in LANGS:
+    data = {}
+    for i, entry in enumerate(S):
+        text = entry[lang]
+        assert sorted(re.findall(r"\{\d+\}", entry["en"])) == sorted(re.findall(r"\{\d+\}", text)), (lang, entry["en"], text)
+        data[f"ui{i + 1:02d}"] = french(text) if lang == "fr" else text
+    (here / f"ui-{lang}.json").write_text(json.dumps(data, ensure_ascii=False, indent=1) + "\n", encoding="utf-8")
+print("written", len(S), "strings in", len(LANGS), "languages")

apps/host/scripts/make-update-locales.py

@@ -0,0 +1,125 @@
+"""Writes src/locales/upd-<lang>.json: the strings of the engine update beside a loaded model (the dialog of Settings > About, branch f-0291-ui-final).
+Run from apps/host:  python scripts/make-update-locales.py
+Every entry names all nine languages; the keys are upd01.. in the order of S. upd-en.json is the English source. Placeholders ({0}) must be kept in every
+language. A separate file keeps this work from colliding with the other catalogs (the same reason pick-, tune-, tools-, fix-, gh-, ui-, engine- and df2- exist)."""
+import json
+import re
+from pathlib import Path
+
+LANGS = ["en", "zh", "ja", "de", "es", "ru", "pt", "ko", "fr"]
+S = []
+
+
+def add(en, zh, ja, de, es, ru, pt, ko, fr):
+    S.append(dict(en=en, zh=zh, ja=ja, de=de, es=es, ru=ru, pt=pt, ko=ko, fr=fr))
+
+
+add("To update the engine, Strata has to stop the model that is loaded: {0}.",
+    "要更新引擎，Strata 必须先停止当前已加载的模型：{0}。",
+    "エンジンを更新するには、読み込み中のモデルを Strata が停止する必要があります：{0}。",
+    "Um die Engine zu aktualisieren, muss Strata das geladene Modell anhalten: {0}.",
+    "Para actualizar el motor, Strata tiene que detener el modelo cargado: {0}.",
+    "Чтобы обновить движок, Strata должна остановить загруженную модель: {0}.",
+    "Para atualizar o motor, o Strata precisa parar o modelo carregado: {0}.",
+    "엔진을 업데이트하려면 Strata가 불러온 모델을 중지해야 합니다: {0}.",
+    "Pour mettre à jour le moteur, Strata doit arrêter le modèle chargé : {0}.")
+add("The new engine downloads first while the model keeps answering. Then the model stops (answers in progress finish first), the engine is updated, and you can start the model again with the same settings. Your models and settings are kept.",
+    "新引擎会先下载，此时模型仍可继续回答。然后模型停止（正在进行的回答会先完成），引擎随即更新，之后你可以用相同的设置再次启动该模型。你的模型和设置都会保留。",
+    "まず新しいエンジンをダウンロードします。その間、モデルは応答を続けます。その後モデルが停止し（進行中の回答は先に完了します）、エンジンが更新され、同じ設定でモデルをもう一度起動できます。モデルと設定はそのまま残ります。",
+    "Zuerst wird die neue Engine heruntergeladen, während das Modell weiter antwortet. Danach hält das Modell an (laufende Antworten werden zuerst beendet), die Engine wird aktualisiert, und Sie können das Modell mit denselben Einstellungen wieder starten. Ihre Modelle und Einstellungen bleiben erhalten.",
+    "Primero se descarga el motor nuevo mientras el modelo sigue respondiendo. Después el modelo se detiene (las respuestas en curso terminan antes), se actualiza el motor y puedes volver a iniciar el modelo con los mismos ajustes. Tus modelos y ajustes se conservan.",
+    "Сначала новый движок скачивается, пока модель продолжает отвечать. Затем модель останавливается (ответы в процессе сначала завершаются), движок обновляется, и вы можете снова запустить модель с теми же настройками. Ваши модели и настройки сохраняются.",
+    "Primeiro o novo motor é baixado enquanto o modelo continua a responder. Depois o modelo para (as respostas em curso terminam antes), o motor é atualizado e pode iniciar o modelo de novo com as mesmas definições. Os seus modelos e definições são mantidos.",
+    "먼저 모델이 계속 응답하는 동안 새 엔진을 다운로드합니다. 그다음 모델이 중지되고(진행 중인 답변은 먼저 끝납니다) 엔진이 업데이트되며, 같은 설정으로 모델을 다시 시작할 수 있습니다. 모델과 설정은 그대로 유지됩니다.",
+    "Le nouveau moteur est d'abord téléchargé pendant que le modèle continue de répondre. Ensuite le modèle s'arrête (les réponses en cours se terminent d'abord), le moteur est mis à jour, et vous pouvez redémarrer le modèle avec les mêmes réglages. Vos modèles et réglages sont conservés.")
+add("Stop and update", "停止并更新", "停止して更新", "Anhalten und aktualisieren", "Detener y actualizar", "Остановить и обновить", "Parar e atualizar", "중지하고 업데이트", "Arrêter et mettre à jour")
+add("Getting the new engine ready. {0} keeps working until it is ready.",
+    "正在准备新引擎。在准备好之前，{0} 会继续工作。",
+    "新しいエンジンを準備しています。準備ができるまで {0} は動き続けます。",
+    "Die neue Engine wird vorbereitet. {0} arbeitet weiter, bis sie bereit ist.",
+    "Preparando el motor nuevo. {0} sigue funcionando hasta que esté listo.",
+    "Готовим новый движок. {0} продолжает работать, пока он не будет готов.",
+    "A preparar o novo motor. {0} continua a funcionar até estar pronto.",
+    "새 엔진을 준비하는 중입니다. 준비될 때까지 {0}은(는) 계속 작동합니다.",
+    "Préparation du nouveau moteur. {0} continue de fonctionner jusqu'à ce qu'il soit prêt.")
+add("Stopping {0}. Answers in progress finish first.",
+    "正在停止 {0}。正在进行的回答会先完成。",
+    "{0} を停止しています。進行中の回答は先に完了します。",
+    "{0} wird angehalten. Laufende Antworten werden zuerst beendet.",
+    "Deteniendo {0}. Las respuestas en curso terminan antes.",
+    "Останавливаем {0}. Ответы в процессе сначала завершаются.",
+    "A parar {0}. As respostas em curso terminam antes.",
+    "{0}을(를) 중지하는 중입니다. 진행 중인 답변은 먼저 끝납니다.",
+    "Arrêt de {0}. Les réponses en cours se terminent d'abord.")
+add("{0} is stopped. Updating the engine…",
+    "{0} 已停止。正在更新引擎…",
+    "{0} を停止しました。エンジンを更新しています…",
+    "{0} ist angehalten. Die Engine wird aktualisiert…",
+    "{0} está detenido. Actualizando el motor…",
+    "{0} остановлена. Обновляем движок…",
+    "{0} está parado. A atualizar o motor…",
+    "{0}이(가) 중지되었습니다. 엔진을 업데이트하는 중입니다…",
+    "{0} est arrêté. Mise à jour du moteur…")
+add("Updating the engine", "正在更新引擎", "エンジンを更新しています", "Engine wird aktualisiert", "Actualizando el motor", "Обновление движка", "A atualizar o motor", "엔진 업데이트 중", "Mise à jour du moteur")
+add("The engine is updated", "引擎已更新", "エンジンを更新しました", "Die Engine ist aktualisiert", "El motor está actualizado", "Движок обновлён", "O motor está atualizado", "엔진이 업데이트되었습니다", "Le moteur est à jour")
+add("The engine was not updated", "引擎未更新", "エンジンは更新されませんでした", "Die Engine wurde nicht aktualisiert", "El motor no se actualizó", "Движок не обновлён", "O motor não foi atualizado", "엔진이 업데이트되지 않았습니다", "Le moteur n'a pas été mis à jour")
+add("The engine is updated. Start {0} again with the same settings?",
+    "引擎已更新。要用相同的设置再次启动 {0} 吗？",
+    "エンジンを更新しました。同じ設定で {0} をもう一度起動しますか？",
+    "Die Engine ist aktualisiert. {0} mit denselben Einstellungen wieder starten?",
+    "El motor está actualizado. ¿Iniciar {0} de nuevo con los mismos ajustes?",
+    "Движок обновлён. Запустить {0} снова с теми же настройками?",
+    "O motor está atualizado. Iniciar {0} de novo com as mesmas definições?",
+    "엔진이 업데이트되었습니다. 같은 설정으로 {0}을(를) 다시 시작할까요?",
+    "Le moteur est à jour. Redémarrer {0} avec les mêmes réglages ?")
+add("The update didn't finish. Your old engine is unchanged and still works. Start {0} again on it?",
+    "更新没有完成。你原来的引擎没有改动，仍然可用。要在它上面再次启动 {0} 吗？",
+    "更新は完了しませんでした。以前のエンジンは変更されておらず、そのまま使えます。そのエンジンで {0} をもう一度起動しますか？",
+    "Die Aktualisierung wurde nicht abgeschlossen. Ihre alte Engine ist unverändert und funktioniert weiter. {0} damit wieder starten?",
+    "La actualización no terminó. Tu motor anterior no cambió y sigue funcionando. ¿Iniciar {0} de nuevo con él?",
+    "Обновление не завершилось. Прежний движок не изменён и работает. Запустить {0} снова на нём?",
+    "A atualização não terminou. O seu motor anterior não foi alterado e continua a funcionar. Iniciar {0} de novo com ele?",
+    "업데이트가 끝나지 않았습니다. 기존 엔진은 그대로이며 계속 작동합니다. 기존 엔진으로 {0}을(를) 다시 시작할까요?",
+    "La mise à jour ne s'est pas terminée. Votre ancien moteur est inchangé et fonctionne toujours. Redémarrer {0} avec lui ?")
+add("Not now", "暂不", "今はしない", "Jetzt nicht", "Ahora no", "Не сейчас", "Agora não", "나중에", "Pas maintenant")
+add("Starting {0}. Loading can take a few minutes.",
+    "正在启动 {0}。加载可能需要几分钟。",
+    "{0} を起動しています。読み込みには数分かかることがあります。",
+    "{0} wird gestartet. Das Laden kann einige Minuten dauern.",
+    "Iniciando {0}. La carga puede tardar unos minutos.",
+    "Запускаем {0}. Загрузка может занять несколько минут.",
+    "A iniciar {0}. O carregamento pode demorar alguns minutos.",
+    "{0}을(를) 시작하는 중입니다. 불러오는 데 몇 분이 걸릴 수 있습니다.",
+    "Démarrage de {0}. Le chargement peut prendre quelques minutes.")
+add("Starting {0} again", "正在再次启动 {0}", "{0} をもう一度起動しています", "{0} wird wieder gestartet", "Iniciando {0} de nuevo", "Снова запускаем {0}", "A iniciar {0} de novo", "{0}을(를) 다시 시작하는 중", "Redémarrage de {0}")
+add("The model did not start again", "模型没有重新启动", "モデルを再起動できませんでした", "Das Modell wurde nicht wieder gestartet", "El modelo no se inició de nuevo", "Модель не запустилась снова", "O modelo não voltou a iniciar", "모델이 다시 시작되지 않았습니다", "Le modèle n'a pas redémarré")
+add("You can load it again from Models.", "你可以在“模型”中再次加载它。", "「モデル」からもう一度読み込めます。", "Sie können es unter „Modelle“ erneut laden.", "Puedes cargarlo de nuevo desde Modelos.", "Вы можете загрузить её снова в разделе «Модели».", "Pode carregá-lo de novo em Modelos.", "모델 화면에서 다시 불러올 수 있습니다.", "Vous pouvez le recharger depuis Modèles.")
+add("A model that was not started from this app is running, so nothing was changed. Stop it, then update the engine again.",
+    "有一个不是从此应用启动的模型正在运行，因此没有做任何更改。请先停止它，然后再次更新引擎。",
+    "このアプリから起動していないモデルが動作しているため、何も変更していません。それを停止してから、もう一度エンジンを更新してください。",
+    "Ein Modell, das nicht aus dieser App gestartet wurde, läuft noch, daher wurde nichts geändert. Halten Sie es an und aktualisieren Sie die Engine dann erneut.",
+    "Hay un modelo en ejecución que no se inició desde esta aplicación, así que no se cambió nada. Deténlo y vuelve a actualizar el motor.",
+    "Работает модель, запущенная не из этого приложения, поэтому ничего не изменено. Остановите её и обновите движок снова.",
+    "Está em execução um modelo que não foi iniciado a partir desta aplicação, por isso nada foi alterado. Pare-o e atualize o motor de novo.",
+    "이 앱에서 시작하지 않은 모델이 실행 중이어서 아무것도 변경하지 않았습니다. 그 모델을 중지한 다음 엔진을 다시 업데이트하세요.",
+    "Un modèle qui n'a pas été démarré depuis cette application est en cours d'exécution, rien n'a donc été modifié. Arrêtez-le, puis mettez à nouveau le moteur à jour.")
+
+here = Path(__file__).resolve().parent.parent / "src" / "locales"
+NBSP = " "
+
+
+def french(text):
+    text = re.sub(r"(?<=[A-Za-zÀ-ſ])'(?=[A-Za-zÀ-ſ{])", "’", text)
+    text = re.sub(r"(?<=\S) ([:;?!])", NBSP + r"\1", text)
+    return text
+
+
+for lang in LANGS:
+    data = {}
+    for i, entry in enumerate(S):
+        text = entry[lang]
+        assert sorted(re.findall(r"\{\d+\}", entry["en"])) == sorted(re.findall(r"\{\d+\}", text)), (lang, entry["en"], text)
+        data[f"upd{i + 1:02d}"] = french(text) if lang == "fr" else text
+    with (here / f"upd-{lang}.json").open("w", encoding="utf-8", newline="\n") as handle:
+        handle.write(json.dumps(data, ensure_ascii=False, indent=1) + "\n")
+print("written", len(S), "strings in", len(LANGS), "languages")

apps/host/scripts/measure.mjs

@@ -20,15 +20,13 @@ import { chromium } from 'playwright-core';
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
+import { requireChromium } from './browser.mjs';
 
 const BASE = process.env.STRATA_URL ?? 'http://localhost:5199';
 const MIN = 45;
 const MAX = 75;
 
-const executablePath = [
-  join(homedir(), 'Library/Caches/ms-playwright/chromium-1234/chrome-mac-arm64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing'),
-  join(homedir(), 'Library/Caches/ms-playwright/chromium_headless_shell-1234/chrome-headless-shell-mac-arm64/chrome-headless-shell'),
-].find((p) => existsSync(p));
+const executablePath = requireChromium();
 
 if (!executablePath) {
   console.error('No cached Chromium found.');

apps/host/scripts/motion.mjs

@@ -21,6 +21,7 @@ import { promisify } from 'node:util';
 import { existsSync, mkdirSync, rmSync, readdirSync } from 'node:fs';
 import { join, resolve } from 'node:path';
 import { homedir } from 'node:os';
+import { requireChromium } from './browser.mjs';
 
 const run = promisify(execFile);
 const BASE = process.env.STRATA_URL ?? 'http://localhost:5199';
@@ -28,10 +29,7 @@ const ROOT = resolve(process.env.STRATA_SHOTS ?? '.shots');
 const TMP = join(ROOT, 'motion-frames');
 mkdirSync(TMP, { recursive: true });
 
-const executablePath = [
-  join(homedir(), 'Library/Caches/ms-playwright/chromium-1234/chrome-mac-arm64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing'),
-  join(homedir(), 'Library/Caches/ms-playwright/chromium_headless_shell-1234/chrome-headless-shell-mac-arm64/chrome-headless-shell'),
-].find((p) => existsSync(p));
+const executablePath = requireChromium();
 
 const ffmpeg = [
   join(homedir(), 'Library/Caches/ms-playwright/ffmpeg-1011/ffmpeg-mac'),

apps/host/scripts/motionbudget.mjs

@@ -20,14 +20,12 @@ import { chromium } from 'playwright-core';
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
+import { requireChromium } from './browser.mjs';
 
 const BASE = process.env.STRATA_URL ?? 'http://localhost:5199';
 const BUDGET = 1.2;
 
-const executablePath = [
-  join(homedir(), 'Library/Caches/ms-playwright/chromium-1234/chrome-mac-arm64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing'),
-  join(homedir(), 'Library/Caches/ms-playwright/chromium_headless_shell-1234/chrome-headless-shell-mac-arm64/chrome-headless-shell'),
-].find((p) => existsSync(p));
+const executablePath = requireChromium();
 
 if (!executablePath) {
   console.error('No cached Chromium found. Run `npm run shot -- x.png <url>` once to confirm the harness.');

apps/host/scripts/test.mjs

@@ -5,6 +5,12 @@ import {spawn} from 'node:child_process';
 import {resolve} from 'node:path';
 const root=resolve(import.meta.dirname,'..');
 const files=readdirSync(resolve(root,'tests')).filter(name=>name.endsWith('.test.mjs')).sort().map(name=>resolve(root,'tests',name));
-const child=spawn(process.execPath,['--test',...files],{cwd:root,stdio:'inherit'});
+/* Every test file runs against scratch copies of the per-user places the host writes to (the owner's real profile is never touched). */
+import {mkdtempSync} from 'node:fs';
+import {tmpdir} from 'node:os';
+import {join} from 'node:path';
+const scratch=mkdtempSync(join(tmpdir(),'strata-host-suite-profile-'));
+const env={...process.env,STRATA_SETTINGS_FILE:join(scratch,'app-settings.json'),STRATA_COMPONENTS_DIR:join(scratch,'components'),LOCALAPPDATA:join(scratch,'Local'),APPDATA:join(scratch,'Roaming'),XDG_DATA_HOME:join(scratch,'xdg-data'),XDG_STATE_HOME:join(scratch,'xdg-state'),XDG_CONFIG_HOME:join(scratch,'xdg-config')};
+const child=spawn(process.execPath,['--test',...files],{cwd:root,stdio:'inherit',env});
 child.on('error',error=>{console.error(error.message);process.exitCode=1;});
 child.on('exit',(code,signal)=>{process.exitCode=code??(signal?1:0);});

apps/host/scripts/ui-do-drive.mjs

@@ -0,0 +1,793 @@
+#!/usr/bin/env node
+/**
+ * Drives the built app in a headless Chrome against a real host with a clean temporary profile (no engine, no model), for the 0.2.10
+ * interface changes (branch f-0291-ui). Each case seeds the chat history it needs into the page's local storage, so the real screens
+ * draw real data without a model.
+ *
+ *   npx vite build && node scripts/ui-do-drive.mjs <shots-dir> [case ...]
+ *
+ * Never point it at a real install: the host it starts uses a fresh STRATA_HOME in the temp folder and a random port.
+ * Light and dark, at a normal and a narrow window. Prints "ok" / "FAIL" lines and exits 1 on a failure.
+ */
+import { spawn, spawnSync } from 'node:child_process';
+import { existsSync, mkdirSync, mkdtempSync, rmSync } from 'node:fs';
+import { createServer } from 'node:net';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { startScriptedWorker } from '../tests/helpers/scripted-worker.mjs';
+
+const HOST_DIR = resolve(import.meta.dirname, '..');
+const SHOTS = resolve(process.argv[2] ?? 'ui-shots');
+const ONLY = process.argv.slice(3);
+mkdirSync(SHOTS, { recursive: true });
+const { chromium } = await import(pathToFileURL(join(HOST_DIR, 'node_modules/playwright-core/index.mjs')).href);
+const CHROME = process.env.CHROME ?? ['C:/Program Files/Google/Chrome/Application/chrome.exe', '/usr/bin/google-chrome'].find(existsSync);
+const freePort = () => new Promise(r => { const s = createServer(); s.listen(0, '127.0.0.1', () => { const p = s.address().port; s.close(() => r(p)); }); });
+const sleep = ms => new Promise(r => setTimeout(r, ms));
+let failed = false;
+export const check = (ok, label, extra = '') => { console.log(`${ok ? 'ok  ' : 'FAIL'} ${label}${extra ? '  ' + extra : ''}`); if (!ok) failed = true; };
+
+const home = mkdtempSync(join(tmpdir(), 'strata-ui-do-'));
+const ws = join(home, 'workspace'); mkdirSync(ws, { recursive: true });
+const port = await freePort();
+const env = { ...process.env, STRATA_HOME: home, STRATA_PORT: String(port), STRATA_WORKSPACE: ws, STRATA_REAL_ENGINE: '0', STRATA_COMPONENTS_DIR: join(home, 'components'), STRATA_SETTINGS_FILE: join(home, 'app-settings.json'), LOCALAPPDATA: join(home, 'Local'), APPDATA: join(home, 'Roaming'), XDG_DATA_HOME: join(home, 'xdg-data'), XDG_CONFIG_HOME: join(home, 'xdg-config'), XDG_STATE_HOME: join(home, 'xdg-state') };
+delete env.STRATA_HARNESS_DIR;
+const child = spawn(process.execPath, [join(HOST_DIR, 'server', 'index.mjs')], { cwd: HOST_DIR, env, stdio: 'ignore', windowsHide: true });
+export const base = `http://127.0.0.1:${port}`;
+for (let i = 0; i < 100; i++) { try { if ((await fetch(`${base}/api/health`)).ok) break; } catch { /* starting */ } await sleep(200); }
+// A saved API connection to a scripted model gives the app a model to talk to, so it stays on the chat screen (no model loaded would send it to Models).
+const worker = await startScriptedWorker({ model: 'cloud-model' });
+const saved = await (await fetch(`${base}/api/model-providers`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ kind: 'custom', name: 'Scripted API', baseUrl: worker.url, protocol: 'openai-chat', apiKey: 'sk-ui-do-test-0123456789', models: [{ id: 'cloud-model', name: 'Cloud model', contextMax: 64000 }] }) })).json();
+const remoteModel = { connectionId: saved.connections?.[0]?.id, modelId: 'cloud-model' };
+check(!!remoteModel.connectionId, 'a scripted API model is connected');
+// "Go straight to the app": the first-run screens are not what these cases look at.
+await fetch(`${base}/api/setup/step`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ step: 1, dismissed: true, flowVersion: 2 }) });
+const browser = await chromium.launch({ executablePath: CHROME, headless: true, args: ['--no-sandbox'] });
+
+const iso = (n = 0) => new Date(Date.UTC(2026, 9, 31, 9, 0, n)).toISOString();
+export const user = (id, content, n = 0) => ({ id, role: 'user', content, at: iso(n) });
+export const reply = (id, content, extra = {}) => ({ id, role: 'assistant', content, at: iso(5), tokens: 120, tps: 40, durationMs: 3000, ...extra });
+export const chat = (id, title, messages) => ({ id, title, defaultTitle: false, updatedAt: iso(9), createdAt: iso(0), messages, workspace: ws, tokensIn: 0, tokensOut: 0, preferences: { useTools: true, mode: 'manual', remoteModel } });
+
+/** A page with the given chats already in local storage. `prefs` are merged into the saved preferences. */
+export async function open(scheme, width, height, sessions, { hash = '#/chat', prefs = {}, origin = base, before = null, locale = 'en-US', keepSetup = false } = {}) {
+  const context = await browser.newContext({ viewport: { width, height }, colorScheme: scheme, locale, permissions: ['clipboard-read', 'clipboard-write'] });
+  const page = await context.newPage();
+  pages.push(page);
+  const problems = [];
+  page.on('pageerror', e => problems.push(e.message));
+  page.problems = problems;
+  await page.addInitScript(({ sessions, prefs }) => {
+    try {
+      if (sessionStorage.getItem('ui-do-seeded')) return;
+      sessionStorage.setItem('ui-do-seeded', '1');
+      if (sessions) localStorage.setItem('strata.sessions.v1', JSON.stringify(sessions));
+      if (Object.keys(prefs).length) localStorage.setItem('strata.prefs.v1', JSON.stringify(prefs));
+    } catch { /* storage refused */ }
+  }, { sessions, prefs });
+  if (before) await before(page);
+  await page.goto(`${origin}/${hash}`);
+  await page.waitForTimeout(1800);
+  const skip = page.getByText('Go straight to the app');
+  if (!keepSetup && await skip.count()) { await skip.click(); await page.waitForTimeout(600); }
+  return page;
+}
+export const shot = (page, name) => page.screenshot({ path: join(SHOTS, `${name}.png`) });
+export const sizes = { wide: [1280, 860], narrow: [390, 800] };
+
+export const cases = {};
+const pages = [];
+
+/* ------------------------------------------------------------------------------------------------------------------- #4725 */
+const longReply = Array.from({ length: 70 }, (_, i) => `Paragraph ${i + 1}. This is part of a long answer from the assistant that goes on for many screens before it asks to change a file in the project.`).join('\n\n');
+const askTool = (id, state = 'proposed', file = 'notes.txt') => ({ id, name: 'write', args: { file_path: file }, preview: `write ${file}\n\na\nb\nc`, effect: 'Creates a file.', scope: 'write', verb: 'Create a file', target: file, state, ask: { id: 'create-file', params: [file], why: 'replaces-if-exists' }, live: false });
+const plainTool = (id, state = 'proposed') => ({ id, name: 'bash', args: {}, preview: 'npm install left-pad', effect: 'Runs a command on your computer.', scope: 'shell', verb: 'Run a command', target: 'npm install left-pad', state });
+cases.approval = async () => {
+  for (const scheme of ['light', 'dark']) for (const [sizeName, [w, h]] of Object.entries(sizes)) {
+    const tag = `${scheme}-${sizeName}`;
+    const sessions = [chat('s1', 'Long reply', [user('u1', 'Please write notes.txt'), reply('a1', longReply, { tools: [askTool('t1')] })])];
+    const page = await open(scheme, w, h, sessions);
+    const dock = page.locator('.approvaldock');
+    await dock.waitFor({ timeout: 15000 });
+    const view = page.viewportSize();
+    const inView = async sel => { const b = await page.locator(sel).first().boundingBox(); return !!b && b.y >= 0 && b.y + b.height <= view.height + 1 && b.x >= 0 && b.x + b.width <= view.width + 1; };
+    check(await page.locator('.askcard').count() === 1, `${tag}: one Approve/Deny card on the page`);
+    check(await page.getByRole('button', { name: 'Approve' }).count() === 1 && await page.getByRole('button', { name: 'Deny' }).count() === 1, `${tag}: one Approve and one Deny`);
+    check(await inView('.approvaldock'), `${tag}: the card is inside the window at the end of the reply`);
+    const scroller = page.locator('.main__body.chat');
+    const atEnd = () => scroller.evaluate(el => el.scrollHeight - el.scrollTop - el.clientHeight);
+    check(await atEnd() < 4, `${tag}: the reply is still scrolled to its end`, String(await atEnd()));
+    check(await page.locator('.approval-wait').count() === 1, `${tag}: the reply says it waits for an answer`);
+    await shot(page, `4725-${tag}-end`);
+    await scroller.evaluate(el => { el.scrollTop = 0; });
+    await page.waitForTimeout(300);
+    check(await inView('.approvaldock'), `${tag}: the card stays in the window when the reader is at the top`);
+    const composerTop = await page.locator('.composer .st-composer').boundingBox();
+    const dockBox = await dock.boundingBox();
+    check(dockBox.y + dockBox.height <= composerTop.y, `${tag}: the card sits above the message box`);
+    check((await page.evaluate(() => document.documentElement.scrollWidth)) <= w, `${tag}: no sideways scroll`);
+    await shot(page, `4725-${tag}-top`);
+    await page.getByRole('button', { name: 'Approve' }).click();
+    await page.waitForTimeout(500);
+    check(await page.locator('.approvaldock').count() === 0, `${tag}: the card goes away after Approve`);
+    check(await page.locator('.approval-wait').count() === 0, `${tag}: and so does the waiting line`);
+    check(page.problems.length === 0, `${tag}: no page error`, page.problems.join('; '));
+    await page.context().close();
+  }
+  // Two waiting at once, one in each card style; Deny works from the dock.
+  const sessions = [chat('s1', 'Two waiting', [user('u1', 'Do two things'), reply('a1', longReply.slice(0, 1500), { tools: [askTool('t1'), plainTool('t2')] })])];
+  const page = await open('light', 1280, 860, sessions);
+  await page.locator('.approvaldock').waitFor({ timeout: 15000 });
+  check(await page.locator('.approvaldock > section').count() === 2, 'two waiting: both cards are in the dock');
+  await shot(page, '4725-two-waiting');
+  await page.getByRole('button', { name: 'Deny' }).first().click();
+  await page.waitForTimeout(400);
+  check(await page.locator('.approvaldock > section').count() === 1, 'two waiting: Deny on the first leaves the second');
+  await page.context().close();
+};
+
+/* ------------------------------------------------------------------------------------------------------------------- #4748 */
+const codeReply = 'Here is a command.\n\n```bash\nnpm install left-pad\n```\n\nThat is all.';
+cases.copy = async () => {
+  for (const scheme of ['light', 'dark']) for (const [sizeName, [w, h]] of Object.entries(sizes)) {
+    const tag = `${scheme}-${sizeName}`;
+    const sessions = [chat('s1', 'Copy', [user('u1', 'Show me a command'), reply('a1', codeReply), user('u2', 'Thanks'), reply('a2', 'You are welcome. Second reply.')])];
+    const page = await open(scheme, w, h, sessions);
+    await page.locator('.st-msg--assistant').last().waitFor({ timeout: 15000 });
+    const flag = async loc => loc.evaluate(el => ({ copied: el.hasAttribute('data-copied'), icon: el.querySelector('use')?.getAttribute('href') ?? '' }));
+    const read = () => page.evaluate(() => navigator.clipboard.readText());
+    // The last reply's copy button (an icon in the action row).
+    const copyResponse = page.getByRole('button', { name: 'Copy response' });
+    await copyResponse.last().click();
+    await page.mouse.move(2, 2);
+    await page.waitForTimeout(250);
+    let f = await flag(copyResponse.last());
+    check(f.copied && f.icon.endsWith('i-check'), `${tag}: Copy response turns into a check mark`, JSON.stringify(f));
+    check((await read()) === 'You are welcome. Second reply.', `${tag}: the reply is on the clipboard`);
+    const row = page.locator('.st-msg--assistant').last().locator('.st-msg__actions');
+    check(await row.evaluate(el => getComputedStyle(el).opacity) === '1', `${tag}: the action row stays visible while it says so, mouse away`);
+    check(/Copied/.test(await page.locator('.st-msg--assistant').last().locator('[role=status]').first().innerText()), `${tag}: a screen reader hears Copied`);
+    await shot(page, `4748-${tag}-reply`);
+    await page.waitForTimeout(2200);
+    f = await flag(copyResponse.last());
+    check(!f.copied && f.icon.endsWith('i-copy'), `${tag}: after about two seconds it is a Copy button again`, JSON.stringify(f));
+    // The code block.
+    const code = page.locator('.st-code__head').getByRole('button', { name: 'Copy code' });
+    await code.click();
+    await page.waitForTimeout(250);
+    f = await flag(code);
+    check(f.copied && f.icon.endsWith('i-check'), `${tag}: the code block's Copy turns into a check mark`, JSON.stringify(f));
+    check((await read()) === 'npm install left-pad', `${tag}: the code is on the clipboard`);
+    await shot(page, `4748-${tag}-code`);
+    await page.waitForTimeout(2200);
+    // The menu item of an earlier reply: says Copied, then the menu closes.
+    await page.locator('.st-msg--assistant').first().hover();
+    await page.locator('.st-msg--assistant').first().getByRole('button', { name: 'More response actions' }).click();
+    const item = page.getByRole('menuitem', { name: 'Copy response' });
+    await item.click();
+    await page.waitForTimeout(250);
+    check(/Copied/.test(await page.locator('.menu [data-copied]').innerText()), `${tag}: the menu item says Copied`);
+    check((await read()).startsWith('Here is a command'), `${tag}: the earlier reply is on the clipboard`);
+    await shot(page, `4748-${tag}-menu`);
+    await page.waitForTimeout(1300);
+    check(await page.locator('.menu').count() === 0, `${tag}: and the menu closes by itself`);
+    check(page.problems.length === 0, `${tag}: no page error`, page.problems.join('; '));
+    await page.context().close();
+  }
+  // A refused clipboard: nothing says Copied on the button, and the person is told in a toast.
+  {
+    const page = await open('light', 1280, 860, [chat('s1', 'Refused', [user('u1', 'Hi'), reply('a1', 'Hello there.')])]);
+    await page.locator('.st-msg--assistant').last().waitFor({ timeout: 15000 });
+    await page.evaluate(() => { Object.defineProperty(navigator, 'clipboard', { value: { writeText: () => Promise.reject(new Error('denied')) }, configurable: true }); document.execCommand = () => false; });
+    const b = page.getByRole('button', { name: 'Copy response' }).last();
+    await b.click();
+    await page.waitForTimeout(400);
+    check(await b.evaluate(el => !el.hasAttribute('data-copied')), 'refused clipboard: the button does not claim success');
+    check(/Couldn.t copy/.test(await page.locator('.st-toast').first().innerText()), 'refused clipboard: a toast says it did not work');
+    await page.context().close();
+  }
+  // The Serving screen: the address and the request template.
+  for (const scheme of ['light', 'dark']) {
+    const page = await open(scheme, 1280, 860, [chat('s1', 'Serving', [user('u1', 'Hi'), reply('a1', 'Hello there.')])], { hash: '#/serving' });
+    const c = page.getByRole('button', { name: 'Copy API base URL' });
+    await c.waitFor({ timeout: 15000 });
+    await c.click();
+    await page.waitForTimeout(250);
+    check(await c.evaluate(el => el.hasAttribute('data-copied') && (el.querySelector('use')?.getAttribute('href') ?? '').endsWith('i-check')), `${scheme}: Serving, Copy API base URL turns into a check mark`);
+    check(/^http:\/\/127\.0\.0\.1:\d+\/v1$/.test(await page.evaluate(() => navigator.clipboard.readText())), `${scheme}: Serving, the address is on the clipboard`);
+    await shot(page, `4748-serving-${scheme}`);
+    await page.getByRole('button', { name: 'Connection guide' }).click();
+    const t = page.getByRole('button', { name: 'Copy request template' });
+    await t.click();
+    await page.waitForTimeout(250);
+    check(await t.evaluate(el => el.hasAttribute('data-copied')), `${scheme}: Serving, Copy request template turns into a check mark`);
+    check((await page.evaluate(() => navigator.clipboard.readText())).startsWith('curl http'), `${scheme}: Serving, the template is on the clipboard`);
+    await page.context().close();
+  }
+};
+
+/* ------------------------------------------------------------------------------------------------------------------- #4804 */
+let tuneHostInfo = null;
+async function tuneHost() {
+  if (tuneHostInfo) return tuneHostInfo;
+  const tport = await freePort();
+  const proc = spawn(process.execPath, [join(HOST_DIR, 'tests/fixtures/tune-ui-host.mjs')], { cwd: HOST_DIR, env: { ...process.env, TUNE_UI_PORT: String(tport), TUNE_UPSTREAM: base, TUNE_SHOT_DIR: SHOTS }, stdio: 'ignore', windowsHide: true });
+  const origin = `http://127.0.0.1:${tport}`;
+  for (let i = 0; i < 100; i++) { try { if ((await fetch(`${origin}/api/native`)).ok) break; } catch { /* starting */ } await sleep(200); }
+  tuneHostInfo = { origin, proc, mode: m => fetch(`${origin}/__fixture/status-mode`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ mode: m }) }) };
+  return tuneHostInfo;
+}
+cases.tune = async () => {
+  const t = await tuneHost();
+  const sessions = [chat('s1', 'Tune', [user('u1', 'Hi'), reply('a1', 'Hello there.')])];
+  const openDialog = async (scheme, w, h, mode, inject = false) => {
+    await t.mode(mode);
+    const page = await open(scheme, w, h, sessions, { hash: '#/models', origin: t.origin });
+    if (inject) await page.route(/\/api\/native(\?.*)?$/, async route => {
+      if (!page.injectJob) return route.continue();
+      const r = await route.fetch(); const j = await r.json();
+      j.jobs = [...(j.jobs ?? []), { id: 'job-x', kind: 'download', state: 'running', startedAt: new Date().toISOString(), summary: 'Downloading the model', error: null, result: null, progress: { text: 'Downloading', percent: 12 } }];
+      return route.fulfill({ response: r, json: j });
+    });
+    const tune = page.getByRole('button', { name: 'Tune model' });
+    await tune.waitFor({ timeout: 20000 });
+    for (let i = 0; i < 40 && await tune.isDisabled(); i++) await page.waitForTimeout(250);
+    await tune.click();
+    await page.getByRole('dialog').waitFor({ timeout: 10000 });
+    return page;
+  };
+  const start = page => page.getByRole('button', { name: 'Start tuning' });
+  // The sentence must be on screen without scrolling the dialog, beside the button (above it when the window is narrow).
+  const seen = async (page, w, h) => {
+    const s = await page.locator('.tune-why').boundingBox(), b = await start(page).boundingBox();
+    return !!s && !!b && s.y >= 0 && s.y + s.height <= h && s.x >= 0 && s.x + s.width <= w && Math.abs((s.y + s.height / 2) - (b.y + b.height / 2)) < 110;
+  };
+  for (const scheme of ['light', 'dark']) for (const [sizeName, [w, h]] of Object.entries(sizes)) {
+    const tag = `${scheme}-${sizeName}`;
+    // 1. The saved tunings are still being read: greyed out, with the reason, and not "No saved tuning".
+    let page = await openDialog(scheme, w, h, 'slow');
+    await page.waitForTimeout(1200);
+    check(await start(page).isDisabled(), `${tag}: loading: Start tuning is greyed out`);
+    let why = await page.locator('.tune-why').innerText().catch(() => '');
+    check(/still checking this model for saved tunings/.test(why), `${tag}: loading: one sentence says why`, why);
+    check(await page.locator('.tune-why').count() === 1, `${tag}: loading: only one such sentence`);
+    check(!/No saved tuning for these choices yet/.test(await page.getByRole('dialog').innerText()), `${tag}: loading: it does not claim there is no saved tuning`);
+    check(await seen(page, w, h), `${tag}: loading: the sentence is on screen next to the button`);
+    await shot(page, `4804-${tag}-loading`);
+    await page.context().close();
+    // 2. Reading them failed.
+    page = await openDialog(scheme, w, h, 'fail');
+    await page.waitForTimeout(1200);
+    check(await start(page).isDisabled(), `${tag}: unreadable: Start tuning is greyed out`);
+    why = await page.locator('.tune-why').innerText().catch(() => '');
+    check(/could not read the tuning details/.test(why), `${tag}: unreadable: one sentence says why`, why);
+    check(await seen(page, w, h), `${tag}: unreadable: the sentence is on screen next to the button`);
+    check(!/No saved tuning/.test(await page.getByRole('dialog').innerText()), `${tag}: unreadable: it does not claim there is no saved tuning`);
+    await shot(page, `4804-${tag}-unreadable`);
+    await page.context().close();
+    // 3. Another operation is running.
+    page = await openDialog(scheme, w, h, 'ok', true);
+    await page.waitForTimeout(800);
+    check(await start(page).isEnabled() && await page.locator('.tune-why').count() === 0, `${tag}: ready: Start tuning works and shows no sentence`);
+    page.injectJob = true;
+    await page.waitForTimeout(3500);
+    check(await start(page).isDisabled(), `${tag}: another operation: Start tuning is greyed out`);
+    why = await page.locator('.tune-why').innerText().catch(() => '');
+    check(/Finish the current operation first/.test(why), `${tag}: another operation: one sentence says why`, why);
+    check((await page.evaluate(() => document.documentElement.scrollWidth)) <= w, `${tag}: no sideways scroll`);
+    check(await seen(page, w, h), `${tag}: other: the sentence is on screen next to the button`);
+    await shot(page, `4804-${tag}-other`);
+    check(page.problems.length === 0, `${tag}: no page error`, page.problems.join('; '));
+    await page.context().close();
+  }
+};
+
+/* ------------------------------------------------------------------------------------------------------------------- #4721 */
+cases.links = async () => {
+  const sessions = () => [chat('s1', 'Links', [user('u1', 'Show links'), reply('a1', `Read [the docs](https://example.com/docs) or open [the logo](${base}/icons/sprite.svg).`)])];
+  for (const scheme of ['light', 'dark']) {
+    // A browser tab: the browser opens the address in a new tab; a file stays in the side panel.
+    let page = await open(scheme, 1280, 860, sessions());
+    await page.getByRole('link', { name: 'the docs' }).waitFor({ timeout: 15000 });
+    await page.evaluate(() => { window.__opened = []; window.open = (...a) => { window.__opened.push(a); return null; }; });
+    await page.getByRole('link', { name: 'the docs' }).click();
+    await page.waitForTimeout(300);
+    let opened = await page.evaluate(() => window.__opened);
+    check(JSON.stringify(opened) === JSON.stringify([['https://example.com/docs', '_blank', 'noopener,noreferrer']]), `${scheme}: a browser tab: a plain click on a web address opens it in a new tab`, JSON.stringify(opened));
+    check(await page.locator('.artifact-panel').count() === 0, `${scheme}: a browser tab: and no side panel opens`);
+    await page.getByRole('link', { name: 'the logo' }).click();
+    await page.locator('.artifact-panel').waitFor({ timeout: 8000 });
+    check((await page.evaluate(() => window.__opened)).length === 1, `${scheme}: a file link keeps the side panel and opens no tab`);
+    await shot(page, `4721-${scheme}-file`);
+    await page.context().close();
+    // The app window: the host hands the address to the default browser; window.open is not used.
+    const posts = [];
+    page = await open(scheme, 1280, 860, sessions(), { before: async p => {
+      await p.route('**/api/app/mode', r => r.fulfill({ json: { mode: 'window', reason: null, canQuit: true, appUpdate: 'unavailable' } }));
+      await p.route('**/api/artifacts/open', r => { posts.push(r.request().postDataJSON()); return r.fulfill({ json: { ok: true } }); });
+    } });
+    await page.getByRole('link', { name: 'the docs' }).waitFor({ timeout: 15000 });
+    await page.evaluate(() => { window.__opened = []; window.open = (...a) => { window.__opened.push(a); return null; }; });
+    await page.getByRole('link', { name: 'the docs' }).click();
+    await page.waitForTimeout(400);
+    check(JSON.stringify(posts) === JSON.stringify([{ action: 'open', url: 'https://example.com/docs' }]), `${scheme}: the app window: the host is asked to open it in the default browser`, JSON.stringify(posts));
+    check((await page.evaluate(() => window.__opened)).length === 0 && await page.locator('.artifact-panel').count() === 0, `${scheme}: the app window: nothing else happens`);
+    check(page.problems.length === 0, `${scheme}: no page error`, page.problems.join('; '));
+    await page.context().close();
+  }
+};
+
+/* ------------------------------------------------------------------------------------------------------------------- #4802 */
+cases.progress = async () => {
+  const t = await tuneHost();
+  await t.mode('ok');
+  const sessions = [chat('s1', 'Progress', [user('u1', 'Hi'), reply('a1', 'Hello there.')])];
+  for (const scheme of ['light', 'dark']) for (const [sizeName, [w, h]] of Object.entries(sizes)) {
+    const tag = `${scheme}-${sizeName}`;
+    const page = await open(scheme, w, h, sessions, { hash: '#/models', origin: t.origin });
+    const started = new Date(Date.now() - (3 * 60 + 12) * 1000).toISOString();
+    await page.route(/\/api\/native(\?.*)?$/, async route => {
+      const r = await route.fetch(); const j = await r.json();
+      j.jobs = [...(j.jobs ?? []), { id: 'job-x', kind: 'install', model: 'iq2_xs', state: 'running', startedAt: started, summary: 'Preparing', error: null, result: { install: { step: '6/7', label: 'Preparing the model data for the engine (one time)', parts: [{ label: 'Model files', done_gb: 0.6, total_gb: 0.6, state: 'done' }], download: { file: 'model files', done_gb: 0.6, total_gb: 0.6, remaining_gb: 0, percent: 99 } } }, progress: null }];
+      return route.fulfill({ response: r, json: j });
+    });
+    await page.reload();
+    const card = page.locator('.native-progress');
+    await card.waitFor({ timeout: 20000 });
+    await page.waitForTimeout(1500);
+    check(await card.locator('.spinner').count() === 1, `${tag}: a spinner shows that it is working`);
+    const alive = () => card.locator('.native-progress__alive').innerText();
+    const a1 = await alive();
+    check(/^Still working for 3m \d+s\. You don't need to do anything\.$/.test(a1), `${tag}: it says how long and that nothing is needed`, a1);
+    await page.waitForTimeout(2200);
+    const a2 = await alive();
+    check(a1 !== a2, `${tag}: the time keeps counting`, `${a1} -> ${a2}`);
+    check(/The buttons below wait until this finishes/.test(await page.locator('.native-wait-note').innerText()), `${tag}: a sentence says why the buttons are greyed out`);
+    const border = await card.evaluate(el => getComputedStyle(el).borderTopColor);
+    const other = await page.locator('.st-card:not(.native-progress)').first().evaluate(el => getComputedStyle(el).borderTopColor);
+    check(border !== other, `${tag}: the card has its own border colour`, `${border} vs ${other}`);
+    check((await page.evaluate(() => document.documentElement.scrollWidth)) <= w, `${tag}: no sideways scroll`);
+    await card.scrollIntoViewIfNeeded();
+    await shot(page, `4802-${tag}`);
+    check(page.problems.length === 0, `${tag}: no page error`, page.problems.join('; '));
+    await page.context().close();
+  }
+};
+
+/* ------------------------------------------------------------------------------------------------------------------- #4798 */
+cases.serving = async () => {
+  const sessions = [chat('s1', 'Serving', [user('u1', 'Hi'), reply('a1', 'Hello there.')])];
+  for (const scheme of ['light', 'dark']) for (const [sizeName, [w, h]] of Object.entries(sizes)) {
+    const tag = `${scheme}-${sizeName}`;
+    // Sharing off: one address, no extra line. Sharing on: the app's own address and the one for other devices, with one sentence.
+    for (const sharing of [false, true]) {
+      const page = await open(scheme, w, h, sessions, { hash: '#/serving', before: async p => {
+        if (!sharing) return;
+        await p.route(/\/api\/serving$/, async route => {
+          if (route.request().method() !== 'GET') return route.continue();
+          const r = await route.fetch(); const j = await r.json();
+          return route.fulfill({ response: r, json: { ...j, localUrl: 'http://127.0.0.1:8079/v1', baseUrl: 'http://100.76.61.73:8080/v1', sharing: { active: true, url: 'http://100.76.61.73:8080/v1' } } });
+        });
+      } });
+      await page.getByText('API base URL', { exact: false }).first().waitFor({ timeout: 15000 });
+      await page.waitForTimeout(800);
+      const text = await page.locator('.serving-overview').innerText();
+      if (sharing) {
+        check(/API base URL on this computer/.test(text) && text.includes('http://127.0.0.1:8079/v1'), `${tag}: sharing on: the app's own address is shown`);
+        check(/Address for other devices/.test(text) && text.includes('http://100.76.61.73:8080/v1'), `${tag}: sharing on: and the address for other devices`);
+        check(await page.locator('.serving-two-addresses').count() === 1 && /its own port/.test(await page.locator('.serving-two-addresses').innerText()), `${tag}: sharing on: one sentence says why they differ`);
+        const t = page.getByRole('button', { name: 'Copy local network URL' });
+        await t.click(); await page.waitForTimeout(250);
+        check((await page.evaluate(() => navigator.clipboard.readText())) === 'http://100.76.61.73:8080/v1', `${tag}: sharing on: the copy button gives the network address`);
+        check((await page.evaluate(() => document.documentElement.scrollWidth)) <= w, `${tag}: sharing on: no sideways scroll`);
+        await page.locator('.serving-overview').scrollIntoViewIfNeeded();
+        await shot(page, `4798-${tag}-sharing`);
+      } else {
+        check(!/Address for other devices/.test(text) && await page.locator('.serving-two-addresses').count() === 0, `${tag}: sharing off: one address, no extra line`);
+      }
+      check(page.problems.length === 0, `${tag}: no page error`, page.problems.join('; '));
+      await page.context().close();
+    }
+  }
+};
+
+/* ------------------------------------------------------------------------------------------------------------------- #4722 */
+cases.width = async () => {
+  const text = '用中文写一段九十字左右的段落，说明本地模型为什么适合处理私人文件，并且不需要把任何内容上传到网络上去，这样可以让人放心。\n\n- 第一条要点同样写得比较长，用来观察列表项在气泡里到底会排到多宽才换行，看看它是否与上面的段落一样。\n- 第二条要点也一样长，看看两条要点是不是排得整齐，不会比段落更宽也不会更窄。\n\nAnd an English paragraph that is long enough to wrap onto at least two lines so that the measure of the prose can be read off it by the test.\n\n1. A numbered point in English that is also long enough to wrap onto a second line in the same bubble as the paragraph above it.\n2. Another numbered point.\n\n| Name | Value |\n| --- | --- |\n| a long cell that is wide | another long cell that is wide too |\n\n```bash\nnpm install a-very-long-package-name another-very-long-package-name yet-another-long-package-name --save-dev --legacy-peer-deps\n```';
+  for (const scheme of ['light', 'dark']) for (const [sizeName, [w, h]] of Object.entries(sizes)) {
+    const tag = `${scheme}-${sizeName}`;
+    const page = await open(scheme, w, h, [chat('s1', 'Width', [user('u1', 'Write'), reply('a1', text)])]);
+    await page.locator('.st-bubble ul').first().waitFor({ timeout: 15000 });
+    const m = await page.evaluate(() => {
+      const b = document.querySelector('.st-msg--assistant .st-bubble'), r = el => Math.round(el.getBoundingClientRect().width);
+      return { bubble: r(b), p: r(b.querySelector('p')), ul: r(b.querySelector('ul')), ol: r(b.querySelector('ol')), table: r(b.querySelector('.md-table-wrap')), code: r(b.querySelector('.st-code')) };
+    });
+    const note = JSON.stringify(m);
+    if (w > 700) {
+      check(Math.abs(m.ul - m.p) <= 2 && Math.abs(m.ol - m.p) <= 2, `${tag}: bullets and numbers have the paragraph's width`, note);
+      check(m.table > m.p + 20 && m.code > m.p + 20, `${tag}: the table and the code block keep the full width`, note);
+    } else {
+      check(Math.abs(m.ul - m.p) <= 2 && m.p <= m.bubble, `${tag}: narrow window: everything fits the column`, note);
+    }
+    check((await page.evaluate(() => document.documentElement.scrollWidth)) <= w, `${tag}: no sideways scroll`);
+    await shot(page, `4722-${tag}`);
+    await page.context().close();
+  }
+};
+
+/* ------------------------------------------------------------------------------------------------------------------- #3723 */
+cases.firstrun = async () => {
+  const setupStep = dismissed => fetch(`${base}/api/setup/step`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ step: 1, dismissed, flowVersion: 2 }) });
+  await setupStep(false);
+  // A computer set to a language Strata does not have: English.
+  const page = await open('light', 1280, 860, null, { hash: '#/setup', locale: 'sv-SE', keepSetup: true });
+  await page.locator('.onboard-language').waitFor({ timeout: 20000 });
+  check(/English/.test(await page.locator('.onboard-language').innerText()), 'Swedish computer: English');
+  await page.context().close();
+  // A first start (nothing saved) on a computer set to Chinese opens in Chinese, with a language choice on the first screen.
+  for (const scheme of ['light', 'dark']) for (const [sizeName, [w, h]] of Object.entries(sizes)) {
+    const tag = `${scheme}-${sizeName}`;
+    const page = await open(scheme, w, h, null, { hash: '#/setup', locale: 'zh-CN', keepSetup: true });
+    await page.locator('.onboard-language').waitFor({ timeout: 20000 });
+    await page.waitForTimeout(500);
+    const pick = page.locator('.onboard-language [role=combobox], .onboard-language button').first();
+    const shown = await pick.innerText();
+    check(/中文/.test(shown), `${tag}: a computer set to Chinese starts in Chinese`, shown);
+    check(/[\u4e00-\u9fff]/.test(await page.locator('.guided-onboarding h1').first().innerText()), `${tag}: the first screen is in Chinese`);
+    const box = await page.locator('.onboard-language').boundingBox();
+    check(!!box && box.x >= 0 && box.x + box.width <= w && box.y >= 0, `${tag}: the choice is on screen`, JSON.stringify(box));
+    const brand = await page.locator('.guided-onboarding .onboard-header .brand').first().boundingBox();
+    check(!brand || box.x >= brand.x + brand.width - 1 || box.x + box.width <= brand.x + 1 || box.y >= brand.y + brand.height || box.y + box.height <= brand.y, `${tag}: the choice does not cover the logo`, JSON.stringify({ brand, box }));
+    await shot(page, `3723-${tag}-first-zh`);
+    // Choosing German changes the screen at once, and it is kept.
+    await pick.click();
+    await page.getByRole('option', { name: 'Deutsch' }).click();
+    await page.waitForTimeout(500);
+    check(/[A-Za-zäöü]/.test(await page.locator('.guided-onboarding h1').first().innerText()) && !/[\u4e00-\u9fff]/.test(await page.locator('.guided-onboarding h1').first().innerText()), `${tag}: choosing Deutsch changes the first screen`);
+    await shot(page, `3723-${tag}-first-de`);
+    await page.reload();
+    await page.locator('.onboard-language').waitFor({ timeout: 20000 });
+    check(/Deutsch/.test(await page.locator('.onboard-language').innerText()), `${tag}: the choice is kept after a restart, whatever the computer says`);
+    check(page.problems.length === 0, `${tag}: no page error`, page.problems.join('; '));
+    await page.context().close();
+  }
+  await setupStep(true);
+};
+
+cases.kv = async () => {
+  const t = await tuneHost();
+  await t.mode('ok');
+  const sessions = [chat('s1', 'KV', [user('u1', 'Hi'), reply('a1', 'Hello there.')])];
+  for (const scheme of ['light', 'dark']) for (const [sizeName, [w, h]] of Object.entries(sizes)) {
+    const tag = `${scheme}-${sizeName}`;
+    const page = await open(scheme, w, h, sessions, { hash: '#/models', origin: t.origin });
+    await page.route(/\/api\/native(\?.*)?$/, async route => {
+      const r = await route.fetch(); const j = await r.json();
+      j.jobs = [...(j.jobs ?? []), { id: 'job-f', kind: 'load', model: 'iq2_xs', state: 'error', startedAt: new Date().toISOString(), summary: 'Load failed', error: "server_exited (exit code 1): EngineDied: the engine exited before it was ready | the engine process ended: exit code 1: \nthe engine log's last lines:\n  strata generate: expert cache auto: 1.92 GiB free, 2048 MiB reserved -> 0 slots\n  strata generate: no VRAM is left for the expert cache: it needs at least 332 slots (737 MiB), about 1000 MiB more than this card has free.", result: null, progress: null }];
+      return route.fulfill({ response: r, json: j });
+    });
+    await page.reload();
+    const expert = page.getByRole('button', { name: 'Expert mode' });
+    await expert.waitFor({ timeout: 20000 });
+    await page.waitForTimeout(1500);
+    await expert.click();
+    const sel = page.getByRole('combobox', { name: 'Native KV format' });
+    if (!await sel.isVisible().catch(() => false)) { await page.waitForTimeout(800); if (!await sel.isVisible().catch(() => false)) await page.getByRole('button', { name: /expert mode/i }).first().click(); }
+    await sel.waitFor({ timeout: 10000 });
+    const hint = page.locator('.native-kv-hint');
+    check(/INT8 is the standard/.test(await hint.innerText()), `${tag}: Context memory: one line says what the chosen format is`);
+    await sel.click();
+    check(await page.getByRole('option').count() === 3, `${tag}: Context memory: three options`);
+    const titles = await page.locator('.select__option-label').evaluateAll(els => els.map(e => e.getAttribute('title')));
+    check(titles.length === 3 && titles.every(x => x && x.length > 20), `${tag}: Context memory: each option carries its line`, JSON.stringify(titles));
+    await page.getByRole('option', { name: 'Q4' }).click();
+    await page.waitForTimeout(300);
+    check(/Q4 uses about half the memory/.test(await hint.innerText()), `${tag}: Context memory: the line follows the choice`);
+    await hint.scrollIntoViewIfNeeded();
+    await shot(page, `3723-${tag}-kv`);
+    const notice = page.locator('.error-notice');
+    await notice.first().waitFor({ timeout: 10000 });
+    const said = await notice.first().innerText();
+    check(/did not fit in your graphics card.s memory/.test(said) && /Context memory to Q4/.test(said), `${tag}: a start that ran out of graphics memory says so in plain words`, said.replace(/\n+/g, ' | ').slice(0, 200));
+    await notice.first().scrollIntoViewIfNeeded();
+    await shot(page, `3723-${tag}-vram`);
+    check((await page.evaluate(() => document.documentElement.scrollWidth)) <= w, `${tag}: no sideways scroll`);
+    check(page.problems.length === 0, `${tag}: no page error`, page.problems.join('; '));
+    await page.context().close();
+  }
+};
+
+/* ------------------------------------------------------------------------------------------------------------------- #4749 */
+cases.helper = async () => {
+  const agents = [
+    { id: 'child-1', name: 'Check the tests', description: 'All 12 tests pass.', status: 'completed', durationMs: 42000, tokens: 1800, updatedAt: Date.now() },
+    { id: 'child-2', name: 'Write the notes', description: 'Could not write notes.txt', status: 'failed', durationMs: 9000, tokens: 400, updatedAt: Date.now() },
+  ];
+  for (const scheme of ['light', 'dark']) for (const [sizeName, [w, h]] of Object.entries(sizes)) {
+    const tag = `${scheme}-${sizeName}`;
+    const sessions = [{ ...chat('s1', 'Helpers', [user('u1', 'Do two things'), reply('a1', 'Both helpers are on it.')]), agents }];
+    const posts = []; let refuse = false;
+    const page = await open(scheme, w, h, sessions, { before: async p => {
+      await p.route('**/api/chat/helper', async r => { posts.push(r.request().postDataJSON()); if (refuse) return r.fulfill({ status: 409, json: { error: 'This helper cannot take a message any more. Ask the assistant in the chat to start a new one.' } }); return r.fulfill({ json: { ok: true, messageId: 'm1' } }); });
+    } });
+    await page.getByRole('button', { name: /Subagents/ }).first().click();
+    const rows = page.locator('.subagent-row');
+    await rows.first().waitFor({ timeout: 15000 });
+    // The finished helper: queue.
+    await rows.nth(0).getByRole('button', { name: 'Message this helper' }).click();
+    const input = rows.nth(0).getByRole('textbox', { name: 'Message to Check the tests' });
+    await input.fill('use ISO dates in the file you just wrote');
+    await shot(page, `4749-${tag}-writing`);
+    await input.press('Enter');
+    await rows.nth(0).getByRole('status').waitFor({ timeout: 5000 });
+    check(JSON.stringify(posts[0]) === JSON.stringify({ sessionId: 's1', helperId: 'child-1', message: 'use ISO dates in the file you just wrote', delivery: 'queue' }), `${tag}: a finished helper gets the message as a new turn (queue)`, JSON.stringify(posts[0]));
+    check(/Sent to Check the tests\./.test(await rows.nth(0).innerText()) && await input.inputValue() === '', `${tag}: the row says it was sent and the box is empty again`);
+    // A second helper (a failed one is listed too).
+    await rows.nth(1).getByRole('button', { name: 'Message this helper' }).click();
+    await rows.nth(1).getByRole('textbox').fill('also add the date');
+    await rows.nth(1).getByRole('button', { name: 'Send' }).click();
+    await rows.nth(1).getByRole('status').waitFor({ timeout: 5000 });
+    check(posts[1]?.delivery === 'queue' && posts[1]?.helperId === 'child-2', `${tag}: the message goes to the helper that was chosen`, JSON.stringify(posts[1]));
+    // A refusal says so in plain words.
+    refuse = true;
+    await rows.nth(0).getByRole('textbox').fill('one more thing');
+    await rows.nth(0).getByRole('button', { name: 'Send' }).click();
+    await rows.nth(0).getByRole('alert').waitFor({ timeout: 5000 });
+    check(/cannot take a message any more/.test(await rows.nth(0).getByRole('alert').innerText()), `${tag}: a refused message says why in plain words`);
+    check((await page.evaluate(() => document.documentElement.scrollWidth)) <= w, `${tag}: no sideways scroll`);
+    await shot(page, `4749-${tag}-sent`);
+    check(page.problems.length === 0, `${tag}: no page error`, page.problems.join('; '));
+    await page.context().close();
+  }
+};
+
+/* ------------------------------------------------------------------------------------------------------------------- #4783 */
+cases.busy = async () => {
+  const fresh = (scheme, w, h, whileBusy) => open(scheme, w, h, [chat('s1', 'Busy', [])], { prefs: whileBusy ? { whileBusy } : {} });
+  const send = async (page, text) => { await page.locator('textarea').first().fill(text); await page.keyboard.press('Enter'); };
+  const lastReply = page => page.locator('.st-msg--assistant .st-bubble').last();
+  for (const scheme of ['light', 'dark']) {
+    const w = 1280, h = 860, tag = scheme;
+    // Wait (the default): Enter while it answers sends nothing, the message stays in the box, and a note says why.
+    let page = await fresh(scheme, w, h, null);
+    await send(page, 'SCRIPT:slow 80');
+    await page.locator('.st-msg--assistant').first().waitFor({ timeout: 15000 });
+    await page.locator('textarea').first().fill('my second message');
+    await page.keyboard.press('Enter');
+    await page.waitForTimeout(600);
+    check(await page.locator('textarea').first().inputValue() === 'my second message', `${tag}: Wait: the message stays in the box`);
+    check(await page.locator('.parked').count() === 0, `${tag}: Wait: nothing is parked`);
+    await page.getByText('The assistant is still answering').first().waitFor({ timeout: 4000 }).catch(() => {});
+    check(await page.getByText('The assistant is still answering').count() > 0, `${tag}: Wait: a note says the assistant is still answering`);
+    await page.context().close();
+    // Send after: it waits (shown), and goes when the answer is done, after the whole first answer.
+    page = await fresh(scheme, w, h, 'queue');
+    await send(page, 'SCRIPT:slow 80');
+    await page.locator('.st-msg--assistant').first().waitFor({ timeout: 15000 });
+    await page.locator('textarea').first().fill('SCRIPT:echo the second answer');
+    check(/Enter sends it when the answer is done/.test(await page.locator('.composer__busy-hint').innerText()), `${tag}: Send after: the hint says what Enter will do`);
+    await page.keyboard.press('Enter');
+    await page.locator('.parked').waitFor({ timeout: 3000 });
+    check(/Waiting to send/.test(await page.locator('.parked').innerText()) && /second answer/.test(await page.locator('.parked').innerText()), `${tag}: Send after: the waiting message is shown`);
+    if (scheme === 'light') await shot(page, `4783-${tag}-waiting`);
+    await page.locator('.st-msg--assistant').nth(1).waitFor({ timeout: 30000 });
+    await page.waitForFunction(() => document.querySelectorAll('.parked').length === 0, null, { timeout: 15000 });
+    const firstText = await page.locator('.st-msg--assistant .st-bubble').first().innerText();
+    check(/w79/.test(firstText), `${tag}: Send after: the first answer was written to its end`, firstText.slice(-30));
+    check(/the second answer/.test(await lastReply(page).innerText()), `${tag}: Send after: then the second message was answered`);
+    await page.context().close();
+    // Interrupt: the answer stops where it is, what is written stays, and the message goes at once.
+    page = await fresh(scheme, w, h, 'interject');
+    await send(page, 'SCRIPT:slow 600');
+    await page.locator('.st-msg--assistant').first().waitFor({ timeout: 15000 });
+    await page.waitForTimeout(800);
+    await page.locator('textarea').first().fill('SCRIPT:echo interrupted and answered');
+    check(/Enter stops the answer here and sends it now/.test(await page.locator('.composer__busy-hint').innerText()), `${tag}: Interrupt: the hint says what Enter will do`);
+    await page.keyboard.press('Enter');
+    const t0 = Date.now();
+    await page.locator('.st-msg--assistant').nth(1).waitFor({ timeout: 30000 });
+    check(Date.now() - t0 < 12000, `${tag}: Interrupt: the new message was answered long before the first answer would have ended`, `${Date.now() - t0} ms`);
+    const cut = await page.locator('.st-msg--assistant .st-bubble').first().innerText();
+    check(cut.includes('w0') && !cut.includes('w599'), `${tag}: Interrupt: the first answer stopped where it was and stays`, `${cut.length} characters`);
+    await page.waitForFunction(() => /interrupted and answered/.test([...document.querySelectorAll('.st-msg--assistant .st-bubble')].at(-1)?.innerText ?? ''), null, { timeout: 15000 }).catch(() => {});
+    check(/interrupted and answered/.test(await lastReply(page).innerText()), `${tag}: Interrupt: the second message was answered`);
+    if (scheme === 'light') await shot(page, `4783-${tag}-interrupted`);
+    check(page.problems.length === 0, `${tag}: no page error`, page.problems.join('; '));
+    await page.context().close();
+  }
+};
+
+/* ------------------------------------------------------------------------------------------------------------------- #4785 */
+cases.quote = async () => {
+  const long = 'First point: local models keep your files on your own computer. Second point: nothing has to be uploaded to a service. Third point: you can work without a network connection.';
+  for (const scheme of ['light', 'dark']) for (const [sizeName, [w, h]] of Object.entries(sizes)) {
+    const tag = `${scheme}-${sizeName}`;
+    const page = await open(scheme, w, h, [chat('s1', 'Quote', [user('u1', 'Why run a model locally?'), reply('a1', long), user('u2', 'Thanks, one more question'), reply('a2', 'Ask away.')])]);
+    await page.locator('.st-msg--assistant').first().waitFor({ timeout: 15000 });
+    // A whole turn, from the message menu.
+    await page.locator('.st-msg--assistant').first().hover();
+    await page.locator('.st-msg--assistant').first().getByRole('button', { name: 'More response actions' }).click();
+    await page.getByRole('menuitem', { name: 'Quote' }).click();
+    await page.locator('.quote').first().waitFor({ timeout: 5000 });
+    check(/Quoting the assistant/.test(await page.locator('.quote').first().innerText()) && /First point/.test(await page.locator('.quote').first().innerText()), `${tag}: Quote in the message menu puts the turn above the box`);
+    // Just a passage: select the second sentence and quote it.
+    await page.evaluate(() => {
+      const p = document.querySelector('.st-msg--assistant .st-bubble p');
+      const node = p.firstChild; const at = node.textContent.indexOf('Second point'); const end = node.textContent.indexOf('Third point');
+      const r = document.createRange(); r.setStart(node, at); r.setEnd(node, end);
+      const s = window.getSelection(); s.removeAllRanges(); s.addRange(r);
+    });
+    await page.locator('.quote-selection').waitFor({ timeout: 5000 });
+    const sbox = await page.locator('.quote-selection').boundingBox();
+    check(!!sbox && sbox.x >= 0 && sbox.y >= 0 && sbox.x + sbox.width <= w, `${tag}: a Quote button appears by the selected words, on screen`, JSON.stringify(sbox));
+    await page.locator('.quote-selection').click();
+    check(await page.locator('.quote').count() === 2 && /^Second point: nothing has to be uploaded to a service\.$/.test((await page.locator('.quote .quote__text').nth(1).innerText()).trim()), `${tag}: the second quote is just the selected passage, listed after the first`);
+    check(await page.locator('.quote-selection').count() === 0, `${tag}: the button goes away`);
+    await shot(page, `4785-${tag}-quotes`);
+    // Remove one, quote it again, jump to the message.
+    await page.locator('.quote').first().getByRole('button', { name: 'Remove this quote' }).click();
+    check(await page.locator('.quote').count() === 1 && /Second point/.test(await page.locator('.quote').first().innerText()), `${tag}: one quote can be removed without touching the others`);
+    await page.locator('.quote__body').first().click();
+    await page.waitForTimeout(400);
+    // Send an answer: the model gets the fixed form, the transcript shows the quote apart from the reply.
+    await page.locator('textarea').first().fill('SCRIPT:echo thanks for the quote');
+    await page.keyboard.press('Enter');
+    await page.locator('.sent-quote').first().waitFor({ timeout: 15000 });
+    await page.waitForTimeout(300);
+    const sent = await page.locator('.st-msg--user').last().innerText();
+    check(/Second point: nothing has to be uploaded/.test(sent) && /SCRIPT:echo thanks for the quote/.test(sent) && !/Quoting:/.test(sent) && !/「/.test(sent), `${tag}: the sent message shows the quote apart from the reply, without the markup`, sent.replace(/\n+/g, ' | ').slice(0, 160));
+    const got = worker.requests.at(-1)?.raw ?? '';
+    check(got.includes('Quoting:\\n「Second point: nothing has to be uploaded to a service.」\\n→ Reply: SCRIPT:echo thanks for the quote'), `${tag}: the model receives the quote in its fixed form`, got.slice(-220));
+    check(await page.locator('.quote').count() === 0, `${tag}: the quotes are cleared after sending`);
+    await page.locator('.sent-quote').first().click();
+    check(await page.locator('.sent-quotes[data-open]').count() === 1, `${tag}: a click opens the rest of a sent quote`);
+    await shot(page, `4785-${tag}-sent`);
+    check((await page.evaluate(() => document.documentElement.scrollWidth)) <= w, `${tag}: no sideways scroll`);
+    check(page.problems.length === 0, `${tag}: no page error`, page.problems.join('; '));
+    await page.context().close();
+  }
+};
+
+/* ------------------------------------------------------------------------------------------------------------------- #4244 */
+cases.ask = async () => {
+  const t = await tuneHost();
+  await t.mode('ok');
+  const asked = () => fetch(`${t.origin}/__fixture/asked`).then(r => r.json());
+  await fetch(`${t.origin}/__fixture/ask`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ on: true }) });
+  for (const scheme of ['light', 'dark']) for (const [sizeName, [w, h]] of Object.entries(sizes)) {
+    const tag = `${scheme}-${sizeName}`;
+    const before = (await asked()).length;
+    const page = await open(scheme, w, h, [chat('s1', 'Ask', [])], { origin: t.origin });
+    await page.locator('textarea').first().fill('Build me a page');
+    await page.keyboard.press('Enter');
+    const card = page.locator('.askq');
+    await card.waitFor({ timeout: 15000 });
+    const text = await card.innerText();
+    check(/Which colour should the page be\?/.test(text) && /Which extras do you want\?/.test(text) && /Warm and strong/.test(text) && /It sets the whole theme/.test(text), `${tag}: the question, its detail and the option descriptions are shown`);
+    check(await page.locator('.askcard').count() === 1 && await page.locator('.approvaldock').count() === 1, `${tag}: it is one card in the dock above the box`);
+    const send = page.getByRole('button', { name: 'Send answer' });
+    check(await send.isDisabled(), `${tag}: Send answer waits until every question has an answer`);
+    await page.getByRole('radio', { name: /Red/ }).click();
+    await page.getByRole('radio', { name: /Blue/ }).click();
+    check(await page.getByRole('radio', { name: /Red/ }).getAttribute('aria-checked') === 'false' && await page.getByRole('radio', { name: /Blue/ }).getAttribute('aria-checked') === 'true', `${tag}: a single-select question takes one choice`);
+    await page.getByRole('checkbox', { name: 'Dark mode' }).click();
+    await page.getByRole('checkbox', { name: 'Animations' }).click();
+    check(await send.isEnabled(), `${tag}: Send answer works once every question has an answer`);
+    await page.waitForTimeout(300);
+    const sb = await send.boundingBox();
+    const top = await page.evaluate(({ x, y }) => { const e = document.elementFromPoint(x, y); return e?.closest('button')?.textContent ?? ''; }, { x: sb.x + sb.width / 2, y: sb.y + sb.height / 2 });
+    check(sb.y >= 0 && sb.y + sb.height <= h && /Send answer/.test(top), `${tag}: the answer buttons are in view and reachable without scrolling the card`, JSON.stringify(sb));
+    await shot(page, `4244-${tag}`);
+    check((await page.evaluate(() => document.documentElement.scrollWidth)) <= w, `${tag}: no sideways scroll`);
+    const box = await page.locator('.approvaldock').boundingBox();
+    check(!!box && box.y >= 0 && box.y + box.height <= h + 1, `${tag}: the dock with the card is inside the window`, JSON.stringify(box));
+    await send.click();
+    await page.waitForFunction(() => document.querySelectorAll('.askq').length === 0, null, { timeout: 8000 });
+    const got = (await asked()).slice(before);
+    check(JSON.stringify(got.at(-1)) === JSON.stringify({ sessionId: 's1', callId: 'call-ask-1', answers: [{ id: 'q1', selected: ['Blue'] }, { id: 'q2', selected: ['Dark mode', 'Animations'] }] }), `${tag}: the answer goes to the host as chosen`, JSON.stringify(got.at(-1)));
+    check(await page.locator('.askq').count() === 0, `${tag}: the card goes away, and the turn ends`);
+    // The person's own words, and a skip.
+    await page.locator('textarea').first().fill('Again');
+    await page.keyboard.press('Enter');
+    await card.waitFor({ timeout: 15000 });
+    await page.getByRole('textbox', { name: 'Type your own answer' }).first().fill('Green, like the logo');
+    await page.getByRole('checkbox', { name: 'Animations' }).click();
+    await send.click();
+    await page.waitForFunction(() => document.querySelectorAll('.askq').length === 0, null, { timeout: 8000 });
+    const own = (await asked()).slice(before).at(-1);
+    check(JSON.stringify(own?.answers) === JSON.stringify([{ id: 'q1', selected: [], custom: 'Green, like the logo' }, { id: 'q2', selected: ['Animations'] }]), `${tag}: the person's own words are sent as such`, JSON.stringify(own));
+    await page.locator('textarea').first().fill('Once more');
+    await page.keyboard.press('Enter');
+    await card.waitFor({ timeout: 15000 });
+    await page.getByRole('button', { name: 'Skip' }).click();
+    await page.waitForFunction(() => document.querySelectorAll('.askq').length === 0, null, { timeout: 8000 });
+    check((await asked()).slice(before).at(-1)?.skip === true, `${tag}: Skip is sent as a skip`);
+    check(page.problems.length === 0, `${tag}: no page error`, page.problems.join('; '));
+    await page.context().close();
+  }
+  // A /loop runs without anyone there: the question is skipped at once, no card, and the loop is not left waiting.
+  {
+    const before = (await asked()).length;
+    const page = await open('light', 1280, 860, [chat('s1', 'Loop', [])], { origin: t.origin });
+    await page.locator('textarea').first().fill('/loop 10m Build me a page stop after 1 answer');
+    await page.keyboard.press('Enter');
+    await page.waitForFunction(async () => (await (await fetch('/__fixture/asked')).json()).length > 0, null, { timeout: 15000 }).catch(() => {});
+    const got = (await asked()).slice(before).at(-1);
+    check(got?.skip === true && got?.callId === 'call-ask-1', 'a loop: the question is skipped at once', JSON.stringify(got));
+    check(await page.locator('.askq').count() === 0, 'a loop: no question card is shown');
+    await page.context().close();
+  }
+  await fetch(`${t.origin}/__fixture/ask`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ on: false }) });
+};
+
+/* ------------------------------------------------------------------------------------------------------------------- #3818 (a probe, no fix) */
+cases.select = async () => {
+  const paras = Array.from({ length: 40 }, (_, i) => `Paragraph ${i + 1}. This is a sentence of a long answer that goes on for a while so that the reply overflows the window.`).join('\n\n');
+  const pick = async (page, fromText, toText) => {
+    const a = await page.getByText(fromText, { exact: false }).first().boundingBox(), b = await page.getByText(toText, { exact: false }).first().boundingBox();
+    await page.mouse.move(a.x + 2, a.y + a.height / 2);
+    await page.mouse.down();
+    await page.mouse.move(b.x + b.width - 4, b.y + b.height / 2, { steps: 12 });
+    await page.mouse.up();
+    return page.evaluate(() => window.getSelection().toString());
+  };
+  const page = await open('light', 1280, 860, [chat('s1', 'Select', [user('u1', 'Write a lot'), reply('a1', paras)])]);
+  await page.locator('.st-bubble p').first().waitFor({ timeout: 15000 });
+  await page.locator('.main__body.chat').evaluate(el => { el.scrollTop = el.scrollHeight; });
+  await page.waitForTimeout(400);
+  // After the reply has finished: a drag across several paragraphs.
+  const visible = await page.evaluate(() => [...document.querySelectorAll('.st-bubble p')].filter(p => { const r = p.getBoundingClientRect(); return r.top > 100 && r.bottom < innerHeight - 220; }).map(p => p.textContent.slice(0, 12)));
+  const first = visible[0], last = visible.at(-1);
+  const got = await pick(page, first, last);
+  check(got.includes(first) && got.includes(last) && got.split('\n').filter(Boolean).length >= visible.length, `finished reply: a drag across ${visible.length} paragraphs selects all of them`, `${got.length} characters`);
+  await page.context().close();
+  // While a reply streams: select a passage of the older reply, and see whether the selection and the view stay.
+  const page2 = await open('light', 1280, 860, [chat('s1', 'Select', [user('u1', 'Write a lot'), reply('a1', paras)])]);
+  await page2.locator('.st-bubble p').first().waitFor({ timeout: 15000 });
+  await page2.locator('textarea').first().fill('SCRIPT:slow 400');
+  await page2.keyboard.press('Enter');
+  await page2.waitForTimeout(1500);
+  const v2 = await page2.evaluate(() => [...document.querySelector('.st-msg--assistant').querySelectorAll('.st-bubble p')].filter(p => { const r = p.getBoundingClientRect(); return r.top > 100 && r.bottom < innerHeight - 220; }).map(p => p.textContent.slice(0, 12)));
+  if (v2.length >= 2) {
+    // The selection is made in code here (a drag moves with the layout and made this probe flaky): words of the older reply, as a drag would select them.
+    const sel0 = await page2.evaluate(([a, b]) => {
+      const ps = [...document.querySelector('.st-msg--assistant').querySelectorAll('.st-bubble p')], from = ps.find(p => p.textContent.startsWith(a)), to = ps.find(p => p.textContent.startsWith(b));
+      const r = document.createRange(); r.setStart(from.firstChild, 0); r.setEnd(to.lastChild, to.lastChild.textContent.length);
+      const s = window.getSelection(); s.removeAllRanges(); s.addRange(r); return s.toString();
+    }, [v2[0], v2.at(-1)]);
+    const top0 = await page2.locator('.main__body.chat').evaluate(el => el.scrollTop);
+    await page2.waitForTimeout(3000);
+    const sel1 = await page2.evaluate(() => window.getSelection().toString());
+    const top1 = await page2.locator('.main__body.chat').evaluate(el => el.scrollTop);
+    console.log(`INFO streaming: selection ${sel0.length} -> ${sel1.length} characters, scrollTop ${Math.round(top0)} -> ${Math.round(top1)}`);
+    console.log(`INFO before: ${JSON.stringify(sel0.slice(0, 40))} ... ${JSON.stringify(sel0.slice(-40))}
+INFO after:  ${JSON.stringify(sel1.slice(0, 40))} ... ${JSON.stringify(sel1.slice(-40))}`);
+    check(sel1 === sel0, 'streaming: a selection in the older reply stays as it was while the new reply is written (a selection inside the paragraph that is being written does not: React replaces its text node on every token)', `${sel0.length} -> ${sel1.length}`);
+    check(Math.abs(top1 - top0) < 40, 'streaming: the view is not pulled away from the selection', `${Math.round(top0)} -> ${Math.round(top1)}`);
+  } else console.log('INFO streaming: the older reply was not on screen, nothing to select');
+  await page2.context().close();
+};
+
+/* ------------------------------------------------------------------------------------------------------------------ run */
+let ran = 0;
+for (const [name, fn] of Object.entries(cases)) {
+  if (ONLY.length && !ONLY.includes(name)) continue;
+  console.log(`--- ${name}`);
+  ran += 1;
+  try { await fn(); } catch (e) {
+    check(false, `${name} threw`, String(e?.stack ?? e).split('\n').slice(0, 4).join(' | '));
+    const last = pages.at(-1);
+    if (last && !last.isClosed()) {
+      await last.screenshot({ path: join(SHOTS, `debug-${name}.png`) }).catch(() => {});
+      console.log('PAGE TEXT:', ((await last.evaluate(() => document.body.innerText).catch(() => '')) || '').slice(0, 600).replace(/\n+/g, ' | '));
+      console.log('PAGE ERRORS:', last.problems?.join('; '));
+    }
+  }
+}
+check(ran > 0, 'at least one case ran');
+await browser.close();
+await worker.close();
+for (const proc of [child, tuneHostInfo?.proc]) if (proc) { if (process.platform === 'win32') spawnSync('taskkill', ['/PID', String(proc.pid), '/T', '/F'], { windowsHide: true }); else proc.kill('SIGTERM'); }
+try { rmSync(home, { recursive: true, force: true, maxRetries: 3 }); } catch { /* best effort */ }
+process.exit(failed ? 1 : 0);

apps/host/server/agent/README.md

@@ -1,5 +1,8 @@
 # Agent bridge (Strata chats as DeepSeek Harness sessions)
 
+This page is for developers who work on the app host's agent code. It lists the files, the frames and routes, and the rules the
+bridge enforces. Tests are listed at the end.
+
 The Harness is a separate, pinned component (`DSH 0.2.1-alpha.3`, commit `57190202`, MIT). The host finds it through
 `STRATA_HARNESS_DIR` (or `<STRATA_COMPONENTS_DIR>/harness`), starts one `dsh --profile web` process on a loopback port,
 and talks to its Gateway. Nothing here downloads or builds anything.
@@ -14,11 +17,13 @@ and talks to its Gateway. Nothing here downloads or builds anything.
 | `children.mjs` | pure projection of one helper agent's events into its row and its approval card |
 | `preset.mjs` | the agent preset (which tools the chat has) |
 | `plugins/strata-gate.mjs` | the Manual-mode approval gate (a Harness plugin, loaded by path) |
+| `plugins/strata-search.mjs`, `plugins/strata-models.mjs` | the app's web search registered with the Harness; helper agents on a named model |
+| `plugins/strata-context.mjs`, `context-budget.mjs`, `context-fit.mjs` | measured context pressure, summaries that fit the window, the check before a message goes out |
 | `agent-bridge.mjs` | the chat-to-session map, turns, approvals, Stop, status |
 
 ## Frames sent on `/api/chat/stream` for an agent turn
 
-`queued`, `start` (`agent:true`), `reasoning`, `delta`, `agent-tool` (new: upserts a tool card by call id with
+`queued`, `start` (`agent:true`), `reasoning`, `delta`, `agent-tool` (upserts a tool card by call id with
 `running | proposed | done | denied | error`), `done` (usage, `finishReason`, `cancelled`), `error`, and `notice`
 (why a chat is not using the agent). The chat UI renders them with its existing components.
 
@@ -56,7 +61,8 @@ The chat's Mode menu is real Harness behaviour. Each turn the page sends the cha
 | Bypass | `strata-bypass` | `danger-full-access` | `never` | Full access without prompts, as before. |
 
 - Manual relies on the gate, so a Manual turn does not start unless the bridge has confirmed the gate is loaded (`/strata-gate` command): without it Manual would be an open sandbox that nobody asks about.
-- The gate listens to `tools/pre-execute` (the seam the Harness's own Auto-review layer uses) and returns an `ask` decision; the Harness's approval service then asks, runs the tool only after `allowed-once`, and records the answer. Read-only tools and a short allowlist of look-only shell commands (Get-ChildItem, git status, ...) run unasked; MCP and unknown tools ask.
+- The gate listens to `tools/pre-execute` (the seam the Harness's own Auto-review layer uses) and returns an `ask` decision; the Harness's approval service then asks, runs the tool only after `allowed-once`, and records the answer. Read-only tools and a short allowlist of look-only shell commands (Get-ChildItem, git status, ...) run unasked, each only with the options listed for it in `strata-gate.mjs` (an unknown option, or one that writes, runs a program, sets something or never ends, asks); MCP and unknown tools ask.
+- Web search and web pages (`web_search`, `web_fetch`) ask once per chat in Manual, not once per call. The gate asks through the approval service itself (`webDecision`: "The assistant wants to search the web for: ... Search words go to <service>." / "... open the web page ..."), remembers a yes for the chat (a helper agent shares its chat's answer, and two searches started together share one card), and on a no gives the model `WEB_REFUSAL` ("The person did not allow web access ... Go on without it and say so."). Plan and Bypass are unchanged. Settings -> Tools has a switch, "Let the assistant search the web without asking" (off by default, `webWithoutAsking` in `tools-settings.mjs`, passed to the gate as `config.web.skipAsk`), that skips the question in Manual. A scheduled task has nobody at the card, so its web call is answered no unless that switch is on. Tests: `tests/web-ask.test.mjs`.
 - The mode is read once per turn; an unknown or missing value is Manual.
 
 ## Tools
@@ -68,7 +74,7 @@ The chat's Mode menu is real Harness behaviour. Each turn the page sends the cha
 What the person chose is saved by `tools-settings.mjs` (inside the host's settings file) and shown by `src/components/SettingsTools.tsx` (`GET/PUT /api/agent/tools`, `POST/PATCH/DELETE /api/agent/tools/custom[/id]`). A change reaches the agent from the next message: the profile carries a `toolsSignature`, and the bridge restarts the Harness (after the running turns end) when it differs.
 
 - Tool groups (`tools-catalog.mjs`): each is one switch in plain words and is one or more preset plugins (`withoutDisabled`); `fetch` and `search` are the two halves of the Harness's `tool-web` (both off drops it). Goals off: `/goal` answers that goals are turned off.
-- Web search needs no account. The default is DuckDuckGo's HTML result page (`../web-search-ddg.mjs`), with Bing's plain result page (`../web-search-bing.mjs`) as the second source. Manners, because DuckDuckGo refuses a program that asks fast (a real box: two searches in 1.2 s answered, the third got HTTP 202 and every DuckDuckGo page refused for many minutes): a browser User-Agent and the page's own request shape (Referer, Origin, Sec-Fetch-*), one request at a time per source, 2.5 to 4 s apart (random), at most 8 a minute, a 30 minute session cache per question, a cooldown after a refusal that doubles (1, 2, 4 ... 10 minutes, `Retry-After` honoured) during which that source gets no request, no lite-page follow-up after a refusal, one retry for a timeout or a 5xx, a 15 s limit. When every source refuses, the tool answers one plain sentence (`LIMITED_SENTENCE`: "Web search is limited right now. Try again in a minute, or add a search key (Exa, Perplexity or DeepSeek) in Settings -> Tools -> Web search.") plus an instruction to the model not to retry; the turn guard in `agent-bridge.mjs` (see Turn guard) stops a model that retries anyway. **The results come from DuckDuckGo or Bing**; they are not ranked or filtered here. The person may switch to Exa, Perplexity or DeepSeek with their own key (`../web-search-keyed.mjs`; DeepSeek uses the Harness's own provider): the key is saved in the settings file, reaches the agent only as the environment variable `STRATA_SEARCH_KEY`, never the profile file and never the screen (it only learns `keySet`). A keyed service without its key falls back to DuckDuckGo. The profile pins `web.searchProvider` to the chosen id so two usable backends cannot make the choice ambiguous.
+- Web search needs no account. The default is DuckDuckGo's HTML result page (`../web-search-ddg.mjs`), with Bing's plain result page (`../web-search-bing.mjs`) as the second source. Manners, because DuckDuckGo refuses a program that asks fast: a browser User-Agent and the page's own request shape (Referer, Origin, Sec-Fetch-*), one request at a time per source, 2.5 to 4 s apart (random), at most 8 a minute, a 30 minute session cache per question, a cooldown after a refusal that doubles (1, 2, 4 ... 10 minutes, `Retry-After` honoured) during which that source gets no request, no lite-page follow-up after a refusal, one retry for a timeout or a 5xx, a 15 s limit. When every source refuses, the tool answers one plain sentence (`LIMITED_SENTENCE`: "Web search is limited right now. Try again in a minute, or add a search key (Exa, Perplexity or DeepSeek) in Settings -> Tools -> Web search.") plus an instruction to the model not to retry; the turn guard in `agent-bridge.mjs` (see Turn guard) stops a model that retries anyway. **The results come from DuckDuckGo or Bing**; they are not ranked or filtered here. The person may switch to Exa, Perplexity or DeepSeek with their own key (`../web-search-keyed.mjs`; DeepSeek uses the Harness's own provider): the key is saved in the settings file, reaches the agent only as the environment variable `STRATA_SEARCH_KEY`, never the profile file and never the screen (it only learns `keySet`). A keyed service without its key falls back to DuckDuckGo. The profile pins `web.searchProvider` to the chosen id so two usable backends cannot make the choice ambiguous.
 - The browser: Playwright's MCP server (`@playwright/mcp`, staged next to the Harness by `apps/desktop/scripts/stage-harness.mjs`) on the person's own Chrome, Edge or Chromium (`browser-probe.mjs`), `--isolated` so it never sees their profile. Tools appear as `mcp__browser__browser_*`. In Manual, opening a page, clicking, typing, uploading, running a script in the page and closing tabs ask (plain reasons: "Open the web page ...", "Click on the page: ..."); looking (snapshot, screenshot, console, network, waiting, listing tabs) does not. Plan refuses every connected tool. The screen says plainly when no browser, or no tool server, is found.
 - The person's own tools: `instructions` (the tool returns their text; look-only, never asks), `command` (runs their command with the assistant's text in the `STRATA_INPUT` environment variable, never spliced into the command line; asks in Manual, refused in Plan) and `server` (a web address or a program, added as `mcp__custom-<name>__*`; asks in Manual). Instruction and command tools are served by `custom-tools-mcp.mjs` (stdio MCP) from a JSON file the settings module rewrites on every change, so a switch in Settings is seen without a restart.
 - `strata-gate.mjs` implements the Manual/Plan rules above (`planDecision`, `browserDecision`, the look-only instruction server).
@@ -79,7 +85,7 @@ What the person chose is saved by `tools-settings.mjs` (inside the host's settin
 - A helper's request for approval is the same card (state `proposed`, id `<helper session>:<call>`), answered with the same `/api/chat/approval`; a chat can only answer its own helpers.
 - The run (the chat's one NDJSON response) stays open until the parent is idle, every helper has finished and reported back, and no armed goal is waiting; `done` is sent then.
 - Stop: pauses an active goal, interrupts every helper (`subagents/interruptByParent`; `session/cancel` on a helper session is refused by the Harness), cancels the parent, waits; a report that would wake the parent afterwards is cancelled too.
-- The number of helpers at once equals the engine's request slots (`maxActiveSubagents` in the profile); the Harness refuses more with a message the model reads.
+- The number of helpers at once is the engine's request slots, with a floor of 4 for a local model and 8 for an API model (`maxActiveSubagents` in the profile). The Harness refuses more with a message the model reads.
 
 ## /goal
 
@@ -87,8 +93,15 @@ What the person chose is saved by `tools-settings.mjs` (inside the host's settin
 
 ## Thinking and the output budget
 
+The Harness staging script (`apps/desktop/scripts/stage-harness.mjs`) applies Strata's guarded pi-ai 1.1.0 patch to its staged copy
+(`harness-budget.mjs`, #3684): below 64K the context safety room is at most `min(4096, floor(contextWindow / 16))` and never more
+than half the estimated remaining room, so an 8K window keeps output room after a tool result instead of ending with a one-token
+cap. The caller's output cap and the one-token floor remain; windows of 64K or more keep the previous calculation. `BUNDLE.json.patches`
+records the patch identity, the dependency version and the before/after SHA-256. Unknown dependency bytes stop staging for review.
+Source and already-installed Harness copies are not changed.
+
 - A local route is reasoning-capable (`reasoning: true`) with `compat.thinkingFormat: 'chat-template'`: the request carries `chat_template_kwargs {enable_thinking, reasoning_effort}`, which the Strata server reads (a top-level `enable_thinking` is ignored by it, which is why pi-ai's `qwen` format left the model thinking). The chat's Reasoning menu travels as `thinking` in the stream body; the bridge sends it with `session/selectModel` (`reasoningEffort`) whenever the model or the level changed; a level a route does not have is dropped (never an error). API routes keep the provider default (the menu is disabled for them in the UI).
-- `localOutputBudget(context)` = context minus 4096 (it was context/4 capped at 8192, which cut big answers off at exactly 8192 tokens); pi-ai sends the window minus the prompt. App-loaded models get `fit_max_tokens: true` so the engine clamps instead of answering 400. Sampling is not set here: the Harness sends none, so the server's own defaults apply.
+- `localOutputBudget(context)` is 30 percent of the window, at least 4096 and at most 32768 (9,830 tokens at 32K, 19,660 at 64K). The Harness's automatic compaction reads it as the room a reply reserves (the request header), and it is NOT the ceiling of a request: `plugins/strata-context.mjs` raises what the adapter sends to half the window, at most 64K tokens (`reply-cut.mjs` `replyCap`; pi-ai clamps it to the window minus the prompt), because a thinking model that writes a whole file in one call was cut inside the call at 19,660 and lost it (AGENT-LOST). A reply that is cut anyway is announced in the chat, the agent is asked to go on in smaller pieces (twice at most), and the file being written is streamed to the page as `agent-tool-draft` frames (name, size, lines, tail of the text). App-loaded models get `fit_max_tokens: true` so the engine clamps instead of answering 400. Sampling is not set here: the Harness sends none, so the server's own defaults apply.
 
 ## Tasks
 
@@ -106,7 +119,7 @@ Failures the person sees are plain sentences with a next step (`AgentUnavailable
 
 ## Helper agents on a named model (`plugins/strata-models.mjs`, `model-routes.mjs`)
 
-The Harness's `subagent` tool takes an exact `provider` route key and model id, and the app had its model choice switched off, so every helper ran on the chat's model. The profile now enables the Harness's `subagent-model-selection-settings` with every route the app can reach (local instances and saved API models), and the `strata-models` plugin wraps the two tool definitions the Harness registers for each chat (`subagent`, `list_subagent_models`) in place:
+The Harness's `subagent` tool takes an exact `provider` route key and model id. The profile enables the Harness's `subagent-model-selection-settings` with every route the app can reach (local instances and saved API models), and the `strata-models` plugin wraps the two tool definitions the Harness registers for each chat (`subagent`, `list_subagent_models`) in place:
 
 - the model is found from its id, `provider/id`, the name in the model picker, `connection name`, or "local" (any letters). A close guess is not started: the tool answers "Did you mean ...?" and nothing runs until the call is made again with that model. Several fits are listed; nothing fitting lists the models that can be used and says they can be added in Models.
 - the tool's own text says when to use it ("ask a subagent", "ask model X"), not to look for the model with shell commands, and not to wait with sleep. The system prompt (`preset.mjs`) says the same, so it reaches every model, local or hosted.
@@ -124,10 +137,31 @@ Pictures are on by default for every model that can read them: an API model read
 
 ## Turn guard (`turn-guard.mjs`)
 
-A turn that keeps failing the same way is stopped by the app, never left to the model. Seen on a search-heavy `/plan`: every web search was refused, the model searched again and rewrote its plan after each one until the context reached 100%, then the turn ended with no answer and no message.
+A turn that keeps failing the same way is stopped by the app, never left to the model.
 
 - **Counted, from what the turn shows:** web searches that failed in a row (3), searches in one turn (10 in a plan turn, 25 otherwise), a plan turn that starts its numbered list from `1.` again (4 times), and a context of 93% or more (the Harness's own compaction did not keep up).
 - **Stopped the way Stop stops** (`session/cancel`, helpers first) but ended as a normal turn (`done`, not cancelled, no error card), so the plan the model had written is still proposed. The plan card carries the reason (`plan.caution`); any other turn ends with one `delta` frame that has `own: true` and `key` (the English sentence, translated by the page; `GUARD_NOTES` are in the interface catalog in all eight languages). Each sentence says what happened and gives one next step.
 - **Compaction:** after a guard stop (and after a turn the model server refused because the context was full) the bridge asks the Harness for `/compact` on that session, so the next message has room. Best effort and logged.
 - **Never silent:** a turn that ends (`completed` or `max-tokens`) with no answer text gets "I ran out of room in this chat..." when the last request used 85% of the window or more, otherwise "I stopped without writing an answer..." (not when tool cards were shown, not after Stop, not after an error, which says why by itself). Goal runs have their own ending lines and are not guarded.
 - Tests: `tests/agent-turn-guard.test.mjs` (counting, always; end to end with the real Harness, the scripted model's `searchloop` and `bloat` scripts and `searchMock: 'limited'` on the bridge, which runs the real search code on a pretend web that refuses, no network).
+
+## Context: measured pressure, summaries that fit, the check before a message goes out
+
+- **`plugins/strata-context.mjs`** (inserted by the profile, like the gate) wraps `tokenMeter.measure` and `llm.stream` in place, once each. Pressure = the last prompt size the model server reported for an answer, plus what changed since priced at the density that measurement showed (`context-budget.mjs`: `pressureNow`, `densityOf`); never lower than the Harness's own price. Node prices are scaled the same way, so the retained tail is in real tokens. A summary request (`purpose: 'compaction'`) that would not fit the window is asked for in pieces: a message bigger than a piece is cut for the request only, each piece builds on the summary before it, a piece the server refuses is halved and tried again. `/strata-context` (a Harness command, like `/strata-gate`) answers `{tokens, window}` for a session so the host can tell the person true figures.
+- **`context-fit.mjs`**: before a message is sent the model server counts it (`POST /v1/messages/count_tokens`, its own tokenizer). `decideFit`: send; summarise first and then send (the message fits an otherwise empty chat); or never fits. The last one is not sent: the error frame has `code: 'CONTEXT_MESSAGE_TOO_LARGE'` and the page offers "Attach as a file" (`oversize.mjs`, `/api/chat/oversize`: the text is saved in the chat's folder, the assistant reads it in parts) or "Send a shortened preview". An engine that cannot count lets the message through; the Harness's own compact-and-retry is the net.
+- **`/compact`** is handled by the host (`compactCommand`): the Harness's `/compact`, then a plain line with the measured figures ("The chat was 90% full and is now 38% full"), or "nothing older to summarize" when the newest message is what fills the chat.
+- **Visible:** `compaction/start` shows "Summarizing earlier messages..." in the status line; `compaction/end` adds one plain line to the reply. The projector also sends a `context` frame after every model request, so the meter follows the running turn.
+- **A refusal that is left** (`CONTEXT_WINDOW_EXCEEDED`) is a plain sentence with the engine's text under Details and the buttons "Summarize and continue" and "Start a new chat". "Try sending the message again" is for other errors only.
+- Tests: `tests/agent-context.test.mjs` (arithmetic; the real Harness against the scripted worker with `window`, `charsPerToken` and `noCount`), `tests/oversize.test.mjs`, `tests/context-ui.test.mjs`. The run against a real engine is `scripts/context-e2e.mjs`.
+
+## History / older measurements
+
+- **Search refusals (2026-10):** on a real box two DuckDuckGo searches in 1.2 s answered, the third got HTTP 202, and every DuckDuckGo page refused for many minutes.
+  The pacing, cooldown and cache rules above come from that test.
+- **Search-heavy `/plan` (2026-10):** every web search was refused, the model searched again and rewrote its plan after each one until the context reached 100%.
+  The turn ended with no answer and no message. The turn guard comes from that run.
+- **Large log paste (2026-10-22, installed 0.2.1, Gyro-S, 64K):** a 118 KB log was 66,500 tokens to the engine and about 29,500 to the Harness
+  (4 characters a token; logs and code are about 2). The engine refused it with a 400. The refusal stayed in the history, so neither the next message nor `/compact` could
+  go through, because the summary request carried the same history. `/compact` was also not a command of the app yet: it went to the model as a question. This
+  produced `strata-context.mjs`, `context-fit.mjs` and the host's own `/compact`.
+- **Output budget:** an earlier local budget of a quarter of the window, capped at 8192, cut big answers off at exactly 8192 tokens.

apps/host/server/agent/agent-bridge.mjs

@@ -22,13 +22,20 @@ import { randomUUID } from 'node:crypto';
 import { GatewayClient } from './gateway-client.mjs';
 import { HarnessProcess, resolveHarness, redact, stopStaleAgent } from './harness-runtime.mjs';
 import { StatusReporter } from './status.mjs';
-import { buildProfile, routeFor, MODE_PRESETS, modeOf, effortOf } from './profile.mjs';
+import { buildProfile, routeFor, MODE_PRESETS, modeOf, effortOf, localOutputBudget, compactionHeadroom } from './profile.mjs';
 import { TurnProjector, parseArguments as parseArgs } from './events.mjs';
 import { ChildProjector } from './children.mjs';
 import { nearestBudget } from './llm-shape.mjs';
 import { DeliverableTracker, ActivityGroups } from './deliverables.mjs';
 import { SkillsUsed, skillInfoFrom } from './skills-used.mjs';
+import { turnEngineSpeed } from './engine-speed.mjs';
 import { TurnGuard, guardNote, GUARD_NOTES } from './turn-guard.mjs';
+import { cutNotice, cutNudge } from './reply-cut.mjs';
+
+/** How often one turn asks the agent to carry on after a reply the length limit cut (each time in smaller pieces). */
+export const MAX_CUT_RETRIES = 2;
+import { buildAnswer, parseQuestions } from './user-questions.mjs';
+import { BASE_TOKENS, COUNT_ABOVE_CHARS, FIT_TEXT, countTokens, decideFit, fill, grouped } from './context-fit.mjs';
 import { PlanStore, planPrompt, parsePlan, parsePoints, stepObjective, stepLine, firstSentence, stepSummary, planAsPrompt, editedSteps, planView, researchPrompt, researchWritePrompt, RESEARCH_NUDGE, parseSources } from './plan.mjs';
 
 /**
@@ -110,11 +117,12 @@ const deferred = () => { let resolve; const promise = new Promise(r => { resolve
  * @param {string|null} [options.componentsDir]         where installed components live
  * @param {() => Array} options.localInstances          ready local instances (see profile.mjs)
  * @param {() => Array} options.connections             saved API connections WITH their keys (host-internal)
+ * @param {() => (string|null)} [options.defaultLocalId]  the local instance the chat runs on: its tool servers are the agent's (T5)
  * @param {NodeJS.ProcessEnv} [options.env]
  * @param {string} [options.nodePath]                   the Node runtime that runs the Harness
  * @param {(line:string)=>void} [options.log]
  */
-export function createAgentBridge({ dataDir, componentsDir = null, bundledDir = null, gate = true, localInstances, connections, tools = () => undefined, skillsDir = () => null, onGoal = () => {}, onPlan = () => {}, onQueue = () => {}, proxyBase = null, searchMock = null, expertSampling = () => null, stallMs = 4 * 60_000, stallToolMs = 20 * 60_000, env = process.env, nodePath = process.execPath, log = () => {}, startTimeoutMs = 120_000, sessionReadyMs = 60_000, sessionRetryMs = 1_500 }) {
+export function createAgentBridge({ dataDir, componentsDir = null, bundledDir = null, gate = true, localInstances, connections, tools = () => undefined, defaultLocalId = () => null, skillsDir = () => null, onGoal = () => {}, onPlan = () => {}, onQueue = () => {}, proxyBase = null, searchMock = null, expertSampling = () => null, engineProgress = () => null, engineGraceMs = 30 * 60_000, stallMs = 4 * 60_000, stallToolMs = 20 * 60_000, env = process.env, nodePath = process.execPath, log = () => {}, startTimeoutMs = 120_000, sessionReadyMs = 60_000, sessionRetryMs = 1_500 }) {
   const root = join(dataDir, 'agent');
   const home = join(root, 'home');
   const sessionsFile = join(root, 'sessions.json');
@@ -154,6 +162,8 @@ export function createAgentBridge({ dataDir, componentsDir = null, bundledDir =
   const queues = new Map();
   const queueView = chatId => (queues.get(chatId) ?? []).map(({ id, text, at, deliverAt }) => ({ id, text, at, deliverAt }));
   const pending = new Map();       // `${sessionId}:${callId}` -> { eventId, sessionId, callId, at }
+  const questions = new Map();     // `${sessionId}:${callId}` -> the agent's own question waiting for the person: { eventId, sessionId, callId, items, at, clientId } (#4244)
+  const chatOfSession = sessionId => Object.keys(sessionMap).find(id => sessionMap[id]?.sessionId === sessionId) ?? null;
   const idleWaiters = new Set();
 
   const chat = id => { let c = chats.get(id); if (!c) { c = { id, turn: null, route: null, routeGeneration: -1 }; chats.set(id, c); } return c; };
@@ -170,7 +180,7 @@ export function createAgentBridge({ dataDir, componentsDir = null, bundledDir =
   /** The agent's profile now, plus where its shaped routes really lead (read by the forwarding endpoint). */
   let shapeTargets = {};
   function buildProfileNow() {
-    const profile = buildProfile({ local: localInstances(), connections: connections(), gate, tools: tools(), skillsDir: skillsDir(), proxyBase, searchMock });
+    const profile = buildProfile({ local: localInstances(), connections: connections(), gate, tools: tools(), skillsDir: skillsDir(), proxyBase, searchMock, defaultLocalId: defaultLocalId() });
     shapeTargets = profile.shapeTargets ?? {};
     return profile;
   }
@@ -192,6 +202,8 @@ export function createAgentBridge({ dataDir, componentsDir = null, bundledDir =
       harness: { version: h.version },
       runtime: rt?.hp.running ? { pid: rt.hp.pid, generation: rt.generation } : null,
       routes: profile.routes.map(({ route, kind, modelId, name, contextWindow }) => ({ route, kind, modelId, name, contextWindow })),
+      // tool servers that could not be wired (a name the rule does not allow, no program or address): the chat says so
+      skippedServers: profile.mcpSkipped ?? [],
       activeTurns: activeTurns(),
       pendingApprovals: pending.size,
     };
@@ -228,6 +240,13 @@ export function createAgentBridge({ dataDir, componentsDir = null, bundledDir =
     return next;
   }
 
+  /** The local engine's own speed for this turn's requests (null when it cannot be read: the stream's estimate stays). */
+  async function engineSpeedOf(route, projector) {
+    const inst = localInstances().find(i => i.id === route.instanceId);
+    if (!inst) return null;
+    return turnEngineSpeed({ baseUrl: inst.baseUrl, key: inst.key, since: projector.startedAt, attempts: projector.streams.size, timeoutMs: 800 });
+  }
+
   /** Make sure a runtime exists that knows the route this turn needs. */
   async function ensureRuntime(choice, signal) {
     for (;;) {
@@ -263,10 +282,23 @@ export function createAgentBridge({ dataDir, componentsDir = null, bundledDir =
       if (!r.callId) return;
       pending.set(`${value.agentId}:${r.callId}`, { eventId: value.eventId, sessionId: value.agentId, callId: r.callId, tool: r.toolName, reason: r.reason ?? null, at: Date.now(), clientId: runtime.clientId });
     } else if (value.type === 'waterfall' && value.event === 'user-questions/request') {
-      // The app has no surface for the agent's own questions yet. Declaring that nobody can answer makes
-      // the tool return an error the model reads and carries on from, instead of a turn that waits forever.
-      void runtime.gw.answerEvent({ clientId: runtime.clientId, eventId: value.eventId, outcome: 'next' }).catch(() => {});
+      // The agent of a chat that is running in front of the person asks the person: the question goes to the page (the question card above the message box) and the
+      // Harness waits for the answer. Anything else (a helper's question, a chat that is stopping, a request with nothing to show) is declared
+      // unanswerable, which makes the tool return an error the model reads and carries on from, instead of a turn that waits forever.
+      const r = value.request ?? {};
+      const chatId = chatOfSession(value.agentId);
+      const turn = chatId ? chats.get(chatId)?.turn : null;
+      const items = parseQuestions(r.questions);
+      // A goal or a plan step runs without anyone there: a question would stall it, so it is declined at once (the model reads "could not be answered" and goes on).
+      if (!turn || turn.finished || turn.stopping || turn.goalRun || turn.plan || !turn.announceQuestion || !items.length) {
+        void runtime.gw.answerEvent({ clientId: runtime.clientId, eventId: value.eventId, outcome: 'next' }).catch(() => {});
+      } else {
+        const callId = String(r.wait?.callId ?? value.eventId);
+        questions.set(`${value.agentId}:${callId}`, { eventId: value.eventId, sessionId: value.agentId, callId, items, at: Date.now(), clientId: runtime.clientId });
+        turn.announceQuestion({ type: 'agent-question', callId, questions: items });
+      }
     } else if (value.type === 'cancel') {
+      for (const [k, v] of questions) if (v.eventId === value.eventId) { questions.delete(k); chats.get(chatOfSession(v.sessionId))?.turn?.announceQuestion?.({ type: 'agent-question-end', callId: v.callId }); }
       for (const [k, v] of pending) if (v.eventId === value.eventId) pending.delete(k);
     }
   }
@@ -398,7 +430,27 @@ export function createAgentBridge({ dataDir, componentsDir = null, bundledDir =
     const appliedMode = planTask ? 'plan' : modeOf(mode);
     await applyMode(runtime, sessionId, appliedMode);
 
-    const projector = new TurnProjector({ policy: MODE_PRESETS[appliedMode].approval });
+    // Does the message fit the model's window? Asked before anything is sent, with the model server's own count (context-fit.mjs). A message
+    // that fits once the older messages are a summary is sent after a summary; one that can never fit is not sent, and the person is told
+    // plainly and offered the two ways out. Whatever cannot be counted goes through: the Harness recovers from a refusal by itself.
+    if (!goal && route.kind === 'local') {
+      const fit = await fitCheck({ runtime, route, sessionId, fresh, history, message }).catch(() => null);
+      if (fit?.action === 'too-large') {
+        reporter.clear();
+        const values = [grouped(fit.tokens), grouped(fit.window)];
+        const text = fill(FIT_TEXT.tooLarge, values);
+        emit({ type: 'error', message: text, key: FIT_TEXT.tooLarge, values, code: 'CONTEXT_MESSAGE_TOO_LARGE', tokens: fit.tokens, window: fit.window });
+        return { error: text };
+      }
+      if (fit?.action === 'summarize') {
+        reporter.set({ phase: 'compacting', code: 'compacting', text: FIT_TEXT.summarizing, key: FIT_TEXT.summarizing, values: [] });
+        const done = await compactChat(runtime, sessionId);
+        reporter.clear();
+        if (done.ok) emit(summarizedNote(done.before, done.after, fit.window));
+      }
+    }
+
+    const projector = new TurnProjector({ policy: MODE_PRESETS[appliedMode].approval, window: route.contextWindow });
     if (!goal) guard = new TurnGuard({ plan: !!planTask, contextMax: route.kind === 'local' ? route.contextWindow : 0 });   // a saved connection's window is often only assumed: never judged by a guess
     projector.onStatus = update => { if (!turn?.parentOpen && turn?.children.size && [...turn.children.values()].some(h => !h.done) && update.phase === 'waiting') return; reporter.set(update); };
     const turn = {
@@ -407,7 +459,7 @@ export function createAgentBridge({ dataDir, componentsDir = null, bundledDir =
       abortFromRuntime: reason => finishTurn(reason), finish: failure => finishTurn(failure),
       // Helper agents (subagents) the Harness started for this chat, and the state of the run around them.
       children: new Map(), subagentCalls: new Map(), parentOpen: false, stopping: false, settleTimer: null, mode: appliedMode,
-      plan: null, advancing: false, goalRun: false, lastActivity: Date.now(), watchdog: null,
+      plan: null, advancing: false, goalRun: false, lastActivity: Date.now(), heard: Date.now(), engineMark: null, watchdog: null,
       research: researchTopic ? { phase: 'gather', nudged: false, waitingStart: false } : null,
     };
     c.turn = turn;
@@ -420,6 +472,13 @@ export function createAgentBridge({ dataDir, componentsDir = null, bundledDir =
       if (turn.finished || turn.stopping) return;
       const toolRunning = [...projector.tools.values()].some(x => x.card?.state === 'running' || x.card?.state === 'proposed') || pending.size > 0 && pendingFor(chatId).length > 0;
       const limit = toolRunning ? stallToolMs : stallMs;
+      // A local engine reading a long prompt sends the Harness nothing for minutes (#3623). Its /metrics progress counts as activity,
+      // for at most engineGraceMs after the Harness last spoke: progress for another chat cannot keep a lost turn alive forever.
+      if (turn.route?.kind === 'local' && Date.now() - turn.heard < engineGraceMs) {
+        let mark = null;
+        try { mark = engineProgress(turn.route.instanceId); } catch { /* no progress known: the Harness alone decides */ }
+        if (mark != null && mark !== turn.engineMark) { turn.engineMark = mark; turn.lastActivity = Date.now(); return; }
+      }
       if (Date.now() - turn.lastActivity < limit) return;
       turn.stalledFor = Math.round((Date.now() - turn.lastActivity) / 1000);
       turn.stopping = true;
@@ -429,9 +488,10 @@ export function createAgentBridge({ dataDir, componentsDir = null, bundledDir =
       turn.finish(`The assistant stopped answering for ${mins > 1 ? mins + ' minutes' : 'a minute'}, so I ended this turn. Anything it already finished is kept. Send your message again to go on.`);
     }, Math.min(15_000, Math.max(200, Math.floor(stallMs / 4))));
     turn.watchdog.unref?.();
-    function finishTurn(failure) {
+    async function finishTurn(failure) {
       if (turn.finished) return;
       turn.finished = true;
+      for (const [k, v] of questions) if (v.sessionId === turn.sessionId) questions.delete(k);
       clearTimeout(turn.settleTimer);
       clearInterval(turn.watchdog);
       turn.follow?.close();
@@ -445,12 +505,22 @@ export function createAgentBridge({ dataDir, componentsDir = null, bundledDir =
       try { extra.push(...settlePlan(failure)); } catch { /* a plan frame must never break the end of a turn */ }
       // The turn guard: a turn the app stopped, or one that ended with no words, always ends with one plain message (a plan card carries it itself).
       let noteReason = turn.guard ?? null;
-      if (!noteReason && guard && !failure && !turn.stopping && !turn.goalRun) {
+      // A reply the length limit cut ends with a sentence that says so (and what was lost), never with silence (AGENT-LOST).
+      const cutEnd = !failure && !turn.stopping && projector.ended?.kind === 'max-tokens';
+      if (cutEnd && !noteReason) {
+        const note = cutNotice({ ...projector.cut(), retrying: false });
+        extra.push({ type: 'delta', own: true, text: `
+
+${note.text}`, key: note.key, values: note.values, noteReason: 'cut' });
+      }
+      if (!noteReason && !cutEnd && guard && !failure && !turn.stopping && !turn.goalRun) {
         noteReason = guard.silent({ ended: projector.ended, wrote: projector.emittedAny === true, acted: projector.tools.size > 0, contextTokens: projector.contextTokens });
       }
       if (noteReason && !extra.some(f => f.type === 'plan' && f.event === 'proposed')) { const note = guardNote(noteReason); if (note) extra.push(note); }
       for (const f of extra) emit(f);
-      const frames = failure ? [{ type: 'error', message: plainAgentFailure(failure), details: failure, code: 'AGENT_STOPPED' }] : projector.finish({ model: route.name, contextMax: route.contextWindow });
+      // The answer speed of a turn on this computer is the engine's own (tokens it produced over its decode time, as the Monitor shows it).
+      const engine = !failure && route.kind === 'local' ? await engineSpeedOf(route, projector) : null;
+      const frames = failure ? [{ type: 'error', message: plainAgentFailure(failure), details: failure, code: 'AGENT_STOPPED' }] : projector.finish({ model: route.name, contextMax: route.contextWindow, engine });
       for (const f of frames.slice(0, -1)) emit(f);
       // Messages typed while the goal ran and not delivered between steps go back to the page now, to be sent as ordinary messages.
       if (turn.goalRun && attached) {
@@ -491,6 +561,7 @@ export function createAgentBridge({ dataDir, componentsDir = null, bundledDir =
     function handle(item) {
       if (turn.finished) return;
       turn.lastActivity = Date.now();
+      turn.heard = turn.lastActivity;
       if (item.type === 'event') {
         const e = item.event;
         if (e.seq <= turn.lastSeq) return;
@@ -528,7 +599,7 @@ export function createAgentBridge({ dataDir, componentsDir = null, bundledDir =
       emitRow(child, true);
       const fold = item => {
         if (turn.finished) return;
-        turn.lastActivity = Date.now();
+        turn.lastActivity = turn.heard = Date.now();
         // A helper that finishes before its throttled "working" row went out would show queued -> completed and never "working": send the held row first.
         if (item.type === 'event' && item.event.type === 'turn/end' && child.rowPending) emitRow(child, true);
         const { frames, row } = cp.consume(item);
@@ -559,6 +630,7 @@ export function createAgentBridge({ dataDir, componentsDir = null, bundledDir =
         case 'turn/start':
           turn.parentOpen = true;
           if (turn.research) turn.research.waitingStart = false;
+          turn.cutWaiting = false;
           clearTimeout(turn.settleTimer);
           // After Stop, a helper's report would start a new turn that nobody asked for.
           if (turn.stopping) void runtime.gw.rpc('session/cancel', { request: { sessionId } }).catch(() => {});
@@ -710,6 +782,24 @@ export function createAgentBridge({ dataDir, componentsDir = null, bundledDir =
           const current = await goalGet();
           if (turn.finished || turn.parentOpen) return;
           if (current && current.phase === 'active' && current.activation === 'armed') { turn.settleTimer = after(700, armSettle); return; }
+          // A reply the length limit cut (AGENT-LOST): the agent lost what it was writing. Say so in the chat and ask it to carry on in smaller pieces, twice at most.
+          if (turn.cutWaiting) { turn.settleTimer = after(300, armSettle); return; }
+          if (projector.ended?.kind === 'max-tokens' && !turn.goalRun && !turn.stopping && (turn.cuts ?? 0) < MAX_CUT_RETRIES) {
+            const cut = projector.cut();
+            turn.cuts = (turn.cuts ?? 0) + 1;
+            const note = cutNotice({ ...cut, retrying: true });
+            emit({ type: 'delta', own: true, text: `
+
+${note.text}
+
+`, key: note.key, values: note.values, noteReason: 'cut' });
+            for (const f of projector.clearCut()) emit(f);
+            turn.cutWaiting = true;
+            try { await runtime.gw.rpc('session/prompt', { request: { requestId: `cut-${randomUUID()}`, sessionId, mode: 'queue', content: [{ type: 'text', text: cutNudge(cut) }] } }); }
+            catch { turn.cutWaiting = false; finishTurn(null); return; }
+            turn.settleTimer = after(500, armSettle);
+            return;
+          }
           // Research: gather (search and read pages), then write the answer in the fixed shape. A step that did not open pages is sent back once.
           if (turn.research && !turn.stopping) {
             const r = turn.research;
@@ -752,6 +842,7 @@ export function createAgentBridge({ dataDir, componentsDir = null, bundledDir =
     }
     turn.announceGoal = announceGoal;
     turn.announceQueue = frame => emit(frame);
+    turn.announceQuestion = frame => emit(frame);
 
     const snapshotTimer = {};
     await Promise.race([turn.snapshot.promise, new Promise((_, rej) => { snapshotTimer.t = after(20_000, () => rej(new Error('the session stream did not open'))); })])
@@ -941,6 +1032,16 @@ export function createAgentBridge({ dataDir, componentsDir = null, bundledDir =
 
   // -- /plan -----------------------------------------------------------------------------------------------
 
+  /** A short answer in the chat that the page translates (the sentence is in the interface catalog, "values" fill its slots). */
+  function sayKey(options, template, values = []) {
+    const { onFrame } = options;
+    onFrame({ type: 'queued', requestId: 'compact-' + randomUUID() });
+    onFrame({ type: 'start', model: '', contextMax: 0, demo: false, remoteModel: false, agent: true, mode: modeOf(options.mode), skills: [] });
+    onFrame({ type: 'delta', text: fill(template, values), key: template, values });
+    onFrame({ type: 'done', finishReason: 'stop', tokensIn: null, tokensOut: null, usageSource: 'unavailable', durationMs: 0 });
+    return { compact: true };
+  }
+
   /** A short answer in the chat (no model): the same frames a turn sends. */
   function sayOnce(options, reply) {
     const { onFrame } = options;
@@ -1044,6 +1145,47 @@ export function createAgentBridge({ dataDir, componentsDir = null, bundledDir =
     delete sessionMap[chatId]; persist();
   }
 
+  // -- the agent's own questions ------------------------------------------------------------------------------
+
+  /**
+   * The person's answer to a question the agent asked (#4244), or a skip. The answer is checked against the questions that were asked, then sent
+   * to the Harness as the result of the waiting `user-questions/request`; a skip declares the question unanswerable, as before, and the model
+   * carries on.
+   */
+  async function answerQuestion({ chatId, callId, answers, skip = false }) {
+    const sessionId = sessionMap[chatId]?.sessionId;
+    const key = `${sessionId}:${callId}`;
+    const entry = questions.get(key);
+    if (!entry || !rt?.hp.running) throw new AgentUnavailable('That question was already answered, or the assistant has gone on.', 'question-gone');
+    const outcome = skip ? 'next' : buildAnswer(entry.items, answers);
+    await rt.gw.answerEvent({ clientId: entry.clientId ?? rt.clientId, eventId: entry.eventId, outcome });
+    questions.delete(key);
+    return { ok: true, skipped: !!skip };
+  }
+
+  // -- a message for a helper ---------------------------------------------------------------------------------
+
+  /**
+   * The person's own words for one helper (#4749), through the Harness's `subagents/prompt`: it delivers one browser-authored message to a
+   * continuable child through its live parent. "steer" reaches a working helper at its next step; "queue" gives a helper that has finished
+   * (or is between steps) a new turn. The Harness refuses a helper that cannot take messages (a one-shot one) and a parent that is not live;
+   * either comes back as a plain sentence.
+   */
+  async function messageHelper({ chatId, helperId, text, delivery = 'queue' }) {
+    const clean = String(text ?? '').trim().slice(0, 8000);
+    if (!clean) throw new AgentUnavailable('Type a few words for the helper.', 'helper-empty');
+    if (!/^[\w.:@-]{1,160}$/.test(String(helperId ?? ''))) throw new AgentUnavailable('That helper is not known.', 'helper-unknown');
+    const parent = sessionMap[chatId]?.sessionId;
+    if (!parent || !rt?.hp.running) throw new AgentUnavailable('The assistant is not running in this chat, so it cannot pass a message on. Send a message in the chat first.', 'helper-idle');
+    try {
+      const receipt = await rt.gw.rpc('subagents/prompt', { request: { requestId: `helper-${randomUUID()}`, parentSessionId: parent, childSessionId: String(helperId), mode: 'continuable', delivery: delivery === 'steer' ? 'steer' : 'queue', content: [{ type: 'text', text: clean }] } });
+      return { ok: true, messageId: receipt?.messageId ?? null, delivery: delivery === 'steer' ? 'steer' : 'queue' };
+    } catch (e) {
+      log(`agent · message for a helper refused: ${String(e?.message ?? e).slice(0, 200)}`);
+      throw new AgentUnavailable(/continuable|one-shot|not.*(found|live|open)|unavailable|closed|ended/i.test(String(e?.message ?? '')) ? 'This helper cannot take a message any more. Ask the assistant in the chat to start a new one.' : 'The message could not be delivered right now. Try again in a moment.', 'helper-refused');
+    }
+  }
+
   // -- messages typed while a goal runs ----------------------------------------------------------------------
 
   /** Queue a message for the running goal. It is delivered between steps, or handed back to the page when the goal ends or pauses. */
@@ -1140,6 +1282,93 @@ export function createAgentBridge({ dataDir, componentsDir = null, bundledDir =
    * Stop one chat's turn. Resolves only once the turn has ended (or the wait times out), because the
    * Harness acknowledges a cancel as admitted, not as done.
    */
+  /** What the chat holds now and the model's window, as the context plugin measures them (null when it cannot be read). */
+  async function contextOf(runtime, sessionId) {
+    try {
+      const r = await runtime.gw.rpc('commands/execute', { agentId: sessionId, line: '/strata-context', submittedAttachments: [] });
+      if (r?.result?.kind !== 'success') return null;
+      const v = JSON.parse(String(r.result.text));
+      return Number.isFinite(v.tokens) ? { tokens: Math.round(v.tokens), window: Number(v.window) > 0 ? Math.round(v.window) : 0 } : null;
+    } catch { return null; }
+  }
+
+  /** The decision of context-fit.mjs for the message about to be sent, or null when the model server cannot count it. */
+  async function fitCheck({ runtime, route, sessionId, fresh, history, message }) {
+    const inst = localInstances().find(i => i.id === route.instanceId);
+    if (!inst || !(route.contextWindow > 0)) return null;
+    const carried = fresh && history.length ? withEarlierConversation(history, message) : message;
+    if (carried.length < COUNT_ABOVE_CHARS) return null;
+    const count = text => countTokens({ baseUrl: inst.baseUrl, key: inst.key, model: inst.modelId, text });
+    let tokens = await count(carried);
+    if (tokens == null) return null;
+    const now = fresh ? null : await contextOf(runtime, sessionId);
+    const window = now?.window || route.contextWindow;
+    const pressure = now?.tokens ?? 0;
+    // Where the Harness starts summarising by itself on this window (profile.mjs: the reply keeps its room, then the headroom).
+    const reply = localOutputBudget(window);
+    const threshold = Math.floor(Math.min(window * 0.8, window - reply - compactionHeadroom(window, reply)));
+    let verdict = decideFit({ window, pressure, messageTokens: tokens, threshold });
+    // The earlier conversation carried into a fresh session is what pushed it over: send the message alone instead.
+    if (verdict.action === 'too-large' && carried !== message) {
+      const alone = await count(message);
+      if (alone != null) { tokens = alone; verdict = decideFit({ window, pressure, messageTokens: alone, threshold }); }
+    }
+    return { ...verdict, tokens, window, pressure };
+  }
+
+  /**
+   * Summarise the older part of a chat with the Harness's /compact and say what happened. Never throws.
+   * ok:true carries the figures before and after; ok:false says why (nothing to summarise, busy, failed).
+   */
+  async function compactChat(runtime, sessionId) {
+    const before = await contextOf(runtime, sessionId);
+    let result;
+    try { result = (await runtime.gw.rpc('commands/execute', { agentId: sessionId, line: '/compact', submittedAttachments: [] }))?.result; }
+    catch (e) { return { ok: false, reason: /not.found|no such/i.test(String(e.message)) ? 'nothing' : 'failed', before, text: String(e.message ?? e) }; }
+    const text = String(result?.text ?? '');
+    log('agent · compact: ' + (result?.kind ?? 'none') + ' ' + text.slice(0, 140));
+    if (result?.kind === 'success' && /^Compacted/i.test(text)) return { ok: true, before, after: await contextOf(runtime, sessionId) };
+    if (result?.kind === 'success') return { ok: false, reason: 'nothing', before, text };
+    if (/active compaction|not idle/i.test(text)) return { ok: false, reason: 'busy', before, text };
+    // The Harness cannot make a summary smaller than what is left when the chat holds little beyond its first prompt: that is nothing to summarise, not a failure.
+    const little = before && before.window > 0 && before.tokens - BASE_TOKENS < before.window * 0.25;
+    return { ok: false, reason: little && /useful summary|not smaller/i.test(text) ? 'nothing' : 'failed', before, text };
+  }
+
+  /** The line in the chat that explains why the context meter fell: how full it was and how full it is. */
+  function summarizedNote(before, after, window) {
+    const w = after?.window || before?.window || window || 0;
+    const pct = v => Math.max(0, Math.min(100, Math.round(100 * v.tokens / w)));
+    const known = w > 0 && before && after;
+    const template = known ? FIT_TEXT.summarized : FIT_TEXT.summarizedShort;
+    const values = known ? [pct(before), pct(after)] : [];
+    return { type: 'delta', own: true, text: '\n\n' + fill(template, values), key: template, values, noteReason: 'compacted' };
+  }
+
+  /** "/compact": summarise the older messages of this chat now, and say in plain words what happened. */
+  async function compactCommand(options) {
+    const { chatId, choice, signal } = options;
+    const c = chat(chatId);
+    const say = (template, values = []) => sayKey(options, template, values);
+    if (c.turn || c.starting) return say(FIT_TEXT.compactBusy);
+    const known = sessionMap[chatId]?.sessionId;
+    if (!known) return say(FIT_TEXT.noChatYet);
+    let runtime;
+    try { ({ rt: runtime } = await ensureRuntime(choice, signal)); } catch { return say(FIT_TEXT.compactFailed); }
+    const done = await compactChat(runtime, known);
+    if (done.ok) {
+      const note = summarizedNote(done.before, done.after, 0);
+      return say(note.key, note.values);
+    }
+    if (done.reason === 'busy') return say(FIT_TEXT.compactBusy);
+    if (done.reason === 'nothing') {
+      const w = done.before?.window || 0;
+      const pct = w > 0 && done.before ? Math.round(100 * done.before.tokens / w) : 0;
+      return say(pct >= 60 ? FIT_TEXT.nothingFull : FIT_TEXT.nothingToSummarize, pct >= 60 ? [pct] : []);
+    }
+    return say(FIT_TEXT.compactFailed);
+  }
+
   /** Summarise the older part of a session with the Harness's own /compact. Best effort: the next message compacts again by itself when it must. */
   async function compactSession(runtime, sessionId) {
     try {
@@ -1180,6 +1409,12 @@ export function createAgentBridge({ dataDir, componentsDir = null, bundledDir =
       .map(p => (p.sessionId === sessionId ? p : { ...p, callId: `${p.sessionId}:${p.callId}` })).map(({ callId, tool, reason, at }) => ({ callId, tool, reason, at }));
   }
 
+  /** Every chat that has an approval waiting, for the task board: the chat, its working folder and what is waiting (same items as pendingFor). */
+  function pendingAll() {
+    if (!pending.size) return [];
+    return Object.keys(sessionMap).map(chatId => ({ chatId, folder: sessionMap[chatId]?.cwd ?? null, pending: pendingFor(chatId) })).filter(c => c.pending.length);
+  }
+
   async function close() {
     const r = rt; rt = null;
     if (r) { r.events?.close(); r.gw.close(); await r.hp.stop(); }
@@ -1188,7 +1423,7 @@ export function createAgentBridge({ dataDir, componentsDir = null, bundledDir =
   /** Let go of a chat's Harness session mapping (a task starts every run in a session of its own). */
   function forget(chatId) { if (chats.get(chatId)?.turn) return; delete sessionMap[chatId]; chats.delete(chatId); persist(); }
 
-  return { goalState, goalControl, harnessDir, status, runTurn, goalCommand, planCommand, researchCommand, llmTarget, setPlanBriefing, resetSession, reopenPlan, skipStep, planGoal, planControl, planState, queueMessage, cancelQueued, takeQueue, forget, approve, setMode, stop, pendingFor, close, sessionOf: chatId => sessionMap[chatId]?.sessionId ?? null, workingFolder: chatId => sessionMap[chatId]?.cwd ?? null, isRunning: chatId => !!chats.get(chatId)?.turn, _debug: () => ({ rt, sessionMap }) };
+  return { compactCommand, messageHelper, answerQuestion, goalState, goalControl, harnessDir, status, runTurn, goalCommand, planCommand, researchCommand, llmTarget, setPlanBriefing, resetSession, reopenPlan, skipStep, planGoal, planControl, planState, queueMessage, cancelQueued, takeQueue, forget, approve, setMode, stop, pendingFor, pendingAll, close, sessionOf: chatId => sessionMap[chatId]?.sessionId ?? null, workingFolder: chatId => sessionMap[chatId]?.cwd ?? null, isRunning: chatId => !!chats.get(chatId)?.turn, _debug: () => ({ rt, sessionMap }) };
 }
 
 /** A goal that stopped by itself, in words. */

apps/host/server/agent/context-budget.mjs

@@ -0,0 +1,174 @@
+/**
+ * Token arithmetic for the agent's context, with no I/O (the Harness plugin `plugins/strata-context.mjs` and the host both use it).
+ *
+ * Why it exists. The Harness prices a conversation with a fixed 4 characters per token. Code, logs and JSON are about twice as dense
+ * (2.09 characters per token in the 2026-10-22 hands-on test), so its pressure read 31,794 tokens while the engine had been sent 59,048,
+ * and compaction waited until the window was already past full. The engine reports the real prompt size with every answer; this module
+ * turns that report into the number compaction decides on, and splits a summarising request that would not fit the window.
+ */
+
+/** The Harness's own price of a text: characters over this, plus a fixed cost per block and per message. */
+export const CHARS_PER_TOKEN = 4;
+const BLOCK_OVERHEAD = 4;
+const MESSAGE_OVERHEAD = 4;
+/** The most a real token can be worth in the Harness's units (one character per token is the worst a tokenizer does). */
+export const MAX_DENSITY = 6;
+/** Room kept free in a window for the engine's own framing and the chat template (the engine keeps 64 tokens of slack itself). */
+export const WINDOW_SLACK = 1024;
+
+/** The Harness's price (4 characters a token) of one message, the same arithmetic as its token meter. */
+export function estimateMessage(message) {
+  const content = Array.isArray(message?.content) ? message.content : [];
+  if (message?.role === 'system') {
+    if (!content.length) return 0;
+    let chars = 0;
+    for (const block of content) chars += block?.type === 'text' ? String(block.text ?? '').length : JSON.stringify(block ?? {}).length;
+    return Math.ceil(chars / CHARS_PER_TOKEN) + MESSAGE_OVERHEAD;
+  }
+  let tokens = MESSAGE_OVERHEAD;
+  for (const block of content) {
+    if (block?.type === 'text' || block?.type === 'reasoning') tokens += Math.ceil(String(block.text ?? '').length / CHARS_PER_TOKEN) + BLOCK_OVERHEAD;
+    else if (block?.type === 'tool-call') tokens += Math.ceil(String(block.name ?? '').length / CHARS_PER_TOKEN) + Math.ceil(String(block.arguments ?? '').length / CHARS_PER_TOKEN) + BLOCK_OVERHEAD;
+    else tokens += BLOCK_OVERHEAD + Math.ceil(JSON.stringify(block ?? {}).length / CHARS_PER_TOKEN);
+  }
+  return tokens;
+}
+
+/** The Harness's price of the tool list of a request header. */
+export function estimateTools(header) {
+  const tools = header?.tools;
+  if (!Array.isArray(tools) || !tools.length) return 0;
+  return Math.ceil(JSON.stringify(tools).length / CHARS_PER_TOKEN) + BLOCK_OVERHEAD;
+}
+
+/**
+ * How many real tokens one of the Harness's tokens is worth, from one measured request: the engine said the prompt was `real` tokens,
+ * the Harness priced the same prompt at `estimated`. Never below 1 (a conversation of plain prose is priced about right, and a lower
+ * number would only delay compaction) and never above MAX_DENSITY (a wild sample must not make every step compact).
+ */
+export function densityOf(real, estimated) {
+  if (!(real > 0) || !(estimated > 0)) return 1;
+  return Math.min(MAX_DENSITY, Math.max(1, real / estimated));
+}
+
+/**
+ * The prompt size compaction decides on. `sample` is the last measured request: `real` tokens for a prompt the Harness priced at
+ * `estimated`. `now` is the Harness's price of the conversation now. What was added or removed since the sample is scaled by the sample's
+ * density; the measured part is exact. Without a sample, or when the measurement is lower than the Harness's own price, the Harness's
+ * price stands (it is never an underestimate that makes this smaller).
+ */
+export function pressureNow({ sample = null, now }) {
+  if (!sample || !(sample.real > 0) || !(sample.estimated > 0)) return Math.max(0, now);
+  const density = densityOf(sample.real, sample.estimated);
+  return Math.max(Math.round(now), Math.round(sample.real + density * (now - sample.estimated)));
+}
+
+/** The usage a finished model request reported, as the prompt side only: input plus the cache's reads and writes (output is not in the prompt). */
+export function promptTokensOf(usage) {
+  if (!usage || typeof usage !== 'object') return 0;
+  const n = value => (Number.isFinite(Number(value)) ? Math.max(0, Number(value)) : 0);
+  return n(usage.inputTokens) + n(usage.cacheReadTokens) + n(usage.cacheWriteTokens);
+}
+
+/** The usage of a settled assistant event (a `usage` on the message, or the last usage chunk of its stream). */
+export function usageOfEvent(event) {
+  const data = event?.data;
+  if (!data) return null;
+  if (data.usage && typeof data.usage === 'object') return data.usage;
+  const stream = Array.isArray(data.stream) ? data.stream : [];
+  for (let i = stream.length - 1; i >= 0; i--) if (stream[i]?.type === 'chunk' && stream[i].chunk?.type === 'usage') return stream[i].chunk.usage ?? null;
+  return null;
+}
+
+/**
+ * A summarising request is: the conversation's system prompt and tools, the messages to condense, then the instruction. This is how many
+ * real tokens the messages may take in a window so that all of it, the summary and a safety margin fit.
+ */
+export function summaryBudget({ window, summaryTokens, toolsTokens = 0, systemTokens = 0, instructionTokens = 900, slack = WINDOW_SLACK }) {
+  return Math.floor(window - summaryTokens - toolsTokens - systemTokens - instructionTokens - slack);
+}
+
+/** Text blocks of a message, longest first: the ones worth shortening when a single message is bigger than the budget. */
+function textBlocks(message) {
+  return (Array.isArray(message?.content) ? message.content : []).filter(b => (b?.type === 'text' || b?.type === 'reasoning') && typeof b.text === 'string');
+}
+
+/**
+ * One message cut down to `maxTokens` (in the Harness's price times `density`): the start and the end of its longest text are kept and
+ * the middle is replaced by a line saying how much was left out. Only the copy sent to the summariser is cut; the conversation keeps
+ * the whole message until the summary replaces it.
+ */
+export function clipMessage(message, maxTokens, density = 1) {
+  if (estimateMessage(message) * density <= maxTokens) return message;
+  const blocks = textBlocks(message);
+  if (!blocks.length) return message;
+  const others = estimateMessage({ ...message, content: (message.content ?? []).filter(b => !blocks.includes(b)) }) * density;
+  const room = Math.max(256, maxTokens - others);
+  const share = room / blocks.reduce((n, b) => n + b.text.length, 0) / density * CHARS_PER_TOKEN;   // characters kept per character
+  const content = (message.content ?? []).map((block) => {
+    if (!blocks.includes(block)) return block;
+    const keep = Math.max(200, Math.floor(block.text.length * Math.min(1, share) - 120));
+    if (block.text.length <= keep) return block;
+    const head = Math.ceil(keep * 0.6), tail = keep - head;
+    const left = block.text.length - head - tail;
+    return { ...block, text: `${block.text.slice(0, head)}\n\n[… ${left.toLocaleString('en-US')} characters from the middle are left out of this summary request …]\n\n${block.text.slice(block.text.length - tail)}` };
+  });
+  return { ...message, content };
+}
+
+/** Whether cutting the list in front of index `i` would separate a tool call from its result. */
+function balancedBefore(messages, i) {
+  let open = 0;
+  for (let k = 0; k < i; k++) {
+    const m = messages[k];
+    if (m?.role === 'assistant') open += (Array.isArray(m.content) ? m.content : []).filter(b => b?.type === 'tool-call').length;
+    else if (m?.role === 'tool') open -= 1;
+  }
+  return open <= 0;
+}
+
+/**
+ * Split messages into runs that each fit `budget` real tokens (price `density`), cutting between a tool call's result and the next
+ * message when it can. A message bigger than the budget by itself is clipped first. Order is kept.
+ */
+export function splitMessages(messages, budget, density = 1) {
+  const room = Math.max(512, budget);
+  const sized = messages.map(m => clipMessage(m, Math.floor(room * 0.8), density));
+  const cost = sized.map(m => estimateMessage(m) * density);
+  const runs = [];
+  let start = 0, used = 0;
+  for (let i = 0; i < sized.length; i++) {
+    if (i > start && used + cost[i] > room) {
+      // Cut as late as possible, but never between a tool call and its result when a clean place exists inside the run.
+      let cut = i;
+      while (cut > start + 1 && !balancedBefore(sized, cut)) cut--;
+      if (!balancedBefore(sized, cut)) cut = i;
+      runs.push(sized.slice(start, cut));
+      start = cut;
+      used = cost.slice(start, i).reduce((n, x) => n + x, 0);
+    }
+    used += cost[i];
+  }
+  if (start < sized.length) runs.push(sized.slice(start));
+  return runs;
+}
+
+/** Whether a failure is the model server saying the prompt does not fit its window. */
+export function isContextOverflow(error) {
+  if (!error) return false;
+  if (error.code === 'CONTEXT_WINDOW_EXCEEDED') return true;
+  const text = [error.message, error.cause?.message, error.failure?.message, error.failure?.code].filter(Boolean).join(' ');
+  return /request exceeds the context window|leaves no room to answer|context[_ ]length|context window|too many tokens|maximum context/i.test(text);
+}
+
+/** The Harness asks for "concise English engineering prose", so a Chinese or Russian chat came back summarised in English (#4750). One sentence is added to the
+ *  summary request's last message: write it in the language the person used. Paths, commands and identifiers stay exact. Messages are not changed in place. */
+export const SUMMARY_LANGUAGE_RULE = 'Write the summary in the language the person used in this conversation (English only when they wrote English). The instruction above is in English; that does not change the language of the summary. Keep file paths, commands, error strings, identifiers and numbers exactly as they appear.';
+export function withSummaryLanguage(messages) {
+  if (!Array.isArray(messages) || !messages.length) return messages;
+  const last = messages[messages.length - 1];
+  if (!last || last.role !== 'user') return messages;
+  const content = typeof last.content === 'string' ? last.content + ' ' + SUMMARY_LANGUAGE_RULE
+    : Array.isArray(last.content) ? [...last.content, { type: 'text', text: SUMMARY_LANGUAGE_RULE }] : null;
+  return content === null ? messages : [...messages.slice(0, -1), { ...last, content }];
+}

apps/host/server/agent/context-fit.mjs

@@ -0,0 +1,102 @@
+/**
+ * Does a message fit the model's window? Asked before it is sent, with the model server's own count, so a message the server would refuse
+ * is never read for half a minute first (2026-10-22: a 103 KB paste was 70,141 tokens in a 65,536-token window, and the 400 came back after
+ * the whole prompt had been read). No I/O except the one count request; everything else is arithmetic the tests call directly.
+ *
+ * Three answers: send it; summarise the chat first and then send it (the message fits once the older messages are a summary); or it can
+ * never fit, and the person is offered the two ways out that do (the text as a file the assistant reads in parts, or a shortened preview).
+ */
+
+/** What a new chat already holds before the person's first word: the system prompt and the tool list. Measured 10,510 by the Harness's price. */
+export const BASE_TOKENS = 12000;
+/** The least room a reply needs after the prompt: an eighth of the window, at most this. */
+export const REPLY_FLOOR = 4096;
+/** A message shorter than this many characters cannot matter to a window of 8K or more, so it is not even counted. */
+export const COUNT_ABOVE_CHARS = 3000;
+
+export const replyRoom = window => Math.max(512, Math.min(REPLY_FLOOR, Math.floor(window / 8)));
+
+/**
+ * @param {{window:number, pressure?:number, base?:number, messageTokens:number, threshold?:number}} input
+ *   `pressure` is what the chat holds now (measured), `base` what an empty chat holds, `messageTokens` the new message, `threshold` where the
+ *   Harness starts summarising by itself. The Harness looks at that only before its NEXT step, so a big message that arrives now would otherwise
+ *   be sent on top of a chat already near the threshold (2026-10-22: 54K of 64K held by the time it was looked at): summarise first.
+ * @returns {{action:'send'|'summarize'|'too-large', room:number, needs:number}}
+ */
+export function decideFit({ window, pressure = 0, base: given = BASE_TOKENS, messageTokens, threshold = 0 }) {
+  const reply = replyRoom(window);
+  const base = Math.min(given, Math.floor(window * 0.6));   // on a small window the first prompt cannot be what the window is made of
+  // A chat holds at least what an empty one does (the system prompt and the tools), so a new chat is not counted as empty.
+  const needs = Math.max(pressure, base) + messageTokens + reply;
+  if (!(window > 0) || !(messageTokens >= 0)) return { action: 'send', room: Infinity, needs: 0 };
+  if (needs <= window) {
+    const worthIt = pressure > base + window * 0.1;   // older messages worth summarising: more than a tenth of the window beyond the first prompt
+    if (threshold > 0 && worthIt && pressure + messageTokens > threshold) return { action: 'summarize', room: window - needs, needs, why: 'threshold' };
+    return { action: 'send', room: window - needs, needs };
+  }
+  // Not as it stands. Does the message fit in an otherwise empty chat (only the system prompt and the tools before it)?
+  if (base + messageTokens + reply <= window) return { action: 'summarize', room: window - (base + messageTokens + reply), needs };
+  return { action: 'too-large', room: window - (base + messageTokens + reply), needs };
+}
+
+/**
+ * The model server's count of a text (its tokenizer and chat template), through its Anthropic-style count endpoint.
+ * Returns the number, or null when it cannot be had (an old engine, a server that is busy, a timeout): then nothing is blocked.
+ */
+export async function countTokens({ baseUrl, key = '', model = '', text, fetchImpl = fetch, timeoutMs = 8000 }) {
+  try {
+    const root = String(baseUrl ?? '').replace(/\/v1\/?$/, '').replace(/\/$/, '');
+    const res = await fetchImpl(`${root}/v1/messages/count_tokens`, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json', ...(key ? { authorization: `Bearer ${key}`, 'x-api-key': key } : {}) },
+      body: JSON.stringify({ model, messages: [{ role: 'user', content: String(text) }] }),
+      signal: AbortSignal.timeout(timeoutMs),
+    });
+    if (!res.ok) return null;
+    const n = Number((await res.json())?.input_tokens);
+    return Number.isFinite(n) && n >= 0 ? Math.round(n) : null;
+  } catch { return null; }
+}
+
+/** The plain sentences (also in the interface catalog in all nine languages). `{0}` slots are filled by the page. */
+export const FIT_TEXT = Object.freeze({
+  tooLarge: 'This message is about {0} tokens long, and this model can read about {1} at a time. It is too large to send as it is.',
+  tooLargeNext: 'Attach it as a file for the assistant to read in parts, or send a shortened preview.',
+  full: 'This conversation no longer fits the model’s window, and summarizing the older messages did not make enough room.',
+  fullNext: 'Summarize it now and continue, or start a new chat.',
+  summarizing: 'Summarizing earlier messages…',
+  summarized: 'Older messages were summarized to make room. The chat was {0}% full and is now {1}% full.',
+  summarizedWas: 'Older messages were summarized to make room. The chat was {0}% full.',
+  summarizedShort: 'Older messages were summarized to make room.',
+  nothingFull: 'This chat is {0}% full, but there is nothing older to summarize: the newest message is what fills it. Start a new chat, or send a shorter message.',
+  nothingToSummarize: 'There is nothing older to summarize yet. Everything in this chat is still needed by the assistant.',
+  noChatYet: 'There is nothing to summarize yet. This chat has not started a conversation with the assistant.',
+  compactFailed: 'The older messages could not be summarized right now. Try again in a moment, or start a new chat.',
+  compactBusy: 'This chat is still working. Stop it or wait for it to finish, then try again.',
+});
+export const fill = (template, values = []) => String(template).replace(/\{(\d+)\}/g, (_, i) => String(values[Number(i)] ?? ''));
+
+/** A number with thousands separators, the way the page writes it. */
+export const grouped = n => Math.round(n).toLocaleString('en-US');
+
+/**
+ * The two ways to send a message that is too large.
+ *   file     the whole text goes in a file in the chat's folder; the message names it and shows how it starts
+ *   preview  the start and the end of the text, cut to what the window can hold, with the number of characters left out
+ * @param {{text:string, mode:'file'|'preview', tokens:number, window:number, pressure?:number, base?:number, path?:string}} input
+ * @returns {{message:string, kept:number}}
+ */
+export function oversizedReplacement({ text, mode, tokens, window, pressure = 0, base = BASE_TOKENS, path = '' }) {
+  const t = String(text);
+  const charsPerToken = tokens > 0 ? Math.max(0.8, t.length / tokens) : 3;
+  if (mode === 'file') {
+    const start = t.slice(0, 1200).trimEnd();
+    return { kept: start.length, message: `My message was too long to send in the chat, so I saved it as a file: ${path}\n\nIt starts like this:\n\n${start}\n\n[the rest is in the file]\n\nPlease read the file in parts (it is long) and then do what my message asks.` };
+  }
+  const room = Math.max(1000, Math.floor((window - Math.max(pressure, base) - replyRoom(window)) * 0.7));
+  const keep = Math.max(500, Math.floor(room * charsPerToken * 0.9));
+  const head = Math.ceil(keep * 0.7), tail = keep - head;
+  const left = Math.max(0, t.length - head - tail);
+  if (!left) return { kept: t.length, message: t };
+  return { kept: head + tail, message: `${t.slice(0, head)}\n\n[… ${grouped(left)} characters from the middle are left out because the message was too long to send …]\n\n${t.slice(t.length - tail)}` };
+}

apps/host/server/agent/custom-command-run.mjs

@@ -0,0 +1,103 @@
+/**
+ * Runs the command of a command tool the person wrote (Settings -> Tools). Split from custom-tools-mcp.mjs so it can be tested.
+ *
+ * T7 (tools and images review, 2026-10-22). It used to run every command with `shell: true` (cmd.exe on Windows, so `Get-Content x` failed with
+ * "not recognized"), in whatever folder the host happened to run in (so `python tools/foo.py` could not find its file), and ended it after two
+ * minutes with 20,000 characters of output, silently cut.
+ *
+ *   shell      'auto' (default): PowerShell for a Windows command that reads as PowerShell (Get-Content, Start-Process, $env:X, $(...)), cmd.exe for
+ *              any other Windows command (so every command that worked keeps working), /bin/sh elsewhere. 'cmd', 'powershell', 'bash' and 'sh' name one.
+ *   cwd        the folder to run in: the tool's own, or the one the assistant names in the call (it knows the chat's folder); else the person's home.
+ *   timeoutSec the time allowed, 1 to 3600 (default 120). A command that runs over is ended together with the programs it started.
+ */
+import { spawn, spawnSync } from 'node:child_process';
+import { existsSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+
+export const DEFAULT_TIMEOUT_SEC = 120;
+export const MAX_TIMEOUT_SEC = 3600;
+export const OUT_MAX = 20000;
+export const SHELLS = ['auto', 'cmd', 'powershell', 'bash', 'sh'];
+
+/** A Windows command that is PowerShell and would fail in cmd.exe. */
+const POWERSHELL_LOOKS = /(^|[\s;|(&])[A-Z][A-Za-z]+-[A-Z][A-Za-z]+\b|\$\w|\$\(|\$env:|@\(|\|\s*(?:%|\?)\s*\{/;
+export const looksLikePowerShell = command => POWERSHELL_LOOKS.test(String(command ?? ''));
+
+let powershellFound;
+/** pwsh when it is installed (PowerShell 7), else the Windows PowerShell every Windows has. */
+function powershellExe(platform) {
+  if (powershellFound) return powershellFound;
+  if (platform !== 'win32') return (powershellFound = 'pwsh');
+  try { if (spawnSync('where', ['pwsh'], { windowsHide: true, timeout: 5000 }).status === 0) return (powershellFound = 'pwsh'); } catch { /* none */ }
+  return (powershellFound = 'powershell.exe');
+}
+
+/**
+ * -> { file, args, shell } for spawn: which program runs `command`.
+ * @param {string} command
+ * @param {{shell?: string, platform?: string}} [options]
+ */
+export function planShell(command, { shell = 'auto', platform = process.platform } = {}) {
+  const windows = platform === 'win32';
+  let choice = SHELLS.includes(shell) ? shell : 'auto';
+  if (choice === 'auto') choice = windows ? (looksLikePowerShell(command) ? 'powershell' : 'cmd') : 'sh';
+  if (choice === 'powershell') return { file: powershellExe(platform), args: ['-NoProfile', '-NonInteractive', '-ExecutionPolicy', 'Bypass', '-Command', command], shell: false, name: 'PowerShell' };
+  if (choice === 'bash') return { file: 'bash', args: ['-c', command], shell: false, name: 'bash' };
+  if (choice === 'sh') return windows ? { file: 'sh', args: ['-c', command], shell: false, name: 'sh' } : { file: command, args: [], shell: true, name: 'sh' };
+  return { file: command, args: [], shell: true, name: windows ? 'cmd.exe' : 'sh' };       // cmd: spawn's shell:true is cmd.exe on Windows
+}
+
+/** The folder a command runs in: -> { cwd } or { error } with a plain sentence. */
+export function resolveCwd(...candidates) {
+  for (const candidate of candidates) {
+    const text = typeof candidate === 'string' ? candidate.trim() : '';
+    if (!text) continue;
+    const expanded = text.replace(/^~(?=$|[\\/])/, homedir());
+    try {
+      if (!existsSync(expanded) || !statSync(expanded).isDirectory()) return { error: `The folder “${text}” does not exist, so the command was not run.` };
+    } catch { return { error: `The folder “${text}” could not be opened, so the command was not run.` }; }
+    return { cwd: expanded };
+  }
+  return { cwd: homedir() };
+}
+
+export const clampTimeoutSec = value => {
+  const n = Number(value);
+  return Number.isFinite(n) && n >= 1 ? Math.min(Math.floor(n), MAX_TIMEOUT_SEC) : DEFAULT_TIMEOUT_SEC;
+};
+
+function endTree(child) {
+  try {
+    if (process.platform === 'win32' && child.pid) spawnSync('taskkill', ['/PID', String(child.pid), '/T', '/F'], { windowsHide: true, timeout: 10000 });
+    else child.kill('SIGKILL');
+  } catch { /* gone */ }
+}
+
+/**
+ * @param {{command: string, input?: string, cwd?: string, callCwd?: string, shell?: string, timeoutSec?: number, platform?: string}} job
+ * @returns {Promise<{ok: boolean, text: string}>}
+ */
+export function runCommand({ command, input = '', cwd, callCwd, shell = 'auto', timeoutSec, platform = process.platform }) {
+  return new Promise(resolve => {
+    const where = resolveCwd(callCwd, cwd);
+    if (where.error) return resolve({ ok: false, text: where.error });
+    const plan = planShell(command, { shell, platform });
+    const limit = clampTimeoutSec(timeoutSec);
+    let child;
+    try {
+      child = spawn(plan.file, plan.args, { shell: plan.shell, windowsHide: true, cwd: where.cwd, env: { ...process.env, STRATA_INPUT: String(input ?? '') }, stdio: ['ignore', 'pipe', 'pipe'] });
+    } catch (e) { return resolve({ ok: false, text: `The command could not start in ${plan.name}: ${e.message}` }); }
+    let text = '', cut = false, timedOut = false;
+    const take = chunk => { if (text.length < OUT_MAX + 1) text += chunk.toString(); else cut = true; };
+    child.stdout.on('data', take); child.stderr.on('data', take);
+    const timer = setTimeout(() => { timedOut = true; endTree(child); }, limit * 1000);
+    child.on('error', e => { clearTimeout(timer); resolve({ ok: false, text: `The command could not start in ${plan.name}: ${e.message}` }); });
+    child.on('close', code => {
+      clearTimeout(timer);
+      if (text.length > OUT_MAX) { cut = true; text = text.slice(0, OUT_MAX); }
+      const out = text.trim() + (cut ? `\n\n(The output was cut after ${OUT_MAX.toLocaleString('en-US')} characters.)` : '');
+      if (timedOut) return resolve({ ok: false, text: `The command was stopped after ${limit} seconds.${out ? '\n' + out : ''}` });
+      resolve({ ok: code === 0, text: out || (code === 0 ? 'The command finished without any error. It printed nothing.' : `The command failed (exit code ${code}) and printed nothing.`) });
+    });
+  });
+}

apps/host/server/agent/custom-tools-mcp.mjs

@@ -8,49 +8,35 @@
  * It speaks the Model Context Protocol over stdio (newline-delimited JSON-RPC), the transport the Harness's MCP client uses for a program
  * it starts. The file is re-read on every request, so a change in Settings is seen without restarting anything. The assistant's text for
  * a command tool reaches the command in the STRATA_INPUT environment variable (never spliced into the command line, so it cannot add
- * commands of its own). A command gets 2 minutes and 20,000 characters of output.
+ * commands of its own). A command runs in the shell that suits it (PowerShell for a Windows command that reads as PowerShell, cmd.exe for
+ * the rest, sh elsewhere), in its own folder or the one the assistant names, gets 2 minutes unless its tool allows more (up to an hour) and
+ * 20,000 characters of output (custom-command-run.mjs).
  */
-import { spawn } from 'node:child_process';
 import { readFileSync } from 'node:fs';
 import { createInterface } from 'node:readline';
+import { runCommand } from './custom-command-run.mjs';
 
 const [mode, file] = process.argv.slice(2);
 if (!['instructions', 'commands'].includes(mode) || !file) { console.error('usage: custom-tools-mcp.mjs instructions|commands <tools.json>'); process.exit(2); }
 
 const load = () => { try { return JSON.parse(readFileSync(file, 'utf8'))[mode] ?? {}; } catch { return {}; } };
-const OUT_MAX = 20000;
-const TIME_MS = 120000;
 
 const schema = mode === 'commands'
-  ? { type: 'object', properties: { input: { type: 'string', description: 'Text to give the command (optional).' } }, additionalProperties: false }
+  ? { type: 'object', properties: {
+    input: { type: 'string', description: 'Text to give the command (optional).' },
+    cwd: { type: 'string', description: 'The folder to run the command in (optional). Give the working folder of this chat when the command uses relative paths.' },
+  }, additionalProperties: false }
   : { type: 'object', properties: {}, additionalProperties: false };
 
 function listTools() {
   return Object.entries(load()).map(([name, t]) => ({ name, description: String(t.description ?? ''), inputSchema: schema, annotations: mode === 'instructions' ? { readOnlyHint: true } : {} }));
 }
 
-function runCommand(command, input) {
-  return new Promise(resolve => {
-    const child = spawn(command, { shell: true, windowsHide: true, env: { ...process.env, STRATA_INPUT: String(input ?? '') }, stdio: ['ignore', 'pipe', 'pipe'] });
-    let text = '';
-    const take = chunk => { if (text.length < OUT_MAX) text += chunk.toString(); };
-    child.stdout.on('data', take); child.stderr.on('data', take);
-    const timer = setTimeout(() => { try { child.kill(); } catch { /* gone */ } }, TIME_MS);
-    child.on('error', e => { clearTimeout(timer); resolve({ ok: false, text: `The command could not start: ${e.message}` }); });
-    child.on('close', (code, signal) => {
-      clearTimeout(timer);
-      const out = text.slice(0, OUT_MAX).trim();
-      if (signal) resolve({ ok: false, text: `The command was stopped after ${TIME_MS / 1000} seconds.${out ? '\n' + out : ''}` });
-      else resolve({ ok: code === 0, text: out || (code === 0 ? 'The command finished without any error. It printed nothing.' : `The command failed (exit code ${code}) and printed nothing.`) });
-    });
-  });
-}
-
 async function call(name, args) {
   const t = load()[name];
   if (!t) return { isError: true, content: [{ type: 'text', text: 'That tool is no longer available.' }] };
   if (mode === 'instructions') return { content: [{ type: 'text', text: String(t.text ?? '') }] };
-  const r = await runCommand(String(t.command ?? ''), args?.input);
+  const r = await runCommand({ command: String(t.command ?? ''), input: args?.input, callCwd: args?.cwd, cwd: t.cwd, shell: t.shell, timeoutSec: t.timeoutSec });
   return { isError: !r.ok, content: [{ type: 'text', text: r.text }] };
 }
 

apps/host/server/agent/engine-progress.mjs

@@ -0,0 +1,11 @@
+/**
+ * How far a local engine has got, as a short text that changes whenever it makes progress. The agent's stall watchdog
+ * compares it with the last one it saw: while a long prompt is read the Harness hears nothing for minutes, but the
+ * engine's /metrics (polled every 2 s) shows `live.prompt_read` moving (#3623). Null when the engine is idle or says nothing.
+ */
+export function engineProgressMark(instance) {
+  const live = instance?.metrics?.live;
+  if (!live || live.state === 'idle' || live.state === 'unloaded') return null;
+  const slots = Array.isArray(live.slots) ? live.slots.map(s => `${s?.state}:${s?.prompt_read ?? ''}:${s?.generated ?? ''}`).join(',') : '';
+  return `${live.state}|${live.prompt_read ?? ''}|${live.generated ?? ''}|${slots}`;
+}

apps/host/server/agent/engine-speed.mjs

@@ -0,0 +1,41 @@
+/**
+ * The engine's own answer speed for one assistant turn: every token its requests produced (thinking, answer and tool calls; with
+ * MTP drafting only the tokens it kept) over the time they spent decoding. These are the numbers the Monitor and `/metrics` show,
+ * so the chat footer reads the same. Nothing here is a guess from the stream: it returns null when the engine does not say.
+ */
+
+/** Sum the engine's finished requests that began at or after `since` (ms). `attempts` is how many model requests the turn made:
+ *  when the engine lists more (another chat ran at the same time), only the newest `attempts` are the turn's. */
+export function sumEngineRequests(requests, { since, attempts = Infinity } = {}) {
+  if (!Array.isArray(requests)) return null;
+  const mine = requests
+    .filter(r => Number.isFinite(r?.time) && r.time * 1000 >= since - 1500)
+    .sort((a, b) => a.time - b.time)
+    .slice(-Math.max(1, attempts));
+  let tokens = 0, decodeMs = 0, promptRead = 0, promptMs = 0;
+  for (const r of mine) {
+    const made = Number.isFinite(r.engine_generated) ? r.engine_generated : r.output_tokens;
+    if (!(made > 0) || !(r.decode_ms > 0)) continue;
+    tokens += made; decodeMs += r.decode_ms;
+    const read = Number.isFinite(r.prompt_read) ? r.prompt_read : (r.prompt_tokens ?? 0) - (r.reused ?? 0);
+    if (read > 0 && r.prompt_ms > 0) { promptRead += read; promptMs += r.prompt_ms; }
+  }
+  if (!(tokens > 0 && decodeMs > 0)) return null;
+  return {
+    tokens, decodeMs, tps: Number((tokens / (decodeMs / 1000)).toFixed(1)),
+    promptTps: promptRead > 0 && promptMs > 0 ? Number((promptRead / (promptMs / 1000)).toFixed(1)) : null,
+  };
+}
+
+/** Ask a local engine for its request history. Any failure is null: the caller keeps the stream's own estimate. */
+export async function turnEngineSpeed({ baseUrl, key, since, attempts, fetcher = fetch, timeoutMs = 1500 }) {
+  try {
+    const origin = new URL(baseUrl).origin;
+    const res = await fetcher(`${origin}/metrics?requests=all`, {
+      signal: AbortSignal.timeout(timeoutMs),
+      headers: key ? { authorization: `Bearer ${key}` } : undefined,
+    });
+    if (!res.ok) return null;
+    return sumEngineRequests((await res.json())?.requests, { since, attempts });
+  } catch { return null; }
+}

apps/host/server/agent/events.mjs

@@ -9,6 +9,9 @@
 
 import { toolUpdate, TokenCount, fmtTokens } from './status.mjs';
 import { askFor } from './ask.mjs';
+import { FIT_TEXT, fill } from './context-fit.mjs';
+import { isContextOverflow } from './context-budget.mjs';
+import { ToolDraft, cutCalls } from './reply-cut.mjs';
 
 const SHELL = new Set(['pwsh', 'bash', 'job_kill', 'job_output', 'job_list']);
 const WRITE = new Set(['write', 'edit']);
@@ -157,6 +160,9 @@ export function withPlain(raw) {
   return plain ? `${plain}\n\nDetails: ${raw.replace(/^Error:\s*/, '')}` : raw;
 }
 
+/** What a launch that printed nothing proves, and no more. */
+export const LAUNCHED_TEXT = 'The command finished without an error, so the program was started. Strata cannot confirm that a window or page actually opened.';
+
 /** A command whose whole point is to open something: it has no output to show when it worked. */
 const LAUNCH = /(^|[\s;|&(])(start-process|start|invoke-item|ii|explorer(?:\.exe)?|xdg-open|open|notepad(?:\.exe)?|code)(?=[\s;|&)]|$)/i;
 
@@ -172,9 +178,10 @@ export function outcomeText(tool, text, args = {}) {
     text = text.replace(/\r?\n?\[stderr\]\r?\n(?:Cannot create type\. Only core types are supported in this language mode\.[\s\S]*?CannotCreateTypeConstrainedLanguage\s*)+$/, '');
     if (!text.trim()) text = '(no output)';
   }
-  // Starting a program or opening a folder prints nothing when it worked. The model used to read "finished, nothing to show" as "cannot tell
-  // whether it opened" and told the person so; a launch that returned without an error did start, and the result says that plainly.
-  if ((tool === 'pwsh' || tool === 'bash') && /^\(no output\)$/.test(text.trim()) && LAUNCH.test(String(args?.command ?? ''))) return 'Started. The program, folder or file was opened.';
+  // Starting a program or opening a folder prints nothing when it worked, and also when it did not (a browser given a file:// address, a
+  // program that closed at once). T9 / #3576: the card used to say "was opened", and the model repeated it ("I previewed it in a browser to
+  // confirm it renders"). It says what is known: the command returned without an error.
+  if ((tool === 'pwsh' || tool === 'bash') && /^\(no output\)$/.test(text.trim()) && LAUNCH.test(String(args?.command ?? ''))) return LAUNCHED_TEXT;
   if ((tool === 'pwsh' || tool === 'bash') && /^\(no output\)$/.test(text.trim())) return 'The command finished without any error. It printed nothing, so there is nothing more to show.';
   return text;
 }
@@ -196,8 +203,10 @@ export class TurnProjector {
    * no question ever reaches the person: the card goes straight from running to denied, without a moment where it
    * offers Approve and Deny buttons that would do nothing.
    */
-  constructor({ startedAt = Date.now(), policy = 'ask' } = {}) {
+  constructor({ startedAt = Date.now(), policy = 'ask', window = 0 } = {}) {
     this.startedAt = startedAt;
+    this.window = Number(window) || 0;   // the model's window, for the figures in the line that says the chat was summarised
+    this.summarizing = false;
     this.policy = policy;
     this.byPolicy = new Set();       // callIds the approval policy rejected without asking
     this.tools = new Map();          // callId -> { card, calledAt }
@@ -214,7 +223,8 @@ export class TurnProjector {
     this.asked = new Map();          // approval id -> callId
     this.onStatus = null;            // (update) => void: what the assistant is doing now (status.mjs); set by the bridge
     this.reasoning = new TokenCount();
-    this.composing = new Map();      // callId -> { name, head, bytes }: a tool call the model is still writing
+    this.composing = new Map();      // callId -> ToolDraft: a tool call the model is still writing (still here at a cut reply = it was lost)
+    this.lastOutput = 0;             // tokens the LAST model request produced
     this.running = [];               // callIds of tools that are running, oldest first
   }
 
@@ -236,7 +246,7 @@ export class TurnProjector {
     return { type: 'agent-tool', tool: entry.card };
   }
 
-  /* The speed shown while a reply streams, and after it: everything the model generated (reasoning included) over the time its
+  /* The speed shown while a reply streams, and after it: everything the model generated (reasoning and tool calls included) over the time its
      requests spent producing it, not over the whole turn (tool runs and the wait for the prompt are not decoding). One stream per model
      request; tokens are one per streamed chunk, or characters / 4 when a server batches. */
   #produced(attemptId, text, out) {
@@ -281,17 +291,20 @@ export class TurnProjector {
           out.push({ type: 'reasoning', text: c.text });
         } else if (c.type === 'tool-call-delta' && c.id) {
           // The model is writing a tool call. For a big file this is the long silent part: nothing else arrives until it is finished.
-          const call = this.composing.get(c.id) ?? { name: c.name ?? '', head: '', bytes: 0 };
+          const call = this.composing.get(c.id) ?? new ToolDraft(c.id, c.name ?? '');
           if (c.name) call.name = c.name;
           const piece = String(c.argumentsDelta ?? '');
-          call.bytes += piece.length;
-          if (call.head.length < 4000) call.head += piece;
+          // Writing a tool call (a whole file, say) is decoding too: its tokens are in the engine's output count, so its time belongs in the speed.
+          this.#produced(f.attemptId, piece, out);
+          call.add(piece);
           this.composing.set(c.id, call);
           if (call.name && !NO_CARD.has(call.name)) {
-            const raw = (/"(?:file_path|path|filePath)"\s*:\s*"((?:[^"\\]|\\.)*)"/.exec(call.head) ?? /"url"\s*:\s*"((?:[^"\\]|\\.)*)"/.exec(call.head))?.[1];
-            let target = raw; try { if (raw !== undefined) target = JSON.parse('"' + raw + '"'); } catch { /* a half-written escape: show it as it is */ }
+            const target = call.target;
             const args = target ? { file_path: target, url: target } : {};
             this.#status(toolUpdate('preparing', 'preparing-tool', call.name, args, { bytes: call.bytes }, { args: { tool: call.name, verb: toolVerb(call.name, 'running'), target: target ?? '', bytes: call.bytes } }));
+            // The live data path of a file being written (AGENT-LOST): the name, a growing size and the tail of the text, at most five times a second.
+            const now = Date.now();
+            if (now - call.at >= 200) { call.at = now; out.push(call.frame({ scope: toolScope(call.name), verb: toolVerb(call.name, 'running') })); }
           }
         } else if (c.type === 'usage' && c.usage) {
           this.usageSeen = true;
@@ -300,7 +313,9 @@ export class TurnProjector {
           const prompt = (Number(c.usage.inputTokens) || 0) + (Number(c.usage.cacheReadTokens) || 0) + (Number(c.usage.cacheWriteTokens) || 0);
           this.tokensIn += prompt;
           this.tokensOut += Number(c.usage.outputTokens) || 0;
+          this.lastOutput = Number(c.usage.outputTokens) || 0;
           this.contextTokens = prompt + (Number(c.usage.outputTokens) || 0);
+          out.push({ type: 'context', contextTokens: this.contextTokens, contextMax: this.window || undefined });
         }
       }
       return out;
@@ -322,7 +337,9 @@ export class TurnProjector {
         const args = parseArguments(d.arguments);
         const card = { ...presentTool({ callId: d.callId, name: d.name, args }), state: 'running' };
         this.tools.set(d.callId, { card, calledAt: e.time });
+        const draft = this.composing.get(d.callId);
         this.composing.delete(d.callId);
+        if (draft && draft.bytes > 0 && !NO_CARD.has(d.name)) out.push(draft.frame({ done: true }));
         this.running.push(d.callId);
         this.#status(toolUpdate('tool', 'tool', d.name, args, {}, { args: { tool: d.name, verb: card.verb, target: card.target } }));
         out.push({ type: 'agent-tool', tool: card });
@@ -369,6 +386,22 @@ export class TurnProjector {
         if (frame) out.push(frame);
         break;
       }
+      case 'compaction/start':
+        // The Harness is summarising the older messages to make room: say so while it does, and again (once) when it is done.
+        this.summarizing = true;
+        this.#status({ phase: 'compacting', code: 'compacting', text: FIT_TEXT.summarizing, key: FIT_TEXT.summarizing, values: [] });
+        break;
+      case 'compaction/end':
+        if (!this.summarizing) break;
+        this.summarizing = false;
+        this.#afterTool();
+        if (!d.error) {
+          const before = this.window > 0 && this.contextTokens ? Math.min(100, Math.round(100 * this.contextTokens / this.window)) : null;
+          const text = before === null ? FIT_TEXT.summarizedShort : FIT_TEXT.summarizedWas;
+          const values = before === null ? [] : [before];
+          out.push({ type: 'delta', own: true, text: '\n\n' + fill(text, values), key: text, values, noteReason: 'compacted' });
+        }
+        break;
       case 'turn/start':
         // The parent woke up again (a helper finished and reported back): the message goes on, as a new paragraph.
         this.ended = null;
@@ -392,8 +425,29 @@ export class TurnProjector {
     return this.#card(callId, { state: 'denied', result: outcome === 'rejected' ? 'Denied. Nothing ran.' : outcome === 'cancelled' ? 'Cancelled. Nothing ran.' : 'No one could answer this request, so nothing ran.' });
   }
 
+  /** A reply the model could not finish (the turn ended on the length limit): what it was writing, so nothing is lost without a word. */
+  cut() {
+    return { tokens: this.lastOutput, calls: cutCalls(this.composing.values()) };
+  }
+
+  /** The agent was asked to carry on: the calls it lost are not pending any more. */
+  clearCut() { const frames = this.#dropDrafts(); this.ended = null; return frames; }
+
+  /** Frames that take the writing cards of calls that will never be whole off the page (the reply was cut, or the turn ended). */
+  #dropDrafts() {
+    const frames = [...this.composing.values()].filter(d => d.bytes > 0 && !NO_CARD.has(d.name)).map(d => d.frame({ done: true, lost: true }));
+    this.composing.clear();
+    return frames;
+  }
+
   /** The terminal frames for a finished turn. */
-  finish({ model, contextMax } = {}) {
+  finish(options = {}) {
+    const cutInfo = this.ended?.kind === 'max-tokens' ? this.cut() : null;
+    const dropped = this.#dropDrafts();
+    return [...dropped, ...this.#finished(options, cutInfo)];
+  }
+
+  #finished({ model, contextMax, engine = null } = {}, cutInfo = null) {
     const reason = this.ended ?? { kind: 'interrupted' };
     const durationMs = Date.now() - this.startedAt;
     const usage = this.usageSeen
@@ -401,17 +455,24 @@ export class TurnProjector {
       : { tokensIn: null, tokensOut: null, usageSource: 'unavailable' };
     const decoded = this.decode();
     const generated = this.usageSeen && this.tokensOut > 0 ? this.tokensOut : decoded.tokens;
-    const tps = decoded.seconds >= 0.3 && generated > 0 ? Number((generated / decoded.seconds).toFixed(1)) : null;
-    const base = { durationMs, ttftMs: this.firstTokenAt ? this.firstTokenAt - this.startedAt : null, model, contextMax, tps, contextTokens: this.contextTokens };
+    // Answer speed, one definition everywhere: all the tokens the model produced over its decode time. The engine's own figures (the ones the
+    // Monitor shows) when the bridge could read them; otherwise the stream's own span. A very short reply has almost no span, so its decode time
+    // is then the time from its first chunk to the end of the turn (only when no tool ran, so no tool time is in it): the number is still shown.
+    let tps = null;
+    if (engine?.tps > 0) tps = engine.tps;
+    else if (generated > 0 && decoded.seconds >= 0.3) tps = Number((generated / decoded.seconds).toFixed(1));
+    else if (generated > 0 && this.tools.size === 0 && this.firstTokenAt && Date.now() - this.firstTokenAt >= 50) tps = Number((generated / ((Date.now() - this.firstTokenAt) / 1000)).toFixed(1));
+    const promptTps = engine?.promptTps > 0 ? engine.promptTps : null;
+    const base = { durationMs, ttftMs: this.firstTokenAt ? this.firstTokenAt - this.startedAt : null, model, contextMax, tps, ...(promptTps ? { promptTps } : {}), contextTokens: this.contextTokens };
     switch (reason.kind) {
       case 'completed':
         return [{ type: 'done', ...base, ...usage, finishReason: 'stop' }];
       case 'max-tokens':
-        return [{ type: 'done', ...base, ...usage, finishReason: 'length' }];
+        return [{ type: 'done', ...base, ...usage, finishReason: 'length', cut: cutInfo }];
       case 'aborted':
         return [{ type: 'done', ...base, ...usage, finishReason: 'aborted', cancelled: true }];
       case 'error':
-        return [{ type: 'error', message: friendlyFailure(reason.error), code: reason.error?.code ?? 'UNKNOWN' }];
+        return [{ type: 'error', message: friendlyFailure(reason.error), code: isContextFailure(reason.error) ? 'CONTEXT_WINDOW_EXCEEDED' : reason.error?.code ?? 'UNKNOWN', ...(isContextFailure(reason.error) ? { key: FIT_TEXT.full, details: String(reason.error?.message ?? '') } : {}) }];
       case 'blocked':
         return [{ type: 'error', message: 'The agent stopped because this turn was blocked by policy.', code: 'BLOCKED' }];
       default:
@@ -420,10 +481,15 @@ export class TurnProjector {
   }
 }
 
+/** Whether a failure is the model server saying the conversation does not fit its window (its code, or the engine's own words). */
+export function isContextFailure(failure) {
+  return isContextOverflow(failure) || /context window|too long for|exceeds the context/i.test(String(failure?.message ?? ''));
+}
+
 /** A model-route failure in words a user can act on. */
 export function friendlyFailure(failure) {
   const message = String(failure?.message ?? 'The model request failed.');
-  if (/context window|too long|exceeds/i.test(message)) return `The conversation no longer fits the model's context window. ${clip(message, 200)}`;
+  if (isContextFailure(failure)) return FIT_TEXT.full;
   if (/ECONNREFUSED|fetch failed|connect/i.test(message)) return `The model is not reachable. ${clip(message, 200)}`;
   if (/401|403|credential|api key/i.test(message)) return 'The model rejected the credentials. Check the connection in Settings.';
   return clip(message, 400);

apps/host/server/agent/harness-runtime.mjs

@@ -13,6 +13,7 @@ import { spawn, spawnSync } from 'node:child_process';
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { join, resolve } from 'node:path';
 import { externalEnvironment } from '../external-env.mjs';
+import { utf8Script } from '../powershell-utf8.mjs';
 
 const URL_PATTERN = /http:\/\/127\.0\.0\.1:(\d+)\/\?token=([A-Za-z0-9_-]+)/;
 
@@ -32,7 +33,7 @@ export function agentEnvironment(base = process.env, extra = {}) {
   }
   // DSH_PERMISSION_MODE is the composition default for a session no chat mode has touched (a child agent, a
   // seeded session): the strictest sandbox, which matches the Manual preset, never the Harness's wider default.
-  return { ...out, DSH_TELEMETRY_DISABLED: '1', DSH_PERMISSION_MODE: 'read-only', ...extra };
+  return { ...out, DSH_TELEMETRY_DISABLED: '1', DSH_PERMISSION_MODE: 'read-only', NODE_USE_SYSTEM_CA: '1', ...extra };
 }
 
 /**
@@ -127,7 +128,7 @@ export class HarnessProcess {
 function commandLineOf(pid) {
   if (!Number.isInteger(pid) || pid <= 0) return null;
   if (process.platform === 'win32') {
-    const r = spawnSync('powershell', ['-NoProfile', '-NonInteractive', '-Command', `(Get-CimInstance Win32_Process -Filter "ProcessId=${pid}").CommandLine`], { encoding: 'utf8', windowsHide: true, timeout: 15000 });
+    const r = spawnSync('powershell', ['-NoProfile', '-NonInteractive', '-Command', utf8Script(`(Get-CimInstance Win32_Process -Filter "ProcessId=${pid}").CommandLine`)], { encoding: 'utf8', windowsHide: true, timeout: 15000 });
     return r.status === 0 && r.stdout.trim() ? r.stdout.trim() : null;
   }
   const r = spawnSync('ps', ['-p', String(pid), '-o', 'args='], { encoding: 'utf8' });

apps/host/server/agent/plan.mjs

@@ -117,7 +117,7 @@ export function stepObjective(plan, index) {
     `You are on step ${index + 1} of ${n}: ${s.text}${s.detail ? ` (${s.detail})` : ''}.`,
     done ? `Already done: ${done}.` : '',
     plan.briefing ? String(plan.briefing) : '',
-    isViewStep(s.text) ? 'This step is about seeing the result in a browser. Never wait for a program to close. If a person is at this computer, start the browser so the command returns at once (Windows: Start-Process; macOS: open; Linux: xdg-open) and say it is open. If there is no screen, check the page without a visible window: use the headless browser tool if you have one, otherwise read the file and its script for mistakes, and say in one plain sentence what you could and could not check. Then finish the step.' : '',
+    isViewStep(s.text) ? 'This step is about seeing the result. To show a local image, SVG, HTML page or PDF, use the present tool (a browser cannot open file:// addresses). Never wait for a program to close. If a person is at this computer and you start a browser, start it so the command returns at once (Windows: Start-Process; macOS: open; Linux: xdg-open) and say only that you started it, not that the page rendered. If there is no screen, check the page without a visible window: use the headless browser tool if you have one, otherwise read the file and its script for mistakes, and say in one plain sentence what you could and could not check. Then finish the step.' : '',
     'Do only this step, check that it worked, and then finish the goal.',
     index + 1 < n ? 'The next steps are handled separately: do not start them.' : '',
   ].filter(Boolean).join(' ');

apps/host/server/agent/plugins/strata-context.mjs

@@ -0,0 +1,205 @@
+/**
+ * Strata's context plugin for the Harness (plain ESM, loaded by absolute path from the profile, like strata-gate and strata-models).
+ *
+ * What it fixes (2026-10-22 hands-on test, Gyro-S at 64K):
+ *   1. Compaction decided from the Harness's own price of the conversation, 4 characters a token. Code, logs and JSON are about twice as
+ *      dense, so a chat the engine had read as 59,048 tokens was priced at 31,794 and compaction started far too late. Here the token meter
+ *      is calibrated by what the model server reports for each answer (its real prompt size): the measured size is exact, and what was
+ *      added since is priced with the density that measurement showed. Automatic compaction and the manual /compact both measure through
+ *      the token meter, so both read the same number as the context meter in the app.
+ *   2. The summarising request itself could be bigger than the window ("/compact" sent a 66,507-token prompt to a 65,536 window). The
+ *      summary is now asked for in pieces that fit: a message bigger than a piece is cut for the request (the conversation keeps it until
+ *      the summary replaces it), the pieces are summarised one after the other, each building on the summary before it, and a piece the
+ *      server still refuses is halved and tried again.
+ *
+ * How. It wraps `tokenMeter.measure` and `llm.stream` in place, once each (the same way strata-models wraps the subagent tools). Only a
+ * request the Harness marks `purpose: 'compaction'` is touched in `llm.stream`. Nothing in the Harness is rewritten: a Harness update
+ * that renames either leaves compaction as it was, and the test that runs the real Harness fails.
+ */
+import { replyCap } from '../reply-cut.mjs';
+import { densityOf, estimateMessage, estimateTools, isContextOverflow, MAX_DENSITY, pressureNow, promptTokensOf, splitMessages, summaryBudget, usageOfEvent, WINDOW_SLACK, withSummaryLanguage } from '../context-budget.mjs';
+
+export const name = 'strata-context';
+
+/** The routes the host writes for models on this computer (profile.mjs): `strata-local`, `strata-local-<id>`, and their `~s<budget>` copies. */
+const isLocalRoute = provider => typeof provider === 'string' && provider.startsWith('strata-local');
+export const inject = ['tokenMeter', 'llm'];
+
+/** Real prompt measurements per session: { real, estimated } for the last answer the model server reported. */
+const samples = new WeakMap();
+const bySessionId = new Map();
+const wrapped = new WeakSet();
+/** Densities that made a summary request fail on this server, per session id (the next request starts from a more careful one). */
+const careful = new Map();
+
+export function apply(ctx) {
+  const meter = ctx.tokenMeter;
+  const llm = ctx.llm;
+  const log = (level, text) => { try { ctx.logger?.[level]?.(`strata-context: ${text}`); } catch { /* logging never blocks */ } };
+
+  // 1. The measured size of the prompt, from the model server's own report for each answer.
+  if (meter && typeof meter.measure === 'function' && !wrapped.has(meter)) {
+    wrapped.add(meter);
+    const original = meter.measure;
+    meter.measure = function measure(session, requestHeader) {
+      const m = original.call(this, session, requestHeader);
+      const sample = samples.get(session);
+      if (!sample) return m;
+      const now = m.surfaceTokens + estimateTools(requestHeader ?? session.requestHeader?.());
+      const total = Math.max(m.totalTokens, pressureNow({ sample, now }));
+      if (total <= m.totalTokens) return m;
+      const density = densityOf(sample.real, sample.estimated);
+      return { ...m, totalTokens: total, nodes: m.nodes.map(n => ({ ...n, tokens: Math.ceil(n.tokens * density) })) };
+    };
+    ctx.on('session/event', (session, event) => {
+      if (event.type !== 'assistant/message') return;
+      const real = promptTokensOf(usageOfEvent(event));
+      if (!(real > 0)) return;
+      try {
+        // The request that was just answered saw the conversation without this answer: its price is the surface before the answer's node.
+        const m = original.call(meter, session);
+        const heuristic = m.nodes.reduce((n, x) => n + (x.seq === event.seq ? 0 : x.heuristicTokens), 0);
+        const estimated = heuristic + estimateTools(session.requestHeader?.());
+        if (!(estimated > 0)) return;
+        const sample = { real, estimated };
+        samples.set(session, sample);
+        if (session.id) bySessionId.set(String(session.id), sample);
+      } catch (e) { log('warn', `could not record a measurement: ${e.message}`); }
+    });
+  }
+
+  // 2. A summary request that fits the window.
+  if (llm && typeof llm.stream === 'function' && !wrapped.has(llm)) {
+    wrapped.add(llm);
+    const original = llm.stream;
+    llm.stream = function stream(options) {
+      if (options?.purpose !== 'compaction') return original.call(this, options);
+      return summaryStream.call(this, options, original);
+    };
+  }
+
+  // 3. A reply that has room to finish (AGENT-LOST, 11-01). The output budget in the profile is what the Harness's compaction sets aside for a
+  // reply (30 percent of the window; it reads it from the request header), and the same number was also the ceiling of every request: a thinking
+  // model that wrote a 15K-token file after 9K tokens of thinking was cut inside the tool call at 19,660, the unfinished call was dropped and the
+  // turn ended with no file and no word. The header (and so compaction) stays as it is; the request that goes to the model server may produce up
+  // to half the window, at most 64K tokens (replyCap), and pi-ai still clamps it to what the window has left after the prompt. The agent loop
+  // dispatches through the adapter's `streamWithSnapshot`, after the loop has checked the request against its header, so that is where the ceiling
+  // is raised, once per adapter, the first time a local route is prepared. A Harness that renames it leaves the ceiling as it was (the test that
+  // runs the real Harness fails).
+  if (llm && typeof llm.prepareCall === 'function' && !wrapped.has(llm.prepareCall)) {
+    const original = llm.prepareCall;
+    const raised = new WeakSet();
+    const prepare = async function prepareCall(config, signal, configure) {
+      try { raiseReplyCeiling(config?.provider, raised); } catch (e) { log('warn', `could not raise the reply ceiling: ${e.message}`); }
+      return original.call(this, config, signal, configure);
+    };
+    wrapped.add(prepare);
+    llm.prepareCall = prepare;
+  }
+  function raiseReplyCeiling(provider, raised) {
+    if (!isLocalRoute(provider)) return;
+    const adapter = llm.adapters?.get?.(provider)?.adapter;
+    if (!adapter || raised.has(adapter) || typeof adapter.streamWithSnapshot !== 'function' || typeof adapter.modelOf !== 'function') return;
+    raised.add(adapter);
+    const stream = adapter.streamWithSnapshot;
+    adapter.streamWithSnapshot = function streamWithSnapshot(options, snapshot) {
+      let next = options;
+      try {
+        if (isLocalRoute(options?.provider)) {
+          const model = this.modelOf(snapshot, options.provider, options.model);
+          const asked = options.maxTokens ?? model.maxTokens ?? 0;
+          // Only the agent's own reply budget is raised: a summary or a title asks for far less and keeps what it asked.
+          if (model.contextWindow > 0 && asked >= Math.floor(model.contextWindow * 0.25)) {
+            const cap = replyCap(model.contextWindow, asked);
+            if (cap > asked) next = { ...options, maxTokens: cap };
+          }
+        }
+      } catch { next = options; }
+      return stream.call(this, next, snapshot);
+    };
+  }
+
+  // The host asks, with /strata-context, how much of the window the chat holds right now: the same measured number compaction decides on
+  // (JSON in the command's text: { tokens, window }). Before a message goes out, and after /compact, so the person is told true figures.
+  ctx.inject(['commands'], (commandCtx) => {
+    commandCtx.commands.register({
+      definitionId: 'strata-context',
+      name: 'strata-context',
+      description: 'Reports how many tokens the conversation holds now and the size of the model window',
+      handler: async (invocation) => {
+        try {
+          const session = invocation.agent.session;
+          const tokens = meter.measure(session).totalTokens;
+          const config = session.requestHeader?.()?.config;
+          let window = 0;
+          if (config) window = (await llm.resolveModelInfo(config.provider, config.model))?.context?.contextWindow ?? 0;
+          return { kind: 'success', text: JSON.stringify({ tokens, window }) };
+        } catch (e) { return { kind: 'error', text: `strata-context: ${e.message}` }; }
+      },
+    });
+  });
+
+  /** A finished stream: its chunks, the text it wrote and why it ended. */
+  async function drain(iterable) {
+    let text = '', finish = null;
+    const chunks = [];
+    for await (const chunk of iterable) {
+      chunks.push(chunk);
+      if (chunk.type === 'text-delta') text += chunk.text ?? '';
+      else if (chunk.type === 'finish') finish = chunk.reason;
+    }
+    return { text, finish, chunks };
+  }
+  const refusedForSize = finish => finish?.kind === 'error' && isContextOverflow(finish.failure ?? finish);
+
+  async function* summaryStream(options, original) {
+    options = { ...options, messages: withSummaryLanguage(options.messages) };   // #4750: the summary follows the conversation's language
+    let window = 0;
+    try { window = (await llm.resolveModelInfo(options.provider, options.model, options.signal))?.context?.contextWindow ?? 0; } catch { window = 0; }
+    const messages = options.messages ?? [];
+    const key = String(options.sessionId ?? '');
+    const summaryTokens = options.maxTokens ?? 4096;
+    if (!(window > 0) || messages.length < 2) { yield* original.call(this, options); return; }
+    const own = bySessionId.get(key);
+    let density = Math.max(careful.get(key) ?? 1, own ? densityOf(own.real, own.estimated) : 1);
+    const price = list => list.reduce((n, m) => n + estimateMessage(m), 0) * density;
+    const limit = window - summaryTokens - WINDOW_SLACK;
+    // The whole request fits by this price: ask as the Harness would (the model server's cache of the conversation is reused).
+    if (price(messages) + estimateTools({ tools: options.tools }) * density <= limit) {
+      const first = await drain(original.call(this, options));
+      if (!refusedForSize(first.finish)) { for (const chunk of first.chunks) yield chunk; return; }
+      density = Math.min(MAX_DENSITY, density * 1.6);
+      careful.set(key, density);
+      log('warn', 'the summary request did not fit the window; asking in pieces');
+    }
+    // In pieces. The instruction is the last message; the system prompt, when there is one, the first.
+    const instruction = messages[messages.length - 1];
+    const system = messages[0]?.role === 'system' ? messages[0] : null;
+    const body = messages.slice(system ? 1 : 0, -1);
+    let tools = options.tools;
+    if (tools && estimateTools({ tools }) * density > window / 3) tools = undefined;   // a long tool list only describes tools: the summary does not need it
+    const fixed = (system ? estimateMessage(system) : 0) * density + estimateTools({ tools }) * density + estimateMessage(instruction) * density;
+    let budget = summaryBudget({ window, summaryTokens: summaryTokens * 2, systemTokens: fixed, instructionTokens: 0 });
+    for (let attempt = 0; ; attempt++) {
+      const runs = splitMessages(body, Math.max(1024, budget), density);
+      log('info', `summarising ${body.length} messages in ${runs.length} piece(s) for a ${window}-token window (density ${density.toFixed(2)}, about ${Math.round(budget)} tokens a piece)`);
+      let failed = null, summary = '';
+      for (let i = 0; i < runs.length && !failed; i++) {
+        options.signal?.throwIfAborted?.();
+        const carried = summary ? [{ role: 'user', content: [{ type: 'text', text: `<compacted-summary>\n${summary}\n</compacted-summary>` }] }] : [];
+        const { tools: _drop, ...rest } = options;
+        const piece = { ...rest, ...(tools ? { tools } : {}), messages: [...(system ? [system] : []), ...carried, ...runs[i], instruction] };
+        const { text, finish, chunks } = await drain(original.call(this, piece));
+        if (refusedForSize(finish)) { failed = finish; break; }
+        // The last piece's answer is the summary the Harness reads; a piece that ended in another error ends the request the same way.
+        if (i === runs.length - 1 || finish?.kind === 'error' || finish?.kind === 'aborted') { for (const chunk of chunks) yield chunk; return; }
+        summary = text;
+      }
+      if (!failed || attempt >= 3) throw Object.assign(new Error(failed?.failure?.message ?? 'the summary request does not fit the window'), { code: 'CONTEXT_WINDOW_EXCEEDED' });
+      density = Math.min(MAX_DENSITY, density * 1.6);
+      careful.set(key, density);
+      budget = Math.max(1024, budget / 2);
+      log('warn', `a piece did not fit; asking again with pieces of about ${Math.round(budget)} tokens`);
+    }
+  }
+}

apps/host/server/agent/plugins/strata-gate.mjs

@@ -41,36 +41,237 @@ export const READ_ONLY_TOOLS = new Set([
   'read', 'glob', 'grep', 'read_image', 'working_directory', 'todo_write', 'skill', 'present', 'lsp',
   'get_goal', 'create_goal', 'update_goal', 'list_agents', 'list_subagent_models', 'job_list', 'job_output',
   'ask_user_question', 'exit_plan_mode',
-  // Reading the internet is part of what the app promises; changing nothing here.
-  'web_fetch', 'web_search',
+  // (web_search and web_fetch are not here: the first use in a chat asks, see webDecision.)
   // Delegation: the child it starts is governed by this same gate.
   'subagent', 'subagent_fork', 'send_message', 'interrupt_agent', 'workflow',
 ]);
 
 const SHELL_TOOLS = new Set(['pwsh', 'bash']);
 
-/** Commands that only look. Matched against the first word of every pipeline segment. */
-const SAFE_COMMANDS = new Set([
-  // PowerShell
-  'get-childitem', 'gci', 'ls', 'dir', 'get-content', 'gc', 'cat', 'type', 'get-item', 'gi', 'get-location', 'pwd', 'gl',
-  'select-string', 'sls', 'measure-object', 'measure', 'select-object', 'select', 'where-object', 'where', 'sort-object', 'sort',
-  'format-table', 'ft', 'format-list', 'fl', 'out-string', 'test-path', 'resolve-path', 'get-filehash', 'get-date', 'get-command',
-  'get-process', 'get-itemproperty', 'write-output', 'echo', 'hostname', 'whoami', 'get-host', 'get-psdrive', 'get-help',
-  'group-object', 'group', 'convertto-json', 'convertfrom-json', 'select-xml', 'compare-object', 'get-unique', 'tee-object-none',
-  // POSIX
-  'head', 'tail', 'wc', 'grep', 'rg', 'egrep', 'fgrep', 'stat', 'file', 'du', 'df', 'uname', 'which', 'basename', 'dirname',
-  'realpath', 'readlink', 'sort', 'uniq', 'cut', 'tr', 'less', 'more', 'date', 'id', 'env-none', 'tree',
-]);
+/**
+ * Which shell commands run without a card in Manual mode, and with which options. Safe by construction (#3975): a command is on the list WITH the
+ * options that are known to only look. Every other option, long or short, abbreviated or attached, makes the command ask. So a write mode
+ * (`sort -o`, `tree -o`, `uniq in out`), a program-execution mode (`sort --compress-program`, `rg --pre`, `git grep -O`), a setting mode
+ * (`date -s`) or one that never ends (`tail -f`) cannot slip in, and a word added to the list later starts with no options at all.
+ *
+ * A spec says what one command accepts:
+ *   f   short options without a value (letters, so `-la` is `-l -a`)       v   short options that need a value (`-k2`, `-k 2`)
+ *   vn  the same, and the value must be a number                          o   short options with an optional value that must be attached (`-Iseconds`)
+ *   n   a bare `-5` is allowed                                            l   long options (`--name`, `--name=value`), spelled in full
+ *   lv  long options that need a value (`--name=value`, `--name value`)   ps  PowerShell parameter names, lower case, spelled in full
+ *   max how many operands (files, patterns) are allowed                   op  a check for each operand
+ *   post a last check from the options seen and the operand count
+ */
+const words = (text) => (text ? text.trim().split(/\s+/) : []);
+const spec = ({ f = '', v = '', vn = '', o = '', n = false, l = '', lv = '', ps = '', max = Infinity, op = null, post = null }) =>
+  ({ f, v, vn, o, n, l: new Set(words(l)), lv: new Set(words(lv)), ps: ps ? new Set([...words(ps), ...PS_COMMON]) : null, max, op, post });
+/** Parameters every cmdlet has that only change how errors and warnings show. (-Debug asks a question and -OutVariable sets one: not listed.) */
+const PS_COMMON = ['erroraction', 'ea', 'warningaction', 'wa', 'informationaction', 'ia', 'verbose', 'vb'];
+const NUMBER = /^[+-]?\d+[A-Za-z]{0,3}$/;
 
-/** git subcommands that only read. */
-const SAFE_GIT = new Set(['status', 'log', 'diff', 'show', 'branch', 'rev-parse', 'ls-files', 'blame', 'describe', 'remote', 'tag', 'shortlog', 'rev-list', 'cat-file', 'grep', 'ls-tree', 'config']);
-const SAFE_VERSION = /^(node|python|python3|py|npm|pnpm|git|dotnet|cargo|rustc|go|java|pip|pip3)\s+(--version|-v|-version|version)$/i;
+/** What `ls`, `dir`, `gci` and `Get-ChildItem` take. */
+const LS = { f: 'aAbBcdDFgGhHiklLmnNopqQrRsStuUvxX1CZ', v: 'ITw', ps: 'path literalpath filter include exclude recurse depth name force file directory hidden readonly system attributes',
+  l: 'all almost-all human-readable recursive directory classify reverse size inode dereference color group-directories-first sort time time-style block-size indicator-style si numeric-uid-gid no-group literal hide ignore quote-name escape author file-type full-time width tabsize' };
+/** What `cat`, `type`, `gc` and `Get-Content` take. (-Wait never ends, so it is not here.) */
+const CAT = { f: 'AbeEnstTuv', ps: 'path literalpath totalcount tail head raw encoding readcount force filter include exclude delimiter stream asbytestream',
+  l: 'show-all number-nonblank show-ends number squeeze-blank show-tabs show-nonprinting' };
+const MEASURE = { ps: 'property sum average maximum minimum line word character ignorewhitespace inputobject standarddeviation allstats' };
+const SELECT = { ps: 'first last skip skiplast property expandproperty unique index excludeproperty inputobject' };
+const WHERE = { ps: 'property value inputobject eq ne gt lt ge le like notlike match notmatch contains notcontains in notin is isnot ceq cne cgt clt cge cle clike cnotlike cmatch cnotmatch ccontains cnotcontains cin cnotin' };
+const GROUP = { ps: 'property noelement ashashtable asstring casesensitive inputobject culture' };
+const FT = { ps: 'property autosize wrap hidetableheaders groupby view force expand repeatheader displayerror showerror inputobject' };
+const FL = { ps: 'property view groupby expand force displayerror showerror inputobject' };
+const SLS = { ps: 'pattern path literalpath simplematch casesensitive context list notmatch quiet allmatches include exclude encoding raw inputobject culture noemphasis' };
+const GETITEM = { ps: 'path literalpath name filter include exclude force stream' };
+const GETLOC = { ps: 'psprovider psdrive stack stackname' };
+const ECHO = { f: 'neE', ps: 'inputobject noenumerate' };
+/** The GNU/BSD grep family. */
+const GREP = { f: 'aiIlLcnvwHhEFGPqrRsTUyzZbxo', v: 'efdD', vn: 'ABCm', n: true,
+  l: 'extended-regexp fixed-strings basic-regexp perl-regexp ignore-case no-ignore-case word-regexp line-regexp invert-match count color colour files-with-matches files-without-match max-count only-matching quiet silent no-messages byte-offset with-filename no-filename label line-buffered initial-tab null after-context before-context context text recursive dereference-recursive include exclude exclude-dir binary-files line-number null-data no-group-separator group-separator regexp file directories devices binary' };
 
-/** Anything that can chain, redirect, expand or start something else is not read-only. */
-const UNSAFE_SYNTAX = /[;&<>`${}()]|\r|\n|--%|\bout-file\b|\bset-content\b|\badd-content\b|\binvoke-|\biex\b|\bstart-|\bnew-|\bremove-|\bcopy-|\bmove-|\brename-|\bclear-|\bset-|\bpush-|\bexpand-|\bsave-|\binstall-|\bcurl\b|\bwget\b|\bsudo\b|\bsh\b|\bbash\b|\bpwsh\b|\bpowershell\b|\bcmd\b|-exec\b|-delete\b|-execdir\b/i;
+/** Commands that only look, each with the options that are known to be harmless. Matched against the first word of every pipeline segment. */
+const SPECS = new Map();
+const add = (names, s) => { for (const name of words(names)) SPECS.set(name, spec(s)); };
+// PowerShell
+add('get-childitem gci', { ps: LS.ps });
+add('ls dir', LS);
+add('get-content gc', { ps: CAT.ps });
+add('cat type', CAT);
+add('get-item gi get-itemproperty', GETITEM);
+add('get-location gl', GETLOC);
+add('pwd', { ...GETLOC, f: 'LP' });
+add('select-string sls', SLS);
+add('measure-object measure', MEASURE);
+add('select-object select', SELECT);
+add('where-object where', WHERE);
+add('sort-object', { ps: 'property descending unique top bottom casesensitive culture stable inputobject' });
+add('format-table ft', FT);
+add('format-list fl', FL);
+add('out-string', { ps: 'stream width inputobject' });
+add('test-path', { ps: 'path literalpath pathtype isvalid filter include exclude olderthan newerthan' });
+add('resolve-path', { ps: 'path literalpath relative relativebasepath force' });
+add('get-filehash', { ps: 'path literalpath algorithm' });
+add('get-date', { ps: 'format uformat date asutc displayhint year month day hour minute second millisecond' });
+add('get-command', { ps: 'name commandtype module all syntax listimported totalcount noun verb fullyqualifiedmodule parametername parametertype' });
+add('get-process', { ps: 'name id includeusername module fileversioninfo inputobject' });
+add('write-output', { ps: ECHO.ps });
+add('echo', ECHO);
+add('get-host', { ps: '' });
+add('get-psdrive', { ps: 'name psprovider scope literalname' });
+add('get-help', { ps: 'name full detailed examples parameter category component functionality role' });
+add('group-object group', GROUP);
+add('convertto-json', { ps: 'depth compress enumsasstrings inputobject asarray escapehandling' });
+add('convertfrom-json', { ps: 'ashashtable depth inputobject noenumerate' });
+add('select-xml', { ps: 'xml path literalpath xpath content namespace' });
+add('compare-object', { ps: 'referenceobject differenceobject property includeequal excludedifferent passthru syncwindow casesensitive culture' });
+add('get-unique', { ps: 'inputobject asstring caseinsensitive onetype' });
+// POSIX. `sort` and `date` take no PowerShell names here: `sort -o FILE` writes, `date -s` sets the clock, and a PowerShell-looking `-Second` or `-Top`
+// must not be read by a real sort or date as one of those. (Sort-Object and Get-Date above are the PowerShell forms.)
+add('head', { f: 'qvz', vn: 'nc', n: true, l: 'quiet silent verbose zero-terminated lines bytes' });
+add('tail', { f: 'qvz', vn: 'nc', n: true, l: 'quiet silent verbose zero-terminated lines bytes' }); // no -f, -F, --follow, --retry, --pid, -s: those never end
+add('wc', { f: 'lwcmL', l: 'lines words bytes chars max-line-length' });
+add('grep egrep fgrep', GREP);
+add('rg', { // no --pre, --pre-glob, --hostname-bin (they run a program) and no -z/--search-zip (it runs decompressors)
+  f: 'iIsSnNHlcwFxvUoLaquhVpbP', v: 'efgtTr', vn: 'ABCjdMm',
+  l: 'ignore-case no-ignore-case smart-case case-sensitive fixed-strings word-regexp line-regexp invert-match count count-matches files-with-matches files-without-match files type-list hidden no-ignore no-ignore-vcs no-ignore-parent no-ignore-dot no-ignore-global no-ignore-messages follow line-number no-line-number with-filename no-filename column heading no-heading null only-matching quiet text multiline multiline-dotall pcre2 no-messages json stats trim unrestricted binary no-config vimgrep pretty byte-offset passthru crlf one-file-system no-unicode regexp file glob iglob type type-not max-count max-depth maxdepth context after-context before-context color replace threads sort sortr max-filesize max-columns path-separator encoding engine ignore-file glob-case-insensitive no-glob-case-insensitive' });
+add('stat', { f: 'LtxlnqrsFf', v: 'c', l: 'dereference file-system terse format printf' });
+add('file', { f: 'bhikLnNrvI', l: 'brief dereference no-dereference mime mime-type mime-encoding keep-going no-pad no-buffer raw' }); // no -C, -m, -f, -P (they write or read other files), no -z/-s/-p (they run decompressors, read devices, reset times)
+add('du', { f: 'abchHklmsxLPSD0', v: 'tB', vn: 'd', l: 'all apparent-size bytes total dereference-args human-readable si summarize one-file-system dereference no-dereference separate-dirs count-links inodes null max-depth threshold block-size time time-style exclude' });
+add('df', { f: 'ahHiklmPTv', v: 'txB', l: 'all human-readable si inodes local portability print-type total sync no-sync output block-size type exclude-type' });
+add('uname', { f: 'asnrvmpio', max: 0, l: 'all kernel-name nodename kernel-release kernel-version machine processor hardware-platform operating-system' });
+add('which', { f: 'as', l: 'all' });
+add('basename', { f: 'az', v: 's', l: 'multiple zero suffix' });
+add('dirname', { f: 'z', l: 'zero' });
+add('realpath', { f: 'emsqzLP', l: 'canonicalize-existing canonicalize-missing no-symlinks quiet zero strip logical physical relative-to relative-base' });
+add('readlink', { f: 'femnqsvz', l: 'canonicalize canonicalize-existing canonicalize-missing no-newline quiet silent verbose zero' });
+add('sort', { f: 'bdfghiMnRrsuVzmcC', v: 'kt', l: 'ignore-leading-blanks dictionary-order ignore-case general-numeric-sort human-numeric-sort ignore-nonprinting month-sort numeric-sort random-sort reverse stable unique version-sort zero-terminated check merge sort field-separator key' });
+// uniq's second operand is its OUTPUT file, so it takes at most one.
+add('uniq', { f: 'cdDuiz', vn: 'fsw', max: 1, l: 'count repeated all-repeated unique ignore-case skip-fields skip-chars check-chars zero-terminated group' });
+add('cut', { f: 'snz', v: 'bcfd', l: 'complement only-delimited zero-terminated bytes characters fields delimiter output-delimiter' });
+add('tr', { f: 'cCdst', max: 2 });
+add('date', { f: 'uR', o: 'I', v: 'dr', lv: 'date reference', l: 'utc universal rfc-email rfc-2822 iso-8601 rfc-3339',
+  op: (word) => word.startsWith('+') }); // a bare operand like 1026120026 SETS the clock; only +FORMAT is a format
+add('id', { f: 'ugGnrazZ', l: 'user group groups name real context zero' });
+add('hostname', { f: 'sfiIdaAyv', max: 0 }); // `hostname NAME` renames the machine
+add('whoami', { l: 'help version', op: (word) => /^\/(all|user|groups|priv|upn|fqdn|logonid|nh)$/i.test(word) });
+add('tree', { f: 'adfilpsugDFqNQrtvxCnASUchJX', v: 'LPIHT', vn: '', l: 'help version filelimit charset sort timefmt noreport dirsfirst filesfirst prune du si gitignore matchdirs ignore-case inodes device nolinks' }); // no -o, no -R
+// `less` and `more` are not here: they wait for keys, and `less` can run commands.
+
+/** The names that run without a card (for the tests). */
+export const readOnlyCommandNames = () => [...SPECS.keys()];
+
+/** git subcommands that only read, with the options they may take. */
+const GIT_VIEW = 'oneline graph decorate no-decorate all branches tags remotes stat shortstat numstat dirstat name-only name-status patch no-patch raw summary compact-summary abbrev-commit no-abbrev-commit abbrev reverse follow no-merges merges first-parent full-history simplify-by-decoration simplify-merges ancestry-path left-right left-only right-only cherry-pick cherry-mark cherry topo-order date-order author-date-order relative-date all-match invert-grep regexp-ignore-case extended-regexp fixed-strings perl-regexp no-color color color-words word-diff word-diff-regex minimal patience histogram diff-algorithm check exit-code quiet cached staged merge-base no-index no-ext-diff no-textconv find-renames find-copies find-copies-harder no-renames ignore-space-change ignore-all-space ignore-space-at-eol ignore-blank-lines ignore-cr-at-eol function-context show-function unified inter-hunk-context src-prefix dst-prefix no-prefix full-index binary text source use-mailmap mailmap no-mailmap log-size notes no-notes show-signature diff-merges boundary children parents no-walk sparse date format pretty author committer grep since until after before max-count skip min-parents max-parents diff-filter encoding stat-width stat-name-width stat-graph-width stat-count count';
+const LISTING = ['l', 'list', 'contains', 'no-contains', 'merged', 'no-merged', 'points-at'];
+const GIT = new Map(Object.entries({
+  status: spec({ f: 'sbvz', o: 'u', l: 'short branch porcelain long ignored untracked-files ignore-submodules renames no-renames find-renames show-stash ahead-behind no-ahead-behind column no-column verbose null' }),
+  log: spec({ f: 'pswbMCizuacmrtqEFPR', vn: 'nU', v: 'SGL', n: true, l: GIT_VIEW }),
+  diff: spec({ f: 'pswbMCizuacmrtqEFPR', vn: 'nU', v: 'SGL', n: true, l: GIT_VIEW }),
+  show: spec({ f: 'pswbMCizuacmrtqEFPR', vn: 'nU', v: 'SGL', n: true, l: GIT_VIEW }),
+  'rev-list': spec({ f: 'pswbMCizuacmrtqEFPR', vn: 'nU', v: 'SGL', n: true, l: GIT_VIEW }),
+  shortlog: spec({ f: 'sneciw', n: false, l: `${GIT_VIEW} summary numbered email committer group` }),
+  // Listing forms only. A name with no list option would CREATE a branch or a tag, and the options that change things are not here.
+  branch: spec({ f: 'avri', l: 'list all remotes verbose show-current ignore-case contains no-contains merged no-merged points-at sort format abbrev no-abbrev color no-color column no-column omit-empty',
+    post: (seen, count) => count === 0 || LISTING.some(name => seen.has(name)) }),
+  tag: spec({ f: 'li', o: 'n', l: 'list sort contains no-contains merged no-merged points-at format column no-column ignore-case omit-empty color no-color',
+    post: (seen, count) => count === 0 || LISTING.some(name => seen.has(name)) }),
+  remote: spec({ f: 'v', l: 'verbose', max: 0 }),
+  // `git config KEY` reads and `git config KEY VALUE` writes, so a key is only taken with --get; no --edit, --add, --unset, --file.
+  config: spec({ f: 'lz', l: 'list get get-all get-regexp show-origin show-scope local global system worktree bool int bool-or-int path expiry-date type null name-only includes no-includes', lv: 'default',
+    post: (seen, count) => (count > 0 ? ['get', 'get-all', 'get-regexp'].some(name => seen.has(name)) : seen.has('list') || seen.has('l')) }),
+  'rev-parse': spec({ f: 'q', l: 'show-toplevel git-dir git-common-dir absolute-git-dir abbrev-ref symbolic symbolic-full-name short verify is-inside-work-tree is-inside-git-dir is-bare-repository is-shallow-repository show-prefix show-cdup show-superproject-working-tree all branches tags remotes quiet revs-only no-revs flags no-flags local-env-vars show-object-format path-format', lv: 'default git-path' }),
+  'ls-files': spec({ f: 'cdmoiskuzvtfD', l: 'cached deleted modified others ignored stage directory unmerged killed no-empty-directory error-unmatch exclude-standard exclude full-name eol deduplicate recurse-submodules sparse abbrev resolve-undo format' }),
+  'ls-tree': spec({ f: 'rtdlz', l: 'name-only name-status long full-name full-tree object-only abbrev format' }),
+  blame: spec({ f: 'wMCespltbfnc', v: 'L', l: 'porcelain line-porcelain incremental show-email show-name show-number date root abbrev' }),
+  describe: spec({ l: 'all tags always long dirty broken contains abbrev match exclude first-parent exact-match candidates' }),
+  'cat-file': spec({ f: 'tsep', l: 'batch batch-check batch-all-objects allow-unknown-type buffer unordered follow-symlinks mailmap use-mailmap' }), // no --textconv, --filters
+  // No -O / --open-files-in-pager: they run a program on the matches.
+  grep: spec({ f: 'aiIlLcnvwHhEFGPqpWrzUo', v: 'e', vn: 'ABCm', n: true, l: 'no-index untracked cached no-exclude-standard exclude-standard recurse-submodules text ignore-case word-regexp invert-match full-name extended-regexp basic-regexp perl-regexp fixed-strings line-number column files-with-matches name-only files-without-match count null only-matching quiet no-color color break heading show-function function-context all-match and or not max-depth max-count threads after-context before-context context recursive no-recursive' }),
+}));
 
 /**
- * Whether a shell command only reads. Conservative by design: one unrecognised word and the answer is no.
+ * One command's words against its spec: every option has to be one the spec knows (anything else is not understood, so it asks).
+ * @param {ReturnType<typeof spec>} sp
+ * @param {{t:string,q:boolean}[]} args the words after the command; q marks a quoted text, which is data and never an option
+ */
+function argumentsAreSafe(sp, args) {
+  const seen = new Set();
+  let operands = 0, ended = false;
+  const operand = (arg) => { operands++; return operands <= sp.max && (!sp.op || sp.op(arg.t, arg.q)); };
+  const valueOf = (i, numeric) => { // the next word as an option's value; it can be a quoted text, a number, or a word that is not an option
+    const arg = args[i + 1];
+    if (!arg) return false;
+    return numeric ? NUMBER.test(arg.t) : arg.q || !arg.t.startsWith('-') || NUMBER.test(arg.t);
+  };
+  for (let i = 0; i < args.length; i++) {
+    const { t, q } = args[i];
+    if (q || ended || t === '-' || t[0] !== '-') { if (!operand(args[i])) return false; continue; }
+    if (t === '--') { ended = true; continue; }
+    if (t.startsWith('--')) {
+      const eq = t.indexOf('=');
+      const name = eq < 0 ? t.slice(2) : t.slice(2, eq);
+      if (sp.l.has(name)) { seen.add(name); continue; }
+      if (sp.lv.has(name)) { seen.add(name); if (eq < 0) { if (!valueOf(i, false)) return false; i++; } continue; }
+      return false;
+    }
+    if (sp.ps) {
+      const named = /^-([A-Za-z][A-Za-z0-9]*)(?::|$)/.exec(t);
+      if (named && sp.ps.has(named[1].toLowerCase())) { seen.add(named[1].toLowerCase()); continue; }
+    }
+    if (sp.n && /^-\d+$/.test(t)) continue;
+    for (let j = 1; j < t.length; j++) {
+      const c = t[j];
+      if (sp.f.includes(c)) { seen.add(c); continue; }
+      if (sp.o.includes(c)) { seen.add(c); break; }
+      const numeric = sp.vn.includes(c);
+      if (!numeric && !sp.v.includes(c)) return false;
+      seen.add(c);
+      const rest = t.slice(j + 1);
+      if (rest) { if (numeric && !NUMBER.test(rest)) return false; } else { if (!valueOf(i, numeric)) return false; i++; }
+      break;
+    }
+  }
+  return sp.post ? sp.post(seen, operands) : true;
+}
+
+const SAFE_VERSION = /^(node|python|python3|py|npm|pnpm|git|dotnet|cargo|rustc|go|java|pip|pip3)\s+(--version|-v|-version|version)$/i;
+
+/** Anything that can chain, redirect, expand or start something else is not read-only. (`sh` as a word, not inside an option like `du -sh`.) */
+const UNSAFE_SYNTAX = /[;&<>`${}()]|\r|\n|--%|\bout-file\b|\bset-content\b|\badd-content\b|\binvoke-|\biex\b|\bstart-|\bnew-|\bremove-|\bcopy-|\bmove-|\brename-|\bclear-|\bset-|\bpush-|\bexpand-|\bsave-|\binstall-|\bcurl\b|\bwget\b|\bsudo\b|(?<![-\w])sh(?![-\w])|\bbash\b|\bpwsh\b|\bpowershell\b|\bcmd\b|-exec\b|-delete\b|-execdir\b/i;
+
+/**
+ * The command with every quoted text replaced by a plain stand-in, or null when it cannot be read safely. What is inside quotes is data
+ * (a path like "C:\Users\x\Q&A", a pattern like 'a|b'), so an & ; | ( ) < > or { in it must not decide anything. Two things still can:
+ * inside double quotes a $ or a backtick expands (a variable, a sub-command), and an unterminated quote means the text was not understood.
+ * Either one gives null, and the command asks as before.
+ * @param {string} text
+ * @param {string[]} [quoted] when given, receives the text inside each quote, in order (the checks on operands read it)
+ * @returns {string|null}
+ */
+export function maskQuotes(text, quoted) {
+  let out = '';
+  for (let i = 0; i < text.length; i++) {
+    const c = text[i];
+    if (c !== '"' && c !== "'") { out += c; continue; }
+    let end = text.indexOf(c, i + 1);
+    // PowerShell writes a quote inside a quoted text by doubling it ('it''s'): the text goes on past the pair.
+    while (end >= 0 && text[end + 1] === c) end = text.indexOf(c, end + 2);
+    if (end < 0) return null;
+    if (c === '"' && /[$`]/.test(text.slice(i + 1, end))) return null;
+    // A quoted text is a whole word. One glued to other characters (--out"put"=f, "a"b) or one that starts with a dash could hide an option from the
+    // word checks below (git diff "--output=f" writes a file), so those are not understood either.
+    const before = text[i - 1], after = text[end + 1];
+    if ((before !== undefined && !/[\s|]/.test(before)) || (after !== undefined && !/[\s|]/.test(after)) || text[i + 1] === '-') return null;
+    out += '"_"';
+    quoted?.push(text.slice(i + 1, end));
+    i = end;
+  }
+  return out;
+}
+
+/**
+ * Whether a shell command only reads. Conservative by design: one unrecognised word or option and the answer is no.
+ * Quoted text is data and is looked at after it has been set aside (maskQuotes): Get-ChildItem "C:\Users\x\Q&A" only lists.
  * @param {string} command
  * @returns {boolean}
  */
@@ -78,23 +279,21 @@ export function isReadOnlyShell(command) {
   const text = String(command ?? '').trim();
   if (!text || text.length > 600) return false;
   if (SAFE_VERSION.test(text)) return true;
-  if (UNSAFE_SYNTAX.test(text)) return false;
-  const segments = text.split('|').map(s => s.trim());
-  return segments.every((segment) => {
-    if (!segment) return false;
-    const words = segment.split(/\s+/);
-    const first = words[0].toLowerCase().replace(/^\.\\/, '');
+  const quoted = [];
+  const masked = maskQuotes(text, quoted);
+  if (masked === null || UNSAFE_SYNTAX.test(masked)) return false;
+  let next = 0;
+  const tokens = masked.split('|').map(segment => segment.trim()).map(segment => words(segment).map(w => (w === '"_"' ? { t: quoted[next++] ?? '', q: true } : { t: w, q: false })));
+  return tokens.every((segment) => {
+    if (!segment.length || segment[0].q) return false;
+    const first = segment[0].t.toLowerCase().replace(/^\.\\/, '');
     if (first === 'git') {
-      // `git config` and `git tag`/`branch`/`remote` can write when given a value; only the bare listing forms are safe.
-      const sub = (words[1] ?? '').toLowerCase();
-      if (!SAFE_GIT.has(sub)) return false;
-      if (['config', 'tag', 'branch', 'remote'].includes(sub)) {
-        const rest = words.slice(2).filter(w => !w.startsWith('-') || /^(-l|-a|-v|-vv|--list|--all|--show-current|--get|--get-all)$/i.test(w));
-        return rest.length === 0 || (sub === 'config' && words[2] === '--get') || (sub === 'remote' && words[2] === '-v');
-      }
-      return !words.some(w => /^--(output|ext-diff|textconv)\b/i.test(w));
+      const sub = segment[1];
+      const sp = sub && !sub.q ? GIT.get(sub.t) : null;
+      return !!sp && argumentsAreSafe(sp, segment.slice(2));
     }
-    return SAFE_COMMANDS.has(first) && !words.some(w => /^-(delete|exec|execdir|fprint|fls|ok)$/i.test(w));
+    const sp = SPECS.get(first);
+    return !!sp && argumentsAreSafe(sp, segment.slice(1));
   });
 }
 
@@ -103,14 +302,37 @@ const clip = (value, max) => {
   return text.length > max ? `${text.slice(0, max - 1)}…` : text;
 };
 
+/** The tools that reach the internet. In Manual the first one in a chat asks once; the answer holds for the rest of that chat. */
+export const WEB_TOOLS = new Set(['web_search', 'web_fetch']);
+/** What the model reads when the person says no. Plain words, and it tells the model what to do next. */
+export const WEB_REFUSAL = 'The person did not allow web access, so nothing was searched or opened. Go on without it and say so.';
+
+/**
+ * The question for a web call, in plain words: what is about to leave this computer and where it goes.
+ * @param {{name:string, arguments:any}} exec
+ * @param {{provider?: string}} [options] provider is the search service's name as the person knows it
+ */
+export function webDecision(exec, options = {}) {
+  const tool = String(exec.name ?? '');
+  const args = exec.arguments && typeof exec.arguments === 'object' ? exec.arguments : {};
+  if (tool === 'web_search') {
+    const queries = Array.isArray(args.queries) ? args.queries : [args.query ?? args.q];
+    const words = clip(queries.filter(q => typeof q === 'string' && q.trim()).join('; '), 160);
+    return { kind: 'ask', web: true, reason: `The assistant wants to search the web for: ${words}. Search words go to ${options.provider || 'the search service'}.` };
+  }
+  return { kind: 'ask', web: true, reason: `The assistant wants to open the web page ${clip(args.url, 200)}. The page's site sees the request.` };
+}
+
 /**
  * The decision for one call in Manual mode, or null when it needs no question.
  * @param {{name:string, arguments:any}} exec
- * @returns {{kind:'ask', reason:string}|null}
+ * @param {{provider?: string}} [options]
+ * @returns {{kind:'ask', reason:string, web?:true}|null}
  */
-export function manualDecision(exec) {
+export function manualDecision(exec, options = {}) {
   const tool = String(exec.name ?? '');
   const args = exec.arguments && typeof exec.arguments === 'object' ? exec.arguments : {};
+  if (WEB_TOOLS.has(tool)) return webDecision(exec, options);
   if (READ_ONLY_TOOLS.has(tool)) return null;
   if (SHELL_TOOLS.has(tool)) {
     if (isReadOnlyShell(args.command)) return null;
@@ -150,7 +372,40 @@ export function planDecision(exec) {
   return { kind: 'deny', reason: 'Plan mode only looks and changes nothing, so it cannot use this tool. Switch to Manual or Bypass to use it.' };
 }
 
-export function apply(ctx) {
+/**
+ * @param {object} ctx
+ * @param {{web?: {provider?: string, skipAsk?: boolean}}} [config] `web.provider`: the search service's name for the question;
+ *        `web.skipAsk`: the person's switch in Settings -> Tools, "search the web without asking" (off unless they turned it on)
+ */
+export function apply(ctx, config = {}) {
+  const web = config.web ?? {};
+  /** Chats (their first session) where the person said yes to the web. One yes holds for the rest of the chat. */
+  const webAllowed = new Set();
+  /** A question already on the screen for a chat, so two searches started together share one card. */
+  const webAsking = new Map();
+  const chatOf = (session, depth = 0) => {
+    const parentId = session.header?.parentSession;
+    if (session.header?.origin === 'subagent' && parentId && depth < 6) {
+      const parent = ctx.sessions.get(parentId);
+      if (parent) return chatOf(parent, depth + 1);
+    }
+    return session.id;
+  };
+  async function askWeb(exec, gate, agent) {
+    const chat = chatOf(agent.session);
+    let question = webAsking.get(chat);
+    if (!question) {
+      question = ctx.approval.request({ agent, toolName: exec.name, callId: exec.callId, reason: gate.reason, displayReason: { en: gate.reason }, signal: exec.signal });
+      webAsking.set(chat, question);
+      const forget = () => { if (webAsking.get(chat) === question) webAsking.delete(chat); };
+      question.then(forget, forget);
+    }
+    const outcome = await question;
+    if (outcome === 'allowed-once') { webAllowed.add(chat); return null; }
+    if (outcome === 'cancelled') return { kind: 'cancel' };
+    return { kind: 'deny', reason: WEB_REFUSAL };
+  }
+
   /** The preset a session is really working under: a child follows the chat that started it. */
   const effectivePreset = (session, depth = 0) => {
     const parentId = session.header?.parentSession;
@@ -164,8 +419,13 @@ export function apply(ctx) {
   ctx.on('tools/pre-execute', async (exec, next) => {
     const agent = exec.agent;
     if (!agent || exec.name === 'run_code') return next();
+    // Fail closed (T4): a session whose preset cannot be read (a reset in progress, a helper whose chat is gone) is treated as Manual, so
+    // anything this file cannot prove is read-only still asks. It used to run unasked.
     let preset;
-    try { preset = effectivePreset(agent.session); } catch { return next(); }
+    try { preset = effectivePreset(agent.session); } catch (e) {
+      preset = MANUAL_PRESET;
+      try { console.warn(`[strata-gate] could not read the permission mode for this call (${e?.message ?? e}); treating it as Manual`); } catch { /* logging must never decide a permission */ }
+    }
     // A helper that was set to ask while the chat was in Manual must stop asking the moment the chat leaves Manual,
     // so a mode change applies to the very next tool call of a running goal and its helpers.
     if (preset !== MANUAL_PRESET && agent.session.header?.origin === 'subagent' && ctx.approval.overrideOf(agent.session) === 'ask') {
@@ -173,8 +433,17 @@ export function apply(ctx) {
     }
     if (preset === PLAN_PRESET) return planDecision(exec) ?? next();
     if (preset !== MANUAL_PRESET) return next();
-    const gate = manualDecision(exec);
+    const gate = manualDecision(exec, { provider: web.provider });
     if (!gate) return next();
+    if (gate.web) {
+      // The person's switch, or a yes already given in this chat: no question.
+      if (web.skipAsk === true || webAllowed.has(chatOf(agent.session))) return next();
+      // A helper's own approval policy is `never`; it must be `ask` for the question to reach the person.
+      if (agent.session.header?.origin === 'subagent' && ctx.approval.overrideOf(agent.session) !== 'ask') {
+        agent.session.append('approval/policy', { policy: 'ask' });
+      }
+      return (await askWeb(exec, gate, agent)) ?? next();
+    }
     // A child's approval policy is pinned to `never` by the Harness; asking is how its request reaches the person.
     if (agent.session.header?.origin === 'subagent' && ctx.approval.overrideOf(agent.session) !== 'ask') {
       agent.session.append('approval/policy', { policy: 'ask' });

apps/host/server/agent/plugins/strata-search.mjs

@@ -16,7 +16,7 @@ export const inject = ['web'];
 export function apply(ctx, config = {}) {
   const keyOf = () => (config.keyEnv ? process.env[config.keyEnv] ?? '' : '');
   // Tests only (the bridge option `searchMock`): the same search code on a pretend web, so nothing leaves the machine.
-  const pretend = config.mock === 'limited' ? { fetch: async url => new Response('<html>please verify you are human: captcha</html>', { status: /duckduckgo/.test(String(url)) ? 202 : 429 }) } : null;
+  const pretend = config.mock === 'offline' ? { fetch: async () => { throw new TypeError('fetch failed'); } } : config.mock === 'limited' ? { fetch: async url => new Response('<html>please verify you are human: captcha</html>', { status: /duckduckgo/.test(String(url)) ? 202 : 429 }) } : null;
   const provider = pretend ? createDuckDuckGoSearch(pretend)
     : config.provider === 'exa' ? createExaSearch({ key: keyOf })
     : config.provider === 'perplexity' ? createPerplexitySearch({ key: keyOf })

apps/host/server/agent/preset.mjs

@@ -11,8 +11,8 @@
  *     reminder tools would run behind its back.
  *   - `web_search` removed (tool-web with `search:false`): every search backend the Harness has needs a service key
  *     the app does not have, so the tool could only fail. `web_fetch` stays. (`searchProvider` can switch it back on.)
- *   - `tool-ask-user` removed: the app has no place to show the agent's own questions, so the tool could only fail;
- *     the agent asks in plain text instead.
+ *   - `tool-ask-user` stays (it is the group "Questions for you" in Settings -> Tools): the app shows the agent's own questions in a card above
+ *     the message box and sends the answer back (#4244). Switched off, the tool is not offered and the agent asks in plain text.
  *   - the `planning` group (Harness plan mode and `exit_plan_mode`) removed: the app's Plan mode is the permission
  *     preset (nothing can change); the Harness's plan mode needs an interactive review the app does not have.
  *   - `tool-bash` / `tool-pwsh`: exactly one, by operating system (the Harness chooses the same at load).
@@ -29,7 +29,7 @@ export const STANDARD_PLUGIN_IDS = [
   'tool-ask-user', 'tool-todo', 'tool-web', 'present', 'tool-plugin-manager',
 ];
 /** What we leave out of it. */
-export const REMOVED_PLUGIN_IDS = ['tool-schedule', 'tool-ask-user', 'planning'];
+export const REMOVED_PLUGIN_IDS = ['tool-schedule', 'planning'];
 /** Plugins removed from inside the `delegation` group (the group stays: helper agents are a feature). */
 export const REMOVED_DELEGATION_IDS = [];
 
@@ -42,12 +42,30 @@ export const AGENT_PROMPT = [
   'You are a helpful assistant that can also work on this computer through your tools. You are running as {{model}}.',
   'Answer questions directly and briefly; use a tool only when the task needs one. The person reads your replies in a chat: use plain words, not tool names or technical jargon.',
   'Look before you change: read a file before you edit or overwrite it, and prefer a small edit to a rewrite. Search with the glob and grep tools and read files with the read tool; use the shell for running programs.',
-  'When you start a program or open a folder or file for the person, the command returning without an error means it worked: say plainly that it is open. Do not say you could not confirm it. If a command fails, say what went wrong in one sentence and what you will try next.',
-  'To open a page or a file for the person (a browser, an app, a folder), start it so the command returns at once and never wait for the program to close: on Windows use Start-Process, on macOS open, on Linux xdg-open. Then say plainly that it is open.',
+  'A command that starts a program, folder or page only tells you that it started. Never say a window opened, a page rendered or that you checked how it looks unless a tool confirmed it. If a command fails, say what went wrong in one sentence and what you will try next.',
+  'To show the person an image, SVG, HTML page or PDF from their folders, use the present tool: the app shows it next to the chat. A browser cannot open file:// addresses. If you do start a program, start it so the command returns at once and never wait for it to close: Start-Process on Windows, open on macOS, xdg-open on Linux.',
   'When the person asks you to ask a subagent, a helper or another model ("ask a subagent", "ask model X"), use the subagent tool and name the model in its model field. Never look for a model with shell commands, and never wait for a helper with sleep: end your turn; its answer arrives as a new message.',
   'Tokens prefixed with @ are files or folders the person pointed at. A failed or refused action changed nothing; say so, and do not claim work you did not do.',
 ].join('\n\n');
 
+/**
+ * The one sentence that says which computer this is. The Harness's own runtime context is off (see `includeRuntimeContext` below), so without it
+ * a model on Windows spent its first steps on `ls`, `uname` and `wc` before trying PowerShell commands (and some ran out of steps first).
+ */
+export const OS_LINES = {
+  win32: 'This computer runs Windows and the shell tool is PowerShell: uname, wc and grep do not exist here; use Get-ChildItem, Get-Content, Select-String and Measure-Object. There is no need to check which system this is.',
+  darwin: 'This computer runs macOS and the shell tool is a Unix shell. There is no need to check which system this is.',
+  linux: 'This computer runs Linux and the shell tool is a Unix shell. There is no need to check which system this is.',
+};
+
+/** AGENT_PROMPT with the sentence for `platform` after its first line. */
+export function agentPromptFor(platform = process.platform) {
+  const line = OS_LINES[platform];
+  if (!line) return AGENT_PROMPT;
+  const [first, ...rest] = AGENT_PROMPT.split('\n\n');
+  return [first, line, ...rest].join('\n\n');
+}
+
 /**
  * @param {{platform?: string, search?: boolean}} [options]
  * @returns {object} the `config` of the `preset-standard` row
@@ -55,7 +73,7 @@ export const AGENT_PROMPT = [
 export function standardPreset({ platform = process.platform, search = false, off = new Set(), skillsDir = null, compaction = [] } = {}) {
   const windows = platform === 'win32';
   const plugins = [
-    { id: 'persona', name: '@deepseek-ai/dsh-persona', config: { prefix: AGENT_PROMPT, complete: true, includeRuntimeContext: false } },
+    { id: 'persona', name: '@deepseek-ai/dsh-persona', config: { prefix: agentPromptFor(platform), complete: true, includeRuntimeContext: false } },
     { id: 'agent-instructions', name: '@deepseek-ai/dsh-agent-instructions', config: { maxBytes: 65536 } },
     { id: 'time-context', name: '@deepseek-ai/dsh-time-context' },
     windows
@@ -88,6 +106,7 @@ export function standardPreset({ platform = process.platform, search = false, of
         { id: 'tool-workflow', name: '@deepseek-ai/dsh-tool-workflow' },
       ],
     },
+    { id: 'tool-ask-user', name: '@deepseek-ai/dsh-tool-ask-user' },
     { id: 'tool-todo', name: '@deepseek-ai/dsh-tool-todo', config: { allowParallelInProgress: true } },
     { id: 'tool-web', name: '@deepseek-ai/dsh-tool-web', config: { fetch: !off.has('fetch'), search: search && !off.has('search'), searchTimeoutMs: 60000 } },
     { id: 'present', name: '@deepseek-ai/dsh-tool-present' },

apps/host/server/agent/profile.mjs

@@ -20,6 +20,7 @@
 import { createHash } from 'node:crypto';
 import { fileURLToPath } from 'node:url';
 import { standardPreset } from './preset.mjs';
+import { validMcpName } from '../mcp-names.mjs';
 import { BUDGETS, isPrivateHost } from './llm-shape.mjs';
 import { DDG_PROVIDER_ID } from '../web-search-ddg.mjs';
 
@@ -55,24 +56,35 @@ export const modeOf = value => (Object.hasOwn(MODE_PRESETS, value) ? value : DEF
 /** The approval gate plugin (plain ESM, loaded by absolute path). */
 export const GATE_PLUGIN = fileURLToPath(new URL('./plugins/strata-gate.mjs', import.meta.url));
 /** The app's web search (DuckDuckGo, or the person's own Exa / Perplexity key), registered with the Harness's web seam. */
+/** Compaction that measures the real prompt and summarises in pieces that fit the window (plugins/strata-context.mjs). */
+export const CONTEXT_PLUGIN = fileURLToPath(new URL('./plugins/strata-context.mjs', import.meta.url));
 export const MODELS_PLUGIN = fileURLToPath(new URL('./plugins/strata-models.mjs', import.meta.url));
 export const SEARCH_PLUGIN = fileURLToPath(new URL('./plugins/strata-search.mjs', import.meta.url));
 /** The app's own tool server for the tools a person writes (instructions, commands). */
 export const CUSTOM_TOOLS_SCRIPT = fileURLToPath(new URL('./custom-tools-mcp.mjs', import.meta.url));
 
+/** The search service as the person knows it, for the question that comes before the first web search in a chat. */
+const SEARCH_NAMES = Object.freeze({ builtin: 'DuckDuckGo, or Bing when DuckDuckGo is busy', exa: 'Exa', perplexity: 'Perplexity', deepseek: 'DeepSeek' });
+
 /** What Settings -> Tools says when nothing was chosen. */
-const NO_TOOLS_SETTINGS = Object.freeze({ off: new Set(), search: { provider: 'builtin', key: '' }, browserEnabled: false, browserPath: null, browserCli: null, servers: {}, hasInstructionTools: false, hasCommandTools: false, toolFile: null });
+const NO_TOOLS_SETTINGS = Object.freeze({ off: new Set(), search: { provider: 'builtin', key: '' }, webWithoutAsking: false, browserEnabled: false, browserPath: null, browserCli: null, servers: {}, hasInstructionTools: false, hasCommandTools: false, toolFile: null });
 
 /**
  * The tool servers (MCP) set up for the model in Settings, as Harness client rows. Their tools appear to the agent as
  * `mcp__<server>__<tool>`. A command or URL goes into the patch as text; a secret (an env value or a header) never does: the row
  * carries `!!js process.env.<NAME>` and the value travels in the agent process's environment (returned in `env`).
  */
-export function mcpRows(servers, env) {
+export function mcpRows(servers, env, skipped = []) {
   const rows = [];
+  const ids = new Set();
   let index = 0;
   for (const [name, server] of Object.entries(servers ?? {})) {
-    if (!server || server.disabled === true || !/^[A-Za-z0-9_-]{1,32}$/.test(name)) continue;
+    if (!server || server.disabled === true) continue;       // switched off on purpose: not an error
+    // A server that cannot be wired is REPORTED (T6): the model never sees its tools, and a silent drop looked like "the tool does not work".
+    if (!validMcpName(name)) { skipped.push({ name, why: 'name' }); continue; }
+    if (!server.command && !server.url) { skipped.push({ name, why: 'address' }); continue; }
+    if (ids.has(`mcp-${slug(name)}`)) { skipped.push({ name, why: 'duplicate' }); continue; }
+    ids.add(`mcp-${slug(name)}`);
     const token = (kind, key, value) => {
       const variable = `STRATA_MCP_${index}_${kind}_${slug(key).replace(/-/g, '_').toUpperCase()}`;
       env[variable] = String(value);
@@ -88,6 +100,24 @@ export function mcpRows(servers, env) {
   return rows;
 }
 
+/**
+ * What the chat says when a tool server was left out (one notice per reason). The sentences are interface copy: they are in every language's
+ * catalog (src/locales/tools-<lang>.json), and the {0} is the list of names exactly as the person wrote them.
+ */
+const SKIPPED_TEXT = {
+  name: 'These tool servers were left out because their names are not allowed: {0}. A name can have up to 32 letters, numbers, hyphens or underscores.',
+  address: 'These tool servers were left out because they have no program or web address: {0}.',
+  duplicate: 'These tool servers were left out because another one has almost the same name: {0}.',
+};
+export function mcpSkippedNotices(skipped) {
+  const out = [];
+  for (const why of Object.keys(SKIPPED_TEXT)) {
+    const names = (skipped ?? []).filter(s => s.why === why).map(s => String(s.name).slice(0, 40));
+    if (names.length) out.push({ code: `mcp-skipped-${why}-${names.join(',')}`.slice(0, 160), message: SKIPPED_TEXT[why].replace('{0}', names.join(', ')) });
+  }
+  return out;
+}
+
 const slug = value => String(value).toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 24) || 'x';
 
 /** Identity of one route's wire configuration, secret included by hash only. */
@@ -163,7 +193,7 @@ export function outputBudget(context, maxOutput = null) {
 /** What a local model, or an OpenAI-style server on this network, takes for the thinking level (see the comment where a local route is built). */
 const THINKING_COMPAT = { supportsStore: false, thinkingFormat: 'chat-template', chatTemplateKwargs: { enable_thinking: { $var: 'thinking.enabled' }, reasoning_effort: { $var: 'thinking.effort', omitWhenOff: true } } };
 
-export function buildProfile({ local = [], connections = [], gate = true, tools = NO_TOOLS_SETTINGS, skillsDir = null, proxyBase = null, searchMock = null }) {
+export function buildProfile({ local = [], connections = [], gate = true, tools = NO_TOOLS_SETTINGS, skillsDir = null, proxyBase = null, searchMock = null, defaultLocalId = null }) {
   const providers = {};
   const env = {};
   const routes = [];
@@ -199,6 +229,9 @@ export function buildProfile({ local = [], connections = [], gate = true, tools
       api: 'openai-completions',
       baseURL: inst.baseUrl,
       apiKeyEnv: keyEnv,
+      // A long prompt read sends only SSE comments, which pi-ai's OpenAI client drops, so its 300 s stream-idle timer would cut the
+      // request five minutes in (#3623). 60 minutes is a backstop: serve ends a hung engine and the bridge's watchdog ends a lost turn.
+      streamIdleTimeoutMs: 60 * 60_000,
       // The Strata server reads the thinking level from `chat_template_kwargs` (enable_thinking, reasoning_effort) or from a top-level
       // reasoning_effort; a top-level `enable_thinking` (pi-ai's `qwen` format) is ignored, so the model went on thinking with the menu on Off.
       compat: THINKING_COMPAT,
@@ -254,9 +287,13 @@ export function buildProfile({ local = [], connections = [], gate = true, tools
     for (const m of conn.models) routes.push({ route, fp, kind: 'api', connectionId: conn.id, connectionName: conn.name, modelId: m.id, name: m.name || m.id, contextWindow: m.contextMax ?? ASSUMED_API_CONTEXT, ...(shaped ? { shaped } : {}) });
   });
 
-  const defaultRoute = routes.find(r => r.kind === 'local') ?? null;
+  // The model the chat really runs on is the default instance, not whichever one was loaded first (T5: with two models loaded, the tool servers of the
+  // first one were wired to a chat on the second).
+  const defaultInstance = local.find(i => i.id === defaultLocalId) ?? local[0] ?? null;
+  const defaultRoute = routes.find(r => r.kind === 'local' && r.instanceId === defaultInstance?.id) ?? routes.find(r => r.kind === 'local') ?? null;
   // One Harness, one set of tool servers: the default local model's.
-  const mcp = mcpRows({ ...(local[0]?.mcpServers ?? {}), ...(tools.servers ?? {}) }, mcpEnv);
+  const mcpSkipped = [];
+  const mcp = mcpRows({ ...(defaultInstance?.mcpServers ?? {}), ...(tools.servers ?? {}) }, mcpEnv, mcpSkipped);
   Object.assign(env, mcpEnv);
   // The person's own instruction and command tools come from the app's tool server; a command tool asks in Manual like any connected tool.
   const own = (kind, on) => on && tools.toolFile ? [{ id: `mcp-strata-${kind}`, name: '@deepseek-ai/dsh-mcp-client', config: { serverName: `strata-${kind}`, transport: 'stdio', command: process.execPath, args: [CUSTOM_TOOLS_SCRIPT, kind, tools.toolFile] } }] : [];
@@ -281,7 +318,10 @@ export function buildProfile({ local = [], connections = [], gate = true, tools
     { id: 'permission', config: { presets: Object.fromEntries(Object.values(MODE_PRESETS).map(({ key, sandbox, approval, name, description }) => [key, { sandbox, approval, name, description }])), defaultPreset: MODE_PRESETS[DEFAULT_MODE].key } },
     { id: 'subagent', config: { maxActiveSubagents: slots > 0 ? Math.max(slots, MIN_LOCAL_HELPERS) : DEFAULT_API_HELPERS } },
     // Manual asks before a change runs, so the person sees one Approve/Deny card and nothing has happened yet.
-    ...(gate ? [{ insert: [{ id: 'strata-gate', name: GATE_PLUGIN }] }] : []),
+    // Its web question names the search service the person chose (a keyed one only when its key is saved), and the person's switch skips the question.
+    ...(gate ? [{ insert: [{ id: 'strata-gate', name: GATE_PLUGIN, config: { web: { provider: SEARCH_NAMES[keyed ?? 'builtin'], skipAsk: tools.webWithoutAsking === true } } }] }] : []),
+    // Compaction decides from what the model server measured, and its summary requests always fit the window (plugins/strata-context.mjs).
+    { insert: [{ id: 'strata-context', name: CONTEXT_PLUGIN, config: {} }] },
     // Helper agents on a model the person names: every model the app can reach is allowed, and the plugin makes the choice forgiving (plugins/strata-models.mjs).
     ...(subagentRoutes.length ? [{ id: 'subagent-model-selection-settings', config: { enabled: true, allowedModels: subagentRoutes.map(r => ({ provider: r.provider, model: r.model })) } }] : []),
     ...(subagentRoutes.length ? [{ insert: [{ id: 'strata-models', name: MODELS_PLUGIN, config: { routes: subagentRoutes } }] }] : []),
@@ -305,7 +345,7 @@ export function buildProfile({ local = [], connections = [], gate = true, tools
   // What the agent is offered (tool groups, web search, tool servers, the person's own tools) decides whether a running agent must be
   // restarted for the next message; the routes are compared separately (a changed context size alone does not restart it).
   const toolsSignature = createHash('sha256').update(JSON.stringify([mcp, ownRows, webRows, entries.find(e => e.id === 'preset-standard'), env.STRATA_SEARCH_KEY ?? '', mcpEnv])).digest('hex').slice(0, 16);
-  return { patch, env, routes, defaultRoute, signature, toolsSignature, shapeTargets };
+  return { patch, env, routes, defaultRoute, signature, toolsSignature, shapeTargets, mcpSkipped };
 }
 
 /** Find the route for a chat's model choice. */

apps/host/server/agent/reply-cut.mjs

@@ -0,0 +1,123 @@
+/**
+ * A reply the model could not finish (AGENT-LOST, 11-01): pure helpers, no I/O.
+ *
+ * A model reply has a ceiling (the "output budget"). A thinking model that then writes a whole file in one tool call can spend all of it
+ * before the call is closed. The Harness drops a tool call that was not closed (its arguments are half a JSON text), the turn ends with
+ * the reason `max-tokens`, and until now the person saw nothing: no file, no card, no sentence. Here:
+ *
+ *   - `replyCap(window)`      how much one reply may produce (the request's ceiling), much larger than the budget the Harness reserves
+ *                             for compaction (profile.mjs `localOutputBudget`): the Harness still clamps it to what the window has left.
+ *   - `ToolDraft`             what a tool call that is being written looks like so far: its name, the file it is for, a size, a tail of the text.
+ *   - `cutNotice(...)`        the plain sentence for the chat, and `cutNudge(...)` the message that lets the agent carry on in smaller pieces.
+ */
+
+/** Half the window, at most 64K tokens, and never less than the budget compaction reserves. The Harness clamps it to the room left (window minus prompt). */
+export function replyCap(window, reserved = 0) {
+  const w = Number.isFinite(window) && window > 0 ? Math.floor(window) : 32768;
+  return Math.max(Math.floor(reserved) || 0, Math.min(Math.floor(w / 2), 65536));
+}
+
+const ESCAPES = { n: '\n', t: '\t', r: '', '"': '"', '\\': '\\', '/': '/', b: '', f: '' };
+
+/** A tail of a JSON string body, read back to text: `\n` becomes a newline, `\"` a quote. A half-written escape at the end is dropped. */
+export function unescapeJsonTail(raw) {
+  let text = String(raw ?? '');
+  const cut = /\\(u[0-9a-fA-F]{0,3})?$/.exec(text);
+  if (cut) text = text.slice(0, cut.index);
+  return text.replace(/\\(u[0-9a-fA-F]{4}|[nrtbf"\\/])/g, (_, e) => (e[0] === 'u' ? String.fromCharCode(parseInt(e.slice(1), 16)) : ESCAPES[e] ?? e));
+}
+
+const TARGET = /"(?:file_path|path|filePath)"\s*:\s*"((?:[^"\\]|\\.)*)"/;
+const URL_ARG = /"url"\s*:\s*"((?:[^"\\]|\\.)*)"/;
+/** The long text argument of the common writing tools; the tail of the arguments is previewed after the first one of these. */
+const BODY = /"(?:content|new_string|new_str|text|code|body|command|file_text)"\s*:\s*"/;
+
+/** One tool call being written: the model's streamed arguments, kept small. */
+export class ToolDraft {
+  constructor(id, name = '') {
+    this.id = id; this.name = name;
+    this.bytes = 0; this.lines = 0;
+    this.head = '';            // the first 4,000 characters: the body argument usually starts here
+    this.where = '';           // the file (or address) the call is for, once seen: a model may write it before or after the text
+    this.carry = '';           // the last 300 characters, so a name split between two pieces is still seen
+    this.tail = '';            // the last 2,400 characters: what is being written now
+    this.at = 0;               // when a frame was last sent for it
+  }
+
+  add(piece) {
+    const text = String(piece ?? '');
+    if (!text) return;
+    this.bytes += text.length;
+    for (let i = text.indexOf('\\n'); i >= 0; i = text.indexOf('\\n', i + 2)) this.lines += 1;
+    if (this.head.length < 4000) this.head += text.slice(0, 4000 - this.head.length);
+    this.tail = (this.tail + text).slice(-2400);
+    if (!this.where) {
+      const seen = this.carry + text;
+      const raw = (TARGET.exec(seen) ?? URL_ARG.exec(seen))?.[1];
+      if (raw !== undefined) { try { this.where = JSON.parse(`"${raw}"`); } catch { this.where = unescapeJsonTail(raw); } }
+      this.carry = seen.slice(-300);
+    }
+  }
+
+  get target() { return this.where; }
+
+  /** The text of the body so far, only its last `max` characters; empty until the body argument has started. */
+  preview(max = 1600) {
+    const start = BODY.exec(this.head);
+    if (!start) return '';
+    const bodyAt = start.index + start[0].length;                    // where the body begins, counted in streamed characters
+    if (bodyAt >= this.bytes) return '';
+    const tailAt = this.bytes - this.tail.length;                    // where the kept tail begins
+    const body = unescapeJsonTail(this.tail.slice(Math.max(0, bodyAt - tailAt)));
+    return body.length > max ? body.slice(-max) : body;
+  }
+
+  /** The frame for the page. */
+  frame({ done = false, ...extra } = {}) {
+    return { type: 'agent-tool-draft', draft: { id: this.id, name: this.name, target: this.target, bytes: this.bytes, lines: this.lines, preview: done ? '' : this.preview(), ...extra, done } };
+  }
+}
+
+const kb = n => (n >= 10_000 ? `${Math.round(n / 1000)} KB` : `${(n / 1000).toFixed(1)} KB`);
+
+/** Calls the model was still writing when its reply was cut: [{ name, target, bytes }]. */
+export function cutCalls(drafts) {
+  return [...drafts].filter(d => d.bytes > 0).map(d => ({ name: d.name, target: d.target, bytes: d.bytes }));
+}
+
+const withTokens = tokens => (tokens > 0 ? ` (${Number(tokens).toLocaleString('en-US')} tokens)` : '');
+
+/** The sentence for the person, with the catalog slots it needs: { text, key, values }. `again` is true when the agent was already asked to carry on. */
+export function cutNotice({ calls = [], tokens = 0, again = false, retrying = false } = {}) {
+  const call = calls.find(c => c.target) ?? calls[0] ?? null;
+  const file = call?.target ? String(call.target).split(/[\\/]/).filter(Boolean).at(-1) : '';
+  const what = file || (/^(write|edit)$/.test(call?.name ?? '') ? 'a file' : call?.name);
+  if (call && retrying) {
+    const key = 'That reply reached its length limit{0} while writing {1} ({2}), so that write did not happen. I asked the assistant to look at what is on disk and write the rest in smaller parts.';
+    const values = [withTokens(tokens), what, kb(call.bytes)];
+    return { key, values, text: fill(key, values) };
+  }
+  if (call) {
+    const key = 'The reply reached its length limit{0} while writing {1} ({2}), so that write did not happen. Say “continue” and it will look at what is on disk and go on in smaller parts.';
+    const values = [withTokens(tokens), what, kb(call.bytes)];
+    return { key, values, text: fill(key, values) };
+  }
+  if (retrying) {
+    const key = 'That reply reached its length limit{0} and was cut off. I asked the assistant to carry on.';
+    return { key, values: [withTokens(tokens)], text: fill(key, [withTokens(tokens)]) };
+  }
+  const key = 'The reply reached its length limit{0} and was cut off. Say “continue” to go on.';
+  return { key, values: [withTokens(tokens)], text: fill(key, [withTokens(tokens)]) };
+}
+
+export function fill(template, values) { return String(template).replace(/\{(\d+)\}/g, (_, i) => String(values[Number(i)] ?? '')); }
+
+/** The message sent to the assistant so it carries on. It is not shown as the person's message. */
+export function cutNudge({ calls = [], tokens = 0 } = {}) {
+  const call = calls.find(c => c.target) ?? calls[0] ?? null;
+  if (!call) {
+    return 'Your last reply was cut off by the output limit before it was finished. Carry on from where it stopped without repeating what you already wrote, and keep your thinking short.';
+  }
+  const file = call.target || 'the file';
+  return `Your last reply was cut off by the output limit${tokens > 0 ? ` (${Number(tokens).toLocaleString('en-US')} tokens)` : ''} while you were writing ${file} in one tool call, so that call did not run and nothing was changed by it. First look at what is on disk now (list the folder, read the end of the file). Do not delete or start over a file that is already complete. If it is not complete, write what is missing in several smaller parts (about 150 lines or fewer each) with edits or appends, and read the end of the file back when you are done. Keep your thinking short.`;
+}

apps/host/server/agent/tools-catalog.mjs

@@ -12,10 +12,11 @@ export const TOOL_GROUPS = [
   { id: 'files', area: 'computer', name: 'Read and change files', about: 'Lets the assistant read, create and edit files in your chat folder.', asks: true, plugins: ['tool-fs'] },
   { id: 'find', area: 'computer', name: 'Find files and text', about: 'Lets the assistant look for files by name and search inside them. It only reads.', asks: false, plugins: ['tool-fs-search'] },
   { id: 'jobs', area: 'computer', name: 'Long-running jobs', about: 'Lets the assistant start a slow command in the background and check on it later.', asks: true, plugins: ['tool-jobs'] },
-  { id: 'fetch', area: 'web', name: 'Open web pages', about: 'Lets the assistant read a web page you point it to.', asks: false, web: 'fetch' },
-  { id: 'search', area: 'web', name: 'Search the web', about: 'Lets the assistant search the web when it needs fresh information.', asks: false, web: 'search' },
+  { id: 'fetch', area: 'web', name: 'Open web pages', about: 'Lets the assistant read a web page you point it to.', asks: true, web: 'fetch' },
+  { id: 'search', area: 'web', name: 'Search the web', about: 'Lets the assistant search the web when it needs fresh information.', asks: true, web: 'search' },
   { id: 'helpers', area: 'together', name: 'Helper assistants', about: 'Lets the assistant start helpers that work on parts of a task at the same time.', asks: false, plugins: ['delegation'] },
   { id: 'goals', area: 'together', name: 'Goals', about: 'Lets you give a goal with /goal. The assistant keeps working until it is done.', asks: false, plugins: ['command-goal', 'tool-goal'] },
+  { id: 'questions', area: 'together', name: 'Questions for you', about: 'Lets the assistant stop and ask you a question, with answers to pick from, when it needs your decision.', asks: false, plugins: ['tool-ask-user'] },
   { id: 'todo', area: 'together', name: 'To-do list', about: 'Lets the assistant keep a checklist while it works on a big task.', asks: false, plugins: ['tool-todo'] },
   { id: 'skills', area: 'together', name: 'Skills', about: 'Lets the assistant use your saved skills when they fit the task.', asks: false, plugins: ['skill-filesystem', 'tool-skill'] },
   { id: 'present', area: 'together', name: 'Show results', about: 'Lets the assistant show a page or file in the preview next to the chat.', asks: false, plugins: ['present'] },

apps/host/server/agent/tools-settings.mjs

@@ -13,6 +13,7 @@
 import { mkdirSync, renameSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { GROUP_IDS, TOOL_GROUPS } from './tools-catalog.mjs';
+import { SHELLS, clampTimeoutSec } from './custom-command-run.mjs';
 
 export const SEARCH_PROVIDERS = ['builtin', 'exa', 'perplexity', 'deepseek'];
 const KINDS = ['instructions', 'command', 'server'];
@@ -32,10 +33,14 @@ function normalize(raw) {
     off: [...new Set((Array.isArray(r.off) ? r.off : []).filter(id => GROUP_IDS.includes(id)))],
     search: { provider: SEARCH_PROVIDERS.includes(search.provider) ? search.provider : 'builtin', key: typeof search.key === 'string' ? search.key : '' },
     browser: { enabled: r.browser?.enabled === true },
+    // Manual mode asks once per chat before the first web search or page. This switch (off unless the person turned it on) skips that question.
+    webWithoutAsking: r.webWithoutAsking === true,
     custom: (Array.isArray(r.custom) ? r.custom : []).filter(t => t && NAME.test(t.name ?? '') && KINDS.includes(t.kind)).slice(0, MAX_CUSTOM).map(t => ({
       id: String(t.id), name: String(t.name), about: clean(t.about, 300), kind: t.kind, enabled: t.enabled !== false,
       instructions: clean(t.instructions, 20000), command: clean(t.command, 2000), address: clean(t.address, 2000),
       args: (Array.isArray(t.args) ? t.args : []).slice(0, 50).map(a => clean(a, 1000)),
+      // a command tool's folder, shell and time allowed (custom-command-run.mjs); '' / 'auto' / 120 when not set
+      cwd: clean(t.cwd, 1000).trim(), shell: SHELLS.includes(t.shell) ? t.shell : 'auto', timeoutSec: clampTimeoutSec(t.timeoutSec),
     })),
   };
 }
@@ -47,7 +52,7 @@ function validateCustom(body, existing) {
   if (!about) throw new Error('Say what the tool does, in a sentence. The assistant reads this to decide when to use it.');
   const kind = body?.kind;
   if (!KINDS.includes(kind)) throw new Error('Choose how the tool works.');
-  const out = { name, about, kind, instructions: '', command: '', address: '', args: [] };
+  const out = { name, about, kind, instructions: '', command: '', address: '', args: [], cwd: '', shell: 'auto', timeoutSec: clampTimeoutSec(undefined) };
   if (kind === 'instructions') {
     out.instructions = clean(body.instructions, 20000).trim();
     if (!out.instructions) throw new Error('Write the instructions the assistant should follow when it uses this tool.');
@@ -55,6 +60,14 @@ function validateCustom(body, existing) {
     out.command = clean(body.command, 2000).trim();
     if (!out.command) throw new Error('Enter the command to run.');
     if (/[\r\n]/.test(out.command)) throw new Error('Put the command on one line.');
+    // The edit form of Settings does not send these three: an edit keeps what the tool had.
+    const before = existing.find(t => t.id === body.id && t.kind === 'command');
+    out.cwd = body.cwd !== undefined ? clean(body.cwd, 1000).trim() : before?.cwd ?? '';
+    if (/[\r\n]/.test(out.cwd)) throw new Error('Put the folder on one line.');
+    if (body.shell !== undefined && !SHELLS.includes(body.shell)) throw new Error('Choose how the command runs: automatic, cmd, PowerShell, bash or sh.');
+    out.shell = body.shell !== undefined ? body.shell : before?.shell ?? 'auto';
+    if (body.timeoutSec !== undefined && !(Number(body.timeoutSec) >= 1 && Number(body.timeoutSec) <= 3600)) throw new Error('Give the time allowed in seconds, from 1 to 3600.');
+    out.timeoutSec = body.timeoutSec !== undefined ? clampTimeoutSec(body.timeoutSec) : before?.timeoutSec ?? clampTimeoutSec(undefined);
   } else {
     out.address = clean(body.address, 2000).trim();
     if (!out.address) throw new Error('Enter the tool server’s web address, or the program that starts it.');
@@ -89,7 +102,7 @@ export function createAgentTools({ read, write, dataDir, browser = () => ({ foun
     for (const t of s.custom.filter(t => t.enabled)) {
       const key = t.id;
       if (t.kind === 'instructions') instructions[key] = { description: t.about, text: t.instructions };
-      else if (t.kind === 'command') commands[key] = { description: t.about, command: t.command };
+      else if (t.kind === 'command') commands[key] = { description: t.about, command: t.command, cwd: t.cwd, shell: t.shell, timeoutSec: t.timeoutSec };
     }
     mkdirSync(join(dataDir, 'agent'), { recursive: true });
     const tmp = `${filePath}.tmp`;
@@ -106,12 +119,14 @@ export function createAgentTools({ read, write, dataDir, browser = () => ({ foun
     return {
       groups: TOOL_GROUPS.map(g => ({ id: g.id, name: g.name, about: g.about, area: g.area, asks: g.asks, enabled: !s.off.includes(g.id) })),
       search: { provider: s.search.provider, keySet: !!s.search.key },
+      webWithoutAsking: s.webWithoutAsking,
       // `found` means the browser tool can run: a browser on this computer AND the tool server in the agent component.
       browser: { enabled: s.browser.enabled, found: !!(probe.found && probe.cli), name: probe.name ?? null, ...(probe.found && !probe.cli ? { missing: 'component' } : {}) },
       custom: s.custom.map(t => ({
         id: t.id, name: t.name, about: t.about, kind: t.kind, enabled: t.enabled,
         summary: t.kind === 'instructions' ? t.instructions.slice(0, 80) : t.kind === 'command' ? t.command : t.address,
         instructions: t.instructions, command: t.command, address: t.address, args: t.args,
+        ...(t.kind === 'command' ? { cwd: t.cwd, shell: t.shell, timeoutSec: t.timeoutSec } : {}),
       })),
     };
   }
@@ -131,6 +146,7 @@ export function createAgentTools({ read, write, dataDir, browser = () => ({ foun
       return {
         off: new Set(s.off),
         search: s.search,
+        webWithoutAsking: s.webWithoutAsking,
         browserEnabled: s.browser.enabled && !!(browser().found && browser().cli),
         browserPath: browser().path ?? null,
         browserCli: browser().cli ?? null,
@@ -160,6 +176,7 @@ export function createAgentTools({ read, write, dataDir, browser = () => ({ foun
           s.search = { ...s.search, key };
         }
       }
+      if (typeof change?.webWithoutAsking === 'boolean') s.webWithoutAsking = change.webWithoutAsking;
       if (change?.browser && typeof change.browser.enabled === 'boolean') s.browser = { enabled: change.browser.enabled };
       if (change?.custom) {
         for (const [id, on] of Object.entries(change.custom)) {

apps/host/server/agent/turn-guard.mjs

@@ -10,7 +10,7 @@
  *   rewrites          a plan turn wrote its numbered plan from "1." again this many times
  *   context           the context is nearly full: the Harness compaction did not keep up
  *
- * What the person is told is `guardNote`: fixed English sentences that are also in the interface catalog in all eight languages (the page
+ * What the person is told is `guardNote`: fixed English sentences that are also in the interface catalog in all nine languages (the page
  * translates a `delta` frame that carries `key`). Each says what happened and gives one next step.
  */
 

apps/host/server/agent/user-questions.mjs

@@ -0,0 +1,39 @@
+/**
+ * The agent's own questions (the Harness's `ask_user_question` tool, #4244). The Harness raises the `user-questions/request` event with
+ * `{ questions: [{ id, question, detail?, header?, options?: [{ label, description? }], multiSelect?, intent? }], wait?: { callId } }` and wants
+ * `{ answers: [{ id, selected: string[], custom? }] }` back (AskUserQuestionRequestEvent / AskUserQuestionAnswer of the pinned Harness).
+ * This file only reads the first into something the page can draw, and checks the second before it goes out.
+ */
+const text = (v, max) => (typeof v === 'string' ? v.trim().slice(0, max) : '');
+
+/** The questions of a request, bounded and plain; an empty list when the request carries nothing that can be shown. */
+export function parseQuestions(raw) {
+  const out = [];
+  for (const q of Array.isArray(raw) ? raw.slice(0, 6) : []) {
+    const id = text(q?.id, 120), question = text(q?.question, 800);
+    if (!id || !question) continue;
+    const options = (Array.isArray(q.options) ? q.options.slice(0, 12) : [])
+      .map(o => ({ label: text(o?.label, 200), description: text(o?.description, 400) || undefined })).filter(o => o.label);
+    out.push({ id, question, detail: text(q.detail, 800) || undefined, header: text(q.header, 80) || undefined, options, multiSelect: q.multiSelect === true });
+  }
+  return out;
+}
+
+/**
+ * The answer the person gave, checked against the questions that were asked: every question answered, only the offered labels (or the person's own
+ * words), one choice for a single-select question. Throws a plain Error with a code on the first thing that does not fit.
+ */
+export function buildAnswer(questions, given) {
+  const byId = new Map((Array.isArray(given) ? given : []).map(a => [String(a?.id ?? ''), a]));
+  const answers = [];
+  for (const q of questions) {
+    const a = byId.get(q.id);
+    const labels = new Set(q.options.map(o => o.label));
+    const selected = (Array.isArray(a?.selected) ? a.selected : []).map(s => String(s)).filter(s => labels.has(s));
+    const custom = text(a?.custom, 2000);
+    if (!selected.length && !custom) throw Object.assign(new Error('Answer every question, or skip them.'), { code: 'question-incomplete' });
+    if (!q.multiSelect && selected.length > 1) throw Object.assign(new Error('Choose one answer for each question.'), { code: 'question-invalid' });
+    answers.push({ id: q.id, selected: [...new Set(selected)], ...(custom ? { custom } : {}) });
+  }
+  return { answers };
+}

apps/host/server/artifacts.mjs

@@ -7,6 +7,16 @@ const run=(command,args)=>promisify(execFile)(command,args,{env:externalEnvironm
 const extensions=new Set(['.md','.txt','.pdf','.html','.htm','.png','.jpg','.jpeg','.webp','.gif','.svg','.csv','.ts','.tsx','.js','.jsx','.py','.json','.css','.rs','.go','.sh','.mp4','.webm']);
 export async function openArtifact(body,{examplesDir,previewsDir,platform=process.platform,launch=run}) {
   if(!['open','reveal'].includes(body.action))throw new Error('Choose Open or Show in file explorer.');
+  if(typeof body.url==='string') {
+    // #4721: a web address goes to the person's default browser (the app window drops window.open: WebView2 has no new-window handler). http and https only, no shell.
+    if(body.action!=='open')throw new Error('A web address can only be opened.');
+    let address;try{address=new URL(body.url);}catch{throw new Error('This is not a web address.');}
+    if(!['http:','https:'].includes(address.protocol)||body.url.length>4096)throw new Error('Only http and https addresses can be opened.');
+    if(platform==='darwin')await launch('open',[address.href]);
+    else if(platform==='win32')await launch('rundll32.exe',['url.dll,FileProtocolHandler',address.href]);
+    else await launch('xdg-open',[address.href]);
+    return {ok:true};
+  }
   let file;
   if(typeof body.path==='string') {
     // Only public example assets can be addressed by path. Never accept host paths.

apps/host/server/bundled-engine.mjs

@@ -9,7 +9,7 @@
  * The copy is made under a hidden temporary name and renamed into place, so an interrupted run leaves nothing half-installed
  * (the next start removes the leftover and tries again).
  */
-import { createReadStream, existsSync, readFileSync } from 'node:fs';
+import { createReadStream, existsSync, readFileSync, readdirSync } from 'node:fs';
 import { execFileSync } from 'node:child_process';
 import { copyFile, mkdir, readdir, readFile, rename, rm, stat } from 'node:fs/promises';
 import { createHash } from 'node:crypto';
@@ -64,6 +64,86 @@ export function nvidiaDriverVersion() {
   return null;
 }
 
+/** Where the builds are published; the wrong-make sentence points here. */
+export const RELEASES_URL = 'https://github.com/Niko1221/Strata/releases';
+
+/** The PCI vendor ids of the display adapters Windows reports as present right now (PowerShell, Win32_VideoController); empty when that cannot be read. */
+export function windowsPresentVendors({ platform = process.platform, run = execFileSync } = {}) {
+  const found = new Set();
+  if (platform !== 'win32') return found;
+  try {
+    const out = run('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', 'Get-CimInstance Win32_VideoController | ForEach-Object { $_.PNPDeviceID }'], { encoding: 'utf8', timeout: 15000, windowsHide: true, stdio: ['ignore', 'pipe', 'ignore'] });
+    for (const match of String(out).matchAll(/VEN_([0-9A-F]{4})/gi)) found.add(match[1].toLowerCase());
+  } catch { /* no PowerShell or a limited account: the registry answer stands */ }
+  return found;
+}
+
+/**
+ * The PCI vendor ids (`10de`, `1002`, `8086`) of the Windows display adapters; empty off Windows or when the registry cannot be read.
+ * The registry keeps the entry of a card that was taken out (an NVIDIA card swapped for a Radeon, #3892): when NVIDIA and AMD are both
+ * listed, only the makes Windows reports as present now count, the same rule Strata Control uses (engine_component.windows_display_adapters).
+ */
+export function windowsDisplayVendors({ platform = process.platform, run = execFileSync, present = windowsPresentVendors } = {}) {
+  const found = new Set();
+  if (platform !== 'win32') return found;
+  try {
+    const out = run('reg', ['query', 'HKLM\\SYSTEM\\CurrentControlSet\\Control\\Class\\{4d36e968-e325-11ce-bfc1-08002be10318}', '/s', '/v', 'MatchingDeviceId'], { encoding: 'utf8', timeout: 8000, windowsHide: true, stdio: ['ignore', 'pipe', 'ignore'] });
+    for (const match of String(out).matchAll(/VEN_([0-9A-F]{4})/gi)) found.add(match[1].toLowerCase());
+  } catch { /* no registry access: the tools decide */ }
+  if (found.has('10de') && found.has('1002')) {
+    const now = present({ platform, run });
+    const kept = new Set([...found].filter(vendor => now.has(vendor)));
+    if (kept.size) return kept;
+  }
+  return found;
+}
+
+const BACKEND_OF_VENDOR = [['10de', 'cuda'], ['1002', 'hip'], ['8086', 'sycl']];
+
+/**
+ * Every engine family this PC's graphics cards can run, in the order NVIDIA, AMD, Intel; STRATA_ENGINE_BACKEND wins. A PC with two
+ * makes lists both, so a build for either make is accepted (recommend, never force).
+ */
+export function gpuBackendsHere(env = process.env, { vendors = windowsDisplayVendors() } = {}) {
+  const forced = String(env.STRATA_ENGINE_BACKEND ?? '').trim().toLowerCase();
+  if (forced) return ['cuda', 'hip', 'sycl'].includes(forced) ? [forced] : [];
+  if (vendors.size) {
+    const list = BACKEND_OF_VENDOR.filter(([vendor]) => vendors.has(vendor)).map(([, backend]) => backend);
+    if (list.length) return list;
+  }
+  if (nvidiaDriverVersion()) return ['cuda'];
+  try {
+    const base = '/sys/class/drm';
+    const seen = new Set();
+    for (const card of readdirSync(base)) {
+      if (!/^card\d+$/.test(card)) continue;
+      try { seen.add(readFileSync(`${base}/${card}/device/vendor`, 'utf8').trim().toLowerCase()); } catch { /* no vendor file */ }
+    }
+    const list = [['0x10de', 'cuda'], ['0x1002', 'hip'], ['0x8086', 'sycl']].filter(([vendor]) => seen.has(vendor)).map(([, backend]) => backend);
+    if (list.length) return list;
+  } catch { /* not Linux */ }
+  return [];
+}
+
+/**
+ * The engine family this PC's graphics card needs ('cuda', 'hip', 'sycl'), or null when it cannot be told. The same order as Control
+ * (NVIDIA first, then AMD, then Intel); STRATA_ENGINE_BACKEND wins. Reads only the driver and (Linux) the PCI vendor of the display adapters.
+ */
+export function gpuBackendHere(env = process.env, options = {}) {
+  return gpuBackendsHere(env, options)[0] ?? null;
+}
+
+const HIP_FAMILIES = [['RX 9000', ['gfx1200', 'gfx1201']], ['RX 7000', ['gfx1100', 'gfx1101', 'gfx1102']], ['RX 6000', ['gfx1030', 'gfx1031']], ['Ryzen AI Max', ['gfx1151']]];
+const MAKE_NAME = { cuda: 'NVIDIA', hip: 'AMD', sycl: 'Intel' };
+
+/** The plain sentence for a build made for another make of graphics card than this PC has. */
+export function wrongMakeNotice(manifest, here) {
+  const built = manifest.backend;
+  const families = [...new Set((manifest.archs ?? []).map(a => HIP_FAMILIES.find(([, list]) => list.includes(a))?.[0]).filter(Boolean))];
+  const builtFor = built === 'hip' && families.length ? `AMD ${families.join(' and ')}` : MAKE_NAME[built] ?? built;
+  return `This Strata is for ${builtFor} cards. Your PC has an ${MAKE_NAME[here] ?? here} card: download the ${MAKE_NAME[here] ?? here} version from ${RELEASES_URL}`;
+}
+
 /** One engine can ship as several builds of the same backend (CUDA 13 and CUDA 12 differ in the oldest driver they run on). */
 const variantOf = manifest => `${manifest.platform}/${manifest.backend}/${manifest.min_driver?.nvidia ?? ''}`;
 
@@ -85,7 +165,7 @@ export async function packageIsWhole(folder, manifest, { deep = false } = {}) {
  * Install the bundled engine when it is needed.
  * Returns { action: 'installed' | 'repaired' | 'kept' | 'none' | 'refused', folder?, version?, reason? }; never throws.
  */
-export async function installBundledEngine({ bundleDir, components, platform = null, log = () => {}, driver = undefined } = {}) {
+export async function installBundledEngine({ bundleDir, components, platform = null, log = () => {}, driver = undefined, backend = undefined } = {}) {
   try {
     if (!bundleDir || !components || !existsSync(bundleDir)) return { action: 'none' };
     let packages = [];
@@ -96,6 +176,19 @@ export async function installBundledEngine({ bundleDir, components, platform = n
     }
     if (platform) packages = packages.filter(p => p.manifest.platform === platform);
     if (!packages.length) return { action: 'none' };
+    // A build for another make of graphics card than this PC has can never run here: it is not unpacked, and the caller says so in plain words.
+    // A PC with two makes (an AMD card for the model, an NVIDIA card for the desktop) accepts a build for either (#3892).
+    const wantedList = backend === undefined ? gpuBackendsHere() : (Array.isArray(backend) ? backend : backend ? [backend] : []);
+    const wanted = wantedList[0] ?? null;
+    if (wanted && ['cuda', 'hip', 'sycl'].includes(wanted)) {
+      const gpu = packages.filter(p => ['cuda', 'hip', 'sycl'].includes(p.manifest.backend));
+      const fits = packages.filter(p => !gpu.includes(p) || wantedList.includes(p.manifest.backend));
+      if (gpu.length && !fits.length) {
+        const first = gpu.sort((a, b) => compareVersions(b.manifest.version, a.manifest.version))[0].manifest;
+        return { action: 'wrong-make', built: first.backend, here: wanted, notice: wrongMakeNotice(first, wanted) };
+      }
+      packages = fits;
+    }
     // The CUDA builds the NVIDIA driver here can run: all of them when the driver is unknown or fits several; when none fits, the one with the lowest
     // requirement, so that Control can name the driver to install (copying the others would only waste disk).
     const driverHere = driver === undefined ? nvidiaDriverVersion() : driver;
@@ -173,3 +266,55 @@ export async function installBundledEngine({ bundleDir, components, platform = n
     return { action: 'refused', reason: error?.message ?? String(error) };
   }
 }
+
+/**
+ * After an update from an installer that carried an engine (a per-GPU build), its `engine-bundle` folder is still in the install folder
+ * (about 570 MB) although the engine was copied to the engine store long ago. It is removed only when EVERY package in it exists complete in
+ * the store (every file there with the size and SHA-256 its manifest lists); otherwise it stays and one line says why.
+ * Returns { removed: bool, reason?: string, packages?: number }; never throws.
+ */
+export async function removeVerifiedBundle({ bundleDir, components, log = () => {} } = {}) {
+  try {
+    if (!bundleDir || !components || !existsSync(bundleDir)) return { removed: false, reason: 'no bundle' };
+    // Files inside a signed macOS app must stay intact after installation.
+    if (process.platform === 'darwin' && resolve(bundleDir).split(sep).some(part => part.toLowerCase().endsWith('.app'))) return keepBundle(log, 'macOS app bundles must remain unchanged after signing');
+    const packages = [];
+    for (const entry of await readdir(bundleDir, { withFileTypes: true })) {
+      if (!entry.isDirectory()) continue;
+      const folder = join(bundleDir, entry.name);
+      const manifest = await readManifest(folder);
+      packages.push({ folder, manifest, name: entry.name });
+    }
+    if (!packages.length) return { removed: false, reason: 'nothing in the bundle' };
+    const store = join(components, 'engine');
+    const stored = existsSync(store) ? (await readdir(store, { withFileTypes: true })).filter(e => e.isDirectory() && !e.name.startsWith('.')).map(e => join(store, e.name)) : [];
+    for (const pkg of packages) {
+      if (!pkg.manifest) return keepBundle(log, `${pkg.name} has no readable manifest`);
+      let found = false;
+      for (const candidate of stored) {
+        const theirs = await readManifest(candidate);
+        if (!theirs || theirs.version !== pkg.manifest.version || theirs.platform !== pkg.manifest.platform || theirs.backend !== pkg.manifest.backend
+          || (theirs.variant ?? '') !== (pkg.manifest.variant ?? '') || (theirs.build_id ?? '') !== (pkg.manifest.build_id ?? '')) continue;
+        if (await packageIsWhole(candidate, pkg.manifest, { deep: true })) { found = true; break; }
+      }
+      if (!found) return keepBundle(log, `${pkg.name} is not (or not completely) in the engine store`);
+    }
+    for (const pkg of packages) await rm(pkg.folder, { recursive: true, force: true });
+    log(`engine bundle: the copy that came with the installer (${packages.map(p => p.name).join(', ')}) was removed; the same engine is complete in the engine store`);
+    return { removed: true, packages: packages.length };
+  } catch (error) {
+    return keepBundle(log, `could not be checked (${error?.message ?? error})`);
+  }
+}
+function keepBundle(log, why) {
+  log(`engine bundle: kept in the install folder (${why})`);
+  return { removed: false, reason: why };
+}
+
+/**
+ * What the host does once its engine step has settled: for an engine that is (or was) there, look at the install folder's leftover bundle.
+ * The lines go to the host's output (console.log), which the desktop shell copies to its log file (`[host] engine bundle: ...`).
+ */
+export function cleanupAfterInstall(settled, { bundleDir, components, log = line => console.log(line) } = {}) {
+  return Promise.resolve(settled).then(result => (['installed', 'kept', 'repaired'].includes(result?.action) ? removeVerifiedBundle({ bundleDir, components, log }) : null), () => null);
+}

apps/host/server/catalog.mjs

@@ -103,7 +103,7 @@ export function expertParams(cores = null) {
     { id: 'server.parallel', group: 'Server', label: 'Engine request slots', effect: 'This UI host dispatches one request at a time', type: 'number', value: 1, recommended: 1 },
     { id: 'server.queue', group: 'Server', label: 'Queue depth', effect: 'Requests allowed to wait', type: 'number', value: 8, recommended: 8 },
     { id: 'server.timeout', group: 'Server', label: 'Request timeout', effect: 'Seconds before a call is dropped', type: 'number', value: 600, recommended: 600 },
-    { id: 'server.cors', group: 'Server', label: 'Allow browser origins', effect: 'CORS for local web apps', type: 'toggle', value: false, recommended: false },
+    { id: 'server.cors', group: 'Server', label: 'Allow browser origins', effect: 'This switch does nothing in the app. Web pages from any site can already call the API shown under Serving. To allow only some sites, or to use the engine’s own server (port 8080), add "cors_origins": ["https://your.site"] to the model’s config file.', type: 'toggle', value: false, recommended: false },
 
     // Advanced
     { id: 'adv.rope', group: 'Advanced', label: 'RoPE scaling', effect: 'Extends context beyond training', type: 'number', value: 1, recommended: 1, advanced: true },

apps/host/server/cloudflare.mjs

@@ -3,6 +3,8 @@ import { spawn } from 'node:child_process';
 import { probe, which } from './util.mjs';
 import { classifyRunning, describeConnector, otherTunnelMessage, ownTunnelMessage } from './cloudflared-find.mjs';
 
+/** A tunnel without a key is allowed (owner decision, 0.2.2); because the link is public the warning is stronger than the local one. */
+export const NO_KEY_TUNNEL_WARNING = 'No API key is set, so anyone who finds this link can use your model from the internet. Create an API key to protect it.';
 export function tunnelHostname(value) {
   const hostname = String(value ?? '').trim().toLowerCase();
   if (hostname.length > 253 || !/^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,63}$/.test(hostname)) throw new Error('Enter a hostname such as ai.example.com, without https:// or a path.');
@@ -13,7 +15,7 @@ export function createCloudflare({ origin, originUrl, hasKey, changed = () => {}
   let value = { status: 'idle', mode: null, url: null, error: null };
   const state = () => {
     const info = binary ? connectorInfo() : null;
-    return { ...value, installed: !!binary, originUrl, connector: info ? { path: info.path, version: info.version, source: info.source, label: info.label, summary: describeConnector(info) } : null, external: other?.running ? externalState() : null };
+    return { ...value, warning: value.status === 'connected' && !hasKey() ? NO_KEY_TUNNEL_WARNING : null, installed: !!binary, originUrl, connector: info ? { path: info.path, version: info.version, source: info.source, label: info.label, summary: describeConnector(info) } : null, external: other?.running ? externalState() : null };
   };
   const update = patch => { value = { ...value, ...patch }; changed(state()); };
   function externalState(token = '') {
@@ -52,7 +54,6 @@ export function createCloudflare({ origin, originUrl, hasKey, changed = () => {}
   }
   async function start(body) {
     if (busy || ['starting', 'connected', 'stopping'].includes(value.status)) throw new Error('Stop the current tunnel before starting another.');
-    if (!hasKey()) throw new Error('Create a Strata API key before connecting Cloudflare.');
     if (!['quick', 'domain'].includes(body.mode)) throw new Error('Choose a temporary URL or your own domain.');
     const hostname = body.mode === 'domain' ? tunnelHostname(body.hostname) : null;
     const token = body.mode === 'domain' ? String(body.token ?? '').trim() : '';

apps/host/server/cloudflared-find.mjs

@@ -10,6 +10,7 @@
  * The first one that runs `cloudflared --version` and is new enough is used; the answer says which one and from where.
  * Nothing here downloads or installs anything.
  */
+import { utf8Script } from './powershell-utf8.mjs';
 import { execFile } from 'node:child_process';
 import { access, stat } from 'node:fs/promises';
 import { constants } from 'node:fs';
@@ -134,7 +135,7 @@ export async function findRunningConnector({ platform = process.platform, exclud
   const skip = new Set(exclude.filter(Number.isInteger));
   let procs = [];
   if (platform === 'win32') {
-    const out = await run('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', "Get-CimInstance Win32_Process -Filter \"Name='cloudflared.exe'\" | ForEach-Object { \"$($_.ProcessId)`t$($_.CommandLine)\" }"]);
+    const out = await run('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', utf8Script("Get-CimInstance Win32_Process -Filter \"Name='cloudflared.exe'\" | ForEach-Object { \"$($_.ProcessId)`t$($_.CommandLine)\" }")]);
     procs = out.split(/\r?\n/).map(l => /^(\d+)\t(.*)$/.exec(l)).filter(Boolean).map(m => ({ pid: Number(m[1]), command: m[2] }));
     if (!procs.length) {   // no PowerShell answer: at least the pids
       const list = await run('tasklist', ['/FI', 'IMAGENAME eq cloudflared.exe', '/NH', '/FO', 'CSV']);

apps/host/server/control-runtime.mjs

@@ -74,6 +74,17 @@ export function findControl({ env = process.env, platform = process.platform, ex
   return control;
 }
 
+/**
+ * The environment of the server the host starts from a source checkout (#3851): the key travels in the run configuration, so a
+ * STRATA_API_KEY the host itself was started with is removed. Setting it to an empty string made serve/server.py stop with
+ * "an API key was given but it is empty".
+ */
+export function sourceServerEnvironment(env = process.env) {
+  const next = { ...env, PYTHONUNBUFFERED: '1', PYTHONUTF8: '1', PYTHONIOENCODING: 'utf-8' };
+  delete next.STRATA_API_KEY;
+  return next;
+}
+
 /** The environment Control runs in: nothing from the user's Python, and acquiring forbidden. */
 export function controlEnvironment(control, { env = process.env, components = componentsDirectory({ env }), acquire = false } = {}) {
   const next = { ...env };
@@ -110,10 +121,18 @@ export class ControlError extends Error {
   }
 }
 
-/** Run one CLI command of Control. Resolves { code, json, text, stderr }; rejects only if it cannot start or times out. */
-export function runCli(control, args, { env = process.env, timeoutMs = 60_000, spawnProcess = spawn, components, acquire = false, onLine = null, signal = null } = {}) {
+/**
+ * Small Control programs that are a module of strata_control and not a `strata` command. They run on Control's interpreter with Control's folder first on the
+ * path (the folder is the working directory), so they work whatever the interpreter does with the script folder.
+ */
+const BOOT = {
+  pictures: 'import os,sys;sys.path.insert(0,os.getcwd());from strata_control import pictures;sys.exit(pictures.main(sys.argv[1:]))',
+};
+
+/** Run one CLI command of Control (or, with `boot`, one of its modules). Resolves { code, json, text, stderr }; rejects only if it cannot start or times out. */
+export function runCli(control, args, { env = process.env, timeoutMs = 60_000, spawnProcess = spawn, components, acquire = false, onLine = null, signal = null, boot = null } = {}) {
   return new Promise((resolveRun, reject) => {
-    const child = spawnProcess(control.python, [control.cli, ...args], {
+    const child = spawnProcess(control.python, boot ? ['-c', BOOT[boot], ...args] : [control.cli, ...args], {
       cwd: control.dir, windowsHide: true, stdio: ['ignore', 'pipe', 'pipe'],
       env: controlEnvironment(control, { env, acquire, ...(components ? { components } : {}) }),
     });
@@ -174,20 +193,44 @@ export function createControl({ control = findControl(), env = process.env, run
       if (result.json?.ok) return result.json;
       throw failure(result, 'The update check failed.');
     },
-    async update({ feed = env.STRATA_UPDATE_FEED ?? null, engine = true, control: withControl = true, appVersion = env.STRATA_APP_VERSION ?? null, force = false, onEvent = null, signal = null } = {}) {
+    async update({ feed = env.STRATA_UPDATE_FEED ?? null, engine = true, control: withControl = true, appVersion = env.STRATA_APP_VERSION ?? null, force = false, stopModel = false, onEvent = null, signal = null } = {}) {
       const args = ['update', '--output', 'jsonl', ...feedArgs(feed), ...(engine ? [] : ['--no-engine']), ...(withControl ? [] : ['--no-control']),
-        ...(appVersion ? ['--app-version', appVersion] : []), ...(force ? ['--force'] : [])];
+        ...(appVersion ? ['--app-version', appVersion] : []), ...(force ? ['--force'] : []), ...(stopModel ? ['--stop-model'] : [])];
       const result = await call(args, { timeoutMs: 3 * 3600_000, acquire: true, onLine: onEvent ?? (() => {}), signal });
       if (result.json?.ok) return result.json;
       const failed = result.json?.results?.find?.(r => r.status === 'failed');
       if (failed) throw Object.assign(new ControlError(failed.error, { exitCode: failed.exit_code ?? result.code, output: result.json }), { code: result.code === 7 ? 'engine_serving' : 'update_failed' });
       throw failure(result, 'The update failed.');
     },
+    /** Install an engine package the person downloaded and chose (the offline path): no network; Control checks the package's own signature. */
+    async installEngineFile(path, { onEvent = null, signal = null } = {}) {
+      const result = await call(['components', 'install-file', path, '--output', 'jsonl'], { timeoutMs: 3600_000, onLine: onEvent ?? (() => {}), signal });
+      if (result.json?.ok) return { ok: true, results: [result.json] };
+      throw failure(result, 'This file could not be installed.');
+    },
     async rollbackEngine() {
       const result = await call(['components', 'rollback', '--output', 'json'], { timeoutMs: 120_000 });
       if (result.json?.ok) return result.json;
       throw failure(result, 'The engine could not be rolled back.');
     },
+    /** The engines installed on this computer, by family (`strata components engines`): the one list the Terminal prints too. Reads files only. */
+    async engines() {
+      const result = await call(['components', 'engines', '--output', 'json'], { timeoutMs: 60_000 });
+      if (result.json?.ok) return result.json;
+      throw failure(result, 'The installed engines could not be read.');
+    },
+    /** Switch to an installed engine (`strata components use`): nothing is downloaded. `root` is only for a DeepSeek engine that lives in more than one place. */
+    async useEngine({ family, folder }) {
+      const result = await call(['components', 'use', folder, '--family', family, '--output', 'json'], { timeoutMs: 600_000 });
+      if (result.json?.ok) return result.json;
+      throw failure(result, 'The engine could not be switched.');
+    },
+    /** Delete an installed engine (`strata components remove`); Control refuses the one in use. */
+    async removeEngine({ family, folder }) {
+      const result = await call(['components', 'remove', folder, '--family', family, '--output', 'json'], { timeoutMs: 600_000 });
+      if (result.json?.ok) return result.json;
+      throw failure(result, 'The engine could not be deleted.');
+    },
     async engine({ backend = null } = {}) {
       const result = await call(['components', 'engine', '--output', 'json', ...(backend ? ['--backend', backend] : [])], { timeoutMs: 30_000 });
       if (result.json) return result.json;                  // exit 5 still carries the report and the notice
@@ -207,6 +250,72 @@ export function createControl({ control = findControl(), env = process.env, run
       if (result.json?.plan && Array.isArray(result.json.plan.issues)) return result.json.plan;
       throw failure(result, 'The files could not be checked.');
     },
+    /** What picking `to` as the models folder means (sizes, free space, which choices are possible, why not): nothing is changed. */
+    async planModelsMove(from, to) {
+      const result = await call(['models', 'move', to, ...(from ? ['--from', from] : []), '--plan', '--output', 'json'], { timeoutMs: 120_000 });
+      if (result.json?.plan) return result.json.plan;
+      throw failure(result, 'The folder could not be checked.');
+    },
+    /**
+     * Move the model files to `to` (copied, checked, then the old copies removed). `onEvent` gets the progress lines; a file at `cancelFile` stops it
+     * safely. Resolves with the summary (done / stopped, what moved, what is left); a failure is a ControlError whose `output` carries the details.
+     */
+    async moveModels(from, to, { installDir = null, cancelFile = null, onEvent = null } = {}) {
+      const args = ['models', 'move', to, ...(from ? ['--from', from] : []), ...(installDir ? ['--install-dir', installDir] : []), ...(cancelFile ? ['--cancel-file', cancelFile] : []), '--output', 'jsonl'];
+      const result = await call(args, { timeoutMs: 24 * 3600_000, onLine: onEvent ?? (() => {}) });
+      if (result.json?.ok && result.json.event === 'result') return result.json;
+      const error = result.json?.error;
+      throw Object.assign(new ControlError(error?.message ?? (result.stderr.split(/\r?\n/).filter(Boolean).pop() || 'The models could not be moved.'), { exitCode: result.code, output: result.json }), { code: error?.code ?? 'move_failed', details: error?.details ?? '' });
+    },
+    /** A move of the models folder that the last run left unfinished (`strata models move --status`): null, or {state, from, to, bytes}. */
+    async interruptedModelsMove(dataFolder) {
+      const result = await call(['models', 'move', '--status', ...(dataFolder ? ['--from', dataFolder] : []), '--output', 'json'], { timeoutMs: 30_000 });
+      if (result.json?.ok) return result.json.interrupted ?? null;
+      throw failure(result, 'The models folder could not be checked.');
+    },
+    /** "Finish it": the same move again, from where it stopped. Same events and result as moveModels. */
+    async resumeModelsMove(dataFolder, { installDir = null, cancelFile = null, onEvent = null } = {}) {
+      const args = ['models', 'move', '--resume', ...(dataFolder ? ['--from', dataFolder] : []), ...(installDir ? ['--install-dir', installDir] : []), ...(cancelFile ? ['--cancel-file', cancelFile] : []), '--output', 'jsonl'];
+      const result = await call(args, { timeoutMs: 24 * 3600_000, onLine: onEvent ?? (() => {}) });
+      if (result.json?.ok && result.json.event === 'result') return result.json;
+      const error = result.json?.error;
+      throw Object.assign(new ControlError(error?.message ?? (result.stderr.split(/\r?\n/).filter(Boolean).pop() || 'The models could not be moved.'), { exitCode: result.code, output: result.json }), { code: error?.code ?? 'move_failed', details: error?.details ?? '' });
+    },
+    /** "Leave it": keep the old folder, remove the partial copies in the new one. */
+    async leaveModelsMove(dataFolder, { installDir = null } = {}) {
+      const result = await call(['models', 'move', '--leave', ...(dataFolder ? ['--from', dataFolder] : []), ...(installDir ? ['--install-dir', installDir] : []), '--output', 'json'], { timeoutMs: 24 * 3600_000 });
+      if (result.json?.ok) return result.json;
+      throw Object.assign(failure(result, 'The partial copies could not be removed.'), { code: result.json?.error?.code ?? 'leave_failed', details: result.json?.error?.details ?? '' });
+    },
+    /**
+     * The DFlash2 drafter for a model's run config and the drafting choice (`strata drafting plan`): { needed, gb, line, note, drafter }. Control decides
+     * (the table of strata_control/drafting.py); the app never reads it. Nothing is downloaded.
+     */
+    async draftingPlan({ configPath = null, mode = null, family = null, dataDir = null } = {}) {
+      const result = await call(['drafting', 'plan', ...(configPath ? ['--config', configPath] : []), ...(mode ? ['--mode', mode] : []), ...(family ? ['--family', family] : []), ...(dataDir ? ['--data-dir', dataDir] : []), '--no-split', '--output', 'json'], { timeoutMs: 30_000 });
+      if (result.json?.ok) return result.json;
+      throw failure(result, 'The drafter could not be checked.');
+    },
+    /** Fetch and pack the drafter when the choice would use it and it is not here (`strata drafting fetch --if-needed`); `onEvent` gets {step, done, total}. */
+    async draftingFetch({ configPath, mode = null, onEvent = null, signal = null } = {}) {
+      const args = ['drafting', 'fetch', '--config', configPath, ...(mode ? ['--mode', mode] : []), '--no-split', '--if-needed', '--output', 'jsonl'];
+      const result = await call(args, { timeoutMs: 3 * 3600_000, acquire: true, onLine: onEvent ?? (() => {}), signal });
+      if (result.json?.ok) return result.json;
+      throw Object.assign(new ControlError(result.json?.error?.message ?? (result.stderr.split(/\r?\n/).filter(Boolean).pop() || 'The DFlash2 drafter could not be downloaded.'), { exitCode: result.code, output: result.json }), { code: 'drafting_failed' });
+    },
+    /**
+     * The picture files of an installed model that has none (strata_control/pictures.py): found or downloaded once (about 0.9 GB, shared), and the run
+     * config's `vision` section worked out for this engine. Nothing else of the model is touched and nothing is written to its run config: the caller does.
+     * Resolves { mmproj, vision, fetched, note, data_dir }; a failure is a ControlError whose `code` is offline | disk | failed | checksum | unsupported | no_reader.
+     * `onEvent` gets {step, done, total}. This is an explicit step that may reach the network (`acquire`), only for the Load the person pressed.
+     */
+    async picturesFetch({ configPath, engineDir, vision = 'yes', dataDir = null, family = null, hardware = null, onEvent = null, signal = null } = {}) {
+      const args = ['fetch', '--config', configPath, '--engine-dir', engineDir, '--vision', vision, ...(dataDir ? ['--data-dir', dataDir] : []), ...(family ? ['--family', family] : []),
+        ...(hardware?.vram_gb != null ? ['--vram-gb', String(hardware.vram_gb)] : []), ...(hardware?.make ? ['--make', String(hardware.make)] : []), ...(hardware?.arch != null ? ['--arch', String(hardware.arch)] : [])];
+      const result = await call(args, { timeoutMs: 3 * 3600_000, acquire: true, boot: 'pictures', onLine: onEvent ?? (() => {}), signal });
+      if (result.json?.ok) return result.json;
+      throw Object.assign(new ControlError(result.json?.error?.message ?? (result.stderr.split(/\r?\n/).filter(Boolean).pop() || 'The picture files could not be downloaded.'), { exitCode: result.code, output: result.json }), { code: result.json?.error?.code ?? 'failed' });
+    },
     async saveProfile(name, configPath) {
       const listed = await call(['profile', 'list', '--output', 'json'], { timeoutMs: 20_000 });
       const known = (listed.json?.profiles ?? []).some(p => p.id === name);

apps/host/server/device-probes.mjs

@@ -1,6 +1,7 @@
 /** Physical topology and GPU sensors; unavailable values stay null. */
 import { readFile, readdir, realpath } from 'node:fs/promises';
 import { probe, round } from './util.mjs';
+import { windowsGpuReading } from './windows-gpu.mjs';
 
 /** Unified GPUs share one system memory pool; dedicated GPUs each have their own. */
 export function gpuMemoryTotals(devices, readings) {
@@ -39,13 +40,15 @@ export function parseNvidiaDevices(raw) {
     return [{id:uuid,index:Number(index),sensorIndex:Number(index),busId:bus?.toLowerCase(),vendor:'nvidia',name,vramGb:round((number(memory)??0)/1024,1),unified:false,backend:'cuda',driver}];
   });
 }
+/** A percentage reading; "[N/A]" and out-of-range values are no reading. */
+const percentOf = v => { const n=number(v); return n!==null&&n>=0&&n<=100?n:null; };
 export function parseNvidiaReadings(raw) {
   return raw.split('\n').flatMap(line=>{
-    const [id,temp,load,memory,power,limit,gen,maxGen,width]=line.split(',').map(s=>s.trim());
+    const [id,temp,load,memory,power,limit,gen,maxGen,width,fan,clock]=line.split(',').map(s=>s.trim());
     if (!id?.startsWith('GPU-')) return [];
     const t=number(temp),u=number(load),m=number(memory);
     const positive = v => { const n=number(v); return n!==null&&n>=0?n:null; };
-    return [{id,temperatureC:t!==null&&t>=0&&t<=150?t:null,utilizationPct:u!==null&&u>=0&&u<=100?u:null,memoryUsedGb:m!==null&&m>=0?round(m/1024,2):null,powerW:positive(power),powerLimitW:positive(limit),pcieGen:positive(gen),pcieGenMax:positive(maxGen),pcieWidth:positive(width),pcieRxMbs:null}];
+    return [{id,temperatureC:t!==null&&t>=0&&t<=150?t:null,utilizationPct:u!==null&&u>=0&&u<=100?u:null,memoryUsedGb:m!==null&&m>=0?round(m/1024,2):null,powerW:positive(power),powerLimitW:positive(limit),pcieGen:positive(gen),pcieGenMax:positive(maxGen),pcieWidth:positive(width),pcieRxMbs:null,fanPct:percentOf(fan),clockMhz:positive(clock)}];
   });
 }
 export function parsePcieThroughput(raw) {
@@ -59,6 +62,18 @@ export function parsePcieThroughput(raw) {
 }
 async function read(path) { try {return (await readFile(path,'utf8')).trim();} catch {return '';} }
 async function list(path) {try{return await readdir(path);}catch{return [];}}
+/** A server's remote-console chip (ASPEED), a virtual display or a framebuffer is not a graphics card: no maker we know and no memory of its own. */
+export function isComputeAdapter(vendor,vramBytes) { return vendor!=='unknown'||vramBytes>0; }
+/**
+ * The temperature of an amdgpu card from its hwmon inputs [{label, milli}]: the edge sensor (what nvtop and rocm-smi show), else the
+ * junction, else the first one that has a plausible value. Cards such as the Instinct line have no edge sensor. 0 is no reading.
+ */
+export function pickGpuTemperature(inputs) {
+  const ok=inputs.filter(i=>i.milli!==null&&i.milli>0&&i.milli<=150000);
+  const first=re=>ok.find(i=>re.test(i.label??''));
+  const chosen=first(/edge|^gpu/i)??ok.find(i=>!i.label)??first(/junction|hotspot/i)??ok.find(i=>!/mem/i.test(i.label??''));
+  return chosen?chosen.milli/1000:null;
+}
 export async function detectDrmGpus() {
   const result=[];
   for(const card of (await list('/sys/class/drm')).filter(n=>/^card\d+$/.test(n))) {
@@ -68,39 +83,44 @@ export async function detectDrmGpus() {
     const vendor={'0x1002':'amd','0x8086':'intel','0x10de':'nvidia'}[vendorId]??'unknown';
     const name=await probe('lspci',['-s',busId]);
     const bytes=number(await read(`${device}/mem_info_vram_total`));
+    if(!isComputeAdapter(vendor,bytes))continue;
     result.push({id:`drm:${busId}`,index:result.length,busId,vendor,name:name.replace(/^[^ ]+\s+[^:]+:\s*/,'')||`${vendor.toUpperCase()} GPU`,vramGb:bytes===null?0:round(bytes/1024**3,1),unified:vendor==='intel'&&!(bytes>0),backend:'vulkan',sensorPath:device});
   }
   return result;
 }
-export async function readGpuTelemetry(gpus) {
+/** `transfer: false` skips the PCIe throughput sample (a second nvidia-smi); it only means something while a model runs. */
+export async function readGpuTelemetry(gpus, { transfer: wantTransfer = true, run = probe } = {}) {
   const now=new Date().toISOString();
   const hasNvidia=gpus.some(g=>g.vendor==='nvidia');
-  let raw=hasNvidia?await probe('nvidia-smi',['--query-gpu=uuid,temperature.gpu,utilization.gpu,memory.used,power.draw,power.limit,pcie.link.gen.current,pcie.link.gen.max,pcie.link.width.current','--format=csv,noheader,nounits'],2000):'';
+  let raw=hasNvidia?await run('nvidia-smi',['--query-gpu=uuid,temperature.gpu,utilization.gpu,memory.used,power.draw,power.limit,pcie.link.gen.current,pcie.link.gen.max,pcie.link.width.current,fan.speed,clocks.current.graphics','--format=csv,noheader,nounits'],2000):'';
   // Older drivers can reject a field; retain their basic sensors in that case.
-  if(hasNvidia&&!raw)raw=await probe('nvidia-smi',['--query-gpu=uuid,temperature.gpu,utilization.gpu,memory.used','--format=csv,noheader,nounits'],2000);
+  if(hasNvidia&&!raw)raw=await run('nvidia-smi',['--query-gpu=uuid,temperature.gpu,utilization.gpu,memory.used','--format=csv,noheader,nounits'],2000);
   const nvidia=new Map(parseNvidiaReadings(raw).map(r=>[r.id,r]));
-  const transfer=hasNvidia?parsePcieThroughput(await probe('nvidia-smi',['dmon','-s','t','-c','1'],1500)):new Map();
+  const transfer=hasNvidia&&wantTransfer?parsePcieThroughput(await run('nvidia-smi',['dmon','-s','t','-c','1'],1500)):new Map();
   return Promise.all(gpus.map(async gpu=>{
     let reading=nvidia.get(gpu.id)??{id:gpu.id??`${gpu.vendor}:${gpu.index}`,temperatureC:null,utilizationPct:null,memoryUsedGb:null,powerW:null,powerLimitW:null,pcieGen:null,pcieGenMax:null,pcieWidth:null,pcieRxMbs:null};
     if(gpu.vendor==='nvidia')reading={...reading,pcieRxMbs:transfer.get(gpu.sensorIndex??gpu.index)??null};
+    if(gpu.luid&&!nvidia.has(gpu.id)) {
+      const counters=windowsGpuReading(gpu.luid);
+      if(counters)reading={...reading,utilizationPct:counters.utilizationPct,memoryUsedGb:round(counters.memoryUsedGb,2),temperatureC:counters.temperatureC??null};
+    }
     if(gpu.sensorPath&&!nvidia.has(gpu.id)) {
-      let temperature=null,power=null,powerLimit=null;
+      let temperature=null,power=null,powerLimit=null,fanPwm=null,clockHz=null;
       for(const hwmon of await list(`${gpu.sensorPath}/hwmon`)) {
         const folder=`${gpu.sensorPath}/hwmon/${hwmon}`,inputs=(await list(folder)).filter(n=>/^temp\d+_input$/.test(n));
         power ??= number(await read(`${folder}/power1_average`)) ?? number(await read(`${folder}/power1_input`));
         powerLimit ??= number(await read(`${folder}/power1_cap`));
-        for(const input of inputs) {
-          const label=await read(`${folder}/${input.replace('_input','_label')}`);
-          if(label&&!/edge|gpu/i.test(label))continue;
-          const milli=number(await read(`${folder}/${input}`));
-          if(milli!==null&&milli>=0&&milli<=150000){temperature=milli/1000;break;}
-        }
+        fanPwm ??= number(await read(`${folder}/pwm1`));          // 0-255, the fan's duty as the amdgpu driver reports it
+        clockHz ??= number(await read(`${folder}/freq1_input`));  // the graphics clock in Hz
+        const sensors=[];
+        for(const input of inputs)sensors.push({label:await read(`${folder}/${input.replace('_input','_label')}`),milli:number(await read(`${folder}/${input}`))});
+        temperature=pickGpuTemperature(sensors);
         if(temperature!==null)break;
       }
       const utilization=number(await read(`${gpu.sensorPath}/gpu_busy_percent`)),bytes=number(await read(`${gpu.sensorPath}/mem_info_vram_used`));
       const gen=path=>read(path).then(raw=>({2.5:1,5:2,8:3,16:4,32:5,64:6}[Number.parseFloat(raw)]??null));
       const [pcieGen,pcieGenMax,width]=await Promise.all([gen(`${gpu.sensorPath}/current_link_speed`),gen(`${gpu.sensorPath}/max_link_speed`),read(`${gpu.sensorPath}/current_link_width`)]);
-      reading={...reading,temperatureC:temperature,utilizationPct:utilization!==null&&utilization>=0&&utilization<=100?utilization:null,memoryUsedGb:bytes!==null&&bytes>=0?round(bytes/1024**3,2):null,powerW:power!==null&&power>=0?power/1e6:null,powerLimitW:powerLimit!==null&&powerLimit>=0?powerLimit/1e6:null,pcieGen,pcieGenMax,pcieWidth:number(width)};
+      reading={...reading,fanPct:fanPwm!==null&&fanPwm>=0&&fanPwm<=255?Math.round(fanPwm/255*100):null,clockMhz:clockHz!==null&&clockHz>0?Math.round(clockHz/1e6):null,temperatureC:temperature,utilizationPct:utilization!==null&&utilization>=0&&utilization<=100?utilization:null,memoryUsedGb:bytes!==null&&bytes>=0?round(bytes/1024**3,2):null,powerW:power!==null&&power>=0?power/1e6:null,powerLimitW:powerLimit!==null&&powerLimit>=0?powerLimit/1e6:null,pcieGen,pcieGenMax,pcieWidth:number(width)};
     }
     return {...reading,sampledAt:now,source:Object.entries(reading).some(([key,value])=>key!=='id'&&typeof value==='number')?'sensor':'none'};
   }));