@zerwiz/ymir 0.1.4 → 0.1.7

package/bin/eindri-acclaim.sh

@@ -0,0 +1,47 @@
+#!/usr/bin/env bash
+# eindri-acclaim.sh — action half of the Eindri→Brokk wake bridge.
+#
+# Runs once when the when-adapter fires on a stable `true`: files the report
+# durably (state/eindri-reports/<agent>.md), marks the agent as reported
+# (state/eindri-done/<agent>.md — so a re-arm never refires instantly on old
+# news), appends a wake to state/.wake-queue (surfaced by Sága's drain in the
+# session digest), and sounds the desktop note. Idempotent via the marker.
+#
+# Usage: bin/eindri-acclaim.sh <agent> [<worktree-root>]
+set -u
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT="${BROKK_ROOT_OVERRIDE:-$(cd "$SCRIPT_DIR/.." && pwd)}"
+
+# The roots that live OUTSIDE the code tree: this machine's records and the
+# runtime state belong to the home the operator chose at installation, never in
+# the tree — a packaged install replaces its tree on upgrade (Rule 04).
+if [ -z "${YMIR_HOARD_LIB_LOADED:-}" ]; then
+  _yr="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  for _yc in "$_yr/hoard-lib.sh" "$(dirname "$_yr")/bin/hoard-lib.sh"; do
+    [ -r "$_yc" ] && { . "$_yc"; YMIR_HOARD_LIB_LOADED=1; break; }
+  done
+  unset _yr _yc
+fi
+hoard_state_dir YMIR_STATE_DIR
+hoard_data_dir YMIR_DATA_DIR
+STATE="${BROKK_STATE_OVERRIDE:-$YMIR_STATE_DIR}"
+AGENT="${1:-}"
+WORKTREE="${2:-}"
+[ -n "$AGENT" ] || { echo "usage: eindri-acclaim.sh <agent> [<worktree-root>]" >&2; exit 2; }
+
+mkdir -p "$STATE/eindri-reports" "$STATE/eindri-done"
+detail=""
+if [ -f "$STATE/eindri-reports/$AGENT.md" ]; then
+  detail="report filed at state/eindri-reports/$AGENT.md"
+elif [ -n "$WORKTREE" ] && [ -f "$WORKTREE/REPORT.md" ]; then
+  cp "$WORKTREE/REPORT.md" "$STATE/eindri-reports/$AGENT.md" 2>/dev/null || true
+  detail="report filed from $WORKTREE/REPORT.md (state/eindri-reports/$AGENT.md)"
+else
+  detail="left working (herdr state flipped; read the pane: herdr agent read $AGENT)"
+fi
+printf 'eindri %s reported: %s\n' "$AGENT" "$detail" >>"$STATE/.wake-queue"
+printf '%s %s: %s\n' "$(date -u +%Y-%m-%dT%H:%M:%SZ)" "$AGENT" "$detail" >"$STATE/eindri-done/$AGENT.md"
+if [ -x "$SCRIPT_DIR/ymir-say.sh" ]; then
+  "$SCRIPT_DIR/ymir-say.sh" note "Eindri $AGENT reported" >/dev/null 2>&1 || true
+fi
+printf 'eindri-acclaim[1]{agent,detail}:\n  "%s","%s"\n' "$AGENT" "$detail"

