@kynver-app/runtime 0.2.24 → 0.2.29

package/dist/wsl-crash-dumps.d.ts

@@ -1,90 +0,0 @@
-/** Default total bytes in wsl-crashes before the observer flags warning (5 GiB). */
-export declare const DEFAULT_WSL_CRASH_DUMP_WARN_BYTES: number;
-/** Default total bytes before critical — ~4× typical 2.2 GiB node dump (10 GiB). */
-export declare const DEFAULT_WSL_CRASH_DUMP_CRITICAL_BYTES: number;
-/** Default dump count before warning. */
-export declare const DEFAULT_WSL_CRASH_DUMP_WARN_COUNT = 2;
-/** Default dump count before critical. */
-export declare const DEFAULT_WSL_CRASH_DUMP_CRITICAL_COUNT = 4;
-export interface WslCrashDumpFile {
-    name: string;
-    path: string;
-    bytes: number;
-    mtimeMs: number;
-    /** Best-effort executable hint parsed from the WSL dump filename. */
-    executableHint: string | null;
-    signal: number | null;
-    pid: number | null;
-}
-export interface WslCrashDumpObservation {
-    ok: boolean;
-    /** Resolved host path (WSL mount) to the wsl-crashes directory. */
-    path: string | null;
-    windowsUser: string | null;
-    dumpCount: number;
-    totalBytes: number;
-    warnBelowBytes: number;
-    criticalBelowBytes: number;
-    warnCount: number;
-    criticalCount: number;
-    /** Newest dumps first. */
-    dumps: WslCrashDumpFile[];
-    /** Unique executable hints across dumps (e.g. node, cursor, vscode-server). */
-    executables: string[];
-    /** `kernel.core_pattern` when readable — surfaces wsl-capture-crash vs apport. */
-    corePattern: string | null;
-    wslCaptureEnabled: boolean;
-    /** Parsed MaxCrashDumpCount from %USERPROFILE%/.wslconfig when readable. */
-    maxCrashDumpCount: number | null;
-    dumpsDisabledInWslConfig: boolean;
-    reason: string | null;
-    probeError: string | null;
-}
-export interface ObserveWslCrashDumpsOptions {
-    forceWsl?: boolean;
-    hostMount?: string;
-    windowsUser?: string;
-    crashDumpDir?: string;
-    warnBelowBytes?: number;
-    criticalBelowBytes?: number;
-    warnCount?: number;
-    criticalCount?: number;
-    /** Test seam — inject listing instead of reading the filesystem. */
-    listDumps?: (dir: string) => WslCrashDumpFile[];
-    readCorePattern?: () => string | null;
-    readWslConfig?: (windowsUser: string, hostMount: string) => WslConfigCrashDumpSettings | null;
-}
-export interface WslConfigCrashDumpSettings {
-    maxCrashDumpCount: number | null;
-    crashDumpFolder: string | null;
-}
-/**
- * Resolve the Windows username for the WSL interop mount. Order: explicit env,
- * `cmd.exe echo %USERNAME%`, then Linux user matching `/mnt/c/Users/<user>`.
- */
-export declare function resolveWslWindowsUsername(): string | null;
-/** Default Windows-side folder: `%LOCALAPPDATA%\\Temp\\wsl-crashes` under the host mount. */
-export declare function resolveWslCrashDumpDir(options?: {
-    hostMount?: string;
-    windowsUser?: string | null;
-    crashDumpDir?: string;
-}): string | null;
-/** Parse WSL dump names like `wsl-crash-1726372480-366-_usr_bin_node-6.dmp`. */
-export declare function parseWslCrashDumpFilename(name: string): {
-    executableHint: string | null;
-    signal: number | null;
-    pid: number | null;
-};
-export declare function readKernelCorePattern(): string | null;
-export declare function isWslCaptureCrashPattern(corePattern: string | null): boolean;
-/** Best-effort parse of `%USERPROFILE%/.wslconfig` crash-dump knobs. */
-export declare function readWslConfigCrashDumpSettings(windowsUser: string, hostMount?: string): WslConfigCrashDumpSettings | null;
-/**
- * Observe Windows-side WSL crash dumps. Returns `null` on non-WSL hosts.
- * When the directory is missing, returns a healthy empty observation.
- */
-export declare function observeWslCrashDumps(options?: ObserveWslCrashDumpsOptions): WslCrashDumpObservation | null;
-export declare function summarizeWslCrashDumpRecoverySteps(input?: {
-    wslCaptureEnabled?: boolean;
-    dumpsDisabledInWslConfig?: boolean;
-}): string;

