@amalgm/core 0.1.0

package/dist/supervision/update.d.ts

@@ -0,0 +1,231 @@
+/**
+ * Updater laws — version comparison, npm install shape, and the
+ * auto-update manager's state vocabulary.
+ *
+ * The host runs npm, reads disks, and restarts processes; this module owns
+ * every decision and every contract string (axiom 8): the semver rules the
+ * updater lives by, the exact npm argv and environment, the error messages
+ * surfaces match on, and the idle-gating reasons the UI displays.
+ *
+ * Engine sources (production until cutover, axiom 9):
+ * `packages/amalgm/lib/updater.js` and `packages/amalgm/lib/supervisor.js`
+ * (auto-update manager), with the label→tag rule imported from
+ * `identity/labels.ts` — one definition (axiom 2).
+ */
+export interface Semver {
+    readonly major: number;
+    readonly minor: number;
+    readonly patch: number;
+    readonly prerelease: string;
+}
+/**
+ * Engine `updater.js:21-31`. Notable exactness: a leading `v` is stripped;
+ * non-numeric components collapse to 0 (`Number(x) || 0`); the prerelease
+ * is whatever follows the FIRST hyphen up to the second — `split('-', 2)`
+ * truncates `1.0.0-alpha-beta` to prerelease `alpha`.
+ */
+export declare function parseSemver(value: unknown): Semver;
+/**
+ * Engine `updater.js:33-55`. The prerelease rules, each load-bearing:
+ *
+ *   1. Both absent → equal.
+ *   2. An ABSENT prerelease WINS: `1.0.0` > `1.0.0-rc.1` — a release
+ *      outranks every prerelease of the same core version.
+ *   3. Dot-separated parts compare left to right; when one side runs out of
+ *      parts, the SHORTER side is smaller (`1.0.0-rc` < `1.0.0-rc.1`).
+ *   4. Two numeric parts compare numerically (`rc.2` < `rc.10`).
+ *   5. A numeric part is smaller than an alphanumeric part:
+ *      `1.0.0-2` < `1.0.0-alpha`.
+ *   6. Two alphanumeric parts compare lexically (`>` / `<` on strings).
+ */
+export declare function comparePrerelease(left: string, right: string): number;
+/** Engine `updater.js:57-64`: major/minor/patch first, prerelease last. */
+export declare function compareVersions(left: unknown, right: unknown): number;
+/**
+ * Engine `updater.js:106-110`: an explicit tag/channel wins with any
+ * leading `@` stripped (`@canary` → `canary`); otherwise the runtime
+ * label's tag. The label is injected — the engine's
+ * `AMALGM_RUNTIME_LABEL` fallback is the host's job.
+ */
+export declare function npmInstallTag(options: {
+    tag?: string | true | undefined;
+    channel?: string | true | undefined;
+    runtimeLabel: string;
+}): string;
+/**
+ * Engine `updater.js:244-249`. `AMALGM_DISABLE_AUTO_UPDATE` disables on a
+ * truthy value (`'1' | 'true' | 'yes' | 'on'`), `AMALGM_AUTO_UPDATE`
+ * disables on a falsy value (`'0' | 'false' | 'no' | 'off'`); both are
+ * trimmed and lowercased first. The env map is injected (axiom 6).
+ */
+export declare function envDisablesAutoUpdate(env: Readonly<Record<string, string | undefined>>): boolean;
+/** Engine `updater.js:251-254`: the `local` label never auto-updates. */
+export declare function autoUpdateSupported(runtimeLabel: string): boolean;
+/** Engine `updater.js:256-259`. */
+export declare function shouldAutoUpdate(options: {
+    runtimeLabel: string;
+    env: Readonly<Record<string, string | undefined>>;
+}): boolean;
+/**
+ * Engine `updater.js:77-83`. npm lays out global installs as
+ * `<prefix>/lib/node_modules/<name>` on POSIX and
+ * `<prefix>/node_modules/<name>` on Windows. Walking that layout backwards
+ * from the package root this process runs from recovers the prefix that
+ * owns the running install, so updates land in the tree the service
+ * actually boots — not whatever prefix the inherited environment points at.
+ * Returns null when the root is not a global-install layout (e.g. a repo
+ * checkout).
+ *
+ * Purity note: the engine calls `path.resolve`; this SDK takes an
+ * already-absolute root and normalizes `\` to `/` (the returned prefix uses
+ * forward slashes — a comparison key, not a filesystem call site).
+ */
+export declare function globalPrefixForPackageRoot(packageRoot: string): string | null;
+/**
+ * Engine `updater.js:94-104`: exactly `['install', '-g', 'amalgm@<tag>']`,
+ * plus `['--prefix', prefix]` when a prefix is known. The `--prefix` flag
+ * outranks every npm config layer, including an inherited
+ * `npm_config_prefix` pointing at a tree this process does not run from.
+ * npm runs through cmd.exe on Windows, where a bare path with spaces would
+ * split — hence the quoting there. Platform is injected (axiom 6).
+ */
+export declare function npmInstallArgs(tag: string, options?: {
+    npmPrefix?: string | null | undefined;
+    packageRoot?: string | undefined;
+    platform?: string | undefined;
+}): string[];
+/** Engine `updater.js:19`: default cache dir name under the host's tmpdir. */
+export declare const NPM_UPDATE_CACHE_DIRNAME = "amalgm-npm-cache";
+/**
+ * Engine `updater.js:112-124`: the npm environment overlay —
+ * `npm_config_audit: 'false'`, `npm_config_fund: 'false'`,
+ * `npm_config_prefer_online: 'true'`, and a cache directory resolved as
+ * `npm_config_cache || NPM_CONFIG_CACHE || AMALGM_NPM_UPDATE_CACHE ||
+ * <tmpdir>/amalgm-npm-cache`. The tmpdir is injected (axiom 6).
+ */
+export declare function npmEnv(env: Readonly<Record<string, string | undefined>>, options: {
+    tmpdir: string;
+}): Record<string, string | undefined>;
+/** Engine `updater.js:175-178`: the detail attached to a failed npm run. */
+export declare function npmFailureDetail(result: {
+    timedOut?: boolean | undefined;
+    stdout?: string | undefined;
+    stderr?: string | undefined;
+}): string;
+/**
+ * Engine `updater.js:187`. Byte-exact, including the trailing space when
+ * the detail is empty — surfaces match on this string.
+ */
+export declare function distTagCheckFailedMessage(tag: string, detail: string): string;
+/** Engine `updater.js:207`. `status` is the exit status, signal, or `'unknown'`. */
+export declare function installFailedMessage(tag: string, status: string | number, detail: string): string;
+/** Engine `updater.js:216`: npm answered but produced no version. */
+export declare function noVersionMessage(tag: string): string;
+/** Engine `updater.js:16`: the error code surfaces and the manager match on. */
+export declare const UPDATE_TARGET_MISMATCH = "AMALGM_UPDATE_TARGET_MISMATCH";
+export interface UpdateTargetMismatchError extends Error {
+    code: typeof UPDATE_TARGET_MISMATCH;
+    targetVersion: string;
+    installedVersion: string | null;
+    packageRoot: string;
+}
+/**
+ * Engine `updater.js:232-239`: npm reported success but the tree this
+ * runtime boots from still carries the old version — the update landed in a
+ * different npm prefix and will never take effect here. Restarting cannot
+ * fix it, so the manager suppresses restarts for this target (see
+ * `restartSuppressedDetail`). Message and `code` are byte-exact.
+ */
+export declare function updateTargetMismatchError(input: {
+    tag: string;
+    targetVersion: string;
+    packageRoot: string;
+    installedVersion: string | null;
+}): UpdateTargetMismatchError;
+/**
+ * Engine `supervisor.js:862`: the `restart_suppressed` state's
+ * `last_error` when a previously-mismatched target shows up again.
+ */
+export declare function restartSuppressedDetail(targetVersion: string, packageRootDir: string): string;
+/**
+ * The auto-update status vocabulary (axiom 8 — exactly these ten), written
+ * to the auto-update state file and read by every surface.
+ */
+export declare const AUTO_UPDATE_STATUSES: readonly ["disabled", "checking", "current", "installing", "restart_required", "critical_restart_required", "critical_restart_pending", "restart_pending", "restart_suppressed", "error"];
+export type AutoUpdateStatus = (typeof AUTO_UPDATE_STATUSES)[number];
+/** Engine `supervisor.js:82-87`: 15-minute checks, 60s initial delay. */
+export declare const AUTO_UPDATE_POLICY: {
+    readonly checkIntervalMs: 900000;
+    readonly initialDelayMs: 60000;
+    readonly idlePollMs: 10000;
+    readonly idleTimeoutMs: 2500;
+};
+/**
+ * Env overrides and their floors (engine `supervisor.js:679,722-736`). A
+ * non-numeric or non-positive value falls back to the policy default; a
+ * numeric value is clamped up to the floor — the knobs can slow the
+ * updater down, never turn it into a busy loop.
+ */
+export declare const AUTO_UPDATE_ENV_OVERRIDES: {
+    readonly checkIntervalMs: {
+        readonly envName: "AMALGM_UPDATE_CHECK_INTERVAL_MS";
+        readonly minimum: 60000;
+    };
+    readonly initialDelayMs: {
+        readonly envName: "AMALGM_UPDATE_INITIAL_DELAY_MS";
+        readonly minimum: 5000;
+    };
+    readonly idlePollMs: {
+        readonly envName: "AMALGM_UPDATE_IDLE_POLL_MS";
+        readonly minimum: 1000;
+    };
+    readonly idleTimeoutMs: {
+        readonly envName: "AMALGM_UPDATE_IDLE_TIMEOUT_MS";
+        readonly minimum: 500;
+    };
+};
+/**
+ * Engine `supervisor.js:570-574` (`numberFromEnv`), over an injected raw
+ * value: `Number(value)`; non-finite or `<= 0` → fallback; otherwise
+ * `max(minimum, value)`.
+ */
+export declare function numberFromEnvValue(value: unknown, fallback: number, minimum?: number): number;
+/** Resolve the full auto-update timing policy from an injected env map. */
+export declare function resolveAutoUpdateTimings(env: Readonly<Record<string, string | undefined>>): {
+    checkIntervalMs: number;
+    initialDelayMs: number;
+    idlePollMs: number;
+    idleTimeoutMs: number;
+};
+/**
+ * Engine `supervisor.js:696-699` (`envFlag`), over an injected raw value:
+ * trimmed, lowercased, truthy iff in `['1', 'true', 'yes', 'on']`. Used
+ * for `AMALGM_SERVICE_MANAGED`, `AMALGM_UPDATE_CRITICAL`, and
+ * `AMALGM_AUTO_UPDATE_CRITICAL`.
+ */
+export declare function envFlag(value: string | undefined): boolean;
+/** The idle report the manager polls while waiting to restart. */
+export interface RuntimeIdleStatus {
+    readonly idle: boolean;
+    readonly reason?: string | undefined;
+    readonly active_turns?: number | null | undefined;
+    readonly tempstore_count?: number | null | undefined;
+    readonly mcp_active?: number | null | undefined;
+}
+/**
+ * Engine `supervisor.js:766`: the `idle_blocked_reason` written when the
+ * runtime is not under a service manager — a restart would not come back.
+ */
+export declare const NOT_SERVICE_MANAGED_REASON = "runtime is not service-managed";
+/**
+ * Engine `supervisor.js:660-675`: why a pending restart is blocked, in
+ * precedence order and byte-exact — the UI shows these verbatim:
+ *
+ *   - null when idle;
+ *   - a probe error's own message when present;
+ *   - `tempstore has N active turn(s)`;
+ *   - `mcp has N active agent conversation(s)`;
+ *   - `runtime is busy` when not idle for any other reason.
+ */
+export declare function autoUpdateIdleBlockedReason(idle: RuntimeIdleStatus): string | null;
+//# sourceMappingURL=update.d.ts.map