package/bin/eindri-control.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+# eindri-control.sh — the CONTROL plane: allowlisted lifecycle verbs for a
+# seated Eindri, addressed by agent name or pane. No arbitrary text, no raw keys.
+#
+#   bin/eindri-control.sh interrupt <agent-or-pane>   # cancel the running turn
+#   bin/eindri-control.sh exit <agent-or-pane>        # stop the agent, keep the pane
+#   bin/eindri-control.sh read <agent-or-pane>        # read its current output
+set -u
+VERB="${1:-}"; TARGET="${2:-}"
+[ -n "$VERB" ] && [ -n "$TARGET" ] || { printf 'error: usage: bin/eindri-control.sh <interrupt|exit|read> <agent-or-pane>\n' >&2; exit 2; }
+command -v herdr >/dev/null 2>&1 || { printf 'error: herdr not on PATH\n' >&2; exit 1; }
+
+case "$VERB" in
+  interrupt)
+    # Deliver the interrupt key sequence; the agent keeps running.
+    herdr agent send-keys "$TARGET" ctrl+c >/dev/null 2>&1 \
+      && printf 'eindri-control[1]{verb,target,state}:\n  "interrupt","%s","delivered"\n' "$TARGET" \
+      || { printf 'eindri-control[1]{verb,target,state}:\n  "interrupt","%s","failed"\n' "$TARGET" >&2; exit 1; } ;;
+  exit)
+    # Stop the agent; keep the pane/worktree. herdr clears the agent on exit.
+    herdr pane close "$TARGET" >/dev/null 2>&1
+    herdr agent release-agent "$TARGET" >/dev/null 2>&1 || true
+    printf 'eindri-control[1]{verb,target,state}:\n  "exit","%s","stopped"\n' "$TARGET" ;;
+  read)
+    herdr agent read "$TARGET" 2>/dev/null || true ;;
+  *)
+    printf 'error: verb %s not allowlisted (interrupt|exit|read)\n' "$VERB" >&2; exit 2 ;;
+esac

package/bin/eindri-role.sh

@@ -0,0 +1,83 @@
+#!/usr/bin/env bash
+# eindri-role.sh — the right smith for the right metal.
+#
+# An Eindri is a delegated hand (see AGENTS.md / docs/lore.md §II). Choosing the
+# wrong smith for a task is like handing a skald a hammer: the work gets done
+# badly, or not at all. This maps a task to the agent whose craft matches it.
+#
+# The roster is the source of truth (.agents/agents/*.md). This is the chooser.
+#
+# Usage:
+#   bin/eindri-role.sh list
+#   bin/eindri-role.sh choose "<task text>"        # the smith whose craft fits
+#   bin/eindri-role.sh for <keyword>               # exact role lookup
+#   bin/eindri-role.sh --version
+#
+# Output: Galdr TOON.
+set -u
+
+VERSION="1.0.0"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+case "${1-}" in
+  -v|-V|--version) printf '%s\n' "$VERSION"; exit 0 ;;
+  -h|--help|"") sed -n '2,16p' "$0" | sed 's/^# \{0,1\}//'; exit 0 ;;
+esac
+ACTION="${1:-list}"; shift || true
+
+# role | craft | the words that call it
+roles() {
+  cat <<'ROLES'
+sindri|code — build, refactor, fix, test|code build refactor fix bug implement feature test compile script forge api backend frontend function class module
+bragi|content — marketing, SEO, social|content write copy marketing seo social post article blog campaign brand announcement newsletter
+huginn|research — search, analyse, discover|research search analyse analyze investigate find discover compare benchmark source docs look up
+kvasir|scout — recon a codebase before work|scout recon survey map explore inventory reconnaissance terrain reconnoiter
+hnoss|design — UI/UX, prototypes, decks, dashboards|design ui ux prototype landing dashboard deck slide visual layout figma design-system
+mimir|plan — design the approach|plan design architect approach strategy spec breakdown sequence decompose
+snotra|document — prose, guides, references|document docs guide reference readme manual explain describe prose
+forseti|review — judge the work|review judge audit critique verify assess check inspect quality gate
+galdr|runtime — the Ymir distro itself|galdr runtime distro install skill toon cli agent-facing extension
+ROLES
+}
+
+case "$ACTION" in
+  list)
+    printf 'eindri-roles[8]{role,craft}:\n'
+    while IFS='|' read -r r c _; do
+      printf '  "%s","%s"\n' "$r" "$c"
+    done < <(roles)
+    ;;
+  for)
+    want="${1:-}"
+    [ -n "$want" ] || { printf 'error: for needs a role name\n' >&2; exit 2; }
+    hit="$(roles | awk -F'|' -v w="$want" '$1==w {print}')"
+    if [ -n "$hit" ]; then
+      printf 'eindri-role[1]{role,craft}:\n  "%s","%s"\n' "$(printf '%s' "$hit" | cut -d'|' -f1)" "$(printf '%s' "$hit" | cut -d'|' -f2)"
+    else
+      printf 'eindri-role[1]{role,known}:\n  "%s","no"\n' "$want"
+      printf 'help: bin/eindri-role.sh list\n' >&2
+      exit 1
+    fi
+    ;;
+  choose)
+    text="$(printf '%s' "${*:-}" | tr '[:upper:]' '[:lower:]')"
+    [ -n "$text" ] || { printf 'error: choose needs task text\n' >&2; exit 2; }
+    best=""; bestscore=0
+    while IFS='|' read -r r craft words; do
+      s=0
+      for w in $words; do
+        [ -n "$w" ] || continue
+        case "$w" in of|the|and|a|to) continue ;; esac
+        printf '%s\n' "$text" | grep -Eqw -- "$w" && s=$((s+1))
+      done
+      if [ "$s" -gt "$bestscore" ]; then bestscore=$s; best="$r"; bestcraft="$craft"; fi
+    done < <(roles)
+    if [ -z "$best" ]; then
+      # No craft word matched: the smith of first resort for general work.
+      best="sindri"; bestcraft="code — build, refactor, fix, test"
+    fi
+    printf 'eindri-choice[1]{role,craft,score}:\n  "%s","%s",%s\n' "$best" "$bestcraft" "$bestscore"
+    ;;
+  *) printf 'error: unknown action %s\nhelp: bin/eindri-role.sh [list|choose|for]\n' "$ACTION" >&2; exit 2 ;;
+esac

