@camstack/system 1.2.390 → 1.2.392

package/dist/process/proc-stat.d.ts

@@ -1,74 +1,74 @@
 /**
- * Kernel jiffies per second (`USER_HZ`). `sysconf(_SC_CLK_TCK)` is not exposed
- * to Node, and this has been 100 on every Linux/x86-64 and arm64 kernel
- * configuration we ship to. A wrong value would scale every CPU number and
- * every elapsed time by one constant — visible at once, not a silent skew.
- */
+* Kernel jiffies per second (`USER_HZ`). `sysconf(_SC_CLK_TCK)` is not exposed
+* to Node, and this has been 100 on every Linux/x86-64 and arm64 kernel
+* configuration we ship to. A wrong value would scale every CPU number and
+* every elapsed time by one constant — visible at once, not a silent skew.
+*/
 export declare const CLOCK_TICKS_PER_SEC = 100;
 /** The fields of one `/proc/<pid>/stat` line this repository reads. */
 export interface ProcStat {
-    readonly pid: number;
-    readonly comm: string;
-    /** Field 3: `R`, `S`, `D`, `Z`, … */
-    readonly state: string;
-    readonly ppid: number;
-    readonly pgid: number;
-    /** `utime + stime`, in jiffies, over the process's whole life. */
-    readonly ticks: number;
-    /** Field 22: jiffies since boot at which this incarnation of the pid began. */
-    readonly startTicks: number;
-    /** Field 24: resident pages. Prefer `VmRSS` from `status`, which is in kB. */
-    readonly rssPages: number;
+	readonly pid: number;
+	readonly comm: string;
+	/** Field 3: `R`, `S`, `D`, `Z`, … */
+	readonly state: string;
+	readonly ppid: number;
+	readonly pgid: number;
+	/** `utime + stime`, in jiffies, over the process's whole life. */
+	readonly ticks: number;
+	/** Field 22: jiffies since boot at which this incarnation of the pid began. */
+	readonly startTicks: number;
+	/** Field 24: resident pages. Prefer `VmRSS` from `status`, which is in kB. */
+	readonly rssPages: number;
 }
 /**
- * Parse one `/proc/<pid>/stat` line. `null` for a line that does not parse —
- * a process that exited between the readdir and the read leaves a truncated
- * or empty file, and that is normal, not an error.
- */
+* Parse one `/proc/<pid>/stat` line. `null` for a line that does not parse —
+* a process that exited between the readdir and the read leaves a truncated
+* or empty file, and that is normal, not an error.
+*/
 export declare function parseProcStat(line: string): ProcStat | null;
 /** Resident memory from `/proc/<pid>/status`, in bytes. Absent is `undefined`, never 0. */
 export interface ProcStatusRss {
-    /** `VmRSS` — what `ps rss` prints. */
-    readonly rssBytes: number | undefined;
-    /** `RssAnon` — private anonymous memory, the runner's own cost. */
-    readonly privateBytes: number | undefined;
-    /** `RssFile` — file-backed pages shared with every process mapping the same files. */
-    readonly sharedBytes: number | undefined;
+	/** `VmRSS` — what `ps rss` prints. */
+	readonly rssBytes: number | undefined;
+	/** `RssAnon` — private anonymous memory, the runner's own cost. */
+	readonly privateBytes: number | undefined;
+	/** `RssFile` — file-backed pages shared with every process mapping the same files. */
+	readonly sharedBytes: number | undefined;
 }
 /** Read `VmRSS` / `RssAnon` / `RssFile` (kB in the file) out of `/proc/<pid>/status`. */
 export declare function parseProcStatusRss(status: string): ProcStatusRss;
 /** Inputs for the two `ps`-compatible derivations below. */
 export interface LifetimeCpuInput {
-    readonly ticks: number;
-    readonly startTicks: number;
-    /** First field of `/proc/uptime`, seconds since boot. */
-    readonly uptimeSec: number;
+	readonly ticks: number;
+	readonly startTicks: number;
+	/** First field of `/proc/uptime`, seconds since boot. */
+	readonly uptimeSec: number;
 }
 /** Seconds the process has been alive — `ps etime`, whole seconds. */
