strom-research 1.19.0-beta.3 → 1.19.0-beta.4

package/CHANGELOG.cs.md

@@ -7,7 +7,7 @@ Změny každé verze ve zkratce. Úplné poznámky a instalační řádky jsou n
 
 ## 1.19.0
 
-*Připravuje se: bety do 1.19.0-beta.3. Oddíl bude úplný s vydáním.*
+*Připravuje se: bety do 1.19.0-beta.4. Oddíl bude úplný s vydáním.*
 
 - **Na archiv, který zmlkl, se čeká, místo opakovaných dotazů.** Když archiv přestane odpovídat, strom ho nechá na
   pokoji hodinu — a když týž den mlčí dál, dvě a pak čtyři hodiny — a agent se dozví, do kdy: mezitím dělá

package/CHANGELOG.de.md

@@ -7,7 +7,7 @@ Die Änderungen jeder Version in Kürze. Die vollständigen Hinweise und die Ins
 
 ## 1.19.0
 
-*In Vorbereitung: die Betas bis 1.19.0-beta.3. Der Abschnitt ist mit dem Release vollständig.*
+*In Vorbereitung: die Betas bis 1.19.0-beta.4. Der Abschnitt ist mit dem Release vollständig.*
 
 - **Auf ein verstummtes Archiv wird gewartet, statt es immer wieder zu fragen.** Antwortet ein Archiv nicht mehr,
   lässt strom es eine Stunde in Ruhe — zwei, dann vier, wenn es am selben Tag still bleibt — und der Agent erfährt, bis

package/CHANGELOG.md

@@ -7,7 +7,7 @@ The changes of each version in short. The full notes and the install lines are o
 
 ## 1.19.0
 
-*In preparation: the betas up to 1.19.0-beta.3. The section is complete with the release.*
+*In preparation: the betas up to 1.19.0-beta.4. The section is complete with the release.*
 
 - **An archive that went silent is waited for, not asked again and again.** When an archive stops answering, strom
   leaves it alone for an hour — two, then four when it stays silent the same day — and the agent hears until when:

package/dist/commands/document.js

@@ -246,7 +246,7 @@ async function readWith(ctx, tree, s, opts, only) {
     }
     const team = readers(ctx, tree, shared, "document", "1", opts, undefined, { stem: s.id });
     const views = s.pages.map((p) => viewsOf(tree, shared, p, team.viewMax));
-    s = { ...s, groups: groupsOf(views), state: "reading", since: now(), pid: process.pid, ...(team.model ? { model: team.model } : {}) };
+    s = { ...s, groups: groupsOf(views), state: "reading", since: now(), pid: process.pid, agent: team.agent, ...(team.model ? { model: team.model } : {}) };
     saveState(tree.root, s);
     const stop = new AbortController();
     const look = setInterval(() => {

package/dist/commands/readers.js

@@ -189,5 +189,5 @@ export function readers(ctx, tree, shared, kind, first, opts, reportsAt, own = {
             fs.appendFileSync(report, r.text.trim() + "\n");
         return { report, text: fs.readFileSync(report, "utf8"), outcome: r.outcome, ...(r.metrics.costUsd !== undefined ? { costUsd: r.metrics.costUsd } : {}), ...(r.metrics.costPartial ? { costPartial: true } : {}), ...(r.resumeAt ? { resumeAt: r.resumeAt } : {}) };
     };
-    return { model, viewMax: sizes.read, parallel, stem, reportsDir, read, cost: () => cost, runs: () => runs, partial: () => partial, failed, progress };
+    return { agent: agentId, model, viewMax: sizes.read, parallel, stem, reportsDir, read, cost: () => cost, runs: () => runs, partial: () => partial, failed, progress };
 }

package/dist/core/live-read.js

@@ -27,6 +27,8 @@ import { EXIT } from "./errors.js";
 import { forApp, refusal } from "./receive.js";
 import { stromLauncher } from "./self.js";
 import { normId } from "./records.js";
+import { metricsDir } from "./metrics.js";
+import { readJournal } from "./readstats.js";
 /** The readings the app may ask, unless the person set others (read.app). */
 export const APP_READ_DEFAULT = { hour: 20, day: 60 };
 /** Readings of the app waiting beside the one being read. */
@@ -213,12 +215,12 @@ export class ReadingsSeen {
         };
     }
 }
