aegis-desktop 1.0.13 → 1.0.15

package/renderer/avatar/hud.js

@@ -1,208 +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';
-
-/**
- * hud.js — the level HUD: XP bar, next unlock, and the honest held state.
- *
- * The HUD is a *renderer*: it draws a projection main handed it and derives
- * nothing. That is not a stylistic preference — §1.5 of the plan says a level is
- * written by main because "a renderer-held counter is a suggestion, not a fact",
- * so `hudModel` has no branch that turns XP into a level. It reads `level`,
- * `progress`, `tier` and `held` off the projection, and when there is no
- * projection it says exactly that:
- *
- *     known: false, percent: null, readout: "level unknown — …"
- *
- * The tempting alternative — treat a missing projection as `level 1, 0 XP` —
- * would be a fabricated number on a screen about the user's own progress, and on
- * a real install (main landed, level 12) it would be a lie, not a default. The
- * unknown state costs a line of text and cannot be wrong.
- *
- * The three honesty rules the tests hold it to:
- *
- *   1. **Unknown is not zero.** No projection ⇒ no percentage, no bar fill, and
- *      a readout that says so.
- *   2. **Held is labelled.** §1.4: a level never silently regresses while the
- *      user watches. When `projection.held` is set the HUD says
- *      `level held · reshuffling` and marks the bar, and the next-unlock line
- *      says it is waiting for the ledger to settle — because unlocks follow the
- *      *settled* level, and claiming a unlock the ledger does not support is the
- *      same class of lie as a level that ticks down unannounced.
- *   3. **Every number has a text twin.** The SVG is `aria-hidden`, so the
- *      readout below it must carry the whole state as a sentence.
- *
- * Pure (a model) plus one small DOM writer. No timers, no storage.
- */
-
-const pkg = typeof window !== 'undefined' && window.AegisAvatarParts
-  ? {
-      parts: window.AegisAvatarParts,
-      level: window.AegisAvatarLevel || null,
-    }
-  : typeof module !== 'undefined' && module.exports
-    ? {
-        parts: require('./parts.js'),
-        level: require('../../lib/avatar/level.js'),
-      }
-    : { parts: null, level: null };
-
-if (!pkg.parts) throw new Error('avatar/hud.js: avatar/parts.js must be loaded first');
-
-function num(v, fallback) {
-  return typeof v === 'number' && Number.isFinite(v) ? v : fallback;
-}
-
-/** `Headphones`, `Seasonal set · pack` — a paid cosmetic says so on the tin. */
-function unlockText(unlock) {
-  return unlock.unlocks
-    .map((u) => (u.paid ? `${u.label} · pack` : u.label))
-    .join(', ');
-}
-
-/**
- * Build the view model.
- *
- * @param {object} input
- * @param {object} [input.persona] validated persona (for the name)
- * @param {object} [input.projection] `xp.evaluate()` output, as main reports it
- * @param {object} [input.capabilities] `level.capabilities()` output, for the
- *   cosmetics gate (which packs the pane may offer)
- * @param {string} [input.expression] current expression id
- * @param {string} [input.expressionLabel] its human label
- * @param {string} [input.reason] why there is no projection, shown verbatim
- */
-function hudModel(input = {}) {
-  const persona = input.persona && typeof input.persona === 'object' ? input.persona : pkg.parts.defaultPersona();
-  const name = (persona.identity && persona.identity.name) || 'Aegis';
-  const projection = input.projection && typeof input.projection === 'object' ? input.projection : null;
-  const levelNo = projection ? num(projection.level, null) : null;
-  const known = levelNo !== null;
-
-  const expressionLabel = String(input.expressionLabel || input.expression || 'neutral');
-  const expressionNote = `expression: ${expressionLabel}`;
-
-  if (!known) {
-    const reason = String(input.reason || 'main has not published a level yet');
-    return {
-      known: false,
-      name,
-      level: null,
-      tier: null,
-      xpIntoLevel: null,
-      xpForNext: null,
-      percent: null,
-      held: false,
-      heldNote: '',
-      nextUnlock: null,
-      nextUnlockText: '',
-      unlockNote: '',
-      expression: input.expression || 'neutral',
-      expressionLabel,
-      readout: `${name} · level unknown — ${reason} · ${expressionNote}`,
-      ariaLive: 'polite',
-    };
-  }
-
-  const held = projection.held === true;
-  const settled = num(projection.settledLevel, levelNo);
-  const tier = projection.tier || call(() => pkg.level.tierFor(levelNo).name, null) || null;
-  const xpIntoLevel = num(projection.xpIntoLevel, null);
-  const xpForNext = num(projection.xpForNext, null);
-  // The bar shows the projection's own progress — never a number this file
-  // computed. Clamped only so a malformed projection cannot draw outside the
-  // track; the held case is labelled in the readout instead of fudged here.
-  const percent = Math.round(Math.min(1, Math.max(0, num(projection.progress, 0))) * 100);
-
-  // Unlocks follow the settled level, never the held one.
-  const unlockLevel = held ? settled : levelNo;
-  let next = null;
-  try {
-    next = pkg.level ? pkg.level.nextUnlock(unlockLevel) : null;
-  } catch {
-    next = null;
-  }
-  const nextUnlockText = next ? `next at level ${next.level}: ${unlockText(next)}` : 'every unlock is yours';
-
-  const parts = [];
-  parts.push(`${name} · level ${levelNo}`);
-  if (tier) parts.push(tier);
-  if (held) parts.push('level held · reshuffling');
-  if (!held && xpForNext !== null && xpIntoLevel !== null) {
-    parts.push(`${xpIntoLevel} / ${xpForNext} XP to level ${levelNo + 1}`);
-  }
-  parts.push(nextUnlockText);
-  parts.push(expressionNote);
-
-  return {
-    known: true,
-    name,
-    level: levelNo,
-    tier,
-    xpIntoLevel,
-    xpForNext,
-    percent,
-    held,
-    heldNote: held ? 'level held · reshuffling' : '',
-    nextUnlock: next,
-    nextUnlockText,
-    // The held state makes the unlock line provisional; say so where it is read.
-    unlockNote: held ? `held — applies after the ledger settles (level ${settled})` : '',
-    expression: input.expression || 'neutral',
-    expressionLabel,
-    readout: parts.join(' · '),
-    ariaLive: 'polite',
-    cosmetics: input.capabilities && Array.isArray(input.capabilities.cosmeticsUnlocked)
-      ? input.capabilities.cosmeticsUnlocked.slice()
-      : null,
-  };
-}
-
-function call(fn, fallback) {
-  try {
-    return fn();
-  } catch {
-    return fallback;
-  }
-}
-
-/** Write a model into DOM handles. Missing handles are skipped, never thrown on. */
-function renderHud(els, model) {
-  const e = els || {};
-  const set = (node, value) => {
-    if (node && typeof value === 'string') node.textContent = value;
-  };
-  const width = model.percent === null ? '' : `${model.percent}%`;
-  if (e.root) {
-    e.root.setAttribute('data-known', model.known ? 'true' : 'false');
-    e.root.setAttribute('data-held', model.held ? 'true' : 'false');
-  }
-  set(e.level, model.known ? `L${model.level}` : 'L—');
-  set(e.tier, model.tier || '—');
-  set(e.readout, model.readout);
-  set(e.nextUnlock, model.nextUnlockText);
-  set(e.unlockNote, model.unlockNote);
-  set(e.expression, model.expressionLabel);
-  if (e.fill) {
-    e.fill.style.width = width;
-    if (e.fill.setAttribute) e.fill.setAttribute('data-held', model.held ? 'true' : 'false');
-  }
-  if (e.bar) {
-    // The bar is decorative: its text twin is the readout, so it is hidden from
-    // assistive tech rather than announced twice with different words.
-    e.bar.setAttribute('aria-hidden', 'true');
-  }
-  if (e.heldBadge) {
-    e.heldBadge.textContent = model.heldNote;
-    e.heldBadge.hidden = !model.held;
-  }
-  return model;
-}
-
-const API = Object.freeze({ hudModel, renderHud, unlockText });
-
-if (typeof module !== 'undefined' && module.exports) module.exports = API;
-else if (typeof globalThis !== 'undefined') globalThis.AegisAvatarHud = API;
+"use strict";const pkg="undefined"!=typeof window&&window.AegisAvatarParts?{parts:window.AegisAvatarParts,level:window.AegisAvatarLevel||null}:"undefined"!=typeof module&&module.exports?{parts:require("./parts.js"),level:require("../../lib/avatar/level.js")}:{parts:null,level:null};if(!pkg.parts)throw new Error("avatar/hud.js: avatar/parts.js must be loaded first");function num(e,l){return"number"==typeof e&&Number.isFinite(e)?e:l}function unlockText(e){return e.unlocks.map((e=>e.paid?`${e.label} · pack`:e.label)).join(", ")}function hudModel(e={}){const l=e.persona&&"object"==typeof e.persona?e.persona:pkg.parts.defaultPersona(),t=l.identity&&l.identity.name||"Aegis",n=e.projection&&"object"==typeof e.projection?e.projection:null,o=n?num(n.level,null):null,r=null!==o,u=String(e.expressionLabel||e.expression||"neutral"),s=`expression: ${u}`;if(!r){const l=String(e.reason||"main has not published a level yet");return{known:!1,name:t,level:null,tier:null,xpIntoLevel:null,xpForNext:null,percent:null,held:!1,heldNote:"",nextUnlock:null,nextUnlockText:"",unlockNote:"",expression:e.expression||"neutral",expressionLabel:u,readout:`${t} · level unknown — ${l} · ${s}`,ariaLive:"polite"}}const i=!0===n.held,a=num(n.settledLevel,o),d=n.tier||call((()=>pkg.level.tierFor(o).name),null)||null,p=num(n.xpIntoLevel,null),c=num(n.xpForNext,null),h=Math.round(100*Math.min(1,Math.max(0,num(n.progress,0)))),x=i?a:o;let v=null;try{v=pkg.level?pkg.level.nextUnlock(x):null}catch{v=null}const f=v?`next at level ${v.level}: ${unlockText(v)}`:"every unlock is yours",k=[];return k.push(`${t} · level ${o}`),d&&k.push(d),i&&k.push("level held · reshuffling"),i||null===c||null===p||k.push(`${p} / ${c} XP to level ${o+1}`),k.push(f),k.push(s),{known:!0,name:t,level:o,tier:d,xpIntoLevel:p,xpForNext:c,percent:h,held:i,heldNote:i?"level held · reshuffling":"",nextUnlock:v,nextUnlockText:f,unlockNote:i?`held — applies after the ledger settles (level ${a})`:"",expression:e.expression||"neutral",expressionLabel:u,readout:k.join(" · "),ariaLive:"polite",cosmetics:e.capabilities&&Array.isArray(e.capabilities.cosmeticsUnlocked)?e.capabilities.cosmeticsUnlocked.slice():null}}function call(e,l){try{return e()}catch{return l}}function renderHud(e,l){const t=e||{},n=(e,l)=>{e&&"string"==typeof l&&(e.textContent=l)},o=null===l.percent?"":`${l.percent}%`;return t.root&&(t.root.setAttribute("data-known",l.known?"true":"false"),t.root.setAttribute("data-held",l.held?"true":"false")),n(t.level,l.known?`L${l.level}`:"L—"),n(t.tier,l.tier||"—"),n(t.readout,l.readout),n(t.nextUnlock,l.nextUnlockText),n(t.unlockNote,l.unlockNote),n(t.expression,l.expressionLabel),t.fill&&(t.fill.style.width=o,t.fill.setAttribute&&t.fill.setAttribute("data-held",l.held?"true":"false")),t.bar&&t.bar.setAttribute("aria-hidden","true"),t.heldBadge&&(t.heldBadge.textContent=l.heldNote,t.heldBadge.hidden=!l.held),l}const API=Object.freeze({hudModel:hudModel,renderHud:renderHud,unlockText:unlockText});"undefined"!=typeof module&&module.exports?module.exports=API:"undefined"!=typeof globalThis&&(globalThis.AegisAvatarHud=API);