package/dist/supervision/update.d.ts.map

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

package/dist/supervision/update.js

@@ -0,0 +1,336 @@
+/**
+ * Updater laws — version comparison, npm install shape, and the
+ * auto-update manager's state vocabulary.
+ *
+ * The host runs npm, reads disks, and restarts processes; this module owns
+ * every decision and every contract string (axiom 8): the semver rules the
+ * updater lives by, the exact npm argv and environment, the error messages
+ * surfaces match on, and the idle-gating reasons the UI displays.
+ *
+ * Engine sources (production until cutover, axiom 9):
+ * `packages/amalgm/lib/updater.js` and `packages/amalgm/lib/supervisor.js`
+ * (auto-update manager), with the label→tag rule imported from
+ * `identity/labels.ts` — one definition (axiom 2).
+ */
+import { npmTagForRuntimeLabel } from '../identity/labels.js';
+/**
+ * Engine `updater.js:21-31`. Notable exactness: a leading `v` is stripped;
+ * non-numeric components collapse to 0 (`Number(x) || 0`); the prerelease
+ * is whatever follows the FIRST hyphen up to the second — `split('-', 2)`
+ * truncates `1.0.0-alpha-beta` to prerelease `alpha`.
+ */
+export function parseSemver(value) {
+    const raw = String(value || '').trim().replace(/^v/, '');
+    const [core = '', prerelease = ''] = raw.split('-', 2);
+    const [major = '0', minor = '0', patch = '0'] = core.split('.');
+    return {
+        major: Number(major) || 0,
+        minor: Number(minor) || 0,
+        patch: Number(patch) || 0,
+        prerelease,
+    };
+}
+/**
+ * Engine `updater.js:33-55`. The prerelease rules, each load-bearing:
+ *
+ *   1. Both absent → equal.
+ *   2. An ABSENT prerelease WINS: `1.0.0` > `1.0.0-rc.1` — a release
+ *      outranks every prerelease of the same core version.
+ *   3. Dot-separated parts compare left to right; when one side runs out of
+ *      parts, the SHORTER side is smaller (`1.0.0-rc` < `1.0.0-rc.1`).
+ *   4. Two numeric parts compare numerically (`rc.2` < `rc.10`).
+ *   5. A numeric part is smaller than an alphanumeric part:
+ *      `1.0.0-2` < `1.0.0-alpha`.
+ *   6. Two alphanumeric parts compare lexically (`>` / `<` on strings).
+ */
+export function comparePrerelease(left, right) {
+    if (!left && !right)
+        return 0;
+    if (!left)
+        return 1;
+    if (!right)
+        return -1;
+    const aParts = left.split('.');
+    const bParts = right.split('.');
+    const count = Math.max(aParts.length, bParts.length);
+    for (let i = 0; i < count; i += 1) {
+        const a = aParts[i] || '';
+        const b = bParts[i] || '';
+        if (a === b)
+            continue;
+        if (!a)
+            return -1;
+        if (!b)
+            return 1;
+        const aNum = /^\d+$/.test(a) ? Number(a) : null;
+        const bNum = /^\d+$/.test(b) ? Number(b) : null;
+        if (aNum !== null && bNum !== null)
+            return aNum > bNum ? 1 : -1;
+        if (aNum !== null && bNum === null)
+            return -1;
+        if (aNum === null && bNum !== null)
+            return 1;
+        if (a !== b)
+            return a > b ? 1 : -1;
+    }
+    return 0;
+}
+/** Engine `updater.js:57-64`: major/minor/patch first, prerelease last. */
+export function compareVersions(left, right) {
+    const a = parseSemver(left);
+    const b = parseSemver(right);
+    for (const key of ['major', 'minor', 'patch']) {
+        if (a[key] !== b[key])
+            return a[key] > b[key] ? 1 : -1;
+    }
+    return comparePrerelease(a.prerelease, b.prerelease);
+}
+/**
+ * Engine `updater.js:106-110`: an explicit tag/channel wins with any
+ * leading `@` stripped (`@canary` → `canary`); otherwise the runtime
+ * label's tag. The label is injected — the engine's
+ * `AMALGM_RUNTIME_LABEL` fallback is the host's job.
+ */
+export function npmInstallTag(options) {
+    const explicit = options.tag || options.channel;
+    if (explicit && explicit !== true)
+        return String(explicit).replace(/^@/, '');
+    return npmTagForRuntimeLabel(options.runtimeLabel);
+}
+/**
+ * Engine `updater.js:244-249`. `AMALGM_DISABLE_AUTO_UPDATE` disables on a
+ * truthy value (`'1' | 'true' | 'yes' | 'on'`), `AMALGM_AUTO_UPDATE`
+ * disables on a falsy value (`'0' | 'false' | 'no' | 'off'`); both are
+ * trimmed and lowercased first. The env map is injected (axiom 6).
+ */
+export function envDisablesAutoUpdate(env) {
+    const disable = String(env['AMALGM_DISABLE_AUTO_UPDATE'] || '').trim().toLowerCase();
+    if (['1', 'true', 'yes', 'on'].includes(disable))
+        return true;
+    const auto = String(env['AMALGM_AUTO_UPDATE'] || '').trim().toLowerCase();
+    return ['0', 'false', 'no', 'off'].includes(auto);
+}
+/** Engine `updater.js:251-254`: the `local` label never auto-updates. */
+export function autoUpdateSupported(runtimeLabel) {
+    return runtimeLabel !== 'local';
+}
+/** Engine `updater.js:256-259`. */
+export function shouldAutoUpdate(options) {
+    return autoUpdateSupported(options.runtimeLabel) && !envDisablesAutoUpdate(options.env);
+}
+/**
+ * Engine `updater.js:77-83`. npm lays out global installs as
+ * `<prefix>/lib/node_modules/<name>` on POSIX and
+ * `<prefix>/node_modules/<name>` on Windows. Walking that layout backwards
+ * from the package root this process runs from recovers the prefix that
+ * owns the running install, so updates land in the tree the service
+ * actually boots — not whatever prefix the inherited environment points at.
+ * Returns null when the root is not a global-install layout (e.g. a repo
+ * checkout).
+ *
+ * Purity note: the engine calls `path.resolve`; this SDK takes an
+ * already-absolute root and normalizes `\` to `/` (the returned prefix uses
+ * forward slashes — a comparison key, not a filesystem call site).
+ */
+export function globalPrefixForPackageRoot(packageRoot) {
+    const root = String(packageRoot).replace(/\\/g, '/').replace(/\/+$/, '');
+    const nodeModules = dirnamePosix(root);
+    if (basenamePosix(nodeModules) !== 'node_modules')
+        return null;
+    const parent = dirnamePosix(nodeModules);
+    return basenamePosix(parent) === 'lib' ? dirnamePosix(parent) : parent;
+}
+function dirnamePosix(value) {
+    const index = value.lastIndexOf('/');
+    if (index < 0)
+        return '.';
+    if (index === 0)
+        return '/';
+    return value.slice(0, index);
+}
+function basenamePosix(value) {
+    const index = value.lastIndexOf('/');
+    return index < 0 ? value : value.slice(index + 1);
+}
+/**
+ * Engine `updater.js:94-104`: exactly `['install', '-g', 'amalgm@<tag>']`,
+ * plus `['--prefix', prefix]` when a prefix is known. The `--prefix` flag
+ * outranks every npm config layer, including an inherited
+ * `npm_config_prefix` pointing at a tree this process does not run from.
+ * npm runs through cmd.exe on Windows, where a bare path with spaces would
+ * split — hence the quoting there. Platform is injected (axiom 6).
+ */
+export function npmInstallArgs(tag, options = {}) {
+    const args = ['install', '-g', `amalgm@${tag}`];
+    const prefix = options.npmPrefix !== undefined
+        ? options.npmPrefix
+        : (options.packageRoot !== undefined ? globalPrefixForPackageRoot(options.packageRoot) : null);
+    if (prefix)
+        args.push('--prefix', options.platform === 'win32' ? `"${prefix}"` : prefix);
+    return args;
+}
+/** Engine `updater.js:19`: default cache dir name under the host's tmpdir. */
+export const NPM_UPDATE_CACHE_DIRNAME = 'amalgm-npm-cache';
+/**
+ * Engine `updater.js:112-124`: the npm environment overlay —
+ * `npm_config_audit: 'false'`, `npm_config_fund: 'false'`,
+ * `npm_config_prefer_online: 'true'`, and a cache directory resolved as
+ * `npm_config_cache || NPM_CONFIG_CACHE || AMALGM_NPM_UPDATE_CACHE ||
+ * <tmpdir>/amalgm-npm-cache`. The tmpdir is injected (axiom 6).
+ */
+export function npmEnv(env, options) {
+    const safeCache = env['npm_config_cache']
+        || env['NPM_CONFIG_CACHE']
+        || env['AMALGM_NPM_UPDATE_CACHE']
+        || `${options.tmpdir.replace(/[\\/]+$/, '')}/${NPM_UPDATE_CACHE_DIRNAME}`;
+    return {
+        ...env,
+        npm_config_audit: 'false',
+        npm_config_fund: 'false',
+        npm_config_cache: safeCache,
+        npm_config_prefer_online: 'true',
+    };
+}
+/** Engine `updater.js:175-178`: the detail attached to a failed npm run. */
+export function npmFailureDetail(result) {
+    if (result.timedOut)
+        return 'npm command timed out';
+    return String(result.stderr || result.stdout || '').trim();
+}
+/**
+ * Engine `updater.js:187`. Byte-exact, including the trailing space when
+ * the detail is empty — surfaces match on this string.
+ */
+export function distTagCheckFailedMessage(tag, detail) {
+    return `Could not check npm dist-tag "${tag}". ${detail}`;
+}
+/** Engine `updater.js:207`. `status` is the exit status, signal, or `'unknown'`. */
+export function installFailedMessage(tag, status, detail) {
+    return `npm install -g amalgm@${tag} failed with status ${status}${detail ? `: ${detail}` : ''}`;
+}
+/** Engine `updater.js:216`: npm answered but produced no version. */
+export function noVersionMessage(tag) {
+    return `npm did not return a version for amalgm@${tag}`;
+}
+/** Engine `updater.js:16`: the error code surfaces and the manager match on. */
+export const UPDATE_TARGET_MISMATCH = 'AMALGM_UPDATE_TARGET_MISMATCH';
+/**
+ * Engine `updater.js:232-239`: npm reported success but the tree this
+ * runtime boots from still carries the old version — the update landed in a
+ * different npm prefix and will never take effect here. Restarting cannot
+ * fix it, so the manager suppresses restarts for this target (see
+ * `restartSuppressedDetail`). Message and `code` are byte-exact.
+ */
+export function updateTargetMismatchError(input) {
+    const error = new Error(`npm reported installing amalgm@${input.tag} (${input.targetVersion}), but the install this runtime boots from at ${input.packageRoot} still carries ${input.installedVersion || 'no readable version'}. The update landed in a different npm prefix and will never take effect here.`);
+    error.code = UPDATE_TARGET_MISMATCH;
+    error.targetVersion = input.targetVersion;
+    error.installedVersion = input.installedVersion;
+    error.packageRoot = input.packageRoot;
+    return error;
+}
+/**
+ * Engine `supervisor.js:862`: the `restart_suppressed` state's
+ * `last_error` when a previously-mismatched target shows up again.
+ */
+export function restartSuppressedDetail(targetVersion, packageRootDir) {
+    return `update ${targetVersion} does not apply to this install (running from ${packageRootDir}); waiting for an install that includes it`;
+}
+/* ------------------------------------------------------------------ *
+ * Auto-update manager laws (engine supervisor.js:660-938).
+ * ------------------------------------------------------------------ */
+/**
+ * The auto-update status vocabulary (axiom 8 — exactly these ten), written
+ * to the auto-update state file and read by every surface.
+ */
+export const AUTO_UPDATE_STATUSES = [
+    'disabled',
+    'checking',
+    'current',
+    'installing',
+    'restart_required',
+    'critical_restart_required',
+    'critical_restart_pending',
+    'restart_pending',
+    'restart_suppressed',
+    'error',
+];
+/** Engine `supervisor.js:82-87`: 15-minute checks, 60s initial delay. */
+export const AUTO_UPDATE_POLICY = {
+    checkIntervalMs: 900_000, // 15 * 60_000 in the engine
+    initialDelayMs: 60_000,
+    idlePollMs: 10_000,
+    idleTimeoutMs: 2_500,
+};
+/**
+ * Env overrides and their floors (engine `supervisor.js:679,722-736`). A
+ * non-numeric or non-positive value falls back to the policy default; a
+ * numeric value is clamped up to the floor — the knobs can slow the
+ * updater down, never turn it into a busy loop.
+ */
+export const AUTO_UPDATE_ENV_OVERRIDES = {
+    checkIntervalMs: { envName: 'AMALGM_UPDATE_CHECK_INTERVAL_MS', minimum: 60_000 },
+    initialDelayMs: { envName: 'AMALGM_UPDATE_INITIAL_DELAY_MS', minimum: 5_000 },
+    idlePollMs: { envName: 'AMALGM_UPDATE_IDLE_POLL_MS', minimum: 1_000 },
+    idleTimeoutMs: { envName: 'AMALGM_UPDATE_IDLE_TIMEOUT_MS', minimum: 500 },
+};
+/**
+ * Engine `supervisor.js:570-574` (`numberFromEnv`), over an injected raw
+ * value: `Number(value)`; non-finite or `<= 0` → fallback; otherwise
+ * `max(minimum, value)`.
+ */
+export function numberFromEnvValue(value, fallback, minimum = 0) {
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed <= 0)
+        return fallback;
+    return Math.max(minimum, parsed);
+}
+/** Resolve the full auto-update timing policy from an injected env map. */
+export function resolveAutoUpdateTimings(env) {
+    return {
+        checkIntervalMs: numberFromEnvValue(env[AUTO_UPDATE_ENV_OVERRIDES.checkIntervalMs.envName], AUTO_UPDATE_POLICY.checkIntervalMs, AUTO_UPDATE_ENV_OVERRIDES.checkIntervalMs.minimum),
+        initialDelayMs: numberFromEnvValue(env[AUTO_UPDATE_ENV_OVERRIDES.initialDelayMs.envName], AUTO_UPDATE_POLICY.initialDelayMs, AUTO_UPDATE_ENV_OVERRIDES.initialDelayMs.minimum),
+        idlePollMs: numberFromEnvValue(env[AUTO_UPDATE_ENV_OVERRIDES.idlePollMs.envName], AUTO_UPDATE_POLICY.idlePollMs, AUTO_UPDATE_ENV_OVERRIDES.idlePollMs.minimum),
+        idleTimeoutMs: numberFromEnvValue(env[AUTO_UPDATE_ENV_OVERRIDES.idleTimeoutMs.envName], AUTO_UPDATE_POLICY.idleTimeoutMs, AUTO_UPDATE_ENV_OVERRIDES.idleTimeoutMs.minimum),
+    };
+}
+/**
+ * Engine `supervisor.js:696-699` (`envFlag`), over an injected raw value:
+ * trimmed, lowercased, truthy iff in `['1', 'true', 'yes', 'on']`. Used
+ * for `AMALGM_SERVICE_MANAGED`, `AMALGM_UPDATE_CRITICAL`, and
+ * `AMALGM_AUTO_UPDATE_CRITICAL`.
+ */
+export function envFlag(value) {
+    return ['1', 'true', 'yes', 'on'].includes(String(value || '').trim().toLowerCase());
+}
+/**
+ * Engine `supervisor.js:766`: the `idle_blocked_reason` written when the
+ * runtime is not under a service manager — a restart would not come back.
+ */
+export const NOT_SERVICE_MANAGED_REASON = 'runtime is not service-managed';
+/**
+ * Engine `supervisor.js:660-675`: why a pending restart is blocked, in
+ * precedence order and byte-exact — the UI shows these verbatim:
+ *
+ *   - null when idle;
+ *   - a probe error's own message when present;
+ *   - `tempstore has N active turn(s)`;
+ *   - `mcp has N active agent conversation(s)`;
+ *   - `runtime is busy` when not idle for any other reason.
+ */
+export function autoUpdateIdleBlockedReason(idle) {
+    if (idle.idle)
+        return null;
+    if (idle.reason)
+        return idle.reason;
+    const tempstoreCount = Number(idle.tempstore_count ?? idle.active_turns) || 0;
+    if (tempstoreCount > 0) {
+        return `tempstore has ${tempstoreCount} active turn${tempstoreCount === 1 ? '' : 's'}`;
+    }
+    const mcpActive = Number(idle.mcp_active) || 0;
+    if (mcpActive > 0) {
+        return `mcp has ${mcpActive} active agent conversation${mcpActive === 1 ? '' : 's'}`;
+    }
+    return 'runtime is busy';
+}
+//# sourceMappingURL=update.js.map

package/dist/supervision/update.js.map

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