package/dist/wsl-host.d.ts

@@ -1,71 +0,0 @@
-/**
- * WSL host disk probe.
- *
- * Under WSL, the runtime VHDX (mounted at `/`) grows dynamically into the
- * Windows host C: drive. When Windows C: fills up, the VHDX cannot expand:
- * writes return SIGBUS, workers exit 135, and the Vmmem VM degrades while
- * the Linux-side `statfs /` still reports plenty of free space inside the
- * VHDX. This module gives the harness a cheap signal for that pressure so
- * it can block dispatch *before* a large npm install/build pushes Windows
- * C: into the ground.
- */
-/** Default warn threshold for the Windows host disk (25 GiB free). */
-export declare const DEFAULT_WSL_HOST_WARN_FREE_BYTES: number;
-/** Default critical threshold for the Windows host disk (12 GiB free). Below
- * this, large rebuilds have been observed to trigger SIGBUS / exit 135 on
- * WSL when the VHDX cannot grow further. */
-export declare const DEFAULT_WSL_HOST_CRITICAL_FREE_BYTES: number;
-/** Default Windows host mount point under WSL. Overridable via env or option. */
-export declare const DEFAULT_WSL_HOST_MOUNT = "/mnt/c";
-export interface WslHostDiskShape {
-    ok: boolean;
-    /** Mount point that was probed. */
-    path: string;
-    freeBytes: number;
-    totalBytes: number;
-    usedPercent: number;
-    warnBelowBytes: number;
-    criticalBelowBytes: number;
-    /** Human-readable explanation when the host disk is under pressure. */
-    reason: string | null;
-    /** True when the probe itself failed (mount missing, statfs error). */
-    probeError: string | null;
-}
-/**
- * Cheap WSL detection. Reads `/proc/sys/kernel/osrelease` (kernel string
- * contains "microsoft" / "WSL2" on Microsoft's WSL kernel) and falls back
- * to `/proc/version`. Both reads are one-shot and gated by `existsSync`,
- * so non-Linux hosts return false without throwing.
- */
-export declare function isWslHost(): boolean;
-export interface ObserveWslHostDiskOptions {
-    /** Override the Windows host mount path (e.g. `/mnt/d`). Falls back to
-     * `KYNVER_WSL_HOST_MOUNT` env, then `/mnt/c`. */
-    wslHostMount?: string;
-    wslHostFreeWarnBytes?: number;
-    wslHostFreeCriticalBytes?: number;
-    /** Override WSL detection for tests / cross-platform CI:
-     * `true` → treat host as WSL; `false` → treat host as non-WSL;
-     * `undefined` → autodetect via `isWslHost()`. */
-    forceWsl?: boolean;
-    /** Test seam — swap in a fake statfs. */
-    statfs?: (path: string) => {
-        bavail: bigint | number;
-        blocks: bigint | number;
-        bsize: bigint | number;
-    };
-}
-/**
- * Probe the Windows host disk under WSL. Returns `null` when this host is
- * not WSL (so callers can treat the field as optional in the gate output).
- * When WSL but the mount is unreachable, returns a `probeError` row with
- * `ok = false` rather than throwing — the gate must still block dispatch
- * because we can't prove the host disk is healthy.
- */
-export declare function observeWslHostDisk(options?: ObserveWslHostDiskOptions): WslHostDiskShape | null;
-/**
- * Short operator recovery hint embedded in gate reasons so AgentOS evidence
- * surfaces actionable steps without a doc lookup. Keep terse — full runbook
- * lives at `docs/runbooks/wsl-disk-pressure.md`.
- */
-export declare function summarizeWslRecoverySteps(): string;