@quickchatai/quickreview 0.0.0-stage → 1.1.0

package/dist/src/openviking/embedder.js

@@ -0,0 +1,457 @@
+// The local English embedder as a supervised child of the daemon.
+//
+// WHAT IT IS. `scripts/openviking-embedder.py` — an OpenAI-compatible
+// `POST /v1/embeddings` on 127.0.0.1, run by the OpenViking venv's python over
+// the pinned llama-cpp-python and the GGUF the image pins. ov.conf points the
+// engine's OpenAI-compatible provider at it (`api_base` on loopback), which is
+// the engine's async embedder: a search never runs a model on the server's
+// one event loop. Nothing leaves the machine.
+//
+// WHY THE DAEMON SUPERVISES IT, and why apart from the server: the container
+// keeps ONE supervised process tree (see supervisor.ts), and the two children
+// fail differently — the server's `/ready` probes this service, so a dead
+// embedder is a server that is up but not serving, never a server crash. The
+// server's FIRST start waits for this one to answer (`gateOpen`), bounded: the
+// gate orders a boot, it never holds memory hostage.
+//
+// ONLY WHEN IT IS THE EMBEDDER IN USE. The daemon starts it when config.toml
+// says `local` AND the ov.conf the entrypoint rendered routes embeddings to
+// this config's loopback URL. Anything else — a hosted opt-in, an ov.conf from
+// an entrypoint that predates the local embedder (a `sync` without the
+// `rebuild` the image needs) — is reported (`state: "off"`, with the reason) and nothing is
+// spawned: a service nobody calls would only burn a CPU of the two. A file it
+// needs that is missing is reported ONCE (`unavailable`), like the server's
+// binary on a dev PC — it will not appear without a rebuild, so retrying is
+// noise.
+//
+// UNDER THE MEMORY SIDECAR (`[openviking] endpoint = "remote"`) the sidecar
+// runs this service beside the server, with this same class: the daemon has
+// nothing to supervise, so it reports `off` with that reason and spawns
+// nothing. Whether the sidecar's embedder serves is read from the server's
+// own `/ready`, which probes it.
+//
+// The same three properties as the server's supervisor: start() never blocks,
+// a crash respawns on the capped ladder forever, status() is synchronous,
+// cached and total.
+import { existsSync, readFileSync } from "node:fs";
+import { spawn as nodeSpawn } from "node:child_process";
+import { dirname, join } from "node:path";
+import { LOCAL_EMBEDDING, localEmbedderBaseUrl } from "../config.js";
+import { ProcSampler } from "./proc.js";
+import { foldChildLines, restartDelayMs, terminateChild, } from "./supervisor.js";
+export function localEmbedderSpec(cfg, repoRoot) {
+    return {
+        // The OpenViking venv's interpreter: the one the image installed the
+        // pinned llama-cpp-python into.
+        python: join(dirname(cfg.bin), "python"),
+        script: join(repoRoot, "scripts", "openviking-embedder.py"),
+        model: LOCAL_EMBEDDING.model,
+        file: cfg.local_embedder_file,
+        sha256: cfg.local_embedder_sha256,
+        port: cfg.local_embedder_port,
+        threads: cfg.local_embedder_threads,
+    };
+}
+/** The service's argv after the interpreter — loopback, always. */
+export function localEmbedderArgv(spec) {
+    return [
+        spec.script,
+        "--model-path",
+        spec.file,
+        "--model-name",
+        spec.model,
+        "--sha256",
+        spec.sha256,
+        "--host",
+        "127.0.0.1",
+        "--port",
+        String(spec.port),
+        "--threads",
+        String(spec.threads),
+    ];
+}
+/**
+ * Does the rendered ov.conf route embeddings to THIS config's local
+ * embedder? `null` when it does, else why not — said in the heartbeat, because
+ * "the daemon did not start it" must always come with a reason.
+ */
+export function localEmbedderOffReason(cfg, ovConfText) {
+    if (cfg.embedding_provider !== "local")
+        return `config.toml embeds through the hosted '${cfg.embedding_provider}' provider`;
+    if (ovConfText === null)
+        return `${cfg.config_file} could not be read`;
+    let dense;
+    try {
+        dense = JSON.parse(ovConfText)?.embedding?.dense;
+    }
+    catch {
+        return `${cfg.config_file} is not JSON`;
+    }
+    const want = localEmbedderBaseUrl(cfg);
+    const apiBase = typeof dense?.api_base === "string" ? dense.api_base.replace(/\/+$/, "") : "";
+    if (apiBase === want)
+        return null;
+    const said = apiBase !== ""
+        ? `api_base ${apiBase}`
+        : `provider '${typeof dense?.provider === "string" ? dense.provider : "(none)"}'`;
+    const head = `ov.conf does not route embeddings to ${want} (it says ${said})`;
+    // Three different faults, three different fixes — never one guess for all.
+    if (apiBase === "")
+        return (`${head} — rendered by an entrypoint that predates the local English embedder? ` +
+            "It ships with the image: scripts/deploy.sh rebuild");
+    if (/^http:\/\/127\.0\.0\.1:\d+\/v1$/.test(apiBase))
+        return (`${head} — config.toml [openviking] local_embedder_port and the port the boot rendered disagree, ` +
+            `and nothing serves ${apiBase}: memory search fails until they agree (ansible: group_vars ` +
+            "openviking_local_embedder_port; compose: the project .env's QCR_OPENVIKING_LOCAL_EMBEDDER_PORT, " +
+            "which the onboarding bring-up mirrors from config.toml)");
+    return (`${head} — config.toml says local, but the boot rendered another embedder ` +
+        "(the re-embed driver reports this drift as openviking.reembed.config_drift)");
+}
+/**
+ * Does memory SERVE — search, and vectorizing what is written? The answer
+ * memory health folds in beside its authenticated probe, which is an `fs/ls`,
+ * needs no embedding, and so keeps answering while a dead embedder fails every
+ * search. Pure, from the two supervisors' cached statuses:
+ *
+ *   - under `local`, an embedder the daemon cannot run (`unavailable`), or
+ *     runs but that does not answer, is NOT serving whatever the server last
+ *     said — it is the server's only embedder;
+ *   - a server that answers `/health` but fails `/ready` — which runs an
+ *     embedding probe: a hosted embedder that refuses, an ov.conf routed to a
+ *     port nothing serves — is NOT serving;
+ *   - a server that does not answer at all is UNKNOWN here (`ok: null`): the
+ *     authenticated probe fails too, and judges it;
+ *   - anything else serves.
+ */
+export function memoryServing(provider, server, embedder) {
+    if (provider === "local" && embedder) {
+        if (embedder.state === "unavailable")
+            return {
+                ok: false,
+                reason: `the local embedder is unavailable — ${embedder.reason ?? "a file it needs is missing"}`,
+            };
+        if (embedder.state === "supervised" && !embedder.ready) {
+            const exit = embedder.last_exit
+                ? ` (last exit code=${embedder.last_exit.code ?? "null"} signal=${embedder.last_exit.signal ?? "null"} at ${embedder.last_exit.at})`
+                : "";
+            const why = !embedder.running
+                ? `not running${exit}, ${embedder.restarts} restart(s)`
+                : embedder.checked_at === undefined
+                    ? "starting (it has not answered /health yet)"
+                    : `running but not answering /health${embedder.last_error ? ` (${embedder.last_error})` : ""}${exit}`;
+            return { ok: false, reason: `the local embedder on 127.0.0.1:${embedder.port} is ${why}` };
+        }
+    }
+    if (!server || !server.running || !server.reachable)
+        return { ok: null };
+    // One failed `/ready` poll is no verdict: the probe runs an embedding on the
+    // one-thread local embedder, which a case batch may hold for a few seconds,
+    // and a single slow probe must not flip memory health to degraded and pause
+    // every pump until the next poll. Unknown
+    // keeps the not-serving clock where it stands; the second in a row decides.
+    if (!server.ready && server.not_ready_polls === 1)
+        return { ok: null };
+    if (!server.ready) {
+        const off = provider === "local" && embedder?.state === "off" && embedder.reason
+            ? `; the local embedder is off — ${embedder.reason}`
+            : "";
+        return {
+            ok: false,
+            reason: `the server answers but its /ready fails (${server.last_error ?? "not ready"}) — /ready runs an embedding probe${off}`,
+        };
+    }
+    return { ok: true };
+}
+/** Why the daemon runs no embedder when the memory sidecar serves memory. */
+export const REMOTE_EMBEDDER_REASON = "the memory sidecar runs it ([openviking] endpoint = remote); its health is the server's /ready";
+/** How often a not-yet-ready child is probed — the gate waits on this. */
+export const EMBEDDER_FAST_POLL_MS = 500;
+/** How long the server's first start waits for the embedder before starting
+ * anyway (the model loads in about a second; the sha256 check in a fraction). */
+export const EMBEDDER_GATE_MAX_WAIT_MS = 120_000;
+const defaultSchedule = (fn, ms) => {
+    const t = setTimeout(fn, ms);
+    t.unref?.();
+    return () => clearTimeout(t);
+};
+export class LocalEmbedderSupervisor {
+    cfg;
+    spec;
+    log;
+    spawnFn;
+    fetchFn;
+    now;
+    exists;
+    readOvConf;
+    sampler;
+    schedule;
+    state = "off";
+    reason = "not started";
+    started = false;
+    stopping = false;
+    child = null;
+    childPid;
+    startedAt = null;
+    attempt = 0;
+    restarts = 0;
+    ready = false;
+    everReady = false;
+    checkedAt;
+    lastExit;
+    lastError;
+    proc;
+    cancelRestart = null;
+    cancelHealth = null;
+    constructor(deps) {
+        this.cfg = deps.cfg;
+        this.spec = localEmbedderSpec(deps.cfg, deps.repoRoot);
+        this.log = deps.log;
+        this.spawnFn = deps.spawn ?? ((cmd, args, opts) => nodeSpawn(cmd, args, opts));
+        this.fetchFn = deps.fetchFn ?? ((url, init) => fetch(url, init));
+        this.now = deps.now ?? (() => new Date());
+        this.exists = deps.exists ?? existsSync;
+        this.readOvConf =
+            deps.readOvConf ??
+                (() => {
+                    try {
+                        return readFileSync(deps.cfg.config_file, "utf8");
+                    }
+                    catch {
+                        return null;
+                    }
+                });
+        this.sampler = deps.sampler ?? new ProcSampler();
+        this.schedule = deps.schedule ?? defaultSchedule;
+    }
+    /** Decide, then spawn and arm the probe. Synchronous and non-blocking. */
+    start() {
+        if (this.started)
+            return;
+        this.started = true;
+        if (!this.cfg.enabled) {
+            this.reason = "memory is disabled in config.toml";
+            return;
+        }
+        if (this.cfg.endpoint === "remote") {
+            this.reason = REMOTE_EMBEDDER_REASON;
+            if (this.cfg.embedding_provider === "local")
+                this.log(`openviking: local embedder NOT started — ${REMOTE_EMBEDDER_REASON}`);
+            return;
+        }
+        const off = localEmbedderOffReason(this.cfg, this.readOvConf());
+        if (off !== null) {
+            this.reason = off;
+            if (this.cfg.embedding_provider === "local")
+                this.log(`openviking: local embedder NOT started — ${off}`);
+            return;
+        }
+        for (const [what, path] of [
+            ["interpreter", this.spec.python],
+            ["service script", this.spec.script],
+            ["model file", this.spec.file],
+        ]) {
+            if (!this.exists(path)) {
+                this.state = "unavailable";
+                this.reason =
+                    `${what} not found: ${path}` +
+                        (what === "model file"
+                            ? " — the image carries it; this one predates it (scripts/deploy.sh rebuild)"
+                            : "");
+                this.log(`openviking: local embedder unavailable — ${this.reason} (memory search degrades)`);
+                return;
+            }
+        }
+        this.state = "supervised";
+        this.reason = undefined;
+        this.spawnChild();
+    }
+    /** The server's start gate: open once this embedder serves — or when it
+     * never will (off, unavailable, stopping). */
+    gateOpen() {
+        return this.state !== "supervised" || this.stopping || this.ready;
+    }
+    /** The last probe answered 200 from a live child. */
+    isReady() {
+        return this.state === "supervised" && this.child !== null && this.ready;
+    }
+    spawnChild() {
+        if (this.stopping)
+            return;
+        this.cancelRestart = null;
+        this.ready = false;
+        this.everReady = false;
+        this.checkedAt = undefined; // the new child has not been probed
+        try {
+            const child = this.spawnFn(this.spec.python, localEmbedderArgv(this.spec), {
+                env: { ...process.env },
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+            this.child = child;
+            this.childPid = child.pid;
+            this.startedAt = this.now().getTime();
+            this.sampler.reset();
+            this.foldLogs(child);
+            child.on("error", (err) => {
+                this.lastError = err.message;
+                this.log("openviking: local embedder spawn error", err);
+                // A failed spawn emits `error` (never `exit`) and has no pid.
+                if (this.child !== child || child.pid !== undefined)
+                    return;
+                this.clearChild();
+                this.scheduleRestart();
+            });
+            child.on("exit", (code, signal) => this.onExit(child, code, signal));
+            this.log(`openviking: local embedder started (pid ${child.pid ?? "?"}) — ${this.spec.model} on 127.0.0.1:${this.spec.port}`);
+            this.armProbe(EMBEDDER_FAST_POLL_MS);
+        }
+        catch (err) {
+            this.clearChild();
+            this.lastError = err instanceof Error ? err.message : String(err);
+            this.log("openviking: local embedder spawn failed", err);
+            this.scheduleRestart();
+        }
+    }
+    clearChild() {
+        this.child = null;
+        this.childPid = undefined;
+        this.startedAt = null;
+        this.ready = false;
+        this.proc = undefined;
+        this.sampler.reset();
+    }
+    /** Its stdout/stderr, line by line, into the daemon log — the service's own
+     * lines already carry the `openviking-embedder:` prefix. */
+    foldLogs(child) {
+        foldChildLines(child, (line) => this.log(line));
+    }
+    onExit(child, code, signal) {
+        if (this.child !== child)
+            return;
+        const upMs = this.startedAt !== null ? this.now().getTime() - this.startedAt : 0;
+        this.clearChild();
+        this.cancelHealth?.();
+        this.cancelHealth = null;
+        this.lastExit = { code, signal, at: this.now().toISOString() };
+        if (this.stopping)
+            return;
+        if (upMs >= this.cfg.restart_reset_after_s * 1000)
+            this.attempt = 0;
+        this.log(`openviking: local embedder exited (code=${code ?? "null"} signal=${signal ?? "null"}) after ${Math.round(upMs / 1000)}s`);
+        this.scheduleRestart();
+    }
+    scheduleRestart() {
+        if (this.stopping)
+            return;
+        const delay = restartDelayMs(this.cfg.restart_backoff_ms, this.attempt);
+        this.attempt += 1;
+        this.restarts += 1;
+        this.log(`openviking: local embedder restarting in ${delay}ms (attempt ${this.attempt})`);
+        this.cancelRestart = this.schedule(() => this.spawnChild(), delay);
+    }
+    /** Self-rescheduling: fast until the child first serves, then at the
+     * server's health cadence. Two probes never overlap. A probe re-arms only
+     * for the child it probed: a replacement arms its own at spawn. */
+    armProbe(ms) {
+        if (this.stopping)
+            return;
+        this.cancelHealth?.();
+        this.cancelHealth = this.schedule(() => {
+            this.cancelHealth = null;
+            const probed = this.child;
+            void this.probe().finally(() => {
+                if (this.child === null || this.child !== probed)
+                    return;
+                this.armProbe(this.everReady ? this.cfg.health_interval_s * 1000 : EMBEDDER_FAST_POLL_MS);
+            });
+        }, ms);
+    }
+    /** One `/health` probe into the cache. Never rejects. An answer that lands
+     * after the child it probed was replaced says nothing about the new one
+     * and is dropped — the same identity rule `onExit` keeps. */
+    async probe() {
+        const probed = this.child;
+        const at = this.now().toISOString();
+        let ok = false;
+        let error;
+        try {
+            const res = await this.fetchFn(`http://127.0.0.1:${this.spec.port}/health`, {
+                signal: AbortSignal.timeout(this.cfg.health_timeout_ms),
+            });
+            ok = res.ok;
+            if (!ok)
+                error = `health ${res.status}`;
+        }
+        catch (err) {
+            ok = false;
+            error = err instanceof Error ? err.message : String(err);
+        }
+        if (this.child !== probed)
+            return;
+        if (error !== undefined)
+            this.lastError = error;
+        this.checkedAt = at;
+        const was = this.ready;
+        this.ready = ok && this.child !== null;
+        if (this.ready) {
+            this.lastError = undefined;
+            if (!this.everReady)
+                this.everReady = true;
+            if (!was)
+                this.log(`openviking: local embedder ready — ${this.spec.model} serving on 127.0.0.1:${this.spec.port}`);
+        }
+        else if (was && this.child !== null) {
+            this.log(`openviking: local embedder stopped answering (${this.lastError ?? "no answer"})`);
+        }
+        this.proc = this.childPid !== undefined ? this.sampler.sample(this.childPid) : undefined;
+    }
+    /** The `embedder` block inside the heartbeat's `openviking` entry. */
+    status() {
+        try {
+            return {
+                state: this.state,
+                ...(this.reason ? { reason: this.reason } : {}),
+                model: this.spec.model,
+                port: this.spec.port,
+                threads: this.spec.threads,
+                running: this.child !== null,
+                ready: this.isReady(),
+                restarts: this.restarts,
+                ...(this.childPid !== undefined ? { pid: this.childPid } : {}),
+                ...(this.startedAt !== null ? { started_at: new Date(this.startedAt).toISOString() } : {}),
+                ...(this.lastExit ? { last_exit: this.lastExit } : {}),
+                ...(this.lastError ? { last_error: this.lastError } : {}),
+                ...(this.checkedAt ? { checked_at: this.checkedAt } : {}),
+                ...(this.proc?.rss_bytes !== undefined ? { rss_bytes: this.proc.rss_bytes } : {}),
+                ...(this.proc?.cpu_pct !== undefined ? { cpu_pct: this.proc.cpu_pct } : {}),
+            };
+        }
+        catch {
+            return {
+                state: this.state,
+                model: LOCAL_EMBEDDING.model,
+                port: this.cfg.local_embedder_port,
+                threads: this.cfg.local_embedder_threads,
+                running: false,
+                ready: false,
+                restarts: this.restarts,
+            };
+        }
+    }
+    /** SIGTERM, then SIGKILL after the grace window. Bounded. */
+    async stop() {
+        if (this.stopping)
+            return;
+        this.stopping = true;
+        this.cancelRestart?.();
+        this.cancelRestart = null;
+        this.cancelHealth?.();
+        this.cancelHealth = null;
+        const child = this.child;
+        if (!child)
+            return;
+        await terminateChild(child, this.schedule);
+        this.clearChild();
+        this.log("openviking: local embedder stopped");
+    }
+}
+//# sourceMappingURL=embedder.js.map

package/dist/src/openviking/embedder.js.map

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

package/dist/src/openviking/gapsink.js

@@ -0,0 +1,38 @@
+export const GAP_ANOMALY_KIND = "openviking_gap";
+/** One row per `op:code` per this long. */
+export const GAP_ROW_EVERY_MS = 3_600_000;
+/** The client's `onGap` sink. Never throws: a counter must not become an
+ * outage on the request path. */
+export function countedGapSink(deps) {
+    const now = deps.now ?? Date.now;
+    const everyMs = deps.everyMs ?? GAP_ROW_EVERY_MS;
+    const counts = new Map();
+    const rowAt = new Map();
+    return (gap) => {
+        try {
+            deps.log?.("openviking gap", gap);
+            try {
+                deps.record?.(gap);
+            }
+            catch {
+                // The health block missing one count is not worth the row.
+            }
+            const key = `${gap.op}:${gap.code}`;
+            const n = (counts.get(key) ?? 0) + 1;
+            counts.set(key, n);
+            const t = now();
+            const last = rowAt.get(key);
+            if (last !== undefined && t - last < everyMs)
+                return;
+            deps.logAnomaly(GAP_ANOMALY_KIND, null, null, `${gap.op} ${gap.code} (${gap.status || "no answer"}): ${gap.message.slice(0, 200)} — ${n} such gap${n === 1 ? "" : "s"} since boot`);
+            // The hour starts only once a row is WRITTEN: a failed insert leaves the
+            // next gap of this kind free to write it.
+            rowAt.set(key, t);
+        }
+        catch {
+            // Swallowed by contract: the client already swallows a throwing sink,
+            // and this sink promises not to need that.
+        }
+    };
+}
+//# sourceMappingURL=gapsink.js.map

package/dist/src/openviking/gapsink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gapsink.js","sourceRoot":"","sources":["../../../src/openviking/gapsink.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAEjD,2CAA2C;AAC3C,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAa1C;iCACiC;AACjC,MAAM,UAAU,cAAc,CAAC,IAAwB;IACrD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,gBAAgB,CAAC;IACjD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,OAAO,CAAC,GAAG,EAAE,EAAE;QACb,IAAI,CAAC;YACH,IAAI,CAAC,GAAG,EAAE,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;YAClC,IAAI,CAAC;gBACH,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC;gBACP,2DAA2D;YAC7D,CAAC;YACD,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;YACpC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACrC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACnB,MAAM,CAAC,GAAG,GAAG,EAAE,CAAC;YAChB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,GAAG,IAAI,GAAG,OAAO;gBAAE,OAAO;YACrD,IAAI,CAAC,UAAU,CACb,gBAAgB,EAChB,IAAI,EACJ,IAAI,EACJ,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,MAAM,IAAI,WAAW,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,aAAa,CACrI,CAAC;YACF,yEAAyE;YACzE,0CAA0C;YAC1C,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,sEAAsE;YACtE,2CAA2C;QAC7C,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/openviking/health.js

@@ -0,0 +1,69 @@
+// OpenViking health probing.
+//
+// The health gate is `/ready`, never `openviking-server doctor`. `doctor` makes
+// live provider calls and exits 1 whenever no `vlm` is configured — which is
+// our normal, deliberate state (memories are authored, never extracted). It
+// would report a permanently sick server.
+//
+// `/health` is unauthenticated and carries the server's own version string;
+// that is what the pin-drift check in the heartbeat reads. Both probes are
+// fail-soft by construction: `probeHealth` resolves an OpenVikingHealth for
+// every outcome — connection refused, timeout, 503, garbage body — and never
+// rejects. A memory engine must never be able to take a round, or the
+// heartbeat, down with it.
+import { errText } from "./client.js";
+/**
+ * Probe `/health`, then `/ready` when the server answered at all.
+ *
+ * `/ready` is skipped when `/health` did not answer: there is nothing to learn
+ * from a second connection refusal, and skipping it halves the cost of the
+ * common "server is restarting" case.
+ */
+export async function probeHealth(opts) {
+    const now = opts.now ?? (() => new Date());
+    const fetchFn = opts.fetchFn ?? ((url, init) => fetch(url, init));
+    const at = now().toISOString();
+    let version;
+    try {
+        const res = await fetchFn(`${opts.baseUrl}/health`, {
+            signal: AbortSignal.timeout(opts.timeoutMs),
+        });
+        if (!res.ok)
+            return { reachable: false, ready: false, error: `health ${res.status}`, at };
+        // A body we cannot parse still proves the process is serving: reachable
+        // stays true, the version simply stays unknown (and so does drift).
+        try {
+            const body = (await res.json());
+            if (typeof body?.version === "string")
+                version = body.version;
+        }
+        catch {
+            version = undefined;
+        }
+    }
+    catch (err) {
+        return { reachable: false, ready: false, error: errText(err), at };
+    }
+    try {
+        const res = await fetchFn(`${opts.baseUrl}/ready`, {
+            signal: AbortSignal.timeout(opts.timeoutMs),
+        });
+        return {
+            reachable: true,
+            ready: res.ok,
+            ...(version ? { version } : {}),
+            ...(res.ok ? {} : { error: `ready ${res.status}` }),
+            at,
+        };
+    }
+    catch (err) {
+        return {
+            reachable: true,
+            ready: false,
+            ...(version ? { version } : {}),
+            error: errText(err),
+            at,
+        };
+    }
+}
+//# sourceMappingURL=health.js.map

package/dist/src/openviking/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../../src/openviking/health.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,EAAE;AACF,gFAAgF;AAChF,6EAA6E;AAC7E,4EAA4E;AAC5E,0CAA0C;AAC1C,EAAE;AACF,4EAA4E;AAC5E,2EAA2E;AAC3E,4EAA4E;AAC5E,6EAA6E;AAC7E,sEAAsE;AACtE,2BAA2B;AAC3B,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAmBtC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAkB;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAc,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;IAC7E,MAAM,EAAE,GAAG,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;IAE/B,IAAI,OAA2B,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,SAAS,EAAE;YAClD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;SAC5C,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,GAAG,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;QAC1F,wEAAwE;QACxE,oEAAoE;QACpE,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA0B,CAAC;YACzD,IAAI,OAAO,IAAI,EAAE,OAAO,KAAK,QAAQ;gBAAE,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAChE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,SAAS,CAAC;QACtB,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC;IACrE,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,QAAQ,EAAE;YACjD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;SAC5C,CAAC,CAAC;QACH,OAAO;YACL,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,GAAG,CAAC,EAAE;YACb,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/B,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;YACnD,EAAE;SACH,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,KAAK;YACZ,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/B,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC;YACnB,EAAE;SACH,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/src/openviking/index.js

@@ -0,0 +1,24 @@
+// The OpenViking runtime: the server the daemon supervises inside
+// the container, on loopback :1933, plus its health gate and heartbeat block.
+// Nothing here is on a review round's critical path — see supervisor.ts.
+export { probeHealth } from "./health.js";
+export { ProcSampler, parseProcStat } from "./proc.js";
+export { OpenVikingSupervisor, } from "./supervisor.js";
+// The local English embedder: the loopback service the server
+// embeds through, supervised beside it.
+export { EMBEDDER_FAST_POLL_MS, EMBEDDER_GATE_MAX_WAIT_MS, LocalEmbedderSupervisor, REMOTE_EMBEDDER_REASON, localEmbedderArgv, localEmbedderOffReason, localEmbedderSpec, memoryServing, } from "./embedder.js";
+// The embedder migration's daemon half: drives the script's
+// `resume` once /ready passes and folds the journal into the heartbeat.
+export { REEMBED_POLL_MS, REEMBED_RETRY_MS, ReembedDriver, loadReembedModule, reembedNamespaces, } from "./reembed.js";
+// The memory engine proper: the HTTP client, the `MemoryStore`
+// implementation over it, and the round path's `ContextAssembler`. Writes go
+// through `content/batch-write` exclusively — there is no `content/write`
+// wrapper anywhere below this barrel, by design.
+export { DISABLED_MEMORY_POLICY, OpenVikingClient, QUOTA_CATEGORIES, batchWriteLanded, buildContextSearchBody, isAuthFailure, keyFromFile, ovFailed, } from "./client.js";
+export { DEFAULT_CATEGORY, MANUAL_TAG, OpenVikingStore, PINNED_TAG, RETIRED_TAG, entryFrom, openVikingStore, renderEntryBody, sha256Prefixed, stampOf, tagsOf, tsFromModTime, tsFromName, validEntryId, withTag, withoutTag, } from "./store.js";
+export { OpenVikingContextAssembler, openVikingContextAssembler, } from "./context.js";
+// The authenticated probe and the boot provisioning report —
+// what the memory health monitor (src/memory/health.ts) is fed from.
+export { classifyProbe, credentialProbe, probeKeyFrom, } from "./probe.js";
+export { provisionReportPath, provisionWake, readProvisionReport } from "./provisionreport.js";
+//# sourceMappingURL=index.js.map

package/dist/src/openviking/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/openviking/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,8EAA8E;AAC9E,yEAAyE;AACzE,OAAO,EAAE,WAAW,EAAqC,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,aAAa,EAAuC,MAAM,WAAW,CAAC;AAC5F,OAAO,EACL,oBAAoB,GAKrB,MAAM,iBAAiB,CAAC;AAWzB,8DAA8D;AAC9D,wCAAwC;AACxC,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,GAGd,MAAM,eAAe,CAAC;AACvB,4DAA4D;AAC5D,wEAAwE;AACxE,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,GAMlB,MAAM,cAAc,CAAC;AAEtB,+DAA+D;AAC/D,6EAA6E;AAC7E,0EAA0E;AAC1E,iDAAiD;AACjD,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,WAAW,EACX,QAAQ,GAoBT,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,UAAU,EACV,WAAW,EACX,SAAS,EACT,eAAe,EACf,eAAe,EACf,cAAc,EACd,OAAO,EACP,MAAM,EACN,aAAa,EACb,UAAU,EACV,YAAY,EACZ,OAAO,EACP,UAAU,GAGX,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,GAE3B,MAAM,cAAc,CAAC;AACtB,6DAA6D;AAC7D,qEAAqE;AACrE,OAAO,EACL,aAAa,EACb,eAAe,EACf,YAAY,GAGb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}