herm-tui 1.9.0-dev.9 → 1.9.0

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

@@ -1,7 +1,7 @@
 ---
 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]
+description: Use when generating or adopting source images/videos for a Herm eikon so Eikon Studio can tune, bake, and optionally share it.
+tags: [eikon, avatar, image-gen, video-gen, herm]
 related_skills: [eikon]
 ---
 
@@ -9,47 +9,52 @@ related_skills: [eikon]
 
 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
+deliverable is one or more images/videos under the active Hermes profile:
 
     ~/.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`.
+Studio resolves `base.*` for the default source and `<state>.*` for
+per-state overrides (`idle listening thinking speaking working error`).
+Direct `source/` discovery supports `png jpg jpeg webp gif bmp mp4 webm mov
+mkv`; Studio's Local file picker currently accepts `png jpg jpeg webp gif mp4
+webm mov`, so copy `bmp`/`mkv` into `source/` manually if needed.
+
+Studio bakes with **Ctrl+S** without activation; **Ctrl+U** bakes and uses the
+eikon as the active avatar.
 
 ## What survives rasterization
 
-Output is 48×24, one theme color, braille/block glyphs. The one-line
-brief (say once, don't repeat):
+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.
+> 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.
+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.
+- **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**.
+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:
+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 picker lists it:
 
 ```bash
 n="<slug>"; mkdir -p "${HERMES_HOME:-$HOME/.hermes}/eikons/$n/source"
@@ -57,52 +62,67 @@ 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.
+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:
+Call `image_generate` with the subject on line 1 and Studio's fixed style hint
+on line 2:
 
-```
+```text
 <subject>, close-up portrait emphasizing the face/head, looking slightly left, stark black and white, bold silhouette, simple uncluttered shape
 high contrast, light subject on dark, black background
 ```
 
-Keep this general: replace `face/head` with the subject's most readable
-feature if it is not a character or creature. 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:
+Keep this general: replace `face/head` with the subject's most readable feature
+if it is not a character or creature. Prefer `aspect_ratio="square"` if the
+tool takes it; if it doesn't, don't worry — Studio crops.
+
+After every candidate, adopt it into `source/base.<ext>` before handoff or
+iteration. 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. **Always overwrite the
-same `<state>.<ext>` in `source/` on every iteration** — Studio reads
-that path live, so a new candidate that lives only in cache is invisible
-to the user. If two rounds fail on background clutter, silently append
-`, isolated on pure black, no floor, no environment` and try again.
+Ask: **keep, regenerate, or adjust?** On adjust, fold their note into the
+subject line and leave the style hint alone. If two rounds fail on background
+clutter, silently append `, isolated on pure black, no floor, no environment`
+and try again.
+
+Overwrite the same role file (`base.<ext>` for the default source,
+`<state>.<ext>` for overrides) so candidates do not drift across filenames. If
+Studio is already open after an external write, tell the user to press reload
+(`r`) or reopen the eikon; dirty drafts must be saved or reverted before reload.
+A candidate left only in temp/cache or in an unselected filename is invisible.
 
 ### 3. Adopt
 
+Use this for generated files, downloaded URLs, or a user-supplied local path.
+Set `role=<state>` for per-state overrides; default is `base`.
+
 ```bash
+role="${role:-base}"
 src="<path-or-downloaded-tmp>"
