@maudecode/talaria-web 0.0.0

package/dist/tools/hygiene.js

@@ -0,0 +1,112 @@
+/**
+ * Periodic process hygiene (Python `background_process._run_process_hygiene`
+ * and `logging_hygiene.rotate_webui_log`): copy-truncate log rotation every
+ * tick, run-journal retention on a long interval. Node closes session
+ * channels on the last unsubscribe, so the channel reaper has nothing to do.
+ */
+import { closeSync, existsSync, fstatSync, ftruncateSync, openSync, readSync } from 'node:fs';
+import { writeFully } from '../fs/atomic.js';
+import { join } from 'node:path';
+export const HYGIENE_INTERVAL_MS = 60_000;
+const RETENTION_INTERVAL_S = 6 * 3600;
+const LOG_DEFAULT_MAX_BYTES = 32 * 1024 * 1024;
+/** Python `webui_log_paths`: an absolute `HERMES_WEBUI_LOG_FILE` wins, else the launcher's `bootstrap-<port>.log`. */
+export function webuiLogPaths(env, stateDir, port) {
+    const configured = (env.HERMES_WEBUI_LOG_FILE ?? '').trim();
+    if (configured.startsWith('/'))
+        return [configured];
+    return [join(stateDir, `bootstrap-${String(port)}.log`)];
+}
+export function webuiLogMaxBytes(env) {
+    const raw = env.HERMES_WEBUI_LOG_MAX_BYTES;
+    if (raw === undefined)
+        return LOG_DEFAULT_MAX_BYTES;
+    const n = Number.parseInt(raw, 10);
+    return Number.isFinite(n) ? n : LOG_DEFAULT_MAX_BYTES;
+}
+/** Python `_rotate_one`: copy the oversized sink into `<log>.1` and truncate the same descriptor in place. */
+export function rotateOne(target, limit, log) {
+    let fd;
+    try {
+        fd = openSync(target, 'r+');
+    }
+    catch {
+        return false;
+    }
+    try {
+        const size = fstatSync(fd).size;
+        if (size <= limit)
+            return false;
+        const previous = `${target}.1`;
+        const out = openSync(previous, 'w');
+        try {
+            const buf = Buffer.alloc(1 << 16);
+            let offset = 0;
+            for (;;) {
+                const n = readSync(fd, buf, 0, buf.length, offset);
+                if (n <= 0)
+                    break;
+                writeFully(out, buf.subarray(0, n));
+                offset += n;
+            }
+        }
+        finally {
+            closeSync(out);
+        }
+        ftruncateSync(fd, 0);
+        log(`[webui] Rotated the WebUI log at ${target} (${String(size)} bytes) into ${previous}`);
+        return true;
+    }
+    catch (error) {
+        log(`[webui] WARNING: Could not rotate the WebUI log at ${target}: ${error.message}`);
+        return false;
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+export function rotateWebuiLog(paths, limit, log) {
+    if (limit <= 0)
+        return false;
+    return paths.filter(existsSync).map((p) => rotateOne(p, limit, log)).some(Boolean);
+}
+export class HygieneTicker {
+    deps;
+    timer = null;
+    retentionLastRun = null;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    start(intervalMs = HYGIENE_INTERVAL_MS) {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => { this.tick(); }, intervalMs);
+        this.timer.unref();
+    }
+    stop() { if (this.timer) {
+        clearInterval(this.timer);
+        this.timer = null;
+    } }
+    /** Python `_run_process_hygiene`: every step is best effort. */
+    tick() {
+        const step = (label, run) => { try {
+            run();
+        }
+        catch (error) {
+            this.deps.log(`[webui] WARNING: ${label} failed: ${error.message}`);
+        } };
+        step('WebUI log rotation', () => { rotateWebuiLog(webuiLogPaths(this.deps.env, this.deps.stateDir, this.deps.port()), webuiLogMaxBytes(this.deps.env), this.deps.log); });
+        for (const sweep of this.deps.sweeps ?? [])
+            step('hygiene sweep', sweep);
+        const now = this.deps.now();
+        if (this.retentionLastRun !== null && now - this.retentionLastRun < RETENTION_INTERVAL_S)
+            return;
+        this.retentionLastRun = now;
+        step('run-journal retention', () => {
+            const result = this.deps.journal.pruneSettled({ now, isActive: (path) => this.deps.activeJournalPaths().has(path) });
+            if (result.pruned)
+                this.deps.log(`[webui] run-journal retention pruned ${String(result.pruned)} files (${String(result.bytes_reclaimed)} bytes)`);
+        });
+    }
+}
+//# sourceMappingURL=hygiene.js.map

package/dist/tools/hygiene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hygiene.js","sourceRoot":"","sources":["../../src/tools/hygiene.ts"],"names":[],"mappings":"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"}

package/dist/tools/insights.d.ts

@@ -0,0 +1,3 @@
+/** Usage analytics from the session index (Python `_handle_insights`). ponytail: the state.db CLI-session merge is not ported. */
+import type { Dict } from '../config/agent-config.js';
+export declare function buildInsights(entries: Dict[], daysRaw: unknown, nowSeconds: number): Dict;

package/dist/tools/insights.js

@@ -0,0 +1,92 @@
+import { str } from '../util.js';
+const num = (v) => { const n = Number.parseFloat(str(v)); return Number.isFinite(n) && n > 0 ? Math.trunc(n) : 0; };
+const cost = (v) => {
+    if (v === null || v === undefined)
+        return 0;
+    const text = typeof v === 'string' ? v.trim().replaceAll('$', '').replaceAll(',', '') : str(v);
+    if (!text)
+        return 0;
+    const n = Number.parseFloat(text);
+    return Number.isFinite(n) && n > 0 ? n : 0;
+};
+function cacheHitPercent(cacheRead, prompt) {
+    if (cacheRead <= 0 || prompt <= 0)
+        return null;
+    return Math.min(100, Math.round((cacheRead / prompt) * 100));
+}
+export function buildInsights(entries, daysRaw, nowSeconds) {
+    const parsed = Number.parseInt(str(daysRaw ?? '30'), 10);
+    const days = Number.isFinite(parsed) ? Math.min(Math.max(parsed, 1), 365) : 30;
+    const today = new Date(nowSeconds * 1000);
+    const midnight = new Date(today.getFullYear(), today.getMonth(), today.getDate()).getTime() / 1000;
+    const cutoff = midnight - (days - 1) * 86_400;
+    const sessions = entries.filter((e) => Math.max(num(e.created_at), num(e.updated_at)) >= cutoff);
+    let totalMessages = 0;
+    let totalInput = 0;
+    let totalOutput = 0;
+    let totalCache = 0;
+    let totalCost = 0;
+    const models = new Map();
+    const daily = new Map();
+    const dow = new Array(7).fill(0);
+    const hod = new Array(24).fill(0);
+    for (const s of sessions) {
+        const input = num(s.input_tokens);
+        const output = num(s.output_tokens);
+        const cache = num(s.cache_read_tokens);
+        const c = cost(s.estimated_cost);
+        totalMessages += num(s.message_count);
+        totalInput += input;
+        totalOutput += output;
+        totalCache += cache;
+        totalCost += c;
+        const model = str(s.model) || 'unknown';
+        const bucket = models.get(model) ?? { sessions: 0, input_tokens: 0, output_tokens: 0, cache_read_tokens: 0, cost: 0 };
+        bucket.sessions += 1;
+        bucket.input_tokens += input;
+        bucket.output_tokens += output;
+        bucket.cache_read_tokens += cache;
+        bucket.cost += c;
+        models.set(model, bucket);
+        const ts = num(s.updated_at) || num(s.created_at);
+        if (ts) {
+            const d = new Date(ts * 1000);
+            const key = `${String(d.getFullYear())}-${String(d.getMonth() + 1).padStart(2, '0')}-${String(d.getDate()).padStart(2, '0')}`;
+            const day = daily.get(key) ?? { input_tokens: 0, output_tokens: 0, cache_read_tokens: 0, sessions: 0, cost: 0 };
+            day.input_tokens += input;
+            day.output_tokens += output;
+            day.cache_read_tokens += cache;
+            day.sessions += 1;
+            day.cost += c;
+            daily.set(key, day);
+            dow[(d.getDay() + 6) % 7] = (dow[(d.getDay() + 6) % 7] ?? 0) + 1;
+            hod[d.getHours()] = (hod[d.getHours()] ?? 0) + 1;
+        }
+    }
+    const totalSessions = sessions.length;
+    const totalTokens = totalInput + totalOutput;
+    const breakdown = [...models.entries()].map(([model, stats]) => {
+        const rowTotal = stats.input_tokens + stats.output_tokens;
+        const rowCost = Math.round(stats.cost * 1e6) / 1e6;
+        return {
+            model, sessions: stats.sessions, input_tokens: stats.input_tokens, output_tokens: stats.output_tokens, cache_read_tokens: stats.cache_read_tokens,
+            cache_hit_percent: cacheHitPercent(stats.cache_read_tokens, stats.input_tokens + stats.cache_read_tokens), total_tokens: rowTotal, cost: rowCost,
+            session_share: totalSessions ? Math.round((stats.sessions / totalSessions) * 100) : 0, token_share: totalTokens ? Math.round((rowTotal / totalTokens) * 100) : 0, cost_share: totalCost ? Math.round((rowCost / totalCost) * 100) : 0,
+        };
+        // Python: `(-cost, -sessions, model)`.
+    }).sort((a, b) => b.cost - a.cost || b.sessions - a.sessions || (a.model < b.model ? -1 : a.model > b.model ? 1 : 0));
+    const series = [];
+    for (let i = 0; i < days; i += 1) {
+        const d = new Date((cutoff + i * 86_400) * 1000);
+        const key = `${String(d.getFullYear())}-${String(d.getMonth() + 1).padStart(2, '0')}-${String(d.getDate()).padStart(2, '0')}`;
+        const b = daily.get(key) ?? { input_tokens: 0, output_tokens: 0, cache_read_tokens: 0, sessions: 0, cost: 0 };
+        series.push({ date: key, input_tokens: b.input_tokens, output_tokens: b.output_tokens, cache_read_tokens: b.cache_read_tokens, sessions: b.sessions, cost: Math.round(b.cost * 1e6) / 1e6 });
+    }
+    const labels = ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'];
+    return {
+        period_days: days, total_sessions: totalSessions, total_messages: totalMessages, total_input_tokens: totalInput, total_output_tokens: totalOutput, total_cache_read_tokens: totalCache,
+        total_cache_hit_percent: cacheHitPercent(totalCache, totalInput + totalCache), total_tokens: totalTokens, total_cost: Math.round(totalCost * 1e6) / 1e6, models: breakdown, daily_tokens: series,
+        activity_by_day: labels.map((day, i) => ({ day, sessions: dow[i] ?? 0 })), activity_by_hour: hod.map((sessions, hour) => ({ hour, sessions })),
+    };
+}
+//# sourceMappingURL=insights.js.map

package/dist/tools/insights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insights.js","sourceRoot":"","sources":["../../src/tools/insights.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAEhC,MAAM,GAAG,GAAG,CAAC,CAAU,EAAU,EAAE,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA,CAAC,CAAC,CAAA;AACnI,MAAM,IAAI,GAAG,CAAC,CAAU,EAAU,EAAE;IAClC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAA;IAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IAC9F,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAA;IACnB,MAAM,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IACjC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC5C,CAAC,CAAA;AAED,SAAS,eAAe,CAAC,SAAiB,EAAE,MAAc;IACxD,IAAI,SAAS,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAA;AAC9D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,OAAgB,EAAE,UAAkB;IACjF,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;IACxD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC9E,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,CAAA;IACzC,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAA;IAClG,MAAM,MAAM,GAAG,QAAQ,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAA;IAC7C,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,MAAM,CAAC,CAAA;IAChG,IAAI,aAAa,GAAG,CAAC,CAAA;IACrB,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,IAAI,WAAW,GAAG,CAAC,CAAA;IACnB,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,IAAI,SAAS,GAAG,CAAC,CAAA;IACjB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAsH,CAAA;IAC5I,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsH,CAAA;IAC3I,MAAM,GAAG,GAAG,IAAI,KAAK,CAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACxC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACzC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAA;QACjC,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAA;QACnC,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAA;QACtC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,CAAA;QAChC,aAAa,IAAI,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAA;QACrC,UAAU,IAAI,KAAK,CAAA;QACnB,WAAW,IAAI,MAAM,CAAA;QACrB,UAAU,IAAI,KAAK,CAAA;QACnB,SAAS,IAAI,CAAC,CAAA;QACd,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,SAAS,CAAA;QACvC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;QACrH,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAA;QACpB,MAAM,CAAC,YAAY,IAAI,KAAK,CAAA;QAC5B,MAAM,CAAC,aAAa,IAAI,MAAM,CAAA;QAC9B,MAAM,CAAC,iBAAiB,IAAI,KAAK,CAAA;QACjC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAA;QAChB,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QACzB,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;QACjD,IAAI,EAAE,EAAE,CAAC;YACP,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,CAAA;YAC7B,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAA;YAC7H,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;YAC/G,GAAG,CAAC,YAAY,IAAI,KAAK,CAAA;YACzB,GAAG,CAAC,aAAa,IAAI,MAAM,CAAA;YAC3B,GAAG,CAAC,iBAAiB,IAAI,KAAK,CAAA;YAC9B,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAA;YACjB,GAAG,CAAC,IAAI,IAAI,CAAC,CAAA;YACb,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;YACnB,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;YAChE,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;QAClD,CAAC;IACH,CAAC;IACD,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAA;IACrC,MAAM,WAAW,GAAG,UAAU,GAAG,WAAW,CAAA;IAC5C,MAAM,SAAS,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE;QAC7D,MAAM,QAAQ,GAAG,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,aAAa,CAAA;QACzD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,GAAG,CAAA;QAClD,OAAO;YACL,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;YACjJ,iBAAiB,EAAE,eAAe,CAAC,KAAK,CAAC,iBAAiB,EAAE,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,iBAAiB,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO;YAChJ,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,QAAQ,GAAG,aAAa,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,WAAW,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;SACtO,CAAA;QACH,uCAAuC;IACvC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACrH,MAAM,MAAM,GAAW,EAAE,CAAA;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,CAAA;QAChD,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAA;QAC7H,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;QAC7G,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,aAAa,EAAE,CAAC,CAAC,aAAa,EAAE,iBAAiB,EAAE,CAAC,CAAC,iBAAiB,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,CAAA;IAC9L,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;IAChE,OAAO;QACL,WAAW,EAAE,IAAI,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,UAAU,EAAE,mBAAmB,EAAE,WAAW,EAAE,uBAAuB,EAAE,UAAU;QACtL,uBAAuB,EAAE,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,GAAG,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM;QAChM,eAAe,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,gBAAgB,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;KAC/I,CAAA;AACH,CAAC"}

package/dist/tools/kanban.d.ts

@@ -0,0 +1,25 @@
+/** Kanban HTTP shapes over the sidecar `kanban.*` namespace (Python `api/kanban_bridge.py`). */
+import type { SidecarLike } from '../sidecar/client.js';
+import type { AgentConfig, Dict } from '../config/agent-config.js';
+export declare const truthyQuery: (v: unknown) => boolean;
+export declare function intQuery(raw: unknown, fallback: number | null, min?: number, max?: number): number | null;
+/** Sidecar `InvalidParams` → 400, `not_found` → 404, `RuntimeError`-class refusals → 409 (Python dispatcher mapping). */
+export declare function kanbanFailure(error: unknown): never;
+export declare class KanbanService {
+    private readonly deps;
+    constructor(deps: {
+        sidecar: () => SidecarLike | null;
+        config: AgentConfig;
+    });
+    sidecar(): SidecarLike;
+    board(home: string, q: {
+        board?: string | undefined;
+        tenant?: string | undefined;
+        assignee?: string | undefined;
+        include_archived?: string | undefined;
+        only_mine?: string | undefined;
+        since?: string | undefined;
+    }, activeProfile: string): Promise<Dict>;
+    events(home: string, board: string | null, since: unknown, limit: unknown): Promise<Dict>;
+    updateConfig(home: string, body: Dict): Promise<Dict>;
+}

package/dist/tools/kanban.js

@@ -0,0 +1,79 @@
+import { SidecarError } from '../sidecar/client.js';
+import { dict } from '../config/agent-config.js';
+import { HttpFailure } from '../sessions/service.js';
+import { str } from '../util.js';
+export const truthyQuery = (v) => ['1', 'true', 'yes', 'on'].includes(str(v).trim().toLowerCase());
+export function intQuery(raw, fallback, min, max) {
+    const text = str(raw).trim();
+    if (!text)
+        return fallback;
+    const n = Number.parseInt(text, 10);
+    if (!Number.isFinite(n))
+        return fallback;
+    let v = n;
+    if (min !== undefined)
+        v = Math.max(min, v);
+    if (max !== undefined)
+        v = Math.min(max, v);
+    return v;
+}
+/** Sidecar `InvalidParams` → 400, `not_found` → 404, `RuntimeError`-class refusals → 409 (Python dispatcher mapping). */
+export function kanbanFailure(error) {
+    if (error instanceof HttpFailure)
+        throw error;
+    if (error instanceof SidecarError) {
+        if (error.condition === 'sidecar_unavailable')
+            throw new HttpFailure(503, `kanban unavailable: ${error.message}`);
+        // Python: `ImportError` (hermes_cli missing) → 503 with the text.
+        if (error.condition === 'kanban_unavailable')
+            throw new HttpFailure(503, error.message);
+        if (error.condition === 'not_found')
+            throw new HttpFailure(404, error.message);
+        if (error.condition === 'invalid_params' || error.code === -32602)
+            throw new HttpFailure(400, error.message);
+        if (error.condition === 'refused' || error.condition === 'conflict')
+            throw new HttpFailure(409, error.message);
+        if (error.condition === 'kanban_error')
+            throw new HttpFailure(400, error.message);
+        // Anything else (sqlite errors, sidecar timeouts) escaped the Python handlers to the dispatcher's opaque 500.
+        throw new HttpFailure(500, 'Internal server error');
+    }
+    // `resolveTrusted` and friends raise plain errors Python reported as 400 `ValueError`s.
+    if (error instanceof Error)
+        throw new HttpFailure(400, error.message);
+    throw error;
+}
+export class KanbanService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    sidecar() {
+        const s = this.deps.sidecar();
+        if (!s)
+            throw new HttpFailure(503, 'kanban unavailable: Hermes Agent sidecar is not running');
+        return s;
+    }
+    board(home, q, activeProfile) {
+        const since = intQuery(q.since, null, 0);
+        return this.sidecar().call('kanban.board', { profile_home: home, board: str(q.board).trim() || null, tenant: str(q.tenant).trim() || null, assignee: str(q.assignee).trim() || null, include_archived: truthyQuery(q.include_archived), only_mine: truthyQuery(q.only_mine), since, profile: activeProfile || 'default' }).catch(kanbanFailure);
+    }
+    events(home, board, since, limit) {
+        return this.sidecar().call('kanban.events', { profile_home: home, board, since: intQuery(since, 0, 0) ?? 0, limit: intQuery(limit, 200, 1, 200) ?? 200 }).catch(kanbanFailure);
+    }
+    async updateConfig(home, body) {
+        if (!('lane_by_profile' in body))
+            throw new HttpFailure(400, 'lane_by_profile is required');
+        if (typeof body.lane_by_profile !== 'boolean')
+            throw new HttpFailure(400, 'lane_by_profile must be boolean');
+        const lane = body.lane_by_profile;
+        await this.deps.config.update(home, (c) => {
+            const dashboard = dict(c.dashboard);
+            dashboard.kanban = { ...dict(dashboard.kanban), lane_by_profile: lane };
+            c.dashboard = dashboard;
+        });
+        const payload = await this.sidecar().call('kanban.config', { profile_home: home, board: null }).catch(kanbanFailure);
+        return { ...payload, lane_by_profile: lane };
+    }
+}
+//# sourceMappingURL=kanban.js.map