package/renderer/avatar/machine.js

@@ -1,215 +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';
-
-/**
- * machine.js — the avatar's face, driven by the engine's real signals.
- *
- * The state machine itself is NOT re-implemented here. `lib/avatar/events.js`
- * is a pure module with no timers and no DOM, and index.html loads that same
- * file into the renderer (its UMD tail publishes `AegisAvatarEvents`), so the
- * face follows the *exact* table the engine's events are described by — not a
- * copy of it that can drift. What this file adds is the only thing the pure
- * module deliberately refuses to know: which real renderer event in this app
- * means which signal.
- *
- * The mapping is the interesting part, and it is one table, testable in
- * isolation:
- *
- *   send / setBusy(true)      → turn.start
- *   a streamed delta          → turn.stream
- *   setBusy(false)            → turn.end {green}
- *   a tool frame              → tool.read | tool.write | tool.run (by NAME)
- *   the approval card         → approval.card / approval.decided
- *   queue progress            → queue.progress
- *   connection state          → sync.error / sync.ok
- *   typing in the composer    → poke
- *
- * `signalForTool` is deliberately conservative: a tool this table has never
- * heard of (a new tool, a commissioned pack, an MCP server's verb) reads as
- * `tool.run` — "the agent is doing something" — rather than being mapped to
- * `reading`, which would understate what is happening on the user's machine.
- * Understating activity on the face of the thing doing it is the wrong way to
- * be wrong.
- *
- * Nothing here throws on an unknown signal: `events.js` made unknown signals
- * no-ops precisely so that tomorrow's feature cannot crash the avatar, and the
- * wrapper below preserves that.
- */
-
-'use strict';
-
-const pkg = typeof window !== 'undefined' && window.AegisAvatarEvents
-  ? { events: window.AegisAvatarEvents, parts: window.AegisAvatarParts || null }
-  : typeof module !== 'undefined' && module.exports
-    ? { events: require('../../lib/avatar/events.js'), parts: require('./parts.js') }
-    : { events: null, parts: null };
-
-if (!pkg.events) throw new Error('avatar/machine.js: lib/avatar/events.js must be loaded first');
-
-/** Tool names → the signal the face shows. Order matters: first match wins. */
-const TOOL_SIGNALS = Object.freeze([
-  Object.freeze({
-    signal: 'tool.write',
-    re: /^(write|edit|apply|patch|create|mkdir|append|save|delete|remove|move|rename|memorysave|memory_save)/i,
-  }),
-  Object.freeze({
-    signal: 'tool.read',
-    re: /^(read|open|list|ls|glob|grep|search|find|cat|stat|memorysearch|memory_search|memorylist|recall)/i,
-  }),
-  Object.freeze({
-    signal: 'tool.run',
-    re: /^(run|shell|bash|exec|spawn|test|build|npm|node|python|fetch|http|curl|websearch|browser)/i,
-  }),
-]);
-
-/** The tool name a frame is about, whichever shape the frame arrived in. */
-function toolName(tool) {
-  if (!tool) return '';
-  if (typeof tool === 'string') return tool;
-  return String(tool.name || tool.tool || tool.id || '');
-}
-
-/**
- * Which signal a tool call is worth. Unknown verbs are `tool.run` — see header.
- * A read frame is the ONLY thing that may say "reading".
- */
-function signalForTool(tool) {
-  const name = toolName(tool);
-  for (const row of TOOL_SIGNALS) if (row.re.test(name)) return row.signal;
-  return 'tool.run';
-}
-
-/**
- * Wrap the shared machine with the app's vocabulary.
- *
- * @param {object} [opts]
- * @param {object} [opts.machine] an `events.createMachine()` instance (tests inject one)
- * @param {number} [opts.idleTimeoutMs] silence before `dozing`
- * @param {function} [opts.onChange] called with `{ state, expression, label, signal }`
- */
-function createAvatarSignals(opts = {}) {
-  const machine = opts.machine || pkg.events.createMachine({
-    state: opts.state,
-    now: opts.now,
-    idleTimeoutMs: opts.idleTimeoutMs,
-  });
-  const listeners = new Set();
-  let lastSent = null;
-
-  function labelFor(expression) {
-    const table = pkg.parts && pkg.parts.EXPRESSIONS;
-    return (table && table[expression] && table[expression].label) || expression;
-  }
-
-  function announce(signal) {
-    const payload = {
-      state: machine.state,
-      expression: machine.expression,
-      label: labelFor(machine.expression),
-      signal: signal == null ? null : String(signal),
-    };
-    for (const fn of listeners) {
-      try {
-        fn(payload);
-      } catch {
-        // A listener that throws must not take the turn with it: app.js calls
-        // this from the chat delta path.
-      }
-    }
-    return payload;
-  }
-
-  function send(signal, meta) {
-    lastSent = String(signal);
-    machine.send(signal, meta);
-    return announce(signal);
-  }
-
-  const api = {
-    machine,
-    get state() {
-      return machine.state;
-    },
-    get expression() {
-      return machine.expression;
-    },
-    get label() {
-      return labelFor(machine.expression);
-    },
-    get lastSignal() {
-      return lastSent;
-    },
-    signal: send,
-    /** turn.start / turn.stream / turn.end — the chat path, in order. */
-    turnStart(meta) {
-      return send('turn.start', meta);
-    },
-    stream() {
-      return send('turn.stream');
-    },
-    turnEnd(meta) {
-      return send('turn.end', meta);
-    },
-    /** A tool frame: the signal is picked from the tool's name. */
-    tool(tool) {
-      return send(signalForTool(tool), { tool: toolName(tool) });
-    },
-    approvalCard() {
-      return send('approval.card');
-    },
-    approvalDecided() {
-      return send('approval.decided');
-    },
-    /** Queue progress frames; the machine treats them as activity. */
-    queue() {
-      return send('queue.progress');
-    },
-    syncOk() {
-      return send('sync.ok');
-    },
-    syncError(meta) {
-      return send('sync.error', meta);
-    },
-    poke() {
-      return send('poke');
-    },
-    celebrateDone() {
-      return send('celebrate.done');
-    },
-    reset() {
-      return send('reset');
-    },
-    /** The caller owns the clock — see events.js's "NO TIMERS INSIDE". */
-    tick(now) {
-      const out = machine.tick(now);
-      if (out.changed) announce('idle.timeout');
-      return out;
-    },
-    on(fn) {
-      listeners.add(fn);
-      return () => listeners.delete(fn);
-    },
-    off(fn) {
-      return listeners.delete(fn);
-    },
-  };
-  return api;
-}
-
-const API = Object.freeze({
-  createAvatarSignals,
-  signalForTool,
-  toolName,
-  TOOL_SIGNALS,
-  STATES: pkg.events.STATES,
-  SIGNALS: pkg.events.SIGNALS,
-  EXPRESSIONS: pkg.events.EXPRESSIONS,
-  expressionFor: pkg.events.expressionFor,
-});
-
-if (typeof module !== 'undefined' && module.exports) module.exports = API;
-else if (typeof globalThis !== 'undefined') globalThis.AegisAvatarMachine = API;
+"use strict";const pkg="undefined"!=typeof window&&window.AegisAvatarEvents?{events:window.AegisAvatarEvents,parts:window.AegisAvatarParts||null}:"undefined"!=typeof module&&module.exports?{events:require("../../lib/avatar/events.js"),parts:require("./parts.js")}:{events:null,parts:null};if(!pkg.events)throw new Error("avatar/machine.js: lib/avatar/events.js must be loaded first");const TOOL_SIGNALS=Object.freeze([Object.freeze({signal:"tool.write",re:/^(write|edit|apply|patch|create|mkdir|append|save|delete|remove|move|rename|memorysave|memory_save)/i}),Object.freeze({signal:"tool.read",re:/^(read|open|list|ls|glob|grep|search|find|cat|stat|memorysearch|memory_search|memorylist|recall)/i}),Object.freeze({signal:"tool.run",re:/^(run|shell|bash|exec|spawn|test|build|npm|node|python|fetch|http|curl|websearch|browser)/i})]);function toolName(e){return e?"string"==typeof e?e:String(e.name||e.tool||e.id||""):""}function signalForTool(e){const t=toolName(e);for(const e of TOOL_SIGNALS)if(e.re.test(t))return e.signal;return"tool.run"}function createAvatarSignals(e={}){const t=e.machine||pkg.events.createMachine({state:e.state,now:e.now,idleTimeoutMs:e.idleTimeoutMs}),r=new Set;let n=null;function o(e){const t=pkg.parts&&pkg.parts.EXPRESSIONS;return t&&t[e]&&t[e].label||e}function s(e){const n={state:t.state,expression:t.expression,label:o(t.expression),signal:null==e?null:String(e)};for(const e of r)try{e(n)}catch{}return n}function a(e,r){return n=String(e),t.send(e,r),s(e)}return{machine:t,get state(){return t.state},get expression(){return t.expression},get label(){return o(t.expression)},get lastSignal(){return n},signal:a,turnStart:e=>a("turn.start",e),stream:()=>a("turn.stream"),turnEnd:e=>a("turn.end",e),tool:e=>a(signalForTool(e),{tool:toolName(e)}),approvalCard:()=>a("approval.card"),approvalDecided:()=>a("approval.decided"),queue:()=>a("queue.progress"),syncOk:()=>a("sync.ok"),syncError:e=>a("sync.error",e),poke:()=>a("poke"),celebrateDone:()=>a("celebrate.done"),reset:()=>a("reset"),tick(e){const r=t.tick(e);return r.changed&&s("idle.timeout"),r},on:e=>(r.add(e),()=>r.delete(e)),off:e=>r.delete(e)}}const API=Object.freeze({createAvatarSignals:createAvatarSignals,signalForTool:signalForTool,toolName:toolName,TOOL_SIGNALS:TOOL_SIGNALS,STATES:pkg.events.STATES,SIGNALS:pkg.events.SIGNALS,EXPRESSIONS:pkg.events.EXPRESSIONS,expressionFor:pkg.events.expressionFor});"undefined"!=typeof module&&module.exports?module.exports=API:"undefined"!=typeof globalThis&&(globalThis.AegisAvatarMachine=API);