@elvisw/dsh-magic-context 0.0.0-bootstrap.0 → 0.0.0-stage

package/lib/dsh/volatile.js

@@ -1,89 +0,0 @@
-/**
- * The volatile-reference readers and the decision-point policy resolver
- * (moved verbatim out of index.ts so every wiring module reads config the
- * same way). Schemastery's volatile fields arrive as live references; the
- * `live*` helpers unwrap them (recursively — nested objects wrap each level)
- * so a settings-form edit applies without a remount.
- */
-import { DEFAULT_POLICY } from "../core/policy.js";
-/** Same as {@link liveNumber} for strings (volatile enums such as log level). */
-export function liveString(value, fallback) {
-    const resolved = liveValue(value);
-    return typeof resolved === 'string' && resolved.length > 0 ? resolved : fallback;
-}
-/**
- * Unwrap a schemastery volatile reference chain. Nested config objects wrap
- * each level, so `config.a?.b?.c` can hand back a reference whose `.get()`
- * is itself a reference — one dereference is not always enough (measured:
- * `maintenance.verifyProvider` printed `[object Object]` with single unwrap).
- */
-export function liveValue(value) {
-    if (value !== null && typeof value === 'object' && typeof value.get === 'function') {
-        return liveValue(value.get());
-    }
-    return value;
-}
-/** Read a value that may be a plain number or a volatile reference. */
-export function liveNumber(value, fallback) {
-    const resolved = liveValue(value);
-    return typeof resolved === 'number' && Number.isFinite(resolved) ? resolved : fallback;
-}
-/** Same as {@link liveNumber} for booleans (volatile toggles). */
-export function liveBoolean(value, fallback) {
-    if (typeof value === 'boolean')
-        return value;
-    if (value !== null && typeof value === 'object' && typeof value.get === 'function') {
-        const current = value.get();
-        if (typeof current === 'boolean')
-            return current;
-    }
-    return fallback;
-}
-/**
- * Read a provider/model route pin live.
- *
- * A pin is only a pin when BOTH halves are non-empty (the same rule the host
- * applies to the maintenance route): a half-filled pair would otherwise be
- * passed to the historian as a route and fail the run with "no configured
- * model". `undefined` means "follow the session route".
- */
-export function liveRoute(provider, model) {
-    const providerValue = typeof provider === 'string' ? provider : liveString(provider, '');
-    const modelValue = typeof model === 'string' ? model : liveString(model, '');
-    return providerValue.length > 0 && modelValue.length > 0
-        ? { provider: providerValue, model: modelValue }
-        : undefined;
-}
-/**
- * The effective pressure policy, evaluated AT THE DECISION POINT.
- *
- * This is what makes a settings-form edit take effect without a restart: the
- * form writes a volatile value, the loader commits it into the reference, and
- * the next pass re-reads it here.
- */
-export function policyOf(configured) {
-    const raw = (configured ?? {});
-    // Deliberately unannotated: annotating this `PressurePolicy` makes every
-    // property below a read-only assignment (45 compile errors) even though the
-    // spread already produced a mutable copy. The return type still checks it.
-    const policy = { ...DEFAULT_POLICY };
-    for (const key of Object.keys(DEFAULT_POLICY)) {
-        const value = raw[key];
-        if (value === undefined)
-            continue;
-        const fallback = DEFAULT_POLICY[key];
-        if (typeof fallback === 'number') {
-            policy[key] = liveNumber(value, fallback);
-        }
-        else if (typeof fallback === 'boolean') {
-            policy[key] = liveBoolean(value, fallback);
-        }
-        else if (typeof fallback === 'string') {
-            policy[key] = liveString(value, fallback);
-        }
-        else {
-            policy[key] = value;
-        }
-    }
-    return policy;
-}