hive-am 1.3.0 → 1.4.0

package/CHANGELOG.md

@@ -6,6 +6,24 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 
 ## [Unreleased]
 
+## [1.4.0] - 2026-10-15
+
+### Added
+
+- **Chat** item in the side rail, above Colony. It opens the last conversation you had open (or the first agent if that one no longer exists). With no agents yet, it shows an empty state with a button to create the first one.
+- **Resources strip** above each chat, folded by default. Closed, it is one line that counts the resources running, stopped or failing (failures in red). Open, it shows a card per resource with start or stop, restart and a link to its own screen. It shows the agent's resources and those of its colony, with a switch to see all of them; the choice and whether it is open are remembered.
+- The README now has screenshots of the colony, chat, resources, clusters, changes explorer and HTTP requests.
+
+### Changed
+
+- Servers: **Keeping it healthy** is split into **If it goes down** (restart policy and maximum restarts) and **Health check** (kind, target and restart when unhealthy). The check timing (every, wait, failures in a row) and the stop and log settings are folded, and the defaults are visible.
+- Servers: a restart waits for the port to be free before starting again, so a stop command that does not really stop the service is reported instead of leaving a failed start behind.
+- Servers: the first health check comes one interval after a start instead of right away.
+
+### Fixed
+
+- Entering a chat no longer flashes the default layout first: saved choices (the agent list collapsed, the resources strip open) apply before the first paint, the side panel only animates when you toggle it, and the conversation fades in when its history arrives.
+
 ## [1.3.0] - 2026-10-14
 
 ### Added
@@ -168,7 +186,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 - Complete documentation in English and Spanish.
 - npm package with the `hive-am` command.
 
-[Unreleased]: https://github.com/hughcbscrt/hive-am/compare/v1.3.0...HEAD
+[Unreleased]: https://github.com/hughcbscrt/hive-am/compare/v1.4.0...HEAD
+[1.4.0]: https://github.com/hughcbscrt/hive-am/compare/v1.3.0...v1.4.0
 [1.3.0]: https://github.com/hughcbscrt/hive-am/compare/v1.2.2...v1.3.0
 [1.2.2]: https://github.com/hughcbscrt/hive-am/compare/v1.2.1...v1.2.2
 [1.2.1]: https://github.com/hughcbscrt/hive-am/compare/v1.2.0...v1.2.1

package/README.md