package/bin/eindri-seat.sh

@@ -0,0 +1,83 @@
+#!/usr/bin/env bash
+# eindri-seat.sh — seat a worker and PROVE it, in one move.
+#
+# The lesson from firstmate (bin/fm-spawn.sh + fm-send.sh + fm-peek.sh): a spawn
+# is not a seat until the brief is delivered AND the agent has been read. Ymir
+# had ported only the launcher, so a seat could be reported while the worker sat
+# idle — "sent but never started". This is the missing half, in our idiom.
+#
+#   bin/eindri-seat.sh <name> --role <role> [--model <model>] -- "<brief>"
+#
+# It seats through bin/herdr-run.sh (the house door, so the model->harness rule
+# and the pane bookkeeping stay in one place), waits for the pane to settle,
+# reads it, and reports what the agent ACTUALLY is:
+#
+#   state: working  — it has begun (exit 0)
+#   state: idle     — seated but nothing ran (exit 3: a seat, not an errand)
+#   state: error    — the pane shows a refusal (the 403/1010 class) (exit 1)
+#
+# Nothing is claimed that the pane does not show.
+set -u
+
+VERSION="1.0.0"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+SETTLE="${YMIR_SEAT_SETTLE:-35}"
+
+case "${1-}" in
+  -v|-V|--version) printf '%s\n' "$VERSION"; exit 0 ;;
+  -h|--help|"") sed -n '2,20p' "$0" | sed 's/^# \{0,1\}//'; exit 0 ;;
+esac
+
+NAME="${1:-}"; shift || true
+[ -n "$NAME" ] || { printf 'error: a name is required\nhelp: bin/eindri-seat.sh <name> --role <role> -- "<brief>"\n' >&2; exit 2; }
+
+# hand the rest to the house door, which owns the harness rule and the pane log
+SEAT_OUT="$("$SCRIPT_DIR/herdr-run.sh" eindri "$NAME" "$@" 2>&1)"
+RC=$?
+printf '%s\n' "$SEAT_OUT"
+
+# The pane id is the door's own answer; without it there is nothing to read.
+# The door answers with the TAB; the pane must be resolved from it (its row
+# carries the eindri's name in the pane field, which is how I once read a name
+# as a pane and reported an empty tail as an idle agent).
+TAB="$(printf '%s\n' "$SEAT_OUT" | sed -n 's/.*","\(w[0-9]*:t[0-9A-Za-z]*\)","[a-z]*".*/\1/p' | head -1)"
+PANE=""
+if [ -n "$TAB" ] && [ -x "${HERDR_BIN_PATH:-}" ]; then
+  PANE="$("${HERDR_BIN_PATH}" pane list 2>/dev/null | python3 -c "
+import json,sys
+try:
+    d=json.load(sys.stdin)
+except Exception:
+    raise SystemExit
+tab=sys.argv[1] if len(sys.argv)>1 else ''
+for p in d.get('result',{}).get('panes',[]) or []:
+    if p.get('tab_id')==tab and p.get('agent'):
+        print(p.get('pane_id','')); break
+" "$TAB")"
+fi
+if [ -z "$PANE" ]; then
+  # herdr absent or the door refused: report what it said, claim nothing more.
+  printf 'eindri[1]{name,state,detail}:\n  "%s","unseated","the door did not return a pane"\n' "$NAME"
+  exit "$([ "$RC" = 0 ] && echo 3 || echo 1)"
+fi
+
+sleep "$SETTLE"
+TAIL="$("${HERDR_BIN_PATH:-herdr}" pane read "$PANE" 2>/dev/null | tail -25)"
+
+STATE="idle"; WHY="seated, but the pane shows no work yet"
+case "$TAIL" in
+  *"Error: 403"*|*"error code: 1010"*|*"Access denied"*)
+    STATE="blocked"; WHY="the provider refused the client (403/1010 class) — see the pane" ;;
+  *working*|*"esc interrupt"*|*"thinking"*|*"✻"*|*"▣"*)
+    STATE="working"; WHY="the agent has begun" ;;
+esac
+
+printf 'eindri[1]{name,pane,state,detail}:\n  "%s","%s","%s","%s"\n' "$NAME" "$PANE" "$STATE" "$WHY"
+printf 'pane_tail[1]{last_lines}:\n  "%s"\n' "$(printf '%s' "$TAIL" | tail -3 | tr '\n' '~' | sed 's/"/\\"/g' | cut -c1-200)"
+
+case "$STATE" in
+  working) exit 0 ;;
+  blocked) exit 1 ;;
+  *) exit 3 ;;
+esac