package/dist/tools/kanban.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kanban.js","sourceRoot":"","sources":["../../src/tools/kanban.ts"],"names":[],"mappings":"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"}

package/dist/tools/mcp-health.d.ts

@@ -0,0 +1,28 @@
+type Dict = Record<string, unknown>;
+export declare const HEALTH_INTERVAL_S = 120;
+export declare const PROBE_TIMEOUT_MS = 8000;
+export type Health = 'healthy' | 'needs_auth' | 'unhealthy' | 'unknown';
+export interface HealthRow {
+    health?: Health;
+    detail?: string;
+    checked_at?: number;
+    pending: boolean;
+}
+export declare function probeServer(cfg: unknown, fetchImpl: typeof fetch): Promise<[Health, string]>;
+export declare function configFingerprint(cfg: unknown): string;
+export declare class McpHealthProber {
+    private readonly deps;
+    private readonly state;
+    private readonly inFlight;
+    private readonly startedAt;
+    constructor(deps: {
+        fetch: () => typeof fetch;
+        now: () => number;
+        log: (line: string) => void;
+    });
+    /** Python `refresh_and_read`: schedule due probes and read back the verdicts for these exact configs. */
+    refreshAndRead(servers: Dict): Record<string, HealthRow>;
+    /** Resolve once every in-flight probe has settled (tests). */
+    settle(): Promise<void>;
+}
+export {};

