@senpi/runtime 3.0.180 → 3.0.181

package/dist/runtime/auto-update/idle-gate.js

@@ -0,0 +1,217 @@
+/**
+ * When is a box idle enough for a runtime self-update restart?
+ *
+ * On OpenClaw 10.x the runtime applies an update by asking the gateway to
+ * restart (restart-to-apply, R2). The gateway's own deferral already waits for
+ * running replies before it exits, so this gate is not what keeps a reply from
+ * being cut. Its job is to keep the ~70 s outage away from a user who is in a
+ * conversation or money in motion: no user turn running or queued, no trade
+ * approval waiting for an answer, no money call in flight, no `senpi deploy`
+ * job running, and no user message in the last 15 min.
+ *
+ * The gate is pure state plus a decision. It does no I/O, registers nothing
+ * and reads no clock of its own: callers pass `now` to every method. That keeps
+ * it host-neutral, so a later read-only `senpi.idle.status` gateway method can
+ * expose {@link UpdateIdleGate.isIdle} on 5.x hosts as well as 10.x.
+ */
+import { isChildSession } from "../../approvals/turn-context.js";
+/** Default: drop a run with no end after 2 h. */
+export const IDLE_STALE_RUN_MS = 2 * 60 * 60_000;
+/** Default: a received message counts as queued for 60 s. */
+export const IDLE_QUEUED_TTL_MS = 60_000;
+/** Default: no user message for 15 min. */
+export const IDLE_RECENT_MESSAGE_MS = 15 * 60_000;
+function asString(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+/**
+ * Whether a run is one the user is waiting on: the hook context's `trigger` is
+ * `"user"`, or its input provenance is `external_user`. Heartbeat, cron,
+ * memory and other background runs are not.
+ *
+ * A spawned child's own run (`subagent:` / `acp:` session) is never a user run
+ * by its context: 10.10 hard-codes `trigger: "user"` for every child run
+ * (`attempt-execution.ts:349`), a heartbeat's or cron's included. A child the
+ * user is waiting on is counted from `subagent_spawned` instead
+ * ({@link UpdateIdleGate.onSubagentSpawned}), which checks its requester.
+ */
+export function isUserTriggeredRun(info) {
+    if (isChildSession(typeof info.sessionKey === "string" ? info.sessionKey : undefined))
+        return false;
+    return info.trigger === "user" || info.inputProvenanceKind === "external_user";
+}
+/**
+ * Tracks user activity for the self-update idle check.
+ *
+ * Inputs (wired in `src/index.ts`, modern hosts only):
+ * - `onRunStart` / `onRunEnd`: `api.runtime.events.onAgentEvent` lifecycle
+ *   `start` and `end`/`error`, plus the `agent_end` hook;
+ * - `onRunClassified`: hook contexts that carry `trigger`/`inputProvenance`
+ *   (`before_prompt_build`, `agent_end`). Only a run classified as
+ *   user-triggered counts; an unclassified run does not block;
+ * - `onSubagentSpawned` / `onSubagentEnded`: subagents of an active user run;
+ * - `onUserMessage`: `message_received`.
+ *
+ * Every tracked run or subagent is dropped after `staleRunMs` without an end,
+ * with one warning per entry, so a lost `end` event cannot pin the box busy.
+ */
+export class UpdateIdleGate {
+    options;
+    runs = new Map();
+    subagents = new Map();
+    /** Arrival times of user messages whose run has not started yet. */
+    queued = [];
+    lastUserMessageAt;
+    staleRunMs;
+    queuedTtlMs;
+    recentMessageMs;
+    constructor(options = {}) {
+        this.options = options;
+        this.staleRunMs = options.staleRunMs ?? IDLE_STALE_RUN_MS;
+        this.queuedTtlMs = options.queuedTtlMs ?? IDLE_QUEUED_TTL_MS;
+        this.recentMessageMs = options.recentMessageMs ?? IDLE_RECENT_MESSAGE_MS;
+    }
+    /** A run's lifecycle started. It does not block until a hook classifies it as a user run. */
+    onRunStart(runId, sessionKey, now) {
+        const id = asString(runId);
+        if (!id)
+            return;
+        // Prune here too, so runs whose end was missed do not pile up between
+        // releases (isIdle is only read while an update is pending).
+        this.dropStale(now);
+        const existing = this.runs.get(id);
+        if (existing) {
+            existing.sessionKey ??= asString(sessionKey);
+            return;
+        }
+        this.runs.set(id, { startedAt: now, user: undefined, sessionKey: asString(sessionKey) });
+    }
+    /**
+     * A hook context described the run's origin. May arrive before the
+     * lifecycle start. Classifying a run as a user run consumes one queued
+     * message, since that message's run has now started.
+     */
+    onRunClassified(runId, info, now) {
+        const id = asString(runId);
+        if (!id)
+            return;
+        const user = isUserTriggeredRun(info);
+        let run = this.runs.get(id);
+        if (!run) {
+            run = { startedAt: now, user: undefined, sessionKey: asString(info.sessionKey) };
+            this.runs.set(id, run);
+        }
+        run.sessionKey ??= asString(info.sessionKey);
+        if (user && run.user !== true) {
+            this.dropExpiredQueued(now);
+            this.queued.shift();
+        }
+        // Once a user run, always a user run: a later hook with a thinner context
+        // must not downgrade it.
+        run.user = run.user === true ? true : user;
+    }
+    /** A run ended (lifecycle `end`/`error`, or the `agent_end` hook). */
+    onRunEnd(runId, _now) {
+        const id = asString(runId);
+        if (id)
+            this.runs.delete(id);
+    }
+    /**
+     * A subagent was spawned. It counts only when its requester session has an
+     * active user run, and then until `onSubagentEnded`, even after the parent
+     * run ends (the user is still waiting on the subagent's result).
+     */
+    onSubagentSpawned(event, now) {
+        const child = asString(event.childSessionKey);
+        const requester = asString(event.requesterSessionKey);
+        if (!child || !requester)
+            return;
+        for (const run of this.runs.values()) {
+            if (run.user === true && run.sessionKey === requester) {
+                this.subagents.set(child, { startedAt: now });
+                return;
+            }
+        }
+    }
+    /** A subagent ended (`subagent_ended`, keyed by its child/target session). */
+    onSubagentEnded(childSessionKey, _now) {
+        const child = asString(childSessionKey);
+        if (child)
+            this.subagents.delete(child);
+    }
+    /** A user message arrived (`message_received`). */
+    onUserMessage(now) {
+        this.lastUserMessageAt = now;
+        this.queued.push(now);
+    }
+    /**
+     * The idle decision at `now`. Idle only when no user run (or user subagent)
+     * is active, no user message is queued, no approval is pending, no order
+     * call is in flight, and the last user message is at least
+     * `recentMessageMs` old. A counter that throws counts as its blocker: an
+     * unknown state is never idle.
+     */
+    isIdle(now) {
+        this.dropStale(now);
+        this.dropExpiredQueued(now);
+        const blockers = [];
+        const userRun = [...this.runs.values()].some((r) => r.user === true) || this.subagents.size > 0;
+        if (userRun)
+            blockers.push("user-run");
+        if (this.queued.length > 0)
+            blockers.push("user-queued");
+        if (safeCount(this.options.pendingApprovals) > 0)
+            blockers.push("approval");
+        if (safeCount(this.options.ordersInFlight) > 0)
+            blockers.push("order");
+        if (safeFlag(this.options.deploysInFlight))
+            blockers.push("deploy");
+        if (this.lastUserMessageAt !== undefined && now - this.lastUserMessageAt < this.recentMessageMs) {
+            blockers.push("recent-message");
+        }
+        return { idle: blockers.length === 0, blockers };
+    }
+    dropExpiredQueued(now) {
+        this.queued = this.queued.filter((at) => now - at < this.queuedTtlMs);
+    }
+    dropStale(now) {
+        for (const [id, run] of this.runs) {
+            if (now - run.startedAt >= this.staleRunMs) {
+                this.runs.delete(id);
+                if (run.user === true) {
+                    this.options.logger?.warn(`[senpi-auto-update] idle gate: dropped user run ${id} with no end after ${Math.round(this.staleRunMs / 60_000)} min`);
+                }
+            }
+        }
+        for (const [key, sub] of this.subagents) {
+            if (now - sub.startedAt >= this.staleRunMs) {
+                this.subagents.delete(key);
+                this.options.logger?.warn(`[senpi-auto-update] idle gate: dropped subagent ${key} with no end after ${Math.round(this.staleRunMs / 60_000)} min`);
+            }
+        }
+    }
+}
+/** Reads a counter, treating a throw as "at least one" so the gate fails busy. */
+/** A flag reader that throws reads as set: an unknown state is never idle. */
+function safeFlag(read) {
+    if (!read)
+        return false;
+    try {
+        return read() !== false;
+    }
+    catch {
+        return true;
+    }
+}
+function safeCount(read) {
+    if (!read)
+        return 0;
+    try {
+        const n = read();
+        return Number.isFinite(n) ? n : 1;
+    }
+    catch {
+        return 1;
+    }
+}
+//# sourceMappingURL=idle-gate.js.map

package/dist/runtime/auto-update/idle-gate.js.map

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

package/dist/runtime/auto-update/install-results.d.ts

@@ -0,0 +1,130 @@
+import type { LogLevel } from "../../utils/logger.js";
+/**
+ * The runtime update results file, schema version 1 (written by the senpi-agent wrapper).
+ *
+ * - Location: `$OPENCLAW_STATE_DIR/senpi-state/runtime-update-results.json`
+ *   (`/data/.openclaw/senpi-state/runtime-update-results.json` on the senpi-agent image).
+ * - Encoding: one UTF-8 JSON object `{ "schemaVersion": 1, "results": [Entry, ...] }`, written
+ *   atomically (temp file in the same directory, then rename). Oldest entry first, at most
+ *   `maxResults`.
+ * - Entry, every field in `fields` present:
+ *   - `id`: 16 lowercase hex chars, unique per entry (the de-duplication key).
+ *   - `at`: ISO 8601 UTC time the step ended.
+ *   - `source`: one of `sources`. `outcome`: one of `outcomes`.
+ *   - `spec`, `fromVersion`, `toVersion`, `targetVersion`, `openclawVersion`: string or null.
+ *   - `durationMs`: the CLI run time in ms, or null when no CLI install ran.
+ *   - `reason`: first line, at most `maxReasonChars`; null on success.
+ * - Readers ignore fields they do not know. An outcome or source this runtime does not know is
+ *   reported as written.
+ */
+export declare const RUNTIME_UPDATE_RESULTS_SCHEMA: {
+    readonly schemaVersion: 1;
+    readonly path: "senpi-state/runtime-update-results.json";
+    readonly maxResults: 20;
+    readonly maxReasonChars: 300;
+    readonly sources: readonly ["marker", "floor"];
+    readonly outcomes: readonly ["updated", "failed", "timeout", "not-newer", "invalid", "lease-skip", "still-below"];
+    readonly fields: readonly ["id", "at", "source", "outcome", "spec", "fromVersion", "toVersion", "targetVersion", "durationMs", "reason", "openclawVersion"];
+};
+/** File name under `<OPENCLAW_STATE_DIR>/senpi-state/`, next to the update marker. */
+export declare const INSTALL_RESULTS_FILE = "runtime-update-results.json";
+/** The only results-file schema this runtime reads. */
+export declare const INSTALL_RESULTS_SCHEMA_VERSION: 1;
+/**
+ * How long the report waits for the OTel SDK init `register()` started (off the start path, so
+ * nothing else waits). Past it the file is kept for the next start.
+ */
+export declare const INSTALL_RESULTS_OTEL_READY_MS = 10000;
+/** How long the report waits for the logs flush before persisting the ids and deleting the file. */
+export declare const INSTALL_RESULTS_OTEL_FLUSH_MS = 5000;
+/** How many reported entry ids the auto-update state keeps for de-duplication. */
+export declare const MAX_REPORTED_RESULT_IDS = 50;
+/** The outcomes the wrapper writes. Anything else is reported as written, at `warn`. */
+export declare const INSTALL_RESULT_OUTCOMES: readonly ["updated", "failed", "timeout", "not-newer", "invalid", "lease-skip", "still-below"];
+/** One results-file entry after validation; a field that was missing or of the wrong type is null. */
+export interface InstallResultEntry {
+    id: string | null;
+    at: string | null;
+    source: string | null;
+    /** `"unknown"` when the entry had no string outcome. */
+    outcome: string;
+    spec: string | null;
+    fromVersion: string | null;
+    toVersion: string | null;
+    targetVersion: string | null;
+    durationMs: number | null;
+    reason: string | null;
+    openclawVersion: string | null;
+}
+/** Where the results file lives for a given OpenClaw state dir. */
+export declare function resolveInstallResultsPath(openclawStateDir: string): string;
+/** The event level for an outcome: success info, a refused or skipped step warn, a failed one error. */
+export declare function installResultLevel(outcome: string): LogLevel;
+/**
+ * Validate one entry. Returns null only for a value that is not an object; every field of the
+ * wrong type is dropped (null), every string is capped.
+ */
+export declare function sanitizeInstallResult(value: unknown): InstallResultEntry | null;
+export type ParsedInstallResults = {
+    kind: "ok";
+    entries: InstallResultEntry[];
+} | {
+    kind: "unparsable";
+    reason: string;
+} | {
+    kind: "unsupported-schema";
+    schemaVersion: number;
+};
+/** Parse the file's text. A numeric schemaVersion other than 1 is a newer writer, not garbage. */
+export declare function parseInstallResults(raw: string): ParsedInstallResults;
+/**
+ * The event body: one deterministic line, e.g.
+ * `Wrapper runtime install (marker): updated @senpi-ai/runtime@3.0.180, 3.0.179 -> 3.0.180, target 3.0.180, 44s`.
+ */
+export declare function describeInstallResult(e: InstallResultEntry): string;
+interface WarnLogger {
+    warn(...args: unknown[]): void;
+}
+/**
+ * The emit path, so an entry is never deleted before its event could leave the process. Each
+ * call is bounded by the implementation and never throws.
+ */
+export interface InstallResultsTelemetry {
+    /**
+     * Resolves `true` once events can be exported (the OTel SDK init settled, or no SDK will
+     * run), `false` when that did not happen in time: nothing is emitted and the file is kept for
+     * the next start.
+     */
+    ready(): Promise<boolean>;
+    /** Force-flush what was emitted. Runs before the ids are persisted and the file deleted. */
+    flush(): Promise<void>;
+}
+export interface ConsumeInstallResultsOptions {
+    path: string;
+    /** Ids reported before, oldest first (from the auto-update state). */
+    reportedIds: readonly string[];
+    /** Emit one event. The caller guards it; a throw here is caught and the entry counts as reported. */
+    emit: (entry: InstallResultEntry) => void;
+    /** Persist the new reported ids, before the file is deleted. A throw is one warning; the delete still runs. */
+    persistReportedIds: (ids: string[]) => Promise<void>;
+    /** Waited for before emitting and flushed after; omitted, events are emitted at once. */
+    telemetry?: InstallResultsTelemetry;
+    logger: WarnLogger;
+}
+export interface ConsumeInstallResultsResult {
+    /** The ids now on record: the previous ones plus those emitted now, the last 50. */
+    reportedIds: string[];
+    emitted: number;
+    skipped: number;
+    /** True when the emit path was not ready in time and the file was kept. */
+    deferred: boolean;
+}
+/**
+ * Read the results file and, for the entries not reported before: wait for the emit path,
+ * emit one event each, flush, persist their ids, then delete the file. That order is what keeps
+ * an entry from being lost (deleted before its event left) or reported twice (deleted, ids not
+ * saved, delete failed next time). Never throws.
+ */
+export declare function consumeInstallResults(opts: ConsumeInstallResultsOptions): Promise<ConsumeInstallResultsResult>;
+export {};
+//# sourceMappingURL=install-results.d.ts.map

package/dist/runtime/auto-update/install-results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-results.d.ts","sourceRoot":"","sources":["../../../src/runtime/auto-update/install-results.ts"],"names":[],"mappings":"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"}

package/dist/runtime/auto-update/install-results.js

@@ -0,0 +1,264 @@
+/**
+ * The wrapper's runtime install outcomes, reported as `auto_update.install_result` events
+ * (R2 Step 10 ↔ senpi-agent A12 W6).
+ *
+ * On OpenClaw 10.x the senpi-agent wrapper installs the runtime with the gateway down: the
+ * marker install before every spawn, and the `SENPI_RUNTIME_MIN_VERSION` floor at boot. The
+ * wrapper has no OTel exporter, so it appends each outcome to
+ * `$OPENCLAW_STATE_DIR/senpi-state/runtime-update-results.json` (senpi-agent
+ * `src/lib/runtimeUpdateResults.js`). The coordinator reads that file once per start, on a
+ * modern host and in the gateway process only (plugin services start only in the gateway),
+ * whether or not auto-update is enabled (operator markers and the floor install without it),
+ * emits one event per entry and deletes the file.
+ *
+ * The contract is {@link RUNTIME_UPDATE_RESULTS_SCHEMA}. Its twin is the wrapper's
+ * `RUNTIME_UPDATE_RESULTS_SCHEMA` in `src/lib/runtimeUpdateResults.js`; both must change
+ * together. The golden file `__tests__/fixtures/runtime-update-results.v1.json` is
+ * byte-identical to senpi-agent's `src/lib/__tests__/fixtures/runtime-update-results.v1.json`:
+ * the wrapper's writer output is compared against it, this parser parses it.
+ *
+ * The file is written by another program, so every field is checked here: a field of the wrong
+ * type is dropped, strings are capped. An unparsable file is deleted with one warning; a file
+ * with a numeric schemaVersion this runtime does not know is left for a newer runtime (the
+ * wrapper leaves it too). Ids already reported (the last {@link MAX_REPORTED_RESULT_IDS}, kept
+ * in the auto-update state) are skipped, so a failed delete never reports an entry twice.
+ *
+ * Validation is hand-written, not zod: the sibling on-disk files of this directory (the update
+ * marker in `update-marker.ts`, the state in `state-store.ts`) are parsed the same way, and this
+ * parser keeps every valid field of a partly bad entry instead of refusing the entry.
+ */
+import { readFile, rm } from "node:fs/promises";
+import { join } from "node:path";
+/**
+ * The runtime update results file, schema version 1 (written by the senpi-agent wrapper).
+ *
+ * - Location: `$OPENCLAW_STATE_DIR/senpi-state/runtime-update-results.json`
+ *   (`/data/.openclaw/senpi-state/runtime-update-results.json` on the senpi-agent image).
+ * - Encoding: one UTF-8 JSON object `{ "schemaVersion": 1, "results": [Entry, ...] }`, written
+ *   atomically (temp file in the same directory, then rename). Oldest entry first, at most
+ *   `maxResults`.
+ * - Entry, every field in `fields` present:
+ *   - `id`: 16 lowercase hex chars, unique per entry (the de-duplication key).
+ *   - `at`: ISO 8601 UTC time the step ended.
+ *   - `source`: one of `sources`. `outcome`: one of `outcomes`.
+ *   - `spec`, `fromVersion`, `toVersion`, `targetVersion`, `openclawVersion`: string or null.
+ *   - `durationMs`: the CLI run time in ms, or null when no CLI install ran.
+ *   - `reason`: first line, at most `maxReasonChars`; null on success.
+ * - Readers ignore fields they do not know. An outcome or source this runtime does not know is
+ *   reported as written.
+ */
+export const RUNTIME_UPDATE_RESULTS_SCHEMA = {
+    schemaVersion: 1,
+    path: "senpi-state/runtime-update-results.json",
+    maxResults: 20,
+    maxReasonChars: 300,
+    sources: ["marker", "floor"],
+    outcomes: ["updated", "failed", "timeout", "not-newer", "invalid", "lease-skip", "still-below"],
+    fields: [
+        "id",
+        "at",
+        "source",
+        "outcome",
+        "spec",
+        "fromVersion",
+        "toVersion",
+        "targetVersion",
+        "durationMs",
+        "reason",
+        "openclawVersion",
+    ],
+};
+/** File name under `<OPENCLAW_STATE_DIR>/senpi-state/`, next to the update marker. */
+export const INSTALL_RESULTS_FILE = "runtime-update-results.json";
+/** The only results-file schema this runtime reads. */
+export const INSTALL_RESULTS_SCHEMA_VERSION = RUNTIME_UPDATE_RESULTS_SCHEMA.schemaVersion;
+/**
+ * How long the report waits for the OTel SDK init `register()` started (off the start path, so
+ * nothing else waits). Past it the file is kept for the next start.
+ */
+export const INSTALL_RESULTS_OTEL_READY_MS = 10_000;
+/** How long the report waits for the logs flush before persisting the ids and deleting the file. */
+export const INSTALL_RESULTS_OTEL_FLUSH_MS = 5_000;
+/** How many reported entry ids the auto-update state keeps for de-duplication. */
+export const MAX_REPORTED_RESULT_IDS = 50;
+/** The outcomes the wrapper writes. Anything else is reported as written, at `warn`. */
+export const INSTALL_RESULT_OUTCOMES = RUNTIME_UPDATE_RESULTS_SCHEMA.outcomes;
+const MAX_REASON_CHARS = RUNTIME_UPDATE_RESULTS_SCHEMA.maxReasonChars;
+const MAX_FIELD_CHARS = 200;
+const MAX_TOKEN_CHARS = 40;
+const ID_RE = /^[0-9A-Za-z_-]{1,64}$/;
+/** Where the results file lives for a given OpenClaw state dir. */
+export function resolveInstallResultsPath(openclawStateDir) {
+    return join(openclawStateDir, RUNTIME_UPDATE_RESULTS_SCHEMA.path);
+}
+/** The event level for an outcome: success info, a refused or skipped step warn, a failed one error. */
+export function installResultLevel(outcome) {
+    switch (outcome) {
+        case "updated":
+        case "not-newer":
+            return "info";
+        case "failed":
+        case "timeout":
+        case "still-below":
+            return "error";
+        default:
+            // "invalid", "lease-skip", and an outcome a newer wrapper added.
+            return "warn";
+    }
+}
+/** First non-empty line, whitespace collapsed, capped; null for a non-string or an empty one. */
+function cleanString(value, max) {
+    if (typeof value !== "string")
+        return null;
+    const line = value.split("\n").map((l) => l.replace(/\s+/g, " ").trim()).find((l) => l.length > 0);
+    return line ? line.slice(0, max) : null;
+}
+/**
+ * Validate one entry. Returns null only for a value that is not an object; every field of the
+ * wrong type is dropped (null), every string is capped.
+ */
+export function sanitizeInstallResult(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return null;
+    const v = value;
+    const id = typeof v.id === "string" && ID_RE.test(v.id) ? v.id : null;
+    const at = cleanString(v.at, MAX_TOKEN_CHARS);
+    const duration = v.durationMs;
+    return {
+        id,
+        at: at && Number.isFinite(Date.parse(at)) ? at : null,
+        source: cleanString(v.source, MAX_TOKEN_CHARS),
+        outcome: cleanString(v.outcome, MAX_TOKEN_CHARS) ?? "unknown",
+        spec: cleanString(v.spec, MAX_FIELD_CHARS),
+        fromVersion: cleanString(v.fromVersion, MAX_TOKEN_CHARS),
+        toVersion: cleanString(v.toVersion, MAX_TOKEN_CHARS),
+        targetVersion: cleanString(v.targetVersion, MAX_TOKEN_CHARS),
+        durationMs: typeof duration === "number" && Number.isFinite(duration) && duration >= 0 ? Math.round(duration) : null,
+        reason: cleanString(v.reason, MAX_REASON_CHARS),
+        openclawVersion: cleanString(v.openclawVersion, MAX_TOKEN_CHARS),
+    };
+}
+/** Parse the file's text. A numeric schemaVersion other than 1 is a newer writer, not garbage. */
+export function parseInstallResults(raw) {
+    let value;
+    try {
+        value = JSON.parse(raw);
+    }
+    catch (error) {
+        return { kind: "unparsable", reason: `not JSON (${error instanceof Error ? error.message : String(error)})` };
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return { kind: "unparsable", reason: "not a JSON object" };
+    }
+    const { schemaVersion, results } = value;
+    if (typeof schemaVersion === "number" && Number.isFinite(schemaVersion) && schemaVersion !== INSTALL_RESULTS_SCHEMA_VERSION) {
+        return { kind: "unsupported-schema", schemaVersion };
+    }
+    if (schemaVersion !== INSTALL_RESULTS_SCHEMA_VERSION) {
+        return { kind: "unparsable", reason: `schemaVersion ${JSON.stringify(schemaVersion) ?? "undefined"} is not 1` };
+    }
+    if (!Array.isArray(results))
+        return { kind: "unparsable", reason: "results is not an array" };
+    const entries = [];
+    for (const r of results) {
+        const entry = sanitizeInstallResult(r);
+        if (entry)
+            entries.push(entry);
+    }
+    return { kind: "ok", entries };
+}
+/**
+ * The event body: one deterministic line, e.g.
+ * `Wrapper runtime install (marker): updated @senpi-ai/runtime@3.0.180, 3.0.179 -> 3.0.180, target 3.0.180, 44s`.
+ */
+export function describeInstallResult(e) {
+    const parts = [`${e.spec ?? "unknown spec"}`, `${e.fromVersion ?? "?"} -> ${e.toVersion ?? "?"}`];
+    if (e.targetVersion)
+        parts.push(`target ${e.targetVersion}`);
+    if (e.durationMs !== null)
+        parts.push(`${Math.round(e.durationMs / 1000)}s`);
+    const tail = e.reason ? `: ${e.reason}` : "";
+    return `Wrapper runtime install (${e.source ?? "unknown"}): ${e.outcome} ${parts.join(", ")}${tail}`;
+}
+/**
+ * Read the results file and, for the entries not reported before: wait for the emit path,
+ * emit one event each, flush, persist their ids, then delete the file. That order is what keeps
+ * an entry from being lost (deleted before its event left) or reported twice (deleted, ids not
+ * saved, delete failed next time). Never throws.
+ */
+export async function consumeInstallResults(opts) {
+    const { path, logger } = opts;
+    const kept = opts.reportedIds.filter((id) => typeof id === "string");
+    const unchanged = { reportedIds: kept.slice(-MAX_REPORTED_RESULT_IDS), emitted: 0, skipped: 0, deferred: false };
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch (error) {
+        if (error?.code !== "ENOENT") {
+            logger.warn(`[senpi-auto-update] could not read the wrapper's install results | path=${path} err=${formatErr(error)}`);
+        }
+        return unchanged;
+    }
+    const parsed = parseInstallResults(raw);
+    if (parsed.kind === "unsupported-schema") {
+        logger.warn(`[senpi-auto-update] wrapper install results use schemaVersion ${parsed.schemaVersion}, which this runtime does not read; leaving the file for a newer runtime | path=${path}`);
+        return unchanged;
+    }
+    if (parsed.kind === "unparsable") {
+        logger.warn(`[senpi-auto-update] wrapper install results unparsable (${parsed.reason}); deleting the file | path=${path}`);
+        await removeQuietly(path, logger);
+        return unchanged;
+    }
+    const seen = new Set(kept);
+    const fresh = [];
+    for (const entry of parsed.entries) {
+        if (entry.id !== null && seen.has(entry.id))
+            continue;
+        if (entry.id !== null)
+            seen.add(entry.id);
+        fresh.push(entry);
+    }
+    const skipped = parsed.entries.length - fresh.length;
+    if (fresh.length === 0) {
+        await removeQuietly(path, logger);
+        return { ...unchanged, skipped };
+    }
+    if (opts.telemetry && !(await opts.telemetry.ready())) {
+        logger.warn(`[senpi-auto-update] telemetry not ready in time; keeping ${fresh.length} wrapper install result(s) for the next start | path=${path}`);
+        return { ...unchanged, skipped, deferred: true };
+    }
+    const ids = [...kept];
+    for (const entry of fresh) {
+        try {
+            opts.emit(entry);
+        }
+        catch {
+            // Telemetry never breaks the coordinator; the entry still counts as reported.
+        }
+        if (entry.id !== null)
+            ids.push(entry.id);
+    }
+    await opts.telemetry?.flush();
+    const reportedIds = ids.slice(-MAX_REPORTED_RESULT_IDS);
+    try {
+        await opts.persistReportedIds(reportedIds);
+    }
+    catch (error) {
+        logger.warn(`[senpi-auto-update] could not save the reported install result ids; if the delete below also fails they are reported again next start | err=${formatErr(error)}`);
+    }
+    await removeQuietly(path, logger);
+    return { reportedIds, emitted: fresh.length, skipped, deferred: false };
+}
+async function removeQuietly(path, logger) {
+    try {
+        await rm(path, { force: true });
+    }
+    catch (error) {
+        logger.warn(`[senpi-auto-update] could not delete the wrapper's install results; reported ids prevent a repeat | path=${path} err=${formatErr(error)}`);
+    }
+}
+function formatErr(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=install-results.js.map

package/dist/runtime/auto-update/install-results.js.map

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