@@ -44,6 +44,25 @@ have installed; it does not replace them and it never copies your conversations
 - **Terminals.** A bottom panel (Ctrl+`) with real shells and object logs, reachable only from this machine.
 - **Local and private.** The server binds to `127.0.0.1`. Data lives in `~/.hive-am/`.
 
+## Screenshots
+
+<table>
+  <tr>
+    <td width="50%"><img src="docs/manual/en/img/colonia-mapa.jpg" alt="The colony map: colonies, agents and resources as hexagons" /><br /><sub><b>The colony.</b> Agents and resources as hexagons, grouped by colony.</sub></td>
+    <td width="50%"><img src="docs/manual/en/img/chat-conversacion.jpg" alt="A conversation with an orchestrator" /><br /><sub><b>Chat.</b> The real session of the CLI, with tokens, cost and tool calls.</sub></td>
+  </tr>
+  <tr>
+    <td width="50%"><img src="docs/manual/en/img/recurso-servidor-logs.jpg" alt="A server resource with its live logs" /><br /><sub><b>Resources.</b> Servers, containers and databases with live logs.</sub></td>
+    <td width="50%"><img src="docs/manual/en/img/recurso-cluster.jpg" alt="A cluster that starts several resources together" /><br /><sub><b>Clusters.</b> Start and stop a group of resources in order.</sub></td>
+  </tr>
+  <tr>
+    <td width="50%"><img src="docs/manual/en/img/cambios-diff.jpg" alt="The changes explorer showing a diff" /><br /><sub><b>Changes.</b> Git tree, diff, history and commit per agent.</sub></td>
+    <td width="50%"><img src="docs/manual/en/img/http-respuesta.jpg" alt="An HTTP request and its response" /><br /><sub><b>HTTP requests.</b> Run <code>.http</code> files and read the response.</sub></td>
+  </tr>
+</table>
+
+More in the [user manual](docs/manual/en/README.md).
+
 ## Providers
 
 | Provider | Run a turn | Transcript source |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hive-am",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "A colony of coding agents: orchestrators and subagents over Claude Code, OpenCode and Kiro, with real session resume, a browser UI and Telegram.",
   "keywords": [
     "ai-agents",

package/server/dist/objects/index.js

@@ -10,7 +10,7 @@ import { dbColumns, dbQuery, dbSchema, dbState, dbTest, forgetDatabase } from '.
 import { addSaved, clearQueries, forgetQueries, listQueries, listSaved, recordQuery, removeSaved, updateSaved } from './db-history.js';
 import { exportCollection, parseHttpFile, createHttpFile, exportHttp, describeHttp, dropSession, inspectHttp, readHttpFile, runHttp, scanHttp, writeHttpFile, sessionClear, sessionOf, sessionSet, sessionView } from './http.js';
 import { ObjectError, parseDatabase } from './model.js';
-import { forgetServer, serverLogs, serverState, startServer, stopServer } from './runner.js';
+import { forgetServer, serverLogs, restartServer, serverState, startServer, stopServer } from './runner.js';
 import { forgetSupervision, resetSupervision, supervise } from './supervisor.js';
 import { maskConfig, objectsStore } from './store.js';
 export { ObjectError } from './model.js';
@@ -59,7 +59,7 @@ function clusterState(o) {
 async function serverStateSupervised(o) {
     const cfg = o.config;
     const base = await serverState(o.id, cfg);
-    return supervise(o, cfg, base, { start: () => startServer(o.id, cfg), restart: async () => { await stopServer(o.id, cfg); await startServer(o.id, cfg); } });
+    return supervise(o, cfg, base, { start: () => startServer(o.id, cfg), restart: () => restartServer(o.id, cfg) });
 }
 export async function stateOf(o) {
     const s = o.kind === 'server' ? await serverStateSupervised(o)
@@ -113,10 +113,8 @@ async function act(o, action) {
             await startServer(o.id, c);
         else if (action === 'stop')
             await stopServer(o.id, c);
-        else {
-            await stopServer(o.id, c);
-            await startServer(o.id, c);
-        }
+        else
+            await restartServer(o.id, c);
     }
     else {
         const c = o.config;

package/server/dist/objects/runner.js

@@ -139,6 +139,26 @@ export async function stopServer(id, cfg) {
             await sleep(100);
     }
 }
+/**
+ * Stop, then start again. With a port, the old listener must be gone before the new one starts: otherwise the check on the port would
+ * report "running" for the old process (a stop command that does not really stop the service) while the new one failed to bind.
+ */
+export async function restartServer(id, cfg) {
+    await stopServer(id, cfg);
+    if (cfg.port) {
+        const grace = cfg.stopTimeoutSec ? cfg.stopTimeoutSec * 1000 : STOP_GRACE_MS;
+        let waited = 0;
+        while (await listening(cfg.port) && waited < grace) {
+            await sleep(300);
+            waited += 300;
+        }
+        if (await listening(cfg.port)) {
+            note(id, `port ${cfg.port} is still in use after stopping: not starting it again. Check that the stop command really stops the service`);
+            throw new ObjectError(`Port ${cfg.port} is still in use after stopping, so it was not started again. Check that the stop command really stops the service.`);
+        }
+    }
+    await startServer(id, cfg);
+}
 /** Lines the object printed. `after` is a byte offset from an earlier call; without it the last `tail` lines come back. */
 export function serverLogs(id, o) {
     const { log } = files(id);

package/server/dist/objects/supervisor.js

@@ -54,8 +54,8 @@ export async function supervise(o, cfg, state, act) {
         if (S.startedAt !== saved?.startedAt) {
             S.startedAt = saved?.startedAt ?? 0;
             S.fails = 0;
-            S.lastCheck = 0;
-        }
+            S.lastCheck = now;
+        } // a new start: the first check comes one interval later, not right away
         if (now - S.lastCheck >= (cfg.health.intervalSec ?? 15) * 1000) {
             S.lastCheck = now;
             const r = await check(cfg, cfg.health);

package/web/.next/BUILD_ID

@@ -1 +1 @@
-aSYzbHk1M5YeS_d3SQKTZ
+YT6HM6qmegMJaBMX5QvuP

package/web/.next/app-build-manifest.json

@@ -13,10 +13,10 @@
       "static/chunks/89-b194fcffe5120c44.js",
       "static/chunks/main-app-6086068e5fb5eacd.js",
       "static/css/945795da867f5250.css",
-      "static/css/d42799b7e6a0e8a2.css",
+      "static/css/582723fcea1f9887.css",
       "static/chunks/586-f7017d585a84738d.js",
-      "static/chunks/281-d8a0dcfaa6d064e4.js",
-      "static/chunks/app/layout-49b46c9b5aa512a8.js"
+      "static/chunks/281-113274e705940a55.js",
+      "static/chunks/app/layout-fad968a635f9a4b3.js"
     ],
     "/connections/page": [
       "static/chunks/webpack-ef515e41a83a16ac.js",
@@ -24,40 +24,33 @@
       "static/chunks/89-b194fcffe5120c44.js",
       "static/chunks/main-app-6086068e5fb5eacd.js",
       "static/chunks/586-f7017d585a84738d.js",
-      "static/chunks/281-d8a0dcfaa6d064e4.js",
+      "static/chunks/281-113274e705940a55.js",
       "static/chunks/app/connections/page-eb11cfb1ffeab3ca.js"
     ],
-    "/agents/page": [
+    "/chat/page": [
       "static/chunks/webpack-ef515e41a83a16ac.js",
       "static/chunks/0937d497-114a2a3de515565e.js",
       "static/chunks/89-b194fcffe5120c44.js",
       "static/chunks/main-app-6086068e5fb5eacd.js",
       "static/chunks/586-f7017d585a84738d.js",
       "static/chunks/706-fa2be0f10ffebe6a.js",
-      "static/chunks/281-d8a0dcfaa6d064e4.js",
+      "static/chunks/281-113274e705940a55.js",
       "static/chunks/517-373a80c8ba432bdc.js",
-      "static/chunks/app/agents/page-9bb8cba69776c719.js"
+      "static/chunks/app/chat/page-5261b12b7d50f5d1.js"
     ],
-    "/resources/page": [
+    "/relations/page": [
       "static/chunks/webpack-ef515e41a83a16ac.js",
       "static/chunks/0937d497-114a2a3de515565e.js",
       "static/chunks/89-b194fcffe5120c44.js",
       "static/chunks/main-app-6086068e5fb5eacd.js",
+      "static/css/c4a545148b5320ec.css",
+      "static/chunks/2b9ff8ee-969e65cc354b2150.js",
       "static/chunks/586-f7017d585a84738d.js",
-      "static/chunks/706-fa2be0f10ffebe6a.js",
-      "static/chunks/837-33c7480524f48577.js",
-      "static/chunks/304-681348099f874a30.js",
-      "static/chunks/581-3ad5c4343dad3f50.js",
-      "static/chunks/281-d8a0dcfaa6d064e4.js",
-      "static/chunks/517-373a80c8ba432bdc.js",
-      "static/chunks/350-0fe82e622e7a670f.js",
-      "static/chunks/291-23f314877fa39054.js",
-      "static/chunks/844-519177e6198ca84f.js",
-      "static/chunks/30-9adcbe92b15a6815.js",
-      "static/chunks/491-28f093772bd460ac.js",
-      "static/chunks/app/resources/page-800f774e5cacf4c9.js"
+      "static/chunks/562-7c2e33d838e869bf.js",
+      "static/chunks/281-113274e705940a55.js",
+      "static/chunks/app/relations/page-a44fd515a3b0525e.js"
     ],
-    "/resources/[id]/page": [
+    "/agents/[id]/page": [
       "static/chunks/webpack-ef515e41a83a16ac.js",
       "static/chunks/0937d497-114a2a3de515565e.js",
       "static/chunks/89-b194fcffe5120c44.js",
@@ -65,104 +58,120 @@
       "static/chunks/586-f7017d585a84738d.js",
       "static/chunks/706-fa2be0f10ffebe6a.js",
       "static/chunks/837-33c7480524f48577.js",
-      "static/chunks/304-681348099f874a30.js",
-      "static/chunks/581-3ad5c4343dad3f50.js",
-      "static/chunks/281-d8a0dcfaa6d064e4.js",
+      "static/chunks/391-18768499e741112e.js",
+      "static/chunks/316-26da9cc233ba7557.js",
+      "static/chunks/281-113274e705940a55.js",
       "static/chunks/517-373a80c8ba432bdc.js",
       "static/chunks/350-0fe82e622e7a670f.js",
-      "static/chunks/291-23f314877fa39054.js",
-      "static/chunks/844-519177e6198ca84f.js",
+      "static/chunks/606-c9a19918b02a98d0.js",
       "static/chunks/30-9adcbe92b15a6815.js",
-      "static/chunks/491-28f093772bd460ac.js",
-      "static/chunks/app/resources/[id]/page-bf05836f97248ca7.js"
+      "static/chunks/705-f81face97b1bb1af.js",
+      "static/chunks/app/agents/[id]/page-6ed6edb3e74b0ebe.js"
     ],
-    "/schedules/page": [
+    "/agents/page": [
       "static/chunks/webpack-ef515e41a83a16ac.js",
       "static/chunks/0937d497-114a2a3de515565e.js",
       "static/chunks/89-b194fcffe5120c44.js",
       "static/chunks/main-app-6086068e5fb5eacd.js",
       "static/chunks/586-f7017d585a84738d.js",
-      "static/chunks/281-d8a0dcfaa6d064e4.js",
-      "static/chunks/app/schedules/page-96976fff4ee23538.js"
+      "static/chunks/706-fa2be0f10ffebe6a.js",
+      "static/chunks/281-113274e705940a55.js",
+      "static/chunks/517-373a80c8ba432bdc.js",
+      "static/chunks/app/agents/page-9bb8cba69776c719.js"
     ],
-    "/skills/page": [
+    "/resources/[id]/page": [
       "static/chunks/webpack-ef515e41a83a16ac.js",
       "static/chunks/0937d497-114a2a3de515565e.js",
       "static/chunks/89-b194fcffe5120c44.js",
       "static/chunks/main-app-6086068e5fb5eacd.js",
       "static/chunks/586-f7017d585a84738d.js",
       "static/chunks/706-fa2be0f10ffebe6a.js",
-      "static/chunks/281-d8a0dcfaa6d064e4.js",
-      "static/chunks/app/skills/page-bc1acd0663f36129.js"
+      "static/chunks/837-33c7480524f48577.js",
+      "static/chunks/391-18768499e741112e.js",
+      "static/chunks/281-113274e705940a55.js",
+      "static/chunks/517-373a80c8ba432bdc.js",
+      "static/chunks/350-0fe82e622e7a670f.js",
+      "static/chunks/606-c9a19918b02a98d0.js",
+      "static/chunks/587-8e4d2be01ba7d48f.js",
+      "static/chunks/30-9adcbe92b15a6815.js",
+      "static/chunks/656-f537149fe28f79aa.js",
+      "static/chunks/app/resources/[id]/page-fc494e85b01e8cb7.js"
     ],
-    "/sessions/page": [
+    "/resources/page": [
       "static/chunks/webpack-ef515e41a83a16ac.js",
       "static/chunks/0937d497-114a2a3de515565e.js",
       "static/chunks/89-b194fcffe5120c44.js",
       "static/chunks/main-app-6086068e5fb5eacd.js",
       "static/chunks/586-f7017d585a84738d.js",
       "static/chunks/706-fa2be0f10ffebe6a.js",
-      "static/chunks/654-92a63b3c4b412666.js",
-      "static/chunks/281-d8a0dcfaa6d064e4.js",
+      "static/chunks/837-33c7480524f48577.js",
+      "static/chunks/391-18768499e741112e.js",
+      "static/chunks/281-113274e705940a55.js",
+      "static/chunks/517-373a80c8ba432bdc.js",
       "static/chunks/350-0fe82e622e7a670f.js",
-      "static/chunks/705-780e48e55b0346bd.js",
-      "static/chunks/app/sessions/page-a7534ebd90e982d6.js"
+      "static/chunks/606-c9a19918b02a98d0.js",
+      "static/chunks/587-8e4d2be01ba7d48f.js",
+      "static/chunks/30-9adcbe92b15a6815.js",
+      "static/chunks/656-f537149fe28f79aa.js",
+      "static/chunks/app/resources/page-61cccd8fdcc2f6c8.js"
     ],
-    "/types/page": [
+    "/page": [
       "static/chunks/webpack-ef515e41a83a16ac.js",
       "static/chunks/0937d497-114a2a3de515565e.js",
       "static/chunks/89-b194fcffe5120c44.js",
       "static/chunks/main-app-6086068e5fb5eacd.js",
       "static/chunks/586-f7017d585a84738d.js",
       "static/chunks/706-fa2be0f10ffebe6a.js",
-      "static/chunks/281-d8a0dcfaa6d064e4.js",
+      "static/chunks/391-18768499e741112e.js",
+      "static/chunks/281-113274e705940a55.js",
       "static/chunks/517-373a80c8ba432bdc.js",
-      "static/chunks/app/types/page-ebd37e220f77c1f3.js"
+      "static/chunks/350-0fe82e622e7a670f.js",
+      "static/chunks/606-c9a19918b02a98d0.js",
+      "static/chunks/587-8e4d2be01ba7d48f.js",
+      "static/chunks/app/page-99e0351e6ccaa384.js"
     ],
-    "/agents/[id]/page": [
+    "/schedules/page": [
+      "static/chunks/webpack-ef515e41a83a16ac.js",
+      "static/chunks/0937d497-114a2a3de515565e.js",
+      "static/chunks/89-b194fcffe5120c44.js",
+      "static/chunks/main-app-6086068e5fb5eacd.js",
+      "static/chunks/586-f7017d585a84738d.js",
+      "static/chunks/281-113274e705940a55.js",
+      "static/chunks/app/schedules/page-96976fff4ee23538.js"
+    ],
+    "/sessions/page": [
       "static/chunks/webpack-ef515e41a83a16ac.js",
       "static/chunks/0937d497-114a2a3de515565e.js",
       "static/chunks/89-b194fcffe5120c44.js",
       "static/chunks/main-app-6086068e5fb5eacd.js",
       "static/chunks/586-f7017d585a84738d.js",
       "static/chunks/706-fa2be0f10ffebe6a.js",
-      "static/chunks/837-33c7480524f48577.js",
-      "static/chunks/304-681348099f874a30.js",
-      "static/chunks/316-26da9cc233ba7557.js",
-      "static/chunks/281-d8a0dcfaa6d064e4.js",
-      "static/chunks/517-373a80c8ba432bdc.js",
+      "static/chunks/654-92a63b3c4b412666.js",
+      "static/chunks/281-113274e705940a55.js",
       "static/chunks/350-0fe82e622e7a670f.js",
-      "static/chunks/291-23f314877fa39054.js",
-      "static/chunks/30-9adcbe92b15a6815.js",
-      "static/chunks/705-780e48e55b0346bd.js",
-      "static/chunks/app/agents/[id]/page-c005161cec5527d8.js"
+      "static/chunks/705-f81face97b1bb1af.js",
+      "static/chunks/app/sessions/page-a7534ebd90e982d6.js"
     ],
-    "/relations/page": [
+    "/types/page": [
       "static/chunks/webpack-ef515e41a83a16ac.js",
       "static/chunks/0937d497-114a2a3de515565e.js",
       "static/chunks/89-b194fcffe5120c44.js",
       "static/chunks/main-app-6086068e5fb5eacd.js",
-      "static/css/c4a545148b5320ec.css",
-      "static/chunks/2b9ff8ee-969e65cc354b2150.js",
       "static/chunks/586-f7017d585a84738d.js",
-      "static/chunks/562-7c2e33d838e869bf.js",
-      "static/chunks/281-d8a0dcfaa6d064e4.js",
-      "static/chunks/app/relations/page-a44fd515a3b0525e.js"
+      "static/chunks/706-fa2be0f10ffebe6a.js",
+      "static/chunks/281-113274e705940a55.js",
+      "static/chunks/517-373a80c8ba432bdc.js",
+      "static/chunks/app/types/page-ebd37e220f77c1f3.js"
     ],
-    "/page": [
+    "/skills/page": [
       "static/chunks/webpack-ef515e41a83a16ac.js",
       "static/chunks/0937d497-114a2a3de515565e.js",
       "static/chunks/89-b194fcffe5120c44.js",
       "static/chunks/main-app-6086068e5fb5eacd.js",
       "static/chunks/586-f7017d585a84738d.js",
       "static/chunks/706-fa2be0f10ffebe6a.js",
-      "static/chunks/304-681348099f874a30.js",
-      "static/chunks/281-d8a0dcfaa6d064e4.js",
-      "static/chunks/517-373a80c8ba432bdc.js",
-      "static/chunks/350-0fe82e622e7a670f.js",
-      "static/chunks/291-23f314877fa39054.js",
-      "static/chunks/844-519177e6198ca84f.js",
-      "static/chunks/app/page-da042d146caeeab6.js"
+      "static/chunks/281-113274e705940a55.js",
+      "static/chunks/app/skills/page-bc1acd0663f36129.js"
     ]
   }
 }

package/web/.next/app-path-routes-manifest.json

@@ -1,17 +1,18 @@
 {
   "/_not-found/page": "/_not-found",
   "/apple-icon.png/route": "/apple-icon.png",
-  "/icon.png/route": "/icon.png",
   "/favicon.ico/route": "/favicon.ico",
+  "/icon.png/route": "/icon.png",
   "/connections/page": "/connections",
+  "/chat/page": "/chat",
+  "/relations/page": "/relations",
+  "/agents/[id]/page": "/agents/[id]",
   "/agents/page": "/agents",
-  "/resources/page": "/resources",
   "/resources/[id]/page": "/resources/[id]",
+  "/resources/page": "/resources",
+  "/page": "/",
   "/schedules/page": "/schedules",
-  "/skills/page": "/skills",
   "/sessions/page": "/sessions",
   "/types/page": "/types",
-  "/agents/[id]/page": "/agents/[id]",
-  "/relations/page": "/relations",
-  "/page": "/"
+  "/skills/page": "/skills"
 }

package/web/.next/build-manifest.json

@@ -5,8 +5,8 @@
   "devFiles": [],
   "ampDevFiles": [],
   "lowPriorityFiles": [
-    "static/aSYzbHk1M5YeS_d3SQKTZ/_buildManifest.js",
-    "static/aSYzbHk1M5YeS_d3SQKTZ/_ssgManifest.js"
+    "static/YT6HM6qmegMJaBMX5QvuP/_buildManifest.js",
+    "static/YT6HM6qmegMJaBMX5QvuP/_ssgManifest.js"
   ],
   "rootMainFiles": [
     "static/chunks/webpack-ef515e41a83a16ac.js",