-export declare function elapsedSecSince(input: Pick<LifetimeCpuInput, 'startTicks' | 'uptimeSec'>): number;
+export declare function elapsedSecSince(input: Pick<LifetimeCpuInput, "startTicks" | "uptimeSec">): number;
 /**
- * `ps pcpu`: CPU time over elapsed time, as a percentage with one decimal.
- *
- * This is deliberately the LIFETIME average `ps` prints, not an instantaneous
- * rate: the columns fed from it have always shown that quantity, and the
- * instantaneous split is a different number with a different owner
- * (`cpuMainPercent` / `cpuGcPercent` from `thread-cpu-sampler.ts`). A process
- * with no elapsed window yet reports 0, never a division by zero.
- */
+* `ps pcpu`: CPU time over elapsed time, as a percentage with one decimal.
+*
+* This is deliberately the LIFETIME average `ps` prints, not an instantaneous
+* rate: the columns fed from it have always shown that quantity, and the
+* instantaneous split is a different number with a different owner
+* (`cpuMainPercent` / `cpuGcPercent` from `thread-cpu-sampler.ts`). A process
+* with no elapsed window yet reports 0, never a division by zero.
+*/
 export declare function lifetimeCpuPercent(input: LifetimeCpuInput): number;
 /**
- * The procfs surface, injectable — the whole reason the readers above are
- * testable against fixtures rather than against a Linux kernel.
- */
+* The procfs surface, injectable — the whole reason the readers above are
+* testable against fixtures rather than against a Linux kernel.
+*/
 export interface ProcReader {
-    /** Numeric entries of `/proc`. */
-    readonly listPids: () => Promise<readonly number[]>;
-    readonly readStat: (pid: number) => Promise<string>;
-    readonly readStatus: (pid: number) => Promise<string>;
-    /** Raw `/proc/<pid>/cmdline`: NUL-separated argv, empty for a kernel thread. */
-    readonly readCmdline: (pid: number) => Promise<string>;
-    /** First field of `/proc/uptime`. */
-    readonly readUptimeSec: () => Promise<number>;
+	/** Numeric entries of `/proc`. */
+	readonly listPids: () => Promise<readonly number[]>;
+	readonly readStat: (pid: number) => Promise<string>;
+	readonly readStatus: (pid: number) => Promise<string>;
+	/** Raw `/proc/<pid>/cmdline`: NUL-separated argv, empty for a kernel thread. */
+	readonly readCmdline: (pid: number) => Promise<string>;
+	/** First field of `/proc/uptime`. */
+	readonly readUptimeSec: () => Promise<number>;
 }
 export declare const nodeProcReader: ProcReader;
 /** `ps command=`: argv joined by spaces, or `[comm]` when there is no argv. */

package/dist/process/resource-monitor.d.ts

@@ -1,28 +1,28 @@
-import { ProcReader } from './proc-stat.js';
+import { type ProcReader } from "./proc-stat.js";
 export interface PidStats {
-    cpu: number;
-    memory: number;
-    /**
-     * Private anonymous resident bytes (Linux RssAnon) — per-process V8 heap +
-     * native allocs NOT shared across processes. The meaningful "what this runner
-     * actually costs" number (RSS double-counts the shared mmap'd framework).
-     * undefined where /proc/<pid>/status is unavailable (e.g. macOS).
-     */
-    privateBytes?: number;
-    /** Shared file-backed resident bytes (Linux RssFile). undefined on macOS. */
-    sharedBytes?: number;
+	cpu: number;
+	memory: number;
+	/**
+	* Private anonymous resident bytes (Linux RssAnon) — per-process V8 heap +
+	* native allocs NOT shared across processes. The meaningful "what this runner
+	* actually costs" number (RSS double-counts the shared mmap'd framework).
+	* undefined where /proc/<pid>/status is unavailable (e.g. macOS).
+	*/
+	privateBytes?: number;
+	/** Shared file-backed resident bytes (Linux RssFile). undefined on macOS. */
+	sharedBytes?: number;
 }
 /** The impure inputs, injectable so the platform branch is pinned by a test. */
 export interface PidStatsDeps {
-    readonly platform: NodeJS.Platform;
-    readonly reader: ProcReader;
-    /** `ps -o pid=,pcpu=,rss= -p <pids>` — the fork, for a platform without `/proc`. */
-    readonly spawnPs: (pids: readonly number[]) => Promise<string>;
+	readonly platform: NodeJS.Platform;
+	readonly reader: ProcReader;
+	/** `ps -o pid=,pcpu=,rss= -p <pids>` — the fork, for a platform without `/proc`. */
+	readonly spawnPs: (pids: readonly number[]) => Promise<string>;
 }
 /**
- * Get CPU% and memory RSS for one or more PIDs.
- * Returns a map of pid → stats. Missing/dead PIDs are silently omitted.
- */
+* Get CPU% and memory RSS for one or more PIDs.
+* Returns a map of pid → stats. Missing/dead PIDs are silently omitted.
+*/
 export declare function getPidStats(pids: number | readonly number[], deps?: PidStatsDeps): Promise<ReadonlyMap<number, PidStats>>;
 /** Get CPU% and memory RSS for a single PID. Returns null if dead. */
 export declare function getSinglePidStats(pid: number): Promise<PidStats | null>;

package/dist/python/python-env-manager.d.ts

