herm-tui 1.6.0-dev.12 → 1.6.0-dev.14

package/assets/skills/eikon/SKILL.md

@@ -1,83 +1,61 @@
 ---
 name: eikon
-description: Author a sidebar eikon avatar — produce/adopt a source image into ~/.hermes/eikons/<name>/, seed studio.json, then coach the user on the in-app Eikon tab controls. Filesystem is the API; no WIP files, no event polling.
+description: Guide the user through making or editing a herm sidebar avatar (eikon) using herm's built-in Eikon Studio tab. The agent's role is advisory (what makes a good source, which knob to reach for); source generation is /eikon-create and all rasterize/bake happens in-app.
+related_skills: [eikon-create]
 ---
 
-# Eikon — author a herm sidebar avatar
+# Building an eikon in herm
 
-## When this fires
+An eikon is a 48×24 monochrome text avatar. It lives on disk as:
 
-User asks for a new avatar, to "make an eikon", to turn an image into their sidebar avatar, or references `~/.hermes/eikons/`.
+    ~/.hermes/eikons/<name>/
+      <name>.eikon      packed NDJSON — written by Studio on Ctrl+S
+      studio.json       Studio's workspace state
+      source/           base.<ext>, <state>.<ext>
 
-## Folder contract
+You do **not** write `.eikon` or `studio.json`. Studio does.
 
+## Where the user does the work
+
+Herm's built-in **Eikon** tab (Studio / Gallery). Tell the user: "open
+the Eikon tab" or "Ctrl+K → Eikon". In Studio:
+
+- `eikon` row → pick / New…
+- `source` row → Local file… / Generate image… / Generate video…
+- `input` section → contrast / invert / flip (pixel-domain, shared)
+- `<rasterizer>` section → symbols / fill / dither (glyph-domain)
+- Preview pane → wheel pans, Ctrl+wheel zooms, Shift+wheel pans X
+- **Ctrl+S** bakes all six states and sets it active
+
+## What makes a good source
+
+One line, once: **48×24, one color. Light subject on black, high
+contrast, strong silhouette.** Fine detail disappears; outline is
+everything.
+
+## When to do what
+
+| user says | you do |
+|---|---|
+| "make me an eikon of X" | Load `eikon-create` and follow it. |
+| drops an image path | `cp` it to `~/.hermes/eikons/<name>/source/base.<ext>` → "Eikon tab, pick <name>". |
+| "edit my <name> eikon" | "Eikon tab → `eikon` row → <name>." |
+| "too dark / washed out" | "invert toggle, then contrast slider — under `input`." |
+| "off-center / too small" | "Ctrl+wheel to zoom, wheel/drag to pan on the preview." |
+| "make it move" | `eikon-create` §5 (video), or Studio's `source` → Generate video…. |
+
+## Quick poster
+
+To show a candidate in chat without Studio:
+
+```bash
+chafa --size=48x24 --symbols=braille --colors=none --format=symbols --stretch "<path>"
 ```