package/bin/eindri-seen.sh

@@ -0,0 +1,54 @@
+#!/usr/bin/env bash
+# eindri-seen.sh — condition half of the Eindri→Brokk wake bridge.
+#
+# Exit 0 (true) when a seated Eindri has REPORTED: a report file exists
+# (state/eindri-reports/<agent>.md, or a REPORT.md at the given worktree root)
+# OR herdr shows the agent left `working` (done / blocked / idle). Exit 1 while
+# the smith still works. Any other exit is an error — per the when-adapter
+# contract, 0 is the only true and never a mutation.
+#
+# Pure check: deterministic per the poll, mutates nothing.
+#
+# Usage: bin/eindri-seen.sh <agent> [<worktree-root>]
+set -u
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT="${BROKK_ROOT_OVERRIDE:-$(cd "$SCRIPT_DIR/.." && pwd)}"
+
+# The roots that live OUTSIDE the code tree: this machine's records and the
+# runtime state belong to the home the operator chose at installation, never in
+# the tree — a packaged install replaces its tree on upgrade (Rule 04).
+if [ -z "${YMIR_HOARD_LIB_LOADED:-}" ]; then
+  _yr="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  for _yc in "$_yr/hoard-lib.sh" "$(dirname "$_yr")/bin/hoard-lib.sh"; do
+    [ -r "$_yc" ] && { . "$_yc"; YMIR_HOARD_LIB_LOADED=1; break; }
+  done
+  unset _yr _yc
+fi
+hoard_state_dir YMIR_STATE_DIR
+hoard_data_dir YMIR_DATA_DIR
+STATE="${BROKK_STATE_OVERRIDE:-$YMIR_STATE_DIR}"
+AGENT="${1:-}"
+WORKTREE="${2:-}"
+[ -n "$AGENT" ] || { echo "usage: eindri-seen.sh <agent> [<worktree-root>]" >&2; exit 2; }
+
+# 1. A report file is the strongest signal the smith is done.
+[ -f "$STATE/eindri-reports/$AGENT.md" ] && exit 0
+[ -n "$WORKTREE" ] && [ -f "$WORKTREE/REPORT.md" ] && exit 0
+
+# 2. herdr state: only a TERMINAL state counts as reported. A pi agent reads
+#    'idle' between its own tool-thoughts while the errand still burns — idle is
+#    still working; done/blocked mean the smith finished or is stuck.
+if command -v herdr >/dev/null 2>&1; then
+  state=$(herdr agent list 2>/dev/null | python3 -c "
+import json,sys
+try:
+    d=json.load(sys.stdin)
+    for a in d['result']['agents']:
+        if (a.get('name')==sys.argv[1]):
+            print(a.get('agent_status','unknown'))
+except Exception:
+    pass
+" "$AGENT")
+  case "$state" in done|blocked) exit 0 ;; esac
+fi
+exit 1