@@ -1,12 +1,12 @@
-import { IPythonEnvironment, PythonProbeResult, PythonEnvReady } from '@camstack/types';
-import { ChildProcess } from 'node:child_process';
+import type { IPythonEnvironment, PythonProbeResult, PythonEnvReady } from "@camstack/types";
+import type { ChildProcess } from "node:child_process";
 export declare class PythonEnvManager implements IPythonEnvironment {
-    private venvPath;
-    private cachedProbe;
-    constructor(dataDir: string);
-    probe(): Promise<PythonProbeResult>;
-    ensure(options: {
-        packages: readonly string[];
-    }): Promise<PythonEnvReady>;
-    spawn(script: string, args: readonly string[]): ChildProcess;
+	private venvPath;
+	private cachedProbe;
+	constructor(dataDir: string);
+	probe(): Promise<PythonProbeResult>;
+	ensure(options: {
+		packages: readonly string[];
+	}): Promise<PythonEnvReady>;
+	spawn(script: string, args: readonly string[]): ChildProcess;
 }

package/dist/repl/interfaces.d.ts

@@ -1,31 +1,31 @@
-import { ReplResult } from '@camstack/types';
 export interface ReplScope {
-    readonly type: 'system' | 'provider' | 'device' | 'addon';
-    readonly providerId?: string;
-    readonly deviceId?: number;
-    readonly addonId?: string;
+	readonly type: "system" | "provider" | "device" | "addon";
+	readonly providerId?: string;
+	readonly deviceId?: number;
+	readonly addonId?: string;
 }
 export interface ReplSessionContext {
-    readonly scope: ReplScope;
-    /** Pre-populated variables available in the REPL session */
-    readonly variables: Record<string, unknown>;
+	readonly scope: ReplScope;
+	/** Pre-populated variables available in the REPL session */
+	readonly variables: Record<string, unknown>;
 }
+import type { ReplResult } from "@camstack/types";
 export type { ReplResult };
 export interface IReplEngine {
-    execute(code: string, context: ReplSessionContext): Promise<ReplResult>;
-    getCompletions(partial: string, context: ReplSessionContext): Promise<string[]>;
+	execute(code: string, context: ReplSessionContext): Promise<ReplResult>;
+	getCompletions(partial: string, context: ReplSessionContext): Promise<string[]>;
 }
 /**
- * Context provider that the server kernel implements.
- * The REPL engine calls this to build the sandbox for each scope type.
- *
- * Methods may return a Promise so the kernel can warm up async
- * resources (e.g. `SystemManager.init()`) before exposing them — the
- * engine awaits each before evaluating user code.
- */
+* Context provider that the server kernel implements.
+* The REPL engine calls this to build the sandbox for each scope type.
+*
+* Methods may return a Promise so the kernel can warm up async
+* resources (e.g. `SystemManager.init()`) before exposing them — the
+* engine awaits each before evaluating user code.
+*/
 export interface IReplContextProvider {
-    getSystemSandbox(): Record<string, unknown> | Promise<Record<string, unknown>>;
-    getDeviceSandbox(deviceId: number): Record<string, unknown> | Promise<Record<string, unknown>>;
-    getProviderSandbox(providerId: string): Record<string, unknown> | Promise<Record<string, unknown>>;
-    getAddonSandbox(addonId: string): Record<string, unknown> | Promise<Record<string, unknown>>;
+	getSystemSandbox(): Record<string, unknown> | Promise<Record<string, unknown>>;
+	getDeviceSandbox(deviceId: number): Record<string, unknown> | Promise<Record<string, unknown>>;
+	getProviderSandbox(providerId: string): Record<string, unknown> | Promise<Record<string, unknown>>;
+	getAddonSandbox(addonId: string): Record<string, unknown> | Promise<Record<string, unknown>>;
 }

package/dist/repl/repl-engine.d.ts

@@ -1,8 +1,8 @@
-import { IReplEngine, IReplContextProvider, ReplSessionContext, ReplResult } from './interfaces.js';
+import type { IReplEngine, IReplContextProvider, ReplSessionContext, ReplResult } from "./interfaces.js";
 export declare class ReplEngine implements IReplEngine {
-    private readonly contextProvider;
-    constructor(contextProvider: IReplContextProvider);
-    execute(code: string, context: ReplSessionContext): Promise<ReplResult>;
-    getCompletions(partial: string, context: ReplSessionContext): Promise<string[]>;
-    private buildSandbox;
+	private readonly contextProvider;
+	constructor(contextProvider: IReplContextProvider);
+	execute(code: string, context: ReplSessionContext): Promise<ReplResult>;
+	getCompletions(partial: string, context: ReplSessionContext): Promise<string[]>;
+	private buildSandbox;
 }