package/dist/tools/mcp-health.js

@@ -0,0 +1,207 @@
+/**
+ * Background MCP server health probes (Python `api/mcp_health.py`): demand
+ * driven, fingerprint keyed, at most four in flight, eight seconds each, one
+ * probe per server identity per 120 s. `unknown` is never treated as healthy.
+ */
+import { readCapped } from '../http/capped.js';
+import { createHash } from 'node:crypto';
+import { accessSync, constants as fsConstants } from 'node:fs';
+import { delimiter, isAbsolute, join } from 'node:path';
+import { str } from '../util.js';
+export const HEALTH_INTERVAL_S = 120;
+export const PROBE_TIMEOUT_MS = 8000;
+const PROBE_BODY_LIMIT_BYTES = 64 * 1024;
+const MAX_CONCURRENT_PROBES = 4;
+const MAX_PROBE_BODY_BYTES = 64 * 1024;
+const AUTH_STATUSES = new Set([401, 403, 407]);
+const PROTOCOL_MISMATCH_STATUSES = new Set([404, 405, 406, 415]);
+const PROTOCOL_VERSION_RE = /\d{4}-\d{2}-\d{2}/;
+const INITIALIZE_REQUEST = { jsonrpc: '2.0', id: 'hermes-webui-health', method: 'initialize', params: { protocolVersion: '2025-06-18', capabilities: {}, clientInfo: { name: 'hermes-webui-health', version: '1' } } };
+function jsonRpcFromBody(raw) {
+    const text = raw.slice(0, MAX_PROBE_BODY_BYTES).trim();
+    if (!text)
+        return null;
+    const parse = (s) => { try {
+        const v = JSON.parse(s);
+        return v && typeof v === 'object' && !Array.isArray(v) ? v : null;
+    }
+    catch {
+        return null;
+    } };
+    const direct = parse(text);
+    if (direct)
+        return direct;
+    // SSE: the reply is the first `data:` payload of an event block.
+    for (const block of text.split(/(?:\r\n|\r|\n){2}/)) {
+        const data = block.split(/\r\n|\r|\n/).filter((l) => l.startsWith('data:')).map((l) => l.slice(5).trim()).join('\n');
+        if (!data)
+            continue;
+        const parsed = parse(data);
+        if (parsed)
+            return parsed;
+    }
+    return null;
+}
+function initializeResult(payload) {
+    const result = payload?.result;
+    if (!result || typeof result !== 'object' || Array.isArray(result))
+        return null;
+    const r = result;
+    return typeof r.protocolVersion === 'string' && PROTOCOL_VERSION_RE.test(r.protocolVersion) ? r : null;
+}
+function statusResult(code, payload) {
+    if (code >= 200 && code < 300) {
+        if (initializeResult(payload))
+            return ['healthy', `HTTP ${String(code)}`];
+        const error = payload?.error;
+        if (error && typeof error === 'object')
+            return ['unhealthy', `initialize rejected: ${str(error.message) || 'error'}`];
+        return ['unknown', 'unexpected initialize reply'];
+    }
+    if (AUTH_STATUSES.has(code))
+        return ['needs_auth', `HTTP ${String(code)}`];
+    if (PROTOCOL_MISMATCH_STATUSES.has(code))
+        return ['unknown', `HTTP ${String(code)} (protocol mismatch)`];
+    return ['unhealthy', `HTTP ${String(code)}`];
+}
+async function probeHttp(url, cfg, fetchImpl) {
+    let scheme = '';
+    try {
+        scheme = new URL(url).protocol;
+    }
+    catch {
+        return ['unhealthy', 'unsupported url scheme'];
+    }
+    if (scheme !== 'http:' && scheme !== 'https:')
+        return ['unhealthy', 'unsupported url scheme'];
+    const headers = { 'Content-Type': 'application/json', Accept: 'application/json, text/event-stream' };
+    if (cfg.headers && typeof cfg.headers === 'object')
+        for (const [k, v] of Object.entries(cfg.headers))
+            if (typeof v === 'string')
+                headers[k] = v;
+    const deadline = Date.now() + PROBE_TIMEOUT_MS;
+    let sessionId = null;
+    let protocolVersion = null;
+    try {
+        const res = await fetchImpl(url, { method: 'POST', headers, body: JSON.stringify(INITIALIZE_REQUEST), redirect: 'manual', signal: AbortSignal.timeout(PROBE_TIMEOUT_MS) });
+        sessionId = res.headers.get('mcp-session-id');
+        let payload = null;
+        if (res.ok) {
+            const remaining = deadline - Date.now();
+            const text = await Promise.race([readCapped(res, PROBE_BODY_LIMIT_BYTES).then((b) => (b ? b.toString('utf8') : '')), new Promise((_, reject) => { setTimeout(() => { reject(new Error('timeout')); }, Math.max(1, remaining)).unref(); })]).catch(() => '');
+            payload = jsonRpcFromBody(text);
+            protocolVersion = str(initializeResult(payload)?.protocolVersion) || null;
+        }
+        return statusResult(res.status, payload);
+    }
+    catch (error) {
+        return ['unhealthy', error.name === 'TimeoutError' ? 'timeout' : error.message || 'transport error'];
+    }
+    finally {
+        if (sessionId) {
+            const remaining = deadline - Date.now();
+            if (remaining > 0) {
+                const terminate = { ...headers, 'Mcp-Session-Id': sessionId, ...(protocolVersion ? { 'MCP-Protocol-Version': protocolVersion } : {}) };
+                try {
+                    await fetchImpl(url, { method: 'DELETE', headers: terminate, signal: AbortSignal.timeout(remaining) });
+                }
+                catch { /* best effort */ }
+            }
+        }
+    }
+}
+function commandExists(command, env) {
+    if (isAbsolute(command) || command.includes('/')) {
+        try {
+            accessSync(command, fsConstants.X_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    const path = env && typeof env === 'object' && typeof env.PATH === 'string' ? env.PATH : process.env.PATH ?? '';
+    for (const dir of path.split(delimiter).filter(Boolean)) {
+        try {
+            accessSync(join(dir, command), fsConstants.X_OK);
+            return true;
+        }
+        catch { /* next */ }
+    }
+    return false;
+}
+export async function probeServer(cfg, fetchImpl) {
+    if (!cfg || typeof cfg !== 'object' || Array.isArray(cfg))
+        return ['unhealthy', 'invalid config'];
+    const c = cfg;
+    const url = str(c.url).trim();
+    if (url)
+        return probeHttp(url, c, fetchImpl);
+    const command = str(c.command).trim();
+    if (command)
+        return commandExists(command, c.env) ? ['unknown', 'stdio server not probed'] : ['unhealthy', `command not found: ${command.split('/').pop() ?? command}`];
+    return ['unhealthy', 'invalid config'];
+}
+export function configFingerprint(cfg) {
+    const canonical = (value) => {
+        if (Array.isArray(value))
+            return `[${value.map(canonical).join(',')}]`;
+        if (value && typeof value === 'object')
+            return `{${Object.keys(value).sort().map((k) => `${JSON.stringify(k)}:${canonical(value[k])}`).join(',')}}`;
+        return JSON.stringify(value ?? null) ?? 'null';
+    };
+    return createHash('sha256').update(canonical(cfg)).digest('hex').slice(0, 16);
+}
+export class McpHealthProber {
+    deps;
+    state = new Map();
+    inFlight = new Set();
+    startedAt = new Map();
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** Python `refresh_and_read`: schedule due probes and read back the verdicts for these exact configs. */
+    refreshAndRead(servers) {
+        const now = this.deps.now();
+        const current = new Map(Object.entries(servers).map(([name, cfg]) => [name, configFingerprint(cfg)]));
+        for (const key of [...this.startedAt.keys()]) {
+            const [name, fp] = key.split('\n');
+            if (now - (this.startedAt.get(key) ?? 0) >= HEALTH_INTERVAL_S && current.get(name) !== fp) {
+                this.startedAt.delete(key);
+                this.state.delete(key);
+            }
+        }
+        const due = [];
+        for (const [name, fp] of current) {
+            const key = `${name}\n${fp}`;
+            if (this.inFlight.has(key))
+                continue;
+            const started = this.startedAt.get(key);
+            if (started !== undefined && now - started < HEALTH_INTERVAL_S)
+                continue;
+            if (this.inFlight.size >= MAX_CONCURRENT_PROBES)
+                continue;
+            this.inFlight.add(key);
+            this.startedAt.set(key, now);
+            due.push([name, servers[name], key]);
+        }
+        const readable = {};
+        for (const [name, fp] of current) {
+            const key = `${name}\n${fp}`;
+            const started = this.startedAt.get(key);
+            readable[name] = { ...(this.state.get(key) ?? {}), pending: this.inFlight.has(key) || started === undefined || now - started >= HEALTH_INTERVAL_S };
+        }
+        for (const [, cfg, key] of due) {
+            void probeServer(cfg, this.deps.fetch()).catch(() => ['unknown', 'health check failed']).then(([health, detail]) => {
+                this.state.set(key, { health, detail, checked_at: this.deps.now() });
+            }).finally(() => { this.inFlight.delete(key); });
+        }
+        return readable;
+    }
+    /** Resolve once every in-flight probe has settled (tests). */
+    async settle() {
+        while (this.inFlight.size)
+            await new Promise((r) => setTimeout(r, 10));
+    }
+}
+//# sourceMappingURL=mcp-health.js.map

package/dist/tools/mcp-health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-health.js","sourceRoot":"","sources":["../../src/tools/mcp-health.ts"],"names":[],"mappings":"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"}

package/dist/tools/mcp.d.ts

@@ -0,0 +1,34 @@
+/** MCP server inventory from config.yaml plus the Agent's already-known runtime status and the background health verdicts (Python MCP handlers). */
+import type { SidecarLike } from '../sidecar/client.js';
+import { type AgentConfig, type Config, type Dict } from '../config/agent-config.js';
+import type { McpHealthProber } from './mcp-health.js';
+export declare function maskSecrets(obj: unknown): unknown;
+export declare function parseEnabled(value: unknown): boolean;
+/** Python `_server_summary`. */
+export declare function serverSummary(name: string, cfg: unknown, runtime: Dict | null): Dict;
+export declare class McpService {
+    private readonly deps;
+    constructor(deps: {
+        sidecar: () => SidecarLike | null;
+        config: AgentConfig;
+        health?: McpHealthProber;
+    });
+    private runtime;
+    private inventory;
+    servers(profileHome: string): Promise<Dict>;
+    tools(profileHome: string): Promise<Dict>;
+    delete(profileHome: string, name: string): Promise<{
+        ok: true;
+        deleted: string;
+    }>;
+    toggle(profileHome: string, name: string, enabledRaw: unknown): Promise<{
+        ok: true;
+        name: string;
+        enabled: boolean;
+    }>;
+    update(profileHome: string, name: string, body: Dict): Promise<{
+        ok: true;
+        server: Dict;
+    }>;
+}
+export declare function notesSources(config: Config, enabled: boolean): Dict;