-dst="${HERMES_HOME:-$HOME/.hermes}/eikons/$n/source/base.${src##*.}"
+base="${src##*/}"
+ext="${base##*.}"
+[ "$ext" = "$base" ] && ext="png"
+ext=".${ext,,}"
+case "$ext" in .png|.jpg|.jpeg|.webp|.gif|.bmp|.mp4|.webm|.mov|.mkv) ;; *) ext=".png" ;; esac
+dst="${HERMES_HOME:-$HOME/.hermes}/eikons/$n/source/$role$ext"
 cp "$src" "$dst" && ls -l "$dst"
 ```
 
-URL return → `curl -fsSL -o /tmp/<n>-base.png "<url>"` first. Ambiguous
-extension → `.png`.
+URL return → download to `/tmp/<n>-<role>.<ext>` first, preserving the media
+extension when known. Ambiguous image URL → `.png`; ambiguous video URL → `.mp4`.
 
 ### 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:
+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 |
 |---|---|
@@ -114,24 +134,39 @@ subject line with pose intent:
 
 ### 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.
+Use `video_generate` if available. Studio's Generate video row appears only
+when the installed Hermes Agent video backend passes its requirement check; this
+skill may also use any available agent `video_generate` tool. If video generation
+is unavailable, adopt a local file or URL result instead.
+
+Before prompting motion for a character/creature, establish a one-line persona:
+temperament, bearing, and what an "idle" moment means for this subject. It keeps
+motion specific instead of generic breathing/bobbing.
+
+Motion discipline: animate only what the user asked for. Do not add ambient
+breathing, swaying, shimmer, cloth ripple, or body motion unless requested;
+small artifacts become obvious at 48×24. Prefer one deliberate motion plus one
+blink over many tiny movements. Put unwanted motion in the negative prompt or
+prompt body when the provider supports it.
+
+What matters for an eikon video source:
+
+- **Duration** — 1–4 s; Studio defaults to 2 s. Longer usually inflates the
+  bake without improving readability.
+- **Aspect** — prefer 1:1 if accepted; otherwise use an accepted aspect and let
+  Studio crop.
+- **Resolution** — low is fine; the target is 48×24. Don't ask for HD.
+- **Start image** — if the tool accepts it, pass `base.*` / the effective idle
+  source as `image_url` so frame 0 anchors on the still pose. Studio's current
+  bridge does not provide an end-frame handoff; skip unsupported knobs.
+- **Loop** — useful but not required. If the provider has loop/seamless flags,
+  set them; otherwise do not chase a perfect loop by prompting.
+- **Model tier** — if a lite/fast tier warps the subject, switch to a better
+  tier if the tool exposes `model=`. Don't burn iterations fighting artifacts a
+  tier bump fixes.
+
+Providers vary. **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).
 
@@ -139,17 +174,19 @@ Adopt as `<state>.mp4` (or `base.mp4` for an animated idle).
 
 Once source files are in place:
 
-> Open the **Eikon** tab → `eikon` row → **<name>**. Tune zoom /
-> contrast / invert / symbols there, then **Ctrl+S** to bake.
+> Open **Eikon → Studio** → `eikon` row → **<name>**. Tune zoom / contrast /
+> invert / symbols there, then **Ctrl+S** to bake or **Ctrl+U** to bake and use.
+> After a saved bake, press `u` in Studio for the Submit eikon dialog or `s` in
+> **Library** for Share to catalog; Herm previews the bundle and GitHub PR target
+> before submission.
 
 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 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 enumerate provider capabilities to the user; just use what's there.
 - Don't repeat the 48×24 brief.

package/db.worker.js

@@ -22,12 +22,15 @@ var __create=Object.create;var{getPrototypeOf:__getProtoOf,defineProperty:__defP
        ORDER BY c.started_at DESC LIMIT 1`)?.get(sid);return{...pred&&{continuesFrom:pred},...succ&&{compressedTo:succ}}}finally{end()}}function tip(sid){let step=q(`SELECT c.id FROM sessions c
      JOIN sessions p ON p.id = c.parent_session_id
      WHERE p.id = ? AND ${CONT("c")}
-     ORDER BY c.started_at DESC LIMIT 1`),cur=sid;for(let i=0;i<100;i++){let next=step?.get(cur);if(!next)return cur;cur=next.id}return cur}function peek(sid,n=60){let end=mark("io:sessions.peek");try{let ext=[hasMsgCol("platform_message_id")?"platform_message_id":"NULL AS platform_message_id",hasMsgCol("observed")?"observed":"NULL AS observed"];return(q(`SELECT role, SUBSTR(content,1,400) AS content, tool_name,
+     ORDER BY c.started_at DESC LIMIT 1`),cur=sid;for(let i=0;i<100;i++){let next=step?.get(cur);if(!next)return cur;cur=next.id}return cur}function peek(sid,_n=4){let end=mark("io:sessions.peek");try{let ext=[hasMsgCol("platform_message_id")?"platform_message_id":"NULL AS platform_message_id",hasMsgCol("observed")?"observed":"NULL AS observed"];return(q(`SELECT role, SUBSTR(content,1,400) AS content, tool_name,
               SUBSTR(tool_calls,1,400) AS tool_calls, timestamp AS at,
               ${ext.join(", ")}
-       FROM (SELECT * FROM messages WHERE session_id = ?
-             ORDER BY id DESC LIMIT ?)
-       ORDER BY id ASC`)?.all(sid,n)??[]).map((r)=>({role:r.role,content:r.content,tool_name:r.tool_name,tool_calls:r.tool_calls,...r.platform_message_id!==null&&{platform_message_id:r.platform_message_id},...r.observed!==null&&{observed:r.observed},at:r.at}))}finally{end()}}function goalState(sid){let row=q("SELECT value FROM state_meta WHERE key = ?")?.get(`goal:${sid}`);if(!row)return null;try{let j=JSON.parse(row.value),checklist=(Array.isArray(j.checklist)?j.checklist:[]).map(parseItem).filter((x)=>x!==null),subgoals=(Array.isArray(j.subgoals)?j.subgoals:[]).map((s)=>typeof s==="string"?s.trim():"").filter((s)=>s.length>0);return{goal:String(j.goal??""),status:j.status??"active",turn_count:typeof j.turn_count==="number"?j.turn_count:void 0,max_turns:j.max_turns??null,checklist:checklist.length>0?checklist:void 0,subgoals:subgoals.length>0?subgoals:void 0,decomposed:j.decomposed===!0?!0:void 0}}catch{return null}}function search(query,limit=30){let m=fts(query);if(!m)return[];let end=mark("io:sessions.search");try{let raw=q(`SELECT m.session_id, m.role,
+       FROM (
+         SELECT * FROM (SELECT * FROM messages WHERE session_id = ? ORDER BY id ASC LIMIT 2)
+         UNION
+         SELECT * FROM (SELECT * FROM messages WHERE session_id = ? ORDER BY id DESC LIMIT 2)
+       )
+       ORDER BY id ASC`)?.all(sid,sid)??[]).map((r)=>({role:r.role,content:r.content,tool_name:r.tool_name,tool_calls:r.tool_calls,...r.platform_message_id!==null&&{platform_message_id:r.platform_message_id},...r.observed!==null&&{observed:r.observed},at:r.at}))}finally{end()}}function goalState(sid){let row=q("SELECT value FROM state_meta WHERE key = ?")?.get(`goal:${sid}`);if(!row)return null;try{let j=JSON.parse(row.value),checklist=(Array.isArray(j.checklist)?j.checklist:[]).map(parseItem).filter((x)=>x!==null),subgoals=(Array.isArray(j.subgoals)?j.subgoals:[]).map((s)=>typeof s==="string"?s.trim():"").filter((s)=>s.length>0);return{goal:String(j.goal??""),status:j.status??"active",turn_count:typeof j.turn_count==="number"?j.turn_count:void 0,max_turns:j.max_turns??null,checklist:checklist.length>0?checklist:void 0,subgoals:subgoals.length>0?subgoals:void 0,decomposed:j.decomposed===!0?!0:void 0}}catch{return null}}function search(query,limit=30){let m=fts(query);if(!m)return[];let end=mark("io:sessions.search");try{let raw=q(`SELECT m.session_id, m.role,
               snippet(messages_fts, 0, '>>>', '<<<', '...', 40) AS snippet,
               s.source, s.model, s.started_at,
               COALESCE(s.title, SUBSTR(m.content, 1, 120)) AS title
@@ -55,7 +58,7 @@ var __create=Object.create;var{getPrototypeOf:__getProtoOf,defineProperty:__defP
     WHERE s.source IN ('tui', 'cli') AND s.message_count > 0
       AND (s.parent_session_id IS NULL OR ${CONT("s")})
     ORDER BY s.started_at DESC LIMIT 1
-  `)?.get();if(!hit)return;let row=byId(chainTip(hit.id));return row&&row.message_count>0?row:void 0},chainTip=(sid)=>tip(walkUp(sid)),systemPrompt=()=>q(`SELECT id, system_prompt AS text FROM sessions
+  `)?.get();if(!hit)return;return byId(chainTip(hit.id))??void 0},chainTip=(sid)=>tip(walkUp(sid)),systemPrompt=()=>q(`SELECT id, system_prompt AS text FROM sessions
       WHERE system_prompt IS NOT NULL AND length(system_prompt) > 1000
       ORDER BY started_at DESC LIMIT 1`)?.get()??null,VALID_ITEM,parseItem=(raw)=>{if(!raw||typeof raw!=="object")return null;let o=raw,text=typeof o.text==="string"?o.text:"";if(!text.trim())return null;let s=typeof o.status==="string"?o.status:"pending",status=VALID_ITEM.has(s)?s:"pending",by=typeof o.added_by==="string"?o.added_by:void 0;return{text,status,addedBy:by==="judge"||by==="user"?by:void 0}},fts=(s)=>s.trim().split(/\s+/).filter(Boolean).map((w)=>/^\w+$/.test(w)?`${w}*`:`"${w.replace(/"/g,'""')}"`).join(" ");var init_sessions_db=__esm(()=>{init_perf();init_sessions_db();HERMES=process.env.HERMES_HOME||`${process.env.HOME||homedir()}/.hermes`,SRC={file:`${HERMES}/state.db`,relative:"state.db",label:"state.db"},conn={path:SRC.file,ro:null},stmts=new Map,msgCols=new Map;VALID_ITEM=new Set(["pending","completed","impossible"])});function analytics(days,opts){let since=Math.floor(Date.now()/1000)-days*86400,db=stateDb();if(!db)return ZERO;let q2=db.query.bind(db),tot=q2(`SELECT COUNT(*) n,
             COALESCE(SUM(message_count),0) msgs,