-~/.hermes/eikons/<name>/
-  <name>.eikon       packed NDJSON (48×24, 6 states)
-  studio.json        { rasterizer, spatial:{zoom,ox,oy}, base:{}, per:{}, glyph, sources:{} }
-  source/            base.png (or .jpg/.webp); optionally idle.png, error.png …
-```
 
-Herm's Eikon tab reads `studio.json` on open and re-renders from `source/`. Ctrl+S in the tab rewrites both files. The sidebar follows `eikon` (a bare name) in `~/.hermes/herm/tui.json`, resolved against `<profile>/eikons/` then bundled.
-
-## Steps
-
-1. **Get a source image.** User-supplied path → use as-is. Otherwise `image_generate` a square mono portrait (prompt should specify: high contrast, centered subject, plain background, 1:1). Save to a temp path.
-
-2. **Pick a name.** Slugify what the user asked for (`lowercase, [a-z0-9-]`). Default `custom` if unclear.
-
-3. **Adopt + seed.** One shell block:
-   ```bash
-   NAME=…; SRC=…
-   mkdir -p ~/.hermes/eikons/$NAME/source
-   cp "$SRC" ~/.hermes/eikons/$NAME/source/base.${SRC##*.}
-   cat > ~/.hermes/eikons/$NAME/studio.json <<EOF
-   {"rasterizer":"chafa","spatial":{"zoom":1,"ox":0.5,"oy":0.5},"base":{},"per":{},"glyph":"◆","sources":{"base":"base.${SRC##*.}"}}
-   EOF
-   ```
-
-4. **Seed a starter `.eikon`** so the tab and gallery have something to show before the user's first Ctrl+S. If `chafa` + `ffmpeg` are installed:
-   ```bash
-   ffmpeg -hide_banner -loglevel error -i ~/.hermes/eikons/$NAME/source/base.* \
-     -vf "crop=min(iw\,ih):min(iw\,ih),eq=contrast=1.0" -frames:v 1 -f image2pipe -vcodec png - \
-   | chafa --size=48x24 --format=symbols --stretch --symbols=braille --colors=none --invert --preprocess off - \
-   > /tmp/eikon-frame.txt
-   ```
-   Then write six copies as NDJSON:
-   ```bash
-   python3 - <<'PY'
-   import json,os
-   n=os.environ["NAME"]; f=open("/tmp/eikon-frame.txt").read().rstrip("\n")
-   rows=(f.split("\n")+[""]*24)[:24]; data="\n".join(r.ljust(48)[:48] for r in rows)
-   out=[json.dumps({"eikon":1,"name":n,"width":48,"height":24,"author":os.environ.get("USER","")})]
-   for s in ["idle","listening","thinking","speaking","working","error"]:
-     out+=[json.dumps({"state":s,"fps":12,"frame_count":1,"loop_from":1}),json.dumps({"f":0,"data":data})]
-   open(os.path.expanduser(f"~/.hermes/eikons/{n}/{n}.eikon"),"w").write("\n".join(out)+"\n")
-   PY
-   ```
-   If chafa/ffmpeg aren't installed, skip this step — the tab's `native` rasterizer will render on first open.
-
-5. **Point the sidebar at it** (optional — user can do this from Gallery):
-   ```bash
-   python3 -c "import json,os; p=os.path.expanduser('~/.hermes/herm/tui.json'); d=json.load(open(p)) if os.path.exists(p) else {}; d['eikon']='$NAME'; open(p,'w').write(json.dumps(d,indent=2))"
-   ```
-
-6. **Coach.** Tell the user:
-   > Wrote `<name>`. Open the **Eikon** tab (Alt+5 or type `/eikon`). Drag the preview to reframe, scroll to zoom. If it's too dark, nudge **contrast** up in the Knobs panel; if detail is mushy, try **symbols → block**. Tab cycles panes; ←→ on a knob row adjusts it. **Ctrl+S** saves and the sidebar updates.
-
-## Knob vocabulary (for coaching — chafa rasterizer)
-
-- `symbols`: braille · block · ascii · sextant · quad · half · wedge
-- `fill`: none · stipple · ascii · braille (gradient class, layers under symbols)
-- `dither`: none · ordered · diffusion · noise (diffusion = halftone grain)
-- `invert`: on/off (most photos want on against a dark terminal)
-- `flip`: none · h · v · hv
-- `contrast`: 0.5–3.0
-
-Spatial (preview pane, not knob rows): wheel zooms; zoom/pan x/pan y sliders below the frame.
-
-## Don't
-
-- Write a WIP file or poll for `tool.complete` — that flow is gone.
-- Write tonal knob values into `studio.json.base` beyond `{}` — user owns tuning.
-- Re-run the pipeline to "adjust contrast" for the user — tell them which knob to move.
+Preview-only; Studio's output will differ (it tone-maps first).
+
+## Don'ts
+
+- Don't hand-write `.eikon` NDJSON.
+- Don't pick knob values for the user. Name the knob.
+- Don't repeat the 48×24 brief.

package/assets/skills/eikon-create/SKILL.md

@@ -0,0 +1,151 @@
+---
+name: eikon-create
+description: Interactively generate source images (and optionally short videos) for a herm eikon avatar, iterate on them with the user, and land them under ~/.hermes/eikons/<name>/source/ so the Eikon Studio tab can tune and bake them. This is the agent-driven counterpart to Studio's one-shot Generate dialog.
+tags: [eikon, avatar, image-gen, herm]
+related_skills: [eikon]
+---
+
+# /eikon-create — generate eikon source files interactively
+
+You are producing **source files**, not the packed `.eikon`. Studio owns
+crop, tone (contrast/invert/flip), rasterizer choice, and baking. Your
+deliverable is one or more images/videos under
+
+    ~/.hermes/eikons/<name>/source/
+
+named so Studio resolves them: `base.*` for the default pose, `<state>.*`
+for per-state overrides (`idle listening thinking speaking working
+error`). Extensions: `png jpg jpeg webp gif bmp mp4 webm mov mkv`.
+
+## What survives rasterization
+
+Output is 48×24, one theme color, braille/block glyphs. The one-line
+brief (say once, don't repeat):
+
+> 48×24, one color. Best results: light subject on black background,
+> high contrast, strong silhouette.
+
+Outline carries everything — facial detail, fine texture, and tonal
+gradients mostly vanish.
+
+## What Studio fixes for you (don't regenerate for these)
+
+Studio adjusts these live on any source without a new generation:
+
+- **Aspect / framing** — Studio crops to a square window; zoom + pan
+  pick which square. A 16:9 or portrait source is fine.
+- **Contrast** — slider, mean-centered. Flat or over-bright sources
+  are usually salvageable.
+- **Invert** — light↔dark swap. A dark-subject-on-light source works
+  with invert off.
+- **Flip** — horizontal/vertical mirror.
+
+So: regenerate for **subject, pose, silhouette, background clutter**.
+Don't regenerate for **crop, exposure, polarity, orientation**.
+
+## Flow
+
+### 0. Name
+
+If the user passed an argument (`/eikon-create <name>`), slug it
+(lowercase, `[^a-z0-9-]` → `-`, collapse runs, trim). Otherwise ask
+once. Make the folder immediately so Studio's Open picker lists it:
+
+```bash
+n="<slug>"; mkdir -p "${HERMES_HOME:-$HOME/.hermes}/eikons/$n/source"
+```
+
+### 1. Subject
+
+Ask what the eikon is. One line is enough. If they drop an image
+instead of describing one, skip to §3 adopt-only.
+
+### 2. Generate base
+
+Call `image_generate` with the subject on line 1 and the fixed suffix
+on line 2 — same suffix Studio seeds:
+
+```
+<subject>
+high contrast, light subject on dark, black background
+```
+
+Prefer square if the tool takes `aspect_ratio`; if it doesn't, don't
+worry — Studio crops. Show the result inline with `![base](<path>)`
+and a 48-wide terminal preview:
+
+```bash
+chafa --size=48x24 --symbols=braille --colors=none --format=symbols --stretch "<path>" 2>/dev/null || true
+```
+
+Ask: **keep, regenerate, or adjust?** On adjust, fold their note into
+the subject line (leave the suffix alone). Loop. If two rounds fail on
+background clutter, silently append `, isolated on pure black, no
+floor, no environment` and try again.
+
+### 3. Adopt
+
+```bash
+src="<path-or-downloaded-tmp>"
+dst="${HERMES_HOME:-$HOME/.hermes}/eikons/$n/source/base.${src##*.}"
+cp "$src" "$dst" && ls -l "$dst"
+```
+
+URL return → `curl -fsSL -o /tmp/<n>-base.png "<url>"` first. Ambiguous
+extension → `.png`.
+
+### 4. Per-state sources (optional)
+
+Base covers all six states by default. If the user wants distinct
+ones, repeat §2–3 per state, saving as `<state>.<ext>`. Nudge the
+subject line with pose intent:
+
+| state | pose nudge |
+|---|---|
+| listening | head turned slightly toward viewer |
+| thinking | head tilted back, contemplative |
+| speaking | mouth open mid-word |
+| working | head bowed forward |
+| error | recoiling, startled |
+
+### 5. Video (optional, only if asked)
+
+Use `video_generate` if available. What matters for an eikon source:
+
+- **Duration** — 2–4 s is the useful range. Longer just inflates the
+  bake. If the provider picks duration itself, accept whatever lands.
+- **Aspect** — prefer 1:1 if the provider exposes it; otherwise any,
+  Studio crops.
+- **Resolution** — low is fine; the target is 48×24. Don't ask for
+  HD if the provider lets you pick.
+- **Start/end frame** — if the provider accepts a start (and/or end)
+  image, pass `base.*` so the clip anchors on the still pose and
+  loops cleanly. If it only takes text, that's fine — Studio plays
+  whatever frames it gets.
+- **Loop** — nice-to-have, not required. If the provider has a loop
+  or seamless flag, set it; if not, don't chase it with prompting.
+
+Providers vary in which of these knobs exist. **Pass what the tool
+accepts, skip what it doesn't, and don't apologize for the gaps.**
+None of them block a usable eikon.
+
+Adopt as `<state>.mp4` (or `base.mp4` for an animated idle).
+
+### 6. Hand off
+
+Once source files are in place:
+
+> Open the **Eikon** tab → `eikon` row → **<name>**. Tune zoom /
+> contrast / invert / symbols there, then **Ctrl+S** to bake.
+
+Stop there. Studio writes `<name>.eikon` and `studio.json`.
+
+## Don'ts
+
+- Don't write `.eikon` or `studio.json`.
+- Don't pick contrast, invert, zoom, or rasterizer values — name the
+  knob, the user turns it in Studio.
+- Don't regenerate for things Studio can fix (see table above).
+- Don't enumerate provider capabilities to the user; just use what's
+  there.
+- Don't repeat the 48×24 brief.

package/db.worker.js

@@ -35,7 +35,7 @@ var __create=Object.create;var{getPrototypeOf:__getProtoOf,defineProperty:__defP
        JOIN sessions s ON s.id = m.session_id
        WHERE messages_fts MATCH ?
        ORDER BY rank LIMIT ?`)?.all(m,limit*4)??[],seen=new Set;return raw.filter((r)=>!seen.has(r.session_id)&&(seen.add(r.session_id),!0)).slice(0,limit)}finally{end()}}function rename(sid,title){let db=new Database(conn.path);try{return db.run("UPDATE sessions SET title = ? WHERE id = ?",[title,sid]),db.query("SELECT changes() AS c").get().c>0}finally{db.close()}}function remove(sid){let db=new Database(conn.path);try{if(!db.query("SELECT 1 FROM sessions WHERE id = ?").get(sid))return!1;return db.run("UPDATE sessions SET parent_session_id = NULL WHERE parent_session_id = ?",[sid]),db.run("DELETE FROM messages WHERE session_id = ?",[sid]),db.run("DELETE FROM sessions WHERE id = ?",[sid]),!0}finally{db.close()}}var HERMES,SRC,conn,setHome=(h)=>{let next=`${h}/state.db`;if(conn.path===next)return;conn.path=SRC.file=next,resetDb()},stateDb=()=>{if(conn.ro)return conn.ro;try{return conn.ro=new Database(conn.path,{readwrite:!0,create:!1})}catch{return null}},resetDb=()=>{for(let s of stmts.values())s.finalize();stmts.clear(),conn.ro?.close(),conn.ro=null},stmts,q=(sql)=>{let db=stateDb();if(!db)return null;let s=stmts.get(sql);if(!s)stmts.set(sql,s=db.query(sql));return s},SUB=(c)=>`(p.ended_at IS NULL OR ${c}.started_at < p.ended_at)`,CONT=(c)=>`(p.end_reason = 'compression' AND ${c}.started_at >= p.ended_at)`,BR=(c)=>`(p.end_reason = 'branched'    AND ${c}.started_at >= p.ended_at)`,kind=(parent,child)=>{if(!parent)return"root";if(parent.ended_at==null||child.started_at<parent.ended_at)return"subagent";if(parent.end_reason==="compression")return"continuation";if(parent.end_reason==="branched")return"branch";return"subagent"},COLS=`
-  s.id, s.source, s.model, s.started_at, s.ended_at, s.end_reason,
+  s.id, s.source, s.model, s.billing_provider, s.started_at, s.ended_at, s.end_reason,
   s.message_count, s.tool_call_count,
   s.input_tokens, s.output_tokens,
   s.cache_read_tokens, s.cache_write_tokens, s.reasoning_tokens,
@@ -48,7 +48,7 @@ var __create=Object.create;var{getPrototypeOf:__getProtoOf,defineProperty:__defP
   (SELECT MAX(timestamp) FROM messages WHERE session_id = s.id) AS last_active,
   (SELECT COUNT(*) FROM sessions c
    WHERE c.parent_session_id = s.id
-     AND (s.ended_at IS NULL OR c.started_at < s.ended_at)) AS subagent_count`,toRow=(r,lineage=null)=>({source:SRC,id:r.id,sessionSource:r.source,model:r.model,started_at:r.started_at,ended_at:r.ended_at,end_reason:r.end_reason,message_count:r.message_count,tool_call_count:r.tool_call_count,input_tokens:r.input_tokens,output_tokens:r.output_tokens,cache_read_tokens:r.cache_read_tokens,cache_write_tokens:r.cache_write_tokens,reasoning_tokens:r.reasoning_tokens,estimated_cost_usd:r.estimated_cost_usd,title:r.title,lastMessage:r.lastMessage,last_active:r.last_active,parent_session_id:r.parent_session_id,subagent_count:r.subagent_count,lineage_root_id:lineage}),one=(id)=>q(`SELECT ${COLS} FROM sessions s WHERE s.id = ?`)?.get(id)??null,byId=(id)=>{let r=one(id);return r?toRow(r):null},lastReal=()=>{let hit=q(`
+     AND (s.ended_at IS NULL OR c.started_at < s.ended_at)) AS subagent_count`,toRow=(r,lineage=null)=>({source:SRC,id:r.id,sessionSource:r.source,model:r.model,billing_provider:r.billing_provider,started_at:r.started_at,ended_at:r.ended_at,end_reason:r.end_reason,message_count:r.message_count,tool_call_count:r.tool_call_count,input_tokens:r.input_tokens,output_tokens:r.output_tokens,cache_read_tokens:r.cache_read_tokens,cache_write_tokens:r.cache_write_tokens,reasoning_tokens:r.reasoning_tokens,estimated_cost_usd:r.estimated_cost_usd,title:r.title,lastMessage:r.lastMessage,last_active:r.last_active,parent_session_id:r.parent_session_id,subagent_count:r.subagent_count,lineage_root_id:lineage}),one=(id)=>q(`SELECT ${COLS} FROM sessions s WHERE s.id = ?`)?.get(id)??null,byId=(id)=>{let r=one(id);return r?toRow(r):null},lastReal=()=>{let hit=q(`
     SELECT s.id FROM sessions s
     LEFT JOIN sessions p ON p.id = s.parent_session_id
     WHERE s.source IN ('tui', 'cli') AND s.message_count > 0