package/bin/eindri-send.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+# eindri-send.sh — the DATA plane: send conversational text to a seated Eindri.
+# The agent reads it as a new turn (herdr steers the running agent). This is how
+# Brokk talks to an Eindri; the reply is read with `herdr agent read`.
+#
+#   bin/eindri-send.sh <agent-or-pane> "<text>"
+set -u
+TARGET="${1:-}"; shift || true; TEXT="${*:-}"
+[ -n "$TARGET" ] && [ -n "$TEXT" ] || { printf 'error: usage: bin/eindri-send.sh <agent-or-pane> "<text>"\n' >&2; exit 2; }
+command -v herdr >/dev/null 2>&1 || { printf 'error: herdr not on PATH\n' >&2; exit 1; }
+if herdr agent prompt "$TARGET" "$TEXT" >/dev/null 2>&1; then
+  printf 'eindri-send[1]{target,state}:\n  "%s","sent"\n' "$TARGET"
+else
+  printf 'eindri-send[1]{target,state}:\n  "%s","FAILED"\n' "$TARGET" >&2; exit 1
+fi

package/bin/eindri-start.sh

@@ -0,0 +1,98 @@
+#!/usr/bin/env bash
+# eindri-start.sh — start an Eindri as the Allfather asks. One command.
+#
+#   ensure backend -> classify the role -> seat the smith -> record -> report
+#
+# A seat is attempted on herdr (the Þjazi backend); when the herdr CLI cannot
+# seat (no `hdr`, or a herdr without `agent start`), it falls back to tmux — the
+# verified sibling — so an agent always starts. Galdr-style TOON.
+#
+# Usage:
+#   eindri-start.sh "<request>" [--role <name>] [--pane|--tab|--space] [--kind pi|opencode]
+#   eindri-start.sh --version
+set -u
+
+VERSION="1.0.0"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# The roots that live OUTSIDE the code tree: this machine's records and the
+# runtime state belong to the home the operator chose at installation, never in
+# the tree — a packaged install replaces its tree on upgrade (Rule 04).
+if [ -z "${YMIR_HOARD_LIB_LOADED:-}" ]; then
+  _yr="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  for _yc in "$_yr/hoard-lib.sh" "$(dirname "$_yr")/bin/hoard-lib.sh"; do
+    [ -r "$_yc" ] && { . "$_yc"; YMIR_HOARD_LIB_LOADED=1; break; }
+  done
+  unset _yr _yc
+fi
+hoard_state_dir YMIR_STATE_DIR
+hoard_data_dir YMIR_DATA_DIR
+STATE="${BROKK_STATE_OVERRIDE:-$YMIR_STATE_DIR}"
+SEATS="$STATE/herdr-seats"
+SESSION="${YMIR_HERDR_SESSION:-brokk}"
+
+case "${1-}" in -v|-V|--version) printf '%s\n' "$VERSION"; exit 0 ;; -h|--help|"") sed -n '2,13p' "$0" | sed 's/^# \{0,1\}//'; exit 0 ;; esac
+
+REQ=""; ROLE=""; SEAT=""; MODEL=""; KIND="${YMIR_HERDR_KIND:-pi}"; MAIN=""
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --role) ROLE=${2-}; shift 2 ;;
+    --kind) KIND=${2-}; shift 2 ;;
+    --model) MODEL=${2-}; shift 2 ;;
+    --main) MAIN="--main"; shift ;;
+    --space) SEAT="--space"; shift ;;
+    --tab) SEAT="--tab"; shift ;;
+    --pane) SEAT="--pane"; shift ;;
+    -*) printf 'error: unknown flag %s\nhelp: bin/eindri-start.sh "<request>" [--role <name>] [--pane|--tab|--space] [--kind pi|opencode]\n' "$1" >&2; exit 2 ;;
+    *) [ -z "$REQ" ] && REQ="$1" || REQ="$REQ $1"; shift ;;
+  esac
+done
+[ -n "$REQ" ] || { printf 'error: eindri-start needs a request\nhelp: bin/eindri-start.sh "build the login page"\n' >&2; exit 2; }
+
+# 1. Backend: ensure herdr (or a usable backend) exists.
+[ -x "$SCRIPT_DIR/herdr-ensure.sh" ] && "$SCRIPT_DIR/herdr-ensure.sh" ensure --install >/dev/null 2>&1 || true
+
+# 2. The right smith for the request.
+if [ -z "$ROLE" ] && [ -x "$SCRIPT_DIR/eindri-role.sh" ]; then
+  ROLE="$("$SCRIPT_DIR/eindri-role.sh" choose "$REQ" 2>/dev/null | sed -n '2p' | sed -E 's/^ *"([^"]+)".*/\1/')"
+fi
+ROLE="${ROLE:-eindri}"
+SLUG="$(printf '%s' "$REQ" | tr 'A-Z' 'a-z' | tr -cs 'a-z0-9' '-' | sed -E 's/^-|-$//g' | cut -c1-24)"
+LABEL="${ROLE}-${SLUG:-task}"
+
+mkdir -p "$STATE"
+
+# 3. Seat: herdr first, tmux fallback — always produce a seat.
+#    rc 3 from herdr-run means "not worth a smith" — report it, do NOT fake a seat.
+seat="none"; refuse=0; rc=0
+if [ -x "$SCRIPT_DIR/herdr-run.sh" ]; then
+  "$SCRIPT_DIR/herdr-run.sh" eindri $SEAT $MAIN ${MODEL:+--model "$MODEL"} "$ROLE" -- "$REQ" >/dev/null 2>&1 || rc=$?
+fi
+if [ "$rc" = 0 ]; then
+  seat="herdr"
+elif [ "$rc" = 3 ]; then
+  seat="none"; refuse=1
+else
+  command -v tmux >/dev/null 2>&1 || { printf 'eindri-start[1]{role,seat,request}:\n  "%s","none","%s"\n' "$ROLE" "$REQ"; printf 'error: no seat — herdr cannot seat and tmux is absent\n' >&2; exit 1; }
+  tmux has-session -t "$SESSION" 2>/dev/null || tmux new-session -d -s "$SESSION" -n shell
+  tmux new-window -t "$SESSION" -n "$LABEL" "bash -lc 'printf \"\\n  %s — Eindri of Ymir\\n  request: %s\\n\\n\"; case \"$KIND\" in pi) exec pi \"$REQ\" ;; *) exec \"$KIND\" ;; esac'" 2>/dev/null \
+    && seat="tmux:$SESSION:$LABEL"
+fi
+[ "$refuse" = 1 ] && { printf 'eindri-start[1]{role,seat,verdict}:\n  "%s","none","too brief — answer it in hand"\n' "$ROLE"; exit 0; }
+[ "$seat" != "none" ] || { printf 'error: could not seat %s\n' "$ROLE" >&2; exit 1; }
+
+# 4. Serve the Eindri over A2A (best effort): its tasks are delivered by
+#    injection into the seated agent's chat; reachable at A2A_URL.
+A2A_URL=""
+if [ "$seat" = herdr ] && [ -f "$SCRIPT_DIR/a2a-serve.py" ]; then
+  PORT=$((7800 + (RANDOM % 100)))
+  mkdir -p "$STATE"
+  nohup python3 "$SCRIPT_DIR/a2a-serve.py" "$ROLE" "$ROLE" "$PORT" >"$STATE/a2a-$ROLE.log" 2>&1 &
+  A2A_URL="http://127.0.0.1:$PORT/"
+fi
+
+# 5. Record + report.
+printf '%s\t%s\t%s\t%s\n' "$(date -u +%Y-%m-%dT%H:%M:%SZ)" "$ROLE" "$seat" "$REQ" >>"$SEATS"
+printf 'eindri-start[1]{role,seat,a2a,request,label}:\n'
+printf '  "%s","%s","%s","%s","%s"\n' "$ROLE" "$seat" "${A2A_URL:-none}" "$REQ" "$LABEL"

package/bin/eindri-watch.sh

@@ -0,0 +1,57 @@
+#!/usr/bin/env bash
+# eindri-watch.sh — the control door on the Eindri→Brokk wake bridge.
+#
+# One when-source per seated smith, spun on the Norns' loom (.agents/backend/
+# fm-procevent-when.sh + the runner's reconcile). When a smith reports (his
+# REPORT.md lands or herdr shows him left working), the bridge fires the
+# acclaim: the wake lands in state/.wake-queue and the session digest shows it.
+# Brokk handles the wake, reads the report, then re-arms for the next errand.
+#
+#   bin/eindri-watch.sh arm [--interval N] [--stable N] <agent> [<worktree>]
+#   bin/eindri-watch.sh retire <agent>
+#   bin/eindri-watch.sh list
+#   bin/eindri-watch.sh reconcile
+set -u
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT="${BROKK_ROOT_OVERRIDE:-$(cd "$SCRIPT_DIR/.." && pwd)}"
+WHEN="$ROOT/.agents/backend/fm-procevent-when.sh"
+RUNNER="$ROOT/.agents/backend/fm-procevent.sh"
+INTERVAL="20"; STABLE="2"
+
+case "${1-}" in
+  ""|-h|--help) sed -n '2,14p' "$0" | sed 's/^# \{0,1\}//'; exit 0 ;;
+esac
+
+cmd="${1-}"; shift || true
+case "$cmd" in
+  arm)
+    while [ $# -gt 0 ] && [ "${1#--}" != "$1" ]; do
+      case "$1" in
+        --interval) INTERVAL="${2-}"; shift 2 ;;
+        --stable) STABLE="${2-}"; shift 2 ;;
+        *) echo "unknown option $1" >&2; exit 2 ;;
+      esac
+    done
+    [ $# -ge 1 ] || { echo "usage: eindri-watch.sh arm [--interval N] [--stable N] <agent> [<worktree>]" >&2; exit 2; }
+    name="${1-}"; wt="${2-}"
+    "$WHEN" arm "$name" --interval "$INTERVAL" --stable "$STABLE" \
+      --condition bash "$SCRIPT_DIR/eindri-seen.sh" "$name" "$wt" \
+      --action bash "$SCRIPT_DIR/eindri-acclaim.sh" "$name" "$wt"
+    state=$(herdr agent list 2>/dev/null | python3 -c "
+import json,sys
+try:
+    d=json.load(sys.stdin)
+    for a in d['result']['agents']:
+        if (a.get('name')==sys.argv[1]): print(a.get('agent_status','unknown'))
+except Exception: pass
+" "$name" 2>/dev/null)
+    printf 'eindri-watch[1]{agent,state,source}:\n  "%s","%s","when-%s"\n' "$name" "${state:-unknown}" "$name"
+    ;;
+  retire)
+    [ $# -ge 1 ] || { echo "usage: eindri-watch.sh retire <agent>" >&2; exit 2; }
+    "$WHEN" retire "$1"
+    ;;
+  list) "$RUNNER" list ;;
+  reconcile) "$RUNNER" reconcile ;;
+  *) echo "unknown command: $cmd (arm|retire|list|reconcile)" >&2; exit 2 ;;
+esac