aegis-desktop 1.0.13 → 1.0.15

package/renderer/companion.js

@@ -1,225 +1,3 @@
 // SPDX-License-Identifier: AGPL-3.0-or-later
 // Copyright (C) 2026 Niklas Borneklint — AEGIS Code (aegiscode) / Aegiscloud.
-// AEGIS Code (aegiscode) — source: https://github.com/aegisinfo/aegiscode-plugin
-// Conveying a modified copy, or running one as a network service, owes the
-// corresponding source under this licence (§5/§13) — see LICENSING.md.
-'use strict';
-
-/**
- * companion.js — the one greeting the app writes to you, once a day.
- *
- * WHAT THIS IS NOT. It is not a notification, a pop-up, a badge, or anything
- * that interrupts. It is one line in the sidebar that changes at most once per
- * local day and can be dismissed for that day. A "daily reminder" that steals
- * focus is a nag; the whole value here is that it is quiet enough to read.
- *
- * THE RULE THAT SHAPES EVERY MESSAGE: it may only say things this process
- * actually knows. There is no engagement metric in this file, no invented
- * streak, no "you usually work on Tuesdays". Every candidate message reads its
- * facts from the `facts` object the caller passes, and a message whose facts
- * are absent is not a candidate at all — it is never shown with a guess in the
- * blank. That is why `pickMessage` returns `{ kind, ... }` rather than a
- * pre-baked string: the copy is chosen by which facts exist, and each branch
- * says exactly which ones it used.
- *
- * Determinism matters for the daily behaviour: the same local day and the same
- * facts must select the same message, or a re-render (which happens on every
- * status read) would flip the suggestion while the user is looking at it. The
- * rotation between equally-valid tips is therefore seeded from the day key,
- * never from Math.random().
- *
- * Pure: no DOM, no Electron, no fs, no clock of its own — `now` is passed in.
- */
-
-/**
- * The local calendar day, as YYYY-MM-DD.
- *
- * Local, not UTC, on purpose: "a daily reminder" means the user's day. A UTC
- * key would roll the message over at 01:00 or 02:00 for most of Europe, which
- * is the middle of the evening for the people most likely to be running this.
- */
-function dayKey(now) {
-  const d = now instanceof Date ? now : new Date(now == null ? Date.now() : now);
-  if (Number.isNaN(d.getTime())) return '';
-  const p = (n) => String(n).padStart(2, '0');
-  return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())}`;
-}
-
-/** Whole local days between two timestamps; null when either is unusable. */
-function daysBetween(a, b) {
-  const t1 = a instanceof Date ? a.getTime() : Number(a);
-  const t2 = b instanceof Date ? b.getTime() : Number(b);
-  if (!Number.isFinite(t1) || !Number.isFinite(t2)) return null;
-  const d1 = new Date(t1); d1.setHours(0, 0, 0, 0);
-  const d2 = new Date(t2); d2.setHours(0, 0, 0, 0);
-  return Math.round((d2.getTime() - d1.getTime()) / 86400000);
-}
-
-/** Stable small hash, so tip rotation is deterministic per day. */
-function hash(s) {
-  let h = 2166136261;
-  const str = String(s);
-  for (let i = 0; i < str.length; i += 1) {
-    h ^= str.charCodeAt(i);
-    h = Math.imul(h, 16777619);
-  }
-  return h >>> 0;
-}
-
-/**
- * Tips that are TRUE OF THIS BUILD — each one names a real affordance. They are
- * the fallback rotation once nothing needs attention; none of them is a "come
- * back and use the app more" nudge, because that would be the app asking for
- * the user's time rather than giving them something back.
- */
-const TIPS = Object.freeze([
-  { id: 'effort', text: 'Effort sizes the call — low for quick edits, high when the answer has to be complete.' },
-  { id: 'tools', text: 'Turn on "confirm before running tools" in Tool approvals to see every command before it runs.' },
-  { id: 'quick', text: 'The Quick Launcher shortcut opens a prompt from anywhere — no need to switch windows.' },
-  { id: 'sessions', text: 'Sessions → Export writes the thread out as a file you keep, not something held in the app.' },
-  { id: 'queue', text: 'Queued tasks run on their own class — they can stay on Aegis Cloud while you work locally.' },
-  { id: 'memory', text: 'Memory entries are yours: the inspector shows the source and tags for every one.' },
-  { id: 'local', text: 'Local model needs no key and no network — useful for anything you would rather not send anywhere.' },
-]);
-
-/**
- * Choose today's message.
- *
- * `facts` (all optional; each one absent merely removes its branch):
- *   keyConfigured  {boolean} an AEGIS API key exists on this machine
- *   modelCount     {number}  how many models the current class listed
- *   lastTurnAt     {number}  epoch ms of the last finished turn, if any
- *   firstSeenAt    {number}  epoch ms this install first ran
- *   queuePending   {number}  unfinished queued tasks
- *   memoryCount    {number}  memory entries visible in the inspector
- *   providerNeedsKey {boolean} byok class has models but no provider key
- *   updatePending  {string}  version string of a downloaded update, if any
- *
- * Returns `{ id, kind, text, usedFacts }` — `kind` is 'action' when the message
- * points at something concrete to do and 'tip' when it is just the rotation.
- */
-function pickMessage(facts, now) {
-  const f = facts && typeof facts === 'object' ? facts : {};
-  const day = dayKey(now);
-  const used = [];
-  const pick = (id, kind, text, keys) => ({
-    id,
-    kind,
-    text,
-    day,
-    usedFacts: keys.filter((k) => f[k] !== undefined && f[k] !== null),
-  });
-
-  // 1. An update that is downloaded and waiting is the single most actionable
-  //    thing the app can know: it is finished work sitting idle until restart.
-  if (typeof f.updatePending === 'string' && f.updatePending) {
-    return pick(
-      'update-ready',
-      'action',
-      `Update ${f.updatePending} is downloaded — restart when it suits you, it installs on quit.`,
-      ['updatePending'],
-    );
-  }
-
-  // 2. No key at all: the app can barely do anything, and the remedy is one
-  //    paste. Not an error message — a reminder is allowed to be the first
-  //    place the user hears it, so it is phrased as an invitation.
-  if (f.keyConfigured === false) {
-    return pick(
-      'connect',
-      'action',
-      'Paste your AEGIS API key in Status to run turns on Aegis Cloud — or pick Local model below for no key at all.',
-      ['keyConfigured'],
-    );
-  }
-
-  // 3. A provider class chosen with models listed but no provider key: the user
-  //    has already walked to the door and has not opened it.
-  if (f.providerNeedsKey === true) {
-    return pick(
-      'provider-key',
-      'action',
-      'Your provider class has models listed but no key saved — add one in Provider settings to use them.',
-      ['providerNeedsKey'],
-    );
-  }
-
-  // 4. Queued work still waiting. Counted, never estimated: "3 queued" is a
-  //    fact, "your queue is busy" would be a guess about progress.
-  if (typeof f.queuePending === 'number' && f.queuePending > 0) {
-    return pick(
-      'queue',
-      'action',
-      `${f.queuePending} queued task${f.queuePending === 1 ? '' : 's'} still waiting — the queue card runs ${f.queuePending === 1 ? 'it' : 'them'} on its own class.`,
-      ['queuePending'],
-    );
-  }
-
-  // 4b. Memory this install already holds. Documented in the facts list from
-  //     the day this file was written, but with no branch behind it — so a user
-  //     with twenty saved entries was told nothing about them and got a generic
-  //     tip instead. Counted exactly, and it points at the inspector, which is
-  //     the only place in the app where the provenance of each entry is shown.
-  if (typeof f.memoryCount === 'number' && f.memoryCount > 0) {
-    return pick(
-      'memory-held',
-      'action',
-      `${f.memoryCount} memory entr${f.memoryCount === 1 ? 'y is' : 'ies are'} already saved here — the inspector shows the source and tags for every one.`,
-      ['memoryCount'],
-    );
-  }
-
-  // 5. First-run, no key required path: say what the app is, once. Only on the
-  //    FIRST local day, so it does not become a permanent fixture.
-  const age = daysBetween(f.firstSeenAt, now);
-  if (age === 0 && f.lastTurnAt == null) {
-    return pick(
-      'first-day',
-      'tip',
-      'First day. Pick a class and a model in the Model card, then send a turn — everything else here is optional.',
-      ['firstSeenAt', 'lastTurnAt'],
-    );
-  }
-
-  // 6. A gap after real use. Reported only when there is a genuine last turn,
-  //    and only past a threshold where the observation is worth stating; below
-  //    it, nothing is said at all (fall through to the rotation).
-  const since = daysBetween(f.lastTurnAt, now);
-  if (since != null && since >= 3) {
-    return pick(
-      'returning',
-      'tip',
-      'Last turn was a few days ago — your sessions and queued tasks are still here.',
-      ['lastTurnAt'],
-    );
-  }
-
-  // 7. Nothing needs attention: rotate one true tip, seeded by the day so it is
-  //    stable for the whole day and different tomorrow.
-  const tip = TIPS[hash(day) % TIPS.length];
-  return pick(`tip-${tip.id}`, 'tip', tip.text, ['tipRotation']);
-}
-
-/** True when this message was already dismissed today. */
-function dismissedToday(dismissed, now) {
-  const d = dismissed && typeof dismissed === 'object' ? dismissed : null;
-  if (!d) return false;
-  return d.day === dayKey(now);
-}
-
-if (typeof module !== 'undefined' && module.exports) {
-  module.exports = { pickMessage, dayKey, daysBetween, dismissedToday, TIPS };
-}
-
-// Also a page global, because index.html loads this file as a classic script
-// (`<script src="companion.js">`) and app.js reads window.aegisCompanion. The
-// module branch above is for Node (test/renderer-providers.test.mjs requires
-// the file directly); the two are mutually exclusive in practice — a classic
-// script has no `module` — so this cannot clobber the module export.
-if (typeof window !== 'undefined') {
-  (window.aegisCompanion = window.aegisCompanion || {}).pickMessage = pickMessage;
-  window.aegisCompanion.dayKey = dayKey;
-  window.aegisCompanion.daysBetween = daysBetween;
-  window.aegisCompanion.dismissedToday = dismissedToday;
-  window.aegisCompanion.TIPS = TIPS;
-}
+"use strict";function dayKey(e){const t=e instanceof Date?e:new Date(null==e?Date.now():e);if(Number.isNaN(t.getTime()))return"";const n=e=>String(e).padStart(2,"0");return`${t.getFullYear()}-${n(t.getMonth()+1)}-${n(t.getDate())}`}function daysBetween(e,t){const n=e instanceof Date?e.getTime():Number(e),o=t instanceof Date?t.getTime():Number(t);if(!Number.isFinite(n)||!Number.isFinite(o))return null;const s=new Date(n);s.setHours(0,0,0,0);const i=new Date(o);return i.setHours(0,0,0,0),Math.round((i.getTime()-s.getTime())/864e5)}function hash(e){let t=2166136261;const n=String(e);for(let e=0;e<n.length;e+=1)t^=n.charCodeAt(e),t=Math.imul(t,16777619);return t>>>0}const TIPS=Object.freeze([{id:"effort",text:"Effort sizes the call — low for quick edits, high when the answer has to be complete."},{id:"tools",text:'Turn on "confirm before running tools" in Tool approvals to see every command before it runs.'},{id:"quick",text:"The Quick Launcher shortcut opens a prompt from anywhere — no need to switch windows."},{id:"sessions",text:"Sessions → Export writes the thread out as a file you keep, not something held in the app."},{id:"queue",text:"Queued tasks run on their own class — they can stay on Aegis Cloud while you work locally."},{id:"memory",text:"Memory entries are yours: the inspector shows the source and tags for every one."},{id:"local",text:"Local model needs no key and no network — useful for anything you would rather not send anywhere."}]);function pickMessage(e,t){const n=e&&"object"==typeof e?e:{},o=dayKey(t),s=(e,t,s,i)=>({id:e,kind:t,text:s,day:o,usedFacts:i.filter((e=>void 0!==n[e]&&null!==n[e]))});if("string"==typeof n.updatePending&&n.updatePending)return s("update-ready","action",`Update ${n.updatePending} is downloaded — restart when it suits you, it installs on quit.`,["updatePending"]);if(!1===n.keyConfigured)return s("connect","action","Paste your AEGIS API key in Status to run turns on Aegis Cloud — or pick Local model below for no key at all.",["keyConfigured"]);if(!0===n.providerNeedsKey)return s("provider-key","action","Your provider class has models listed but no key saved — add one in Provider settings to use them.",["providerNeedsKey"]);if("number"==typeof n.queuePending&&n.queuePending>0)return s("queue","action",`${n.queuePending} queued task${1===n.queuePending?"":"s"} still waiting — the queue card runs ${1===n.queuePending?"it":"them"} on its own class.`,["queuePending"]);if("number"==typeof n.memoryCount&&n.memoryCount>0)return s("memory-held","action",`${n.memoryCount} memory entr${1===n.memoryCount?"y is":"ies are"} already saved here — the inspector shows the source and tags for every one.`,["memoryCount"]);if(0===daysBetween(n.firstSeenAt,t)&&null==n.lastTurnAt)return s("first-day","tip","First day. Pick a class and a model in the Model card, then send a turn — everything else here is optional.",["firstSeenAt","lastTurnAt"]);const i=daysBetween(n.lastTurnAt,t);if(null!=i&&i>=3)return s("returning","tip","Last turn was a few days ago — your sessions and queued tasks are still here.",["lastTurnAt"]);const r=TIPS[hash(o)%TIPS.length];return s(`tip-${r.id}`,"tip",r.text,["tipRotation"])}function dismissedToday(e,t){const n=e&&"object"==typeof e?e:null;return!!n&&n.day===dayKey(t)}"undefined"!=typeof module&&module.exports&&(module.exports={pickMessage:pickMessage,dayKey:dayKey,daysBetween:daysBetween,dismissedToday:dismissedToday,TIPS:TIPS}),"undefined"!=typeof window&&((window.aegisCompanion=window.aegisCompanion||{}).pickMessage=pickMessage,window.aegisCompanion.dayKey=dayKey,window.aegisCompanion.daysBetween=daysBetween,window.aegisCompanion.dismissedToday=dismissedToday,window.aegisCompanion.TIPS=TIPS);

package/renderer/diff.js

@@ -1,361 +1,3 @@
 // SPDX-License-Identifier: AGPL-3.0-or-later
 // Copyright (C) 2026 Niklas Borneklint — AEGIS Code (aegiscode) / Aegiscloud.
-// AEGIS Code (aegiscode) — source: https://github.com/aegisinfo/aegiscode-plugin
-// Conveying a modified copy, or running one as a network service, owes the
-// corresponding source under this licence (§5/§13) — see LICENSING.md.
-'use strict';
-
-/**
- * Line-level diff for the transcript's edit blocks.
- *
- * An `editFile`/`writeFile` call used to render as a single gray row
- * ("  ⎿  → editFile src/hello.js ✓"): you could see that a file changed and
- * never *what* changed — the one thing a coding session is actually about.
- * This module turns the tool call's arguments into a real unified-style diff,
- * which diffview.js paints as a collapsible colored block.
- *
- * Where the two sides come from:
- *   editFile  — args.old_string → args.new_string. No I/O at all.
- *   writeFile — the file as it was on disk *before* the call ran, against
- *               args.content. app.js builds the preview when the tool's
- *               `phase: 'run'` event arrives, which is strictly before the
- *               executor writes, so the read is the pre-edit state.
- *
- * Pure: strings in, plain row objects out — no spans, no colors, no globals —
- * so the whole thing is unit-testable with no TTY. The DOM painting lives in
- * diffview.js, exactly the split render.js already keeps between structure and
- * paint.
- *
- * Ported from `cli/src/diff.js`; the engine's tool names are
- * `Edit`/`Write`/`MultiEdit`, this host's are `editFile`/`writeFile`, so
- * `editPreview` accepts both spellings. `MultiEdit` has no counterpart here
- * and is kept only so a newer engine frame cannot silently render nothing.
- *
- * `fs`/`path` are Node-only and the renderer is sandboxed (main.js sets
- * contextIsolation:true, nodeIntegration:false, sandbox:true), so `require`
- * may not exist at all when this loads as a classic <script>. The require is
- * therefore guarded and the pre-edit read is injectable (`opts.readFile`):
- * without either a Node fs or an injected reader a `Write` degrades to a
- * create-style diff instead of throwing — a preview is decoration, and
- * decoration must never break a turn.
- */
-
-// Guarded so the same file loads both as a Node module (tests, CLI reuse) and
-// as a sandboxed classic script, where `require` is simply absent.
-let fs = null;
-let path = null;
-try {
-  if (typeof require === 'function') {
-    fs = require('node:fs');
-    path = require('node:path');
-  }
-} catch {
-  fs = null; // sandboxed renderer: fall back to an injected readFile
-  path = null;
-}
-
-// Budgets. The preview is built synchronously inside the tool event, on the
-// render path, so a 200 MB writeFile must not stall the window — the read is
-// capped and the LCS table is bounded so a pathological pair of long files
-// cannot allocate hundreds of megabytes. Past a budget the middle collapses to
-// "remove everything, add everything", which is honest about being incomplete
-// (`truncated: true` on the preview, `… N unchanged lines` in the block).
-const DIFF_LIMITS = {
-  fileBytes: 256 * 1024, // bytes read from disk for writeFile
-  lcsCells: 250000, // n*m cap for the LCS table (~1 MB of Int32)
-  rows: 400, // diff rows kept per preview
-  context: 3, // unchanged lines kept around each change
-};
-
-/**
- * Split text into display lines. A trailing newline is a terminator, not an
- * empty last line — otherwise every normal file diff ends in a phantom
- * "- " / "+ " pair. CRLF is normalized so a Windows checkout doesn't render as
- * "every line changed".
- */
-function splitLines(text) {
-  const s = String(text == null ? '' : text).replace(/\r\n?/g, '\n');
-  if (s === '') return [];
-  const lines = s.split('\n');
-  if (lines.length && lines[lines.length - 1] === '') lines.pop();
-  return lines;
-}
-
-/**
- * Unified-style diff of two strings.
- *
- * @returns {{rows: Array<{sign: string, text: string, no: number|null,
- *   marker?: boolean, note?: string}>, adds: number, dels: number,
- *   truncated: boolean}} `rows` carries context rows around each change run
- *   (DIFF_LIMITS.context lines), collapsed runs of unchanged lines as `marker`
- *   rows, and every changed line with a `no` for the gutter (old number on
- *   '-', new number otherwise).
- */
-function lineDiff(oldText, newText) {
-  const a = splitLines(oldText);
-  const b = splitLines(newText);
-  let pre = 0;
-  while (pre < a.length && pre < b.length && a[pre] === b[pre]) pre++;
-  let post = 0;
-  while (post < a.length - pre && post < b.length - pre && a[a.length - 1 - post] === b[b.length - 1 - post]) post++;
-
-  const midA = a.slice(pre, a.length - post);
-  const midB = b.slice(pre, b.length - post);
-  const ops = lcsOps(midA, midB);
-  const truncated = ops === null;
-  // Nothing changed: say so with no rows at all. The prefix/suffix trim ate the
-  // whole file (pre === a.length, post === 0), so the context arithmetic below
-  // would otherwise paint "… N unchanged lines" plus three orphans over an
-  // identical pair — a marker claiming an omission that never happened. This
-  // guard is what keeps `lineDiff(x, x)` from rendering as a fake edit.
-
-  const body = ops || [
-    ...midA.map((text) => ({ sign: '-', text })),
-    ...midB.map((text) => ({ sign: '+', text })),
-  ];
-  if (!body.some((op) => op.sign !== ' ')) return { rows: [], adds: 0, dels: 0, truncated };
-
-  const ctx = DIFF_LIMITS.context;
-
-  const rows = [];
-  let oldNo = 1;
-  let newNo = 1;
-  // Leading context: keep *all* of it when it fits, otherwise the last `ctx`
-  // lines plus a marker for the ones actually dropped. The engine's original
-  // condition (`ctxBeforeStart < pre`) fires whenever the change is preceded by
-  // any line at all, so an ordinary three-line edit grew a bogus
-  // "… 1 unchanged line" marker and a change deep in a file reported `ctx` as
-  // the number hidden rather than the real count. A marker means "something was
-  // omitted", so it may only appear when something was.
-  const leadStart = pre > ctx ? pre - ctx : 0;
-  const hiddenLead = leadStart;
-  if (hiddenLead > 0) {
-    rows.push({ sign: ' ', text: '', marker: true, note: `… ${hiddenLead} unchanged line${hiddenLead === 1 ? '' : 's'}` });
-  }
-  for (let i = leadStart; i < pre; i++) {
-    rows.push({ sign: ' ', text: a[i], no: newNo });
-    newNo++;
-    oldNo++;
-  }
-  for (const op of body) {
-    if (op.sign === ' ') {
-      rows.push({ sign: ' ', text: op.text, no: newNo });
-      newNo++;
-      oldNo++;
-    } else if (op.sign === '-') {
-      rows.push({ sign: '-', text: op.text, no: oldNo });
-      oldNo++;
-    } else {
-      rows.push({ sign: '+', text: op.text, no: newNo });
-      newNo++;
-    }
-  }
-  // Suffix context: the first `ctx` lines of the untouched tail, then a marker
-  // for whatever unchanged tail is left over. Both the index into `b` and the
-  // gutter number come from `b`'s tail, not `a`'s: the engine read
-  // `b[a.length - post + i]`, which is the wrong line — and the wrong numbering
-  // — for every edit that changes the line count.
-  const tailStart = b.length - post;
-  const tailCount = Math.min(post, ctx);
-  newNo = tailStart + 1;
-  for (let i = 0; i < tailCount; i++) {
-    rows.push({ sign: ' ', text: b[tailStart + i], no: newNo });
-    newNo++;
-    oldNo++;
-  }
-  if (post > ctx) {
-    const n = post - ctx;
-    rows.push({ sign: ' ', text: '', marker: true, note: `… ${n} unchanged line${n === 1 ? '' : 's'}` });
-  }
-
-  const adds = rows.filter((r) => r.sign === '+').length;
-  const dels = rows.filter((r) => r.sign === '-').length;
-  let out = rows;
-  let cut = false;
-  if (out.length > DIFF_LIMITS.rows) {
-    out = out.slice(0, DIFF_LIMITS.rows);
-    out.push({ sign: ' ', text: '', marker: true, note: `… ${rows.length - DIFF_LIMITS.rows} more diff lines` });
-    cut = true;
-  }
-  return { rows: out, adds, dels, truncated: truncated || cut };
-}
-
-/**
- * Longest-common-subsequence walk over two line arrays.
- * @returns {Array<{sign: string, text: string}>|null} ops, or null when the
- *   table would exceed DIFF_LIMITS.lcsCells (the caller then treats the middle
- *   as a full replacement).
- */
-function lcsOps(a, b) {
-  const n = a.length;
-  const m = b.length;
-  if (!n || !m) {
-    return [
-      ...a.map((text) => ({ sign: '-', text })),
-      ...b.map((text) => ({ sign: '+', text })),
-    ];
-  }
-  if (n * m > DIFF_LIMITS.lcsCells) return null;
-  const w = m + 1;
-  const dp = new Int32Array((n + 1) * w); // dp[i*w+j] = |LCS(a[i:], b[j:])|
-  for (let i = n - 1; i >= 0; i--) {
-    for (let j = m - 1; j >= 0; j--) {
-      dp[i * w + j] = a[i] === b[j]
-        ? dp[(i + 1) * w + (j + 1)] + 1
-        : Math.max(dp[(i + 1) * w + j], dp[i * w + (j + 1)]);
-    }
-  }
-  const ops = [];
-  let i = 0;
-  let j = 0;
-  while (i < n && j < m) {
-    if (a[i] === b[j]) { ops.push({ sign: ' ', text: a[i] }); i++; j++; }
-    else if (dp[(i + 1) * w + j] >= dp[i * w + (j + 1)]) { ops.push({ sign: '-', text: a[i] }); i++; }
-    else { ops.push({ sign: '+', text: b[j] }); j++; }
-  }
-  while (i < n) ops.push({ sign: '-', text: a[i++] });
-  while (j < m) ops.push({ sign: '+', text: b[j++] });
-  return ops;
-}
-
-/** Capped read for the pre-edit state. Never throws; missing/unreadable → null. */
-function readCapped(file, opts = {}) {
-  // No Node fs (sandboxed renderer) → report missing so a Write degrades to a
-  // create-style diff rather than throwing on the render path.
-  if (!fs) return { text: null, missing: true };
-  const bytes = opts.bytes == null ? DIFF_LIMITS.fileBytes : opts.bytes;
-  try {
-    const st = fs.statSync(file);
-    if (!st.isFile()) return { text: null, missing: true };
-    const text = fs.readFileSync(file, 'utf8');
-    if (st.size > bytes) return { text: text.slice(0, bytes), missing: false, truncated: true };
-    return { text, missing: false };
-  } catch {
-    return { text: null, missing: true };
-  }
-}
-
-/** Path as the user thinks of it: relative to the session cwd when it is inside it. */
-function shortPath(file, cwd) {
-  const f = String(file || '');
-  if (!cwd || !path) return f; // no node:path in the sandbox → show the raw path
-  const rel = path.relative(cwd, f);
-  if (rel && !rel.startsWith('..') && !path.isAbsolute(rel)) return rel;
-  const parts = f.split(path.sep).filter(Boolean);
-  const base = f.startsWith(path.sep) ? path.sep : '';
-  return parts.length > 2 ? base + '…' + path.sep + parts.slice(-2).join(path.sep) : f;
-}
-
-/**
- * Build the diff preview for a tool call, or null when the call isn't an edit
- * or its arguments don't carry enough to diff (a partial stream, a malformed
- * call). Never throws — a preview is decoration, not the tool result, so a bad
- * argument object must not be able to break a turn.
- *
- * @param {string} name Tool name — this host's `editFile`/`writeFile`, or the
- *   engine's `Edit`/`Write`/`MultiEdit` (a vendored frame can carry either).
- * @param {object|string} args Tool arguments as parsed from the stream.
- * @param {{cwd?: string, readFile?: Function}} [opts] `readFile` is injectable
- *   so tests never touch disk and the sandboxed renderer can inject a bridge.
- */
-function editPreview(name, args, opts = {}) {
-  try {
-    const cwd = opts.cwd == null ? (typeof process !== 'undefined' ? process.cwd() : '') : opts.cwd;
-    const readFile = opts.readFile || readCapped;
-    if (!args || typeof args !== 'object') return null;
-    const file = typeof args.file_path === 'string' ? args.file_path
-      : typeof args.path === 'string' ? args.path : null;
-    if (!file) return null;
-    const base = { file, short: shortPath(file, cwd) };
-
-    if (name === 'Edit' || name === 'editFile') {
-      if (typeof args.old_string !== 'string' || typeof args.new_string !== 'string') return null;
-      return Object.assign(
-        { kind: 'Update' },
-        base,
-        lineDiff(args.old_string, args.new_string),
-        { replaceAll: !!args.replace_all },
-      );
-    }
-
-    if (name === 'Write' || name === 'writeFile') {
-      if (typeof args.content !== 'string') return null;
-      const prev = readFile(file) || { text: null, missing: true };
-      const d = lineDiff(prev.text == null ? '' : prev.text, args.content);
-      return Object.assign(
-        { kind: prev.missing ? 'Create' : 'Write' },
-        base,
-        d,
-        { truncated: d.truncated || !!prev.truncated },
-      );
-    }
-
-    if (name === 'MultiEdit') {
-      const edits = (Array.isArray(args.edits) ? args.edits : []).filter(
-        (e) => e && typeof e.old_string === 'string' && typeof e.new_string === 'string',
-      );
-      if (!edits.length) return null;
-      const prev = readFile(file) || { text: null, missing: true };
-      if (typeof prev.text === 'string') {
-        let cur = prev.text;
-        let misses = 0;
-        for (const e of edits) {
-          if (cur.indexOf(e.old_string) === -1) { misses++; continue; }
-          cur = e.replace_all
-            ? cur.split(e.old_string).join(e.new_string)
-            : cur.replace(e.old_string, e.new_string);
-        }
-        const d = lineDiff(prev.text, cur);
-        return Object.assign(
-          { kind: 'Update' },
-          base,
-          d,
-          { misses, replaceAll: edits.some((e) => e.replace_all) },
-        );
-      }
-      // No base on disk: stack each edit's own diff rather than inventing one.
-      let rows = [];
-      let adds = 0;
-      let dels = 0;
-      let truncated = false;
-      edits.forEach((e, i) => {
-        const d = lineDiff(e.old_string, e.new_string);
-        if (i) rows.push({ sign: ' ', text: '', marker: true, note: `… edit ${i + 1} of ${edits.length}` });
-        rows = rows.concat(d.rows);
-        adds += d.adds;
-        dels += d.dels;
-        truncated = truncated || d.truncated;
-      });
-      return Object.assign(
-        { kind: 'Update' },
-        base,
-        { rows, adds, dels, truncated, stacked: edits.length },
-      );
-    }
-
-    return null;
-  } catch {
-    return null; // decoration must never break a turn
-  }
-}
-
-/** Human count line in the reference's wording: "Added 3 lines, removed 1 line". */
-function changeSummary(preview) {
-  const parts = [];
-  if (preview.adds) parts.push(`Added ${preview.adds} line${preview.adds === 1 ? '' : 's'}`);
-  if (preview.dels) parts.push(`removed ${preview.dels} line${preview.dels === 1 ? '' : 's'}`);
-  return parts.length ? parts.join(', ') : 'no line changes';
-}
-
-if (typeof module !== 'undefined' && module.exports) {
-  module.exports = {
-    DIFF_LIMITS,
-    splitLines,
-    lineDiff,
-    lcsOps,
-    readCapped,
-    shortPath,
-    changeSummary,
-    editPreview,
-  };
-}
+"use strict";let fs=null,path=null;try{"function"==typeof require&&(fs=require("node:fs"),path=require("node:path"))}catch{fs=null,path=null}const DIFF_LIMITS={fileBytes:262144,lcsCells:25e4,rows:400,context:3};function splitLines(t){const e=String(null==t?"":t).replace(/\r\n?/g,"\n");if(""===e)return[];const n=e.split("\n");return n.length&&""===n[n.length-1]&&n.pop(),n}function lineDiff(t,e){const n=splitLines(t),s=splitLines(e);let i=0;for(;i<n.length&&i<s.length&&n[i]===s[i];)i++;let l=0;for(;l<n.length-i&&l<s.length-i&&n[n.length-1-l]===s[s.length-1-l];)l++;const r=n.slice(i,n.length-l),o=s.slice(i,s.length-l),a=lcsOps(r,o),c=null===a,u=a||[...r.map((t=>({sign:"-",text:t}))),...o.map((t=>({sign:"+",text:t})))];if(!u.some((t=>" "!==t.sign)))return{rows:[],adds:0,dels:0,truncated:c};const p=DIFF_LIMITS.context,f=[];let g=1,d=1;const h=i>p?i-p:0,x=h;x>0&&f.push({sign:" ",text:"",marker:!0,note:`… ${x} unchanged line${1===x?"":"s"}`});for(let t=h;t<i;t++)f.push({sign:" ",text:n[t],no:d}),d++,g++;for(const t of u)" "===t.sign?(f.push({sign:" ",text:t.text,no:d}),d++,g++):"-"===t.sign?(f.push({sign:"-",text:t.text,no:g}),g++):(f.push({sign:"+",text:t.text,no:d}),d++);const m=s.length-l,I=Math.min(l,p);d=m+1;for(let t=0;t<I;t++)f.push({sign:" ",text:s[m+t],no:d}),d++,g++;if(l>p){const t=l-p;f.push({sign:" ",text:"",marker:!0,note:`… ${t} unchanged line${1===t?"":"s"}`})}const y=f.filter((t=>"+"===t.sign)).length,_=f.filter((t=>"-"===t.sign)).length;let F=f,w=!1;return F.length>DIFF_LIMITS.rows&&(F=F.slice(0,DIFF_LIMITS.rows),F.push({sign:" ",text:"",marker:!0,note:`… ${f.length-DIFF_LIMITS.rows} more diff lines`}),w=!0),{rows:F,adds:y,dels:_,truncated:c||w}}function lcsOps(t,e){const n=t.length,s=e.length;if(!n||!s)return[...t.map((t=>({sign:"-",text:t}))),...e.map((t=>({sign:"+",text:t})))];if(n*s>DIFF_LIMITS.lcsCells)return null;const i=s+1,l=new Int32Array((n+1)*i);for(let r=n-1;r>=0;r--)for(let n=s-1;n>=0;n--)l[r*i+n]=t[r]===e[n]?l[(r+1)*i+(n+1)]+1:Math.max(l[(r+1)*i+n],l[r*i+(n+1)]);const r=[];let o=0,a=0;for(;o<n&&a<s;)t[o]===e[a]?(r.push({sign:" ",text:t[o]}),o++,a++):l[(o+1)*i+a]>=l[o*i+(a+1)]?(r.push({sign:"-",text:t[o]}),o++):(r.push({sign:"+",text:e[a]}),a++);for(;o<n;)r.push({sign:"-",text:t[o++]});for(;a<s;)r.push({sign:"+",text:e[a++]});return r}function readCapped(t,e={}){if(!fs)return{text:null,missing:!0};const n=null==e.bytes?DIFF_LIMITS.fileBytes:e.bytes;try{const e=fs.statSync(t);if(!e.isFile())return{text:null,missing:!0};const s=fs.readFileSync(t,"utf8");return e.size>n?{text:s.slice(0,n),missing:!1,truncated:!0}:{text:s,missing:!1}}catch{return{text:null,missing:!0}}}function shortPath(t,e){const n=String(t||"");if(!e||!path)return n;const s=path.relative(e,n);if(s&&!s.startsWith("..")&&!path.isAbsolute(s))return s;const i=n.split(path.sep).filter(Boolean),l=n.startsWith(path.sep)?path.sep:"";return i.length>2?l+"…"+path.sep+i.slice(-2).join(path.sep):n}function editPreview(t,e,n={}){try{const s=null==n.cwd?"undefined"!=typeof process?process.cwd():"":n.cwd,i=n.readFile||readCapped;if(!e||"object"!=typeof e)return null;const l="string"==typeof e.file_path?e.file_path:"string"==typeof e.path?e.path:null;if(!l)return null;const r={file:l,short:shortPath(l,s)};if("Edit"===t||"editFile"===t)return"string"!=typeof e.old_string||"string"!=typeof e.new_string?null:Object.assign({kind:"Update"},r,lineDiff(e.old_string,e.new_string),{replaceAll:!!e.replace_all});if("Write"===t||"writeFile"===t){if("string"!=typeof e.content)return null;const t=i(l)||{text:null,missing:!0},n=lineDiff(null==t.text?"":t.text,e.content);return Object.assign({kind:t.missing?"Create":"Write"},r,n,{truncated:n.truncated||!!t.truncated})}if("MultiEdit"===t){const t=(Array.isArray(e.edits)?e.edits:[]).filter((t=>t&&"string"==typeof t.old_string&&"string"==typeof t.new_string));if(!t.length)return null;const n=i(l)||{text:null,missing:!0};if("string"==typeof n.text){let e=n.text,s=0;for(const n of t)-1!==e.indexOf(n.old_string)?e=n.replace_all?e.split(n.old_string).join(n.new_string):e.replace(n.old_string,n.new_string):s++;const i=lineDiff(n.text,e);return Object.assign({kind:"Update"},r,i,{misses:s,replaceAll:t.some((t=>t.replace_all))})}let s=[],o=0,a=0,c=!1;return t.forEach(((e,n)=>{const i=lineDiff(e.old_string,e.new_string);n&&s.push({sign:" ",text:"",marker:!0,note:`… edit ${n+1} of ${t.length}`}),s=s.concat(i.rows),o+=i.adds,a+=i.dels,c=c||i.truncated})),Object.assign({kind:"Update"},r,{rows:s,adds:o,dels:a,truncated:c,stacked:t.length})}return null}catch{return null}}function changeSummary(t){const e=[];return t.adds&&e.push(`Added ${t.adds} line${1===t.adds?"":"s"}`),t.dels&&e.push(`removed ${t.dels} line${1===t.dels?"":"s"}`),e.length?e.join(", "):"no line changes"}"undefined"!=typeof module&&module.exports&&(module.exports={DIFF_LIMITS:DIFF_LIMITS,splitLines:splitLines,lineDiff:lineDiff,lcsOps:lcsOps,readCapped:readCapped,shortPath:shortPath,changeSummary:changeSummary,editPreview:editPreview});