agents-city 0.5.8 → 0.5.10

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     {
       "name": "city",
       "source": "./plugin",
-      "version": "0.5.8",
+      "version": "0.5.10",
       "description": "Operate one autonomous city seat, its domain, role, repo support agents, goal, recognised skills and explicit roads to other cities."
     }
   ]

package/README.es.md

@@ -619,6 +619,35 @@ agents-city setup --no-browser
 | `--tui` | usa onboarding de terminal y abre la sesión |
 | `--no-browser` | mantiene el Hall en terminal e imprime su URL |
 
+### `agents-city hall`
+
+El ayuntamiento corre **desacoplado**, como el bus de la ciudad y todo lo demás
+que vive mucho en este producto. Cerrar la ventana desde la que lo lanzaste deja
+de ser una forma de romper la página que alguien está mirando, y `agents-city
+hall` dos veces te devuelve la dirección que ya está sirviendo en vez de abrir
+un segundo. Se para con `agents-city exit`; `--foreground` sirve en la ventana y
+muere con ella.
+
+Su dirección sobrevive a un reinicio. El token se acuñaba por proceso, y eso
+hacía desechable cada pestaña — cierras el ayuntamiento, lo vuelves a abrir, y la
+página que alguien tenía queda rechazada para siempre, sin más vuelta que leer
+una URL nueva en una terminal. Se guarda en `~/.agents-city/.runtime/hall.pase`,
+modo 0600, en la misma clase que el token del bus que este producto ya guarda.
+
+Si la ciudad está corriendo se dice en **todas** las pantallas, no en una
+portada a la que quizá no vuelvas: abierta o no, cuántos agentes están conectados
+de verdad y — sólo cuando falta — que esta ciudad corre sin ninguna de sus reglas.
+Esa última luz hubo que ganársela: antes adivinaba si existía un directorio, y ese
+directorio es la caché del *marketplace*, que aparece en cuanto alguien lo añade.
+Así que una máquina sin el plugin enseñaba un «installed» en verde, y por eso su
+dueño podía pasarse una tarde sin ver que no se estaba aplicando nada. Ahora se lo
+pregunta a Claude.
+
+Y cuando el ayuntamiento no contesta, la página lo dice con sus palabras: qué ha
+pasado, que no se ha perdido nada, el comando que lo vuelve a abrir y un botón
+que reintenta — más un reintento silencioso cada pocos segundos, para que una
+pestaña abierta se recupere sola cuando el ayuntamiento vuelve.
+
 ### `agents-city seat`
 
 Configura lo solicitado, garantiza tmux/plugin y abre o reanuda la sesión de la

package/README.md

@@ -610,6 +610,34 @@ agents-city setup --no-browser
 | `--tui` | use terminal onboarding and open the session |
 | `--no-browser` | keep the Hall in the terminal and print its URL |
 
+### `agents-city hall`
+
+The town hall runs **detached**, like the city bus and every other long-lived
+piece of this product. Closing the window that started it is not a way to break
+the page somebody is looking at, and `agents-city hall` run twice hands back the
+address that is already serving rather than starting a second one. Stop it with
+`agents-city exit`; `--foreground` serves in the window and stops with it.
+
+Its address survives a restart. The token used to be minted per process, which
+made every tab disposable — close the hall, open it again, and the page somebody
+had is permanently refused, with no way back except reading a new URL out of a
+terminal. It is stored at `~/.agents-city/.runtime/hall.pase`, mode 0600, in the
+same class as the bus token this product already keeps.
+
+Whether the city is running is said on **every** screen, not on the front page
+somebody may never return to: open or not, how many agents are actually
+connected, and — only when it is missing — that this city is running with none of
+its rules. That last light is the one that had to be earned: it used to be a
+guess at whether a directory existed, and that directory is the *marketplace's*
+cache, which appears the moment somebody adds the marketplace. So a machine with
+no city plugin showed a green "installed", which is why its owner could spend an
+afternoon unable to see that nothing was being enforced. It asks Claude now.
+
+And when the hall is not answering, the page says so in its own words: what
+happened, that nothing was lost, the command that opens it again, and a button
+that retries — plus a quiet retry every few seconds, so a page left open
+recovers by itself when the hall comes back.
+
 ### `agents-city seat`
 
 Configures requested settings, ensures tmux/plugin, and opens or resumes the city