-/** /status reads: those at work, and those ended in the last week. */
-export function statusReads(seen, now = Date.now()) {
+/** /status reads: those at work (with the seconds each is expected to take: expectSecs), and those ended in the last week. */
+export function statusReads(seen, agentNow, now = Date.now()) {
     return seen
         .all()
-        .map((r) => r.read)
-        .filter((r) => !FINAL_STATES.includes(r.state) || Date.parse(r.since) > now - STATUS_DAYS * DAY_MS);
+        .filter((r) => !FINAL_STATES.includes(r.read.state) || Date.parse(r.read.since) > now - STATUS_DAYS * DAY_MS)
+        .map((r) => (r.state && !FINAL_STATES.includes(r.read.state) ? { ...r.read, expectSecs: expectOf(seen.root, r.state, agentNow) } : r.read));
 }
 /**
  * GET /reads: the last 90 days, and every reading no source of the research is of. inSource: a source of this tree —
@@ -268,6 +270,7 @@ export function readAccepts(tree, settings, env, seen, now = Date.now()) {
         max: READ_MAX_BYTES,
         pages: DOC_PAGES,
         langs: readLangs(),
+        ...(not ? {} : { expectSecs: expectSecs(tree.root, settings.agent(tree.config).value) }),
     };
 }
 function notReady(tree, settings, env, seen, now) {
@@ -296,6 +299,55 @@ function notReady(tree, settings, env, seen, now) {
     }
     return undefined;
 }
+// ── how long a reading takes ────────────────────────────────────────────────────────────────────────────────────
+/** A reading's seconds before any of this agent's readers ended here (measured 2026-10-20 and 21): Grok's take minutes. */
+export const READ_EXPECT_DEFAULT = { grok: 240 };
+export const READ_EXPECT_OTHERS = 60;
+/** The readers of documents a reading's time is learned from: the last so many of the agent that read to an end. */
+const EXPECT_LAST = 9;
+const expectSeen = new Map();
+/** How long this agent's readers of documents took here (.strom/metrics/readers.jsonl, nothing of the tree), oldest first. */
+function readerSecs(root, agent) {
+    const file = path.join(metricsDir(root), "readers.jsonl");
+    let key = "-";
+    try {
+        const st = fs.statSync(file);
+        key = `${st.mtimeMs}:${st.size}`;
+    }
+    catch {
+        return [];
+    }
+    let had = expectSeen.get(file);
+    if (had?.key !== key) {
+        const secs = new Map();
+        for (const r of readJournal(file)) {
+            const ms = typeof r.wallMs === "number" ? r.wallMs : typeof r.ms === "number" ? r.ms : NaN;
+            if (r.kind !== "document" || r.outcome !== "ok" || typeof r.agent !== "string" || !(ms >= 0))
+                continue;
+            secs.set(r.agent, [...(secs.get(r.agent) ?? []), ms / 1000].slice(-EXPECT_LAST));
+        }
+        had = { key, secs };
+        expectSeen.set(file, had);
+    }
+    return had.secs.get(agent) ?? [];
+}
+/**
+ * The seconds one reading is expected to take with this agent (`rounds`: its readers one after another, a long
+ * document's parts beyond the readers at work at once): the median of its last readers of documents here, else what
+ * the agent's readers took when measured — for the app to say a reading takes minutes, never a promise.
+ */
+export function expectSecs(root, agent, rounds = 1) {
+    const secs = readerSecs(root, agent).sort((a, b) => a - b);
+    const mid = secs.length >> 1;
+    const one = secs.length ? (secs.length % 2 ? secs[mid] : (secs[mid - 1] + secs[mid]) / 2) : (READ_EXPECT_DEFAULT[agent] ?? READ_EXPECT_OTHERS);
+    return Math.max(1, Math.round(one * Math.max(1, rounds)));
+}
+/** A reading at work or queued: how long it is expected to take from its start (since, when it is reading). */
+function expectOf(root, s, agentNow) {
+    // each part of the document read by the first reader and the blind one, as many at once as the readers asked, three at least
+    const jobs = Math.max(1, s.groups.length) * ((s.only === "blind" ? 0 : 1) + (s.readers > 1 ? 1 : 0));
+    return expectSecs(root, s.agent ?? agentNow, Math.ceil(jobs / Math.max(3, s.readers)));
+}
 const BODY_MAX = 16 * 1024;
 /** The names of files sent to be read kept until they are asked (the last ones). */
 const NAMES_KEPT = 200;
@@ -394,7 +446,10 @@ export class AppReadings {
             return this.json(res, n.code, n.body);
         }
         const r = resultForApp(got.result);
-        this.json(res, 200, { ...r, pages: r.pages.map((p) => ({ ...p, image: `read/${id}/page/${p.n}.jpg` })) });
+        // at work or queued: how long it is expected to take from its start
+        const s = FINAL_STATES.includes(got.result.state) ? undefined : loadState(this.b.root, id);
+        const expect = s ? { expectSecs: expectOf(this.b.root, s, this.b.settings().agent(got.tree.config).value) } : {};
+        this.json(res, 200, { ...r, ...expect, pages: r.pages.map((p) => ({ ...p, image: `read/${id}/page/${p.n}.jpg` })) });
     }
     /** GET /read/<id>/page/<n>.jpg: the page upright as a JPEG of 2000 px at most (a HEIC's, a PDF's page too). */
     page(res, id, rest) {

package/dist/core/live.js

@@ -1211,7 +1211,7 @@ function status(root, env, version, seen) {
         ...(intake ? { lastIntake: intake } : {}),
         accepts: accepts(tree, settings, env, seen),
         // the documents the app asked to be read and the research's own readings: at work, and ended in the last week
-        ...(archive || !seen ? {} : { reads: statusReads(seen) }),
+        ...(archive || !seen ? {} : { reads: statusReads(seen, settings.agent(tree.config).value) }),
         inbox: { trees: inboxTrees(root, env), material: materialWaiting(tree) },
         sends: recentSends(root, tree),
         batches: batchStatus(tree),

package/dist/core/tree.js

@@ -27,7 +27,7 @@ import { lastBackup } from "./backup.js";
 export const TREE_FILE = "strom.json";
 // between releases the candidate being made (a bridge run from the sources says what it is: the Strom app goes by it);
 // at a release the release's own (package.json)
-export const VERSION = "1.19.0-beta.3";
+export const VERSION = "1.19.0-beta.4";
 const GITIGNORE = `# Strom Research — local state and large files are not versioned
 .strom/
 /media/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "strom-research",
-  "version": "1.19.0-beta.3",
+  "version": "1.19.0-beta.4",
   "description": "Genealogical research toolkit for AI coding agents",
   "type": "module",
   "bin": {