package/bin/hall

@@ -4,6 +4,12 @@
     ./bin/hall                open it
     ./bin/hall --city lab     open one known city
     ./bin/hall --no-browser   print the address instead
+    ./bin/hall --foreground   serve here, and stop when this window closes
+
+It runs detached, like the city bus and every other long-lived piece of this
+product. Closing the window that started it is not a way to break the page
+somebody is looking at, and its address survives a restart, so a tab left open
+overnight still works in the morning.
 
 One page on localhost: the selected city's identity, owner seat (role, folders,
 goal), repo support agents, recognised skills, roads, districts and houses. It
@@ -51,10 +57,72 @@ def asegura_build():
     return True
 
 
+def vivo():
+    """The URL of a Hall already serving on this machine, or ''.
+
+    Asked, not assumed: a marker file outlives a process that was killed, and
+    handing somebody a URL that answers nothing is exactly the broken tab this
+    change exists to remove.
+    """
+    import json
+    import urllib.error
+    import urllib.request
+
+    try:
+        with open(serve.marcador(), encoding='utf-8') as f:
+            url = str(json.load(f).get('url') or '')
+        if not url:
+            return ''
+        with urllib.request.urlopen(url, timeout=2) as r:
+            return url if r.status == 200 else ''
+    except (OSError, ValueError, urllib.error.URLError):
+        return ''
+
+
+def despega(datos, abrir):
+    """Start the Hall detached, and wait until it can actually answer.
+
+    Detached because every other long-lived piece of this product already is —
+    the bus hub, the gateways, the adapters — and the Hall was the one that died
+    with whichever terminal happened to start it. Closing a window is not
+    supposed to be a way to break the page somebody is looking at.
+
+    It waits for the address to serve rather than printing one optimistically: a
+    URL that is not up yet is the same broken tab, one second earlier.
+    """
+    import subprocess
+    import time
+    import webbrowser
+
+    subprocess.Popen(
+        [sys.executable, os.path.join(AQUI, 'serve.py'), datos],
+        stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL, start_new_session=True,
+    )
+    limite = time.monotonic() + 25
+    while time.monotonic() < limite:
+        url = vivo()
+        if url:
+            print(f'\n  The town hall\n\n    {url}\n')
+            print('    It keeps running when you close this window.')
+            print('    Stop it with:  agents-city exit\n')
+            if abrir:
+                try:
+                    webbrowser.open(url)
+                except Exception:
+                    pass
+            return 0
+        time.sleep(0.2)
+    print('  The hall did not come up. Run it here to see why:', file=sys.stderr)
+    print(f'    {os.path.basename(sys.argv[0])} --foreground', file=sys.stderr)
+    return 1
+
+
 if __name__ == '__main__':
     ap = argparse.ArgumentParser(description='Open one personal city in the local Hall')
     ap.add_argument('--city', default='', help='known city name, id or path')
     ap.add_argument('--no-browser', action='store_true', help='print the URL only')
+    ap.add_argument('--foreground', action='store_true',
+                    help='serve in this window and stop when it closes')
     a = ap.parse_args()
     if not asegura_build():
         sys.exit(1)
@@ -68,6 +136,18 @@ if __name__ == '__main__':
         print(f"  This city belongs to {owner!r}, not {usuario!r}.", file=sys.stderr)
         sys.exit(1)
     cities.selecciona(usuario, datos)
-    sys.exit(0 if serve.sirve(datos,
-                              abrir=not a.no_browser,
-                              pagina='hall') else 0)
+    if a.foreground:
+        sys.exit(0 if serve.sirve(datos, abrir=not a.no_browser, pagina='hall') else 0)
+    # Already open: hand back the same address rather than starting a second
+    # hall and leaving somebody with two of them and no way to tell which.
+    ya = vivo()
+    if ya:
+        print(f'\n  The town hall is already open\n\n    {ya}\n')
+        if not a.no_browser:
+            import webbrowser
+            try:
+                webbrowser.open(ya)
+            except Exception:
+                pass
+        sys.exit(0)
+    sys.exit(despega(datos, abrir=not a.no_browser))