@phigon/observer 8.0.2 → 8.2.0

package/dist/src/system-inspection.d.ts

@@ -0,0 +1,78 @@
+/**
+ * inspect_system report. Every field from the first version keeps its name
+ * and meaning (the desktop parses them). New facts are bounded and contain no
+ * file contents, environment values, command lines or user names.
+ */
+export type SystemInspection = {
+    hostname: string;
+    platform: string;
+    release: string;
+    logical_cpus: number;
+    memory_bytes: number;
+    free_memory_bytes: number;
+    uptime_seconds: number;
+    observed_at: string;
+    observer_version: string;
+    architecture: string;
+    cpu_model: string | null;
+    /** Share of all logical processors busy during the sample window, 0-100. */
+    cpu_load_percent: number | null;
+    /** 1, 5 and 15 minute run-queue averages; Windows has none. */
+    load_average: [number, number, number] | null;
+    sample_window_ms: number;
+    disk_path: string;
+    disk_total_bytes: number | null;
+    /** Space the observer's account can still use. */
+    disk_free_bytes: number | null;
+    agents: InspectedAgent[];
+    /** False when discovery or measurement was partial, timed out or unavailable. */
+    agents_complete: boolean;
+    /** Running agents left out to keep the report short (busiest are kept). */
+    agents_omitted: number;
+};
+export type InspectedAgent = {
+    name: string;
+    process_id: number;
+    /** Share of the whole machine's CPU during the sample window, 0-100. */
+    cpu_percent: number | null;
+    /** Resident memory (Windows working set). */
+    memory_bytes: number | null;
+    run_time_seconds: number;
+};
+export type RunningAgent = Readonly<{
+    name: string;
+    processId: number;
+    startedAt: Date;
+}>;
+export type RunningAgents = Readonly<{
+    agents: readonly RunningAgent[];
+    complete: boolean;
+}>;
+/** One reading of cumulative CPU time and memory for a process. */
+export type ProcessReading = Readonly<{
+    startedAt: number | null;
+    cpuMs: number | null;
+    memoryBytes: number | null;
+}>;
+export type ProcessSample = Readonly<{
+    before: ReadonlyMap<number, ProcessReading>;
+    after: ReadonlyMap<number, ProcessReading>;
+    elapsedMs: number;
+}>;
+export type ProcessSampler = (processIds: readonly number[], windowMs: number) => Promise<ProcessSample>;
+export declare function inspectSystem(options?: Readonly<{
+    agents?: () => Promise<RunningAgents>;
+    sampler?: ProcessSampler;
+    observerVersion?: string;
+    windowMs?: number;
+    now?: () => number;
+}>): Promise<SystemInspection>;
+/** Compact enough for the 4,000 characters Cortex reads, still readable as JSON. */
+export declare function formatInspection(report: SystemInspection): string;
+export declare function defaultProcessSampler(target?: NodeJS.Platform): ProcessSampler;
+export declare function parseWindowsSample(stdout: string): ProcessSample;
+export declare function parseLinuxProcess(stat: string, status: string, bootSeconds: number): ProcessReading | null;
+export declare function parsePsSample(stdout: string): Map<number, ProcessReading>;
+/** "[[dd-]hh:]mm:ss[.cc]" as printed by ps. */
+export declare function parseCpuTime(value: string): number | null;
+//# sourceMappingURL=system-inspection.d.ts.map

package/dist/src/system-inspection.d.ts.map

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

package/dist/src/system-inspection.js

@@ -0,0 +1,281 @@
+import { execFile } from "node:child_process";
+import { readFile, statfs } from "node:fs/promises";
+import { arch, cpus, freemem, hostname, loadavg, platform, release, totalmem, uptime } from "node:os";
+const maxAgents = 20;
+const sampleWindowMs = 500;
+const agentListTimeoutMs = 15_000;
+const sampleTimeoutMs = 10_000;
+const diskTimeoutMs = 2_000;
+export async function inspectSystem(options = {}) {
+    const now = options.now ?? Date.now;
+    const windowMs = options.windowMs ?? sampleWindowMs;
+    const logicalCpus = Math.max(1, cpus().length);
+    const diskPath = mainDiskPath();
+    // The machine-wide CPU window runs before discovery or sampling starts, so
+    // the observer's own work does not inflate it.
+    const [cpuLoad, disk, version] = await Promise.all([
+        machineCpuLoad(windowMs),
+        withTimeout(statfs(diskPath), diskTimeoutMs).then((stats) => ({ total: stats.blocks * stats.bsize, free: stats.bavail * stats.bsize }), () => null),
+        options.observerVersion === undefined ? readObserverVersion() : Promise.resolve(options.observerVersion),
+    ]);
+    const measured = await measureAgents(options.agents, options.sampler ?? defaultProcessSampler(), windowMs, logicalCpus, now);
+    const model = cpus()[0]?.model.trim().replace(/\s+/gu, " ").slice(0, 128);
+    return {
+        hostname: hostname(),
+        platform: platform(),
+        release: release(),
+        logical_cpus: cpus().length,
+        memory_bytes: totalmem(),
+        free_memory_bytes: freemem(),
+        uptime_seconds: Math.floor(uptime()),
+        observed_at: new Date(now()).toISOString(),
+        observer_version: version,
+        architecture: arch(),
+        cpu_model: model ? model : null,
+        cpu_load_percent: cpuLoad,
+        load_average: platform() === "win32" ? null : loadavg().map((value) => round(value, 2)),
+        sample_window_ms: windowMs,
+        disk_path: diskPath,
+        disk_total_bytes: disk?.total ?? null,
+        disk_free_bytes: disk?.free ?? null,
+        agents: measured.agents,
+        agents_complete: measured.complete,
+        agents_omitted: measured.omitted,
+    };
+}
+/** Compact enough for the 4,000 characters Cortex reads, still readable as JSON. */
+export function formatInspection(report) {
+    const lines = Object.entries(report).map(([key, value]) => key === "agents" && Array.isArray(value) && value.length > 0
+        ? `  ${JSON.stringify(key)}: [\n${value.map((agent) => `    ${JSON.stringify(agent)}`).join(",\n")}\n  ]`
+        : `  ${JSON.stringify(key)}: ${JSON.stringify(value)}`);
+    return `{\n${lines.join(",\n")}\n}`;
+}
+async function measureAgents(list, sampler, windowMs, logicalCpus, now) {
+    if (list === undefined)
+        return { agents: [], complete: false, omitted: 0 };
+    let running;
+    try {
+        running = await withTimeout(list(), agentListTimeoutMs);
+    }
+    catch {
+        return { agents: [], complete: false, omitted: 0 };
+    }
+    const candidates = running.agents.filter((agent) => Number.isSafeInteger(agent.processId) && agent.processId > 0).slice(0, 256);
+    if (candidates.length === 0)
+        return { agents: [], complete: running.complete, omitted: 0 };
+    let sample;
+    try {
+        sample = await withTimeout(sampler(candidates.map((agent) => agent.processId), windowMs), sampleTimeoutMs);
+    }
+    catch {
+        sample = undefined;
+    }
+    const measured = [];
+    let complete = running.complete && sample !== undefined;
+    for (const agent of candidates) {
+        const before = sample?.before.get(agent.processId);
+        const after = sample?.after.get(agent.processId);
+        const startedAt = agent.startedAt.getTime();
+        if (sample !== undefined) {
+            // Gone, or the PID now belongs to another process: not a running agent.
+            if (after === undefined)
+                continue;
+            if (after.startedAt !== null && Math.abs(after.startedAt - startedAt) >= 1_000)
+                continue;
+        }
+        const cpuDelta = before?.cpuMs != null && after?.cpuMs != null && sample !== undefined && sample.elapsedMs > 0
+            ? Math.max(0, after.cpuMs - before.cpuMs) / (sample.elapsedMs * logicalCpus) * 100
+            : null;
+        if (sample !== undefined && (cpuDelta === null || after?.memoryBytes == null))
+            complete = false;
+        measured.push({
+            name: agent.name.replace(/[\u0000-\u001f\u007f]/gu, " ").trim().slice(0, 64) || "Unnamed agent",
+            process_id: agent.processId,
+            cpu_percent: cpuDelta === null ? null : round(Math.min(100, cpuDelta), 1),
+            memory_bytes: after?.memoryBytes ?? null,
+            run_time_seconds: Math.max(0, Math.floor((now() - startedAt) / 1_000)),
+        });
+    }
+    measured.sort((left, right) => (right.cpu_percent ?? -1) - (left.cpu_percent ?? -1) ||
+        (right.memory_bytes ?? -1) - (left.memory_bytes ?? -1) || left.process_id - right.process_id);
+    return { agents: measured.slice(0, maxAgents), complete, omitted: Math.max(0, measured.length - maxAgents) };
+}
+async function machineCpuLoad(windowMs) {
+    const before = cpuTotals(cpus());
+    await new Promise((resolve) => setTimeout(resolve, windowMs));
+    const after = cpuTotals(cpus());
+    const total = after.total - before.total;
+    if (!(total > 0))
+        return null;
+    return round(Math.min(100, Math.max(0, (total - (after.idle - before.idle)) / total * 100)), 1);
+}
+function cpuTotals(processors) {
+    let total = 0;
+    let idle = 0;
+    for (const { times } of processors) {
+        total += times.user + times.nice + times.sys + times.idle + times.irq;
+        idle += times.idle;
+    }
+    return { total, idle };
+}
+function mainDiskPath() {
+    if (platform() !== "win32")
+        return "/";
+    const drive = process.env["SystemDrive"] ?? "C:";
+    return /^[A-Za-z]:$/u.test(drive) ? `${drive.toUpperCase()}\\` : "C:\\";
+}
+async function readObserverVersion() {
+    try {
+        const value = JSON.parse(await readFile(new URL("../../package.json", import.meta.url), "utf8"));
+        const version = value !== null && typeof value === "object" && "version" in value ? value.version : undefined;
+        return typeof version === "string" && /^[0-9A-Za-z.+-]{1,64}$/u.test(version) ? version : "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+}
+function round(value, digits) {
+    const scale = 10 ** digits;
+    return Math.round(value * scale) / scale;
+}
+function withTimeout(work, milliseconds) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new Error("timeout")), milliseconds);
+        work.then((value) => { clearTimeout(timer); resolve(value); }, (error) => { clearTimeout(timer); reject(error instanceof Error ? error : new Error("failed")); });
+    });
+}
+export function defaultProcessSampler(target = process.platform) {
+    if (target === "win32")
+        return sampleWindowsProcesses;
+    if (target === "linux")
+        return sampleLinuxProcesses;
+    return samplePsProcesses;
+}
+// Windows: one PowerShell call takes both readings, so its own start-up cost
+// falls outside the measured window.
+async function sampleWindowsProcesses(processIds, windowMs) {
+    const ids = processIds.filter((id) => Number.isSafeInteger(id) && id > 0).join(",");
+    const script = [
+        `$ids = @(${ids})`,
+        "function Read-Agents { foreach ($p in @(Get-Process -Id $ids -ErrorAction SilentlyContinue)) {",
+        "  $s = $null; $c = $null",
+        "  try { $s = $p.StartTime.ToUniversalTime().ToString('o') } catch {}",
+        "  try { $c = $p.TotalProcessorTime.TotalMilliseconds } catch {}",
+        "  [pscustomobject]@{ i = $p.Id; s = $s; c = $c; m = $p.WorkingSet64 } } }",
+        "$w = [Diagnostics.Stopwatch]::StartNew(); $a = @(Read-Agents)",
+        `Start-Sleep -Milliseconds ${Math.max(50, Math.min(5_000, Math.floor(windowMs)))}`,
+        "$e = $w.Elapsed.TotalMilliseconds; $b = @(Read-Agents)",
+        "ConvertTo-Json -Compress -Depth 3 -InputObject @{ a = $a; b = $b; e = $e }",
+    ].join("\n");
+    const stdout = await run("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", script], {});
+    return parseWindowsSample(stdout);
+}
+export function parseWindowsSample(stdout) {
+    const value = JSON.parse(stdout);
+    const readings = (entries) => {
+        const map = new Map();
+        for (const entry of Array.isArray(entries) ? entries : entries === undefined || entries === null ? [] : [entries]) {
+            if (entry === null || typeof entry !== "object")
+                continue;
+            const item = entry;
+            if (typeof item["i"] !== "number" || !Number.isSafeInteger(item["i"]))
+                continue;
+            const startedAt = typeof item["s"] === "string" ? Date.parse(item["s"]) : Number.NaN;
+            map.set(item["i"], {
+                startedAt: Number.isFinite(startedAt) ? startedAt : null,
+                cpuMs: finiteOrNull(item["c"]),
+                memoryBytes: finiteOrNull(item["m"]),
+            });
+        }
+        return map;
+    };
+    return { before: readings(value.a), after: readings(value.b), elapsedMs: finiteOrNull(value.e) ?? 0 };
+}
+// Linux: /proc gives CPU time in clock ticks (USER_HZ, 100 on Linux) and
+// the start time relative to boot.
+async function sampleLinuxProcesses(processIds, windowMs) {
+    const bootSeconds = Number(/^btime\s+(\d+)$/mu.exec(await readFile("/proc/stat", "utf8"))?.[1]);
+    const read = async () => {
+        const readings = new Map();
+        await Promise.all(processIds.map(async (processId) => {
+            try {
+                const [stat, status] = await Promise.all([
+                    readFile(`/proc/${processId}/stat`, "utf8"),
+                    readFile(`/proc/${processId}/status`, "utf8"),
+                ]);
+                const reading = parseLinuxProcess(stat, status, bootSeconds);
+                if (reading !== null)
+                    readings.set(processId, reading);
+            }
+            catch { /* exited or not visible */ }
+        }));
+        return readings;
+    };
+    const started = performance.now();
+    const before = await read();
+    await new Promise((resolve) => setTimeout(resolve, windowMs));
+    const elapsedMs = performance.now() - started;
+    return { before, after: await read(), elapsedMs };
+}
+export function parseLinuxProcess(stat, status, bootSeconds) {
+    // The command name may contain spaces and parentheses; fields follow the last ")".
+    const fields = stat.slice(stat.lastIndexOf(")") + 2).split(" ");
+    if (fields.length < 20 || fields[0] === "Z")
+        return null;
+    const ticks = Number(fields[11]) + Number(fields[12]);
+    const startTicks = Number(fields[19]);
+    const rssKiB = Number(/^VmRSS:\s+(\d+)\s+kB$/mu.exec(status)?.[1]);
+    return {
+        startedAt: Number.isFinite(bootSeconds) && Number.isFinite(startTicks) ? bootSeconds * 1_000 + startTicks * 10 : null,
+        cpuMs: Number.isFinite(ticks) ? ticks * 10 : null,
+        memoryBytes: Number.isFinite(rssKiB) ? rssKiB * 1_024 : null,
+    };
+}
+// macOS and other Unix systems: two ps readings.
+async function samplePsProcesses(processIds, windowMs) {
+    const read = async () => parsePsSample(await run("ps", ["-o", "pid=,rss=,time=,lstart=", "-p", processIds.join(",")], { LANG: "C", LC_ALL: "C" }, true));
+    const started = performance.now();
+    const before = await read();
+    await new Promise((resolve) => setTimeout(resolve, windowMs));
+    const elapsedMs = performance.now() - started;
+    return { before, after: await read(), elapsedMs };
+}
+export function parsePsSample(stdout) {
+    const readings = new Map();
+    for (const line of stdout.split(/\r?\n/u)) {
+        const match = /^\s*(\d+)\s+(\d+)\s+(\S+)\s+(\S+\s+\S+\s+\d{1,2}\s+\d{2}:\d{2}:\d{2}\s+\d{4})\s*$/u.exec(line);
+        if (match === null)
+            continue;
+        const startedAt = Date.parse(match[4]);
+        readings.set(Number(match[1]), {
+            startedAt: Number.isFinite(startedAt) ? startedAt : null,
+            cpuMs: parseCpuTime(match[3]),
+            memoryBytes: Number(match[2]) * 1_024,
+        });
+    }
+    return readings;
+}
+/** "[[dd-]hh:]mm:ss[.cc]" as printed by ps. */
+export function parseCpuTime(value) {
+    const match = /^(?:(\d+)-)?(?:(\d+):)?(\d+):(\d+(?:\.\d+)?)$/u.exec(value);
+    if (match === null)
+        return null;
+    const [days, hours, minutes, seconds] = [match[1], match[2], match[3], match[4]].map((part) => Number(part ?? 0));
+    return Math.round((((days * 24 + hours) * 60 + minutes) * 60 + seconds) * 1_000);
+}
+function run(file, args, environment, allowExitOne = false) {
+    return new Promise((resolve, reject) => execFile(file, args, {
+        timeout: sampleTimeoutMs, maxBuffer: 1 << 20, encoding: "utf8", windowsHide: true,
+        env: { ...process.env, ...environment },
+    }, (error, stdout) => {
+        // ps exits 1 when some of the listed processes have already exited.
+        if (error === null || (allowExitOne && error.code === 1))
+            resolve(stdout);
+        else
+            reject(error);
+    }));
+}
+function finiteOrNull(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+//# sourceMappingURL=system-inspection.js.map

package/dist/src/system-inspection.js.map

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

package/dist/src/update.d.ts

@@ -0,0 +1,15 @@
+export declare function newerVersion(current: string, latest: string): boolean;
+export declare function latestObserverVersion(directory: string, options?: {
+    force?: boolean;
+    fetcher?: typeof fetch;
+    now?: number;
+}): Promise<string | null>;
+export declare function installObserverUpdate(version: string): Promise<void>;
+export declare function offerObserverUpdate(options: {
+    current: string;
+    latest: string | null;
+    confirm: () => Promise<string>;
+    write: (message: string) => void;
+    install?: (version: string) => Promise<void>;
+}): Promise<boolean>;
+//# sourceMappingURL=update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/update.ts"],"names":[],"mappings":"AAQA,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAQrE;AAED,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE;IACtE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CAClD,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoC9B;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAY1E;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE;IACjD,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACvE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChF,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnB"}

package/dist/src/update.js

@@ -0,0 +1,93 @@
+import { spawn } from "node:child_process";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+const versionPattern = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/u;
+const cacheTTLms = 24 * 60 * 60 * 1000;
+const failureRetryMs = 15 * 60 * 1000;
+const registryURL = "https://registry.npmjs.org/@phigon%2fobserver/latest";
+export function newerVersion(current, latest) {
+    if (!versionPattern.test(current) || !versionPattern.test(latest))
+        return false;
+    const before = current.split(".").map(Number);
+    const after = latest.split(".").map(Number);
+    for (let index = 0; index < 3; index++) {
+        if (after[index] !== before[index])
+            return after[index] > before[index];
+    }
+    return false;
+}
+export async function latestObserverVersion(directory, options = {}) {
+    const now = options.now ?? Date.now();
+    const cachePath = join(directory, "update-check.json");
+    if (!options.force) {
+        try {
+            const cache = JSON.parse(await readFile(cachePath, "utf8"));
+            if (typeof cache.checkedAt === "number" && now >= cache.checkedAt && now - cache.checkedAt < cacheTTLms &&
+                (cache.version === null || (typeof cache.version === "string" && versionPattern.test(cache.version))))
+                return cache.version;
+        }
+        catch { /* Missing or malformed cache is safe to replace. */ }
+    }
+    let version = null;
+    let checked = false;
+    try {
+        const response = await (options.fetcher ?? fetch)(registryURL, { signal: AbortSignal.timeout(1500), redirect: "error", headers: { Accept: "application/json" } });
+        if (!response.ok || !response.body)
+            throw new Error("Registry unavailable.");
+        const reader = response.body.getReader();
+        const chunks = [];
+        let size = 0;
+        try {
+            while (true) {
+                const next = await reader.read();
+                if (next.done)
+                    break;
+                size += next.value.byteLength;
+                if (size > 128 * 1024)
+                    throw new Error("Registry metadata exceeds limit.");
+                chunks.push(next.value);
+            }
+            const value = JSON.parse(Buffer.concat(chunks).toString("utf8"));
+            if (value.name === "@phigon/observer" && typeof value.version === "string" && versionPattern.test(value.version)) {
+                version = value.version;
+                checked = true;
+            }
+        }
+        finally {
+            await reader.cancel().catch(() => undefined);
+        }
+    }
+    catch { /* Offline update checks must not block monitoring or pairing. */ }
+    try {
+        await mkdir(directory, { recursive: true, mode: 0o700 });
+        // A failed lookup is retried soon; only a real answer is cached for a day.
+        await writeFile(cachePath, JSON.stringify({ checkedAt: checked ? now : now - cacheTTLms + failureRetryMs, version }), { mode: 0o600 });
+    }
+    catch { /* A cache is optional. */ }
+    return version;
+}
+export async function installObserverUpdate(version) {
+    if (!versionPattern.test(version))
+        throw new Error("Invalid observer version.");
+    const args = ["install", "--global", `@phigon/observer@${version}`, "--registry=https://registry.npmjs.org"];
+    // cmd is needed for npm.cmd on Windows; every argument above is fixed or a
+    // validated numeric version. No caller-controlled shell syntax is accepted.
+    const command = process.platform === "win32" ? "cmd.exe" : "npm";
+    const commandArgs = process.platform === "win32" ? ["/d", "/s", "/c", `npm ${args.join(" ")}`] : args;
+    await new Promise((resolve, reject) => {
+        const child = spawn(command, commandArgs, { stdio: "inherit", windowsHide: true, shell: false });
+        child.once("error", () => reject(new Error("Could not start npm. Run npm install --global @phigon/observer manually.")));
+        child.once("exit", (code) => code === 0 ? resolve() : reject(new Error("Update failed. Check npm permissions and network access, then run npm install --global @phigon/observer. Your pairing data was not removed.")));
+    });
+}
+export async function offerObserverUpdate(options) {
+    if (!options.latest || !newerVersion(options.current, options.latest))
+        return false;
+    options.write(`A new Phigon observer version is available: ${options.current} → ${options.latest}.\nType "yes" to update, or press Enter to continue: `);
+    if ((await options.confirm()).trim().toLowerCase() !== "yes")
+        return false;
+    await (options.install ?? installObserverUpdate)(options.latest);
+    options.write("Observer updated. Run your command again. Restart the observer service if it is running; your pairing and queued activity are preserved.\n");
+    return true;
+}
+//# sourceMappingURL=update.js.map

package/dist/src/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,cAAc,GAAG,6CAA6C,CAAC;AACrE,MAAM,UAAU,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACvC,MAAM,cAAc,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACtC,MAAM,WAAW,GAAG,sDAAsD,CAAC;AAC3E,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,MAAc;IAC1D,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAChF,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QACvC,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC,KAAK,CAAE,GAAG,MAAM,CAAC,KAAK,CAAE,CAAC;IAC5E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,SAAiB,EAAE,UAE3D,EAAE;IACJ,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IACvD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAoD,CAAC;YAC/G,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,GAAG,IAAI,KAAK,CAAC,SAAS,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,UAAU;gBACnG,CAAC,KAAK,CAAC,OAAO,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC,OAAO,CAAC;QAClI,CAAC;QAAC,MAAM,CAAC,CAAC,oDAAoD,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;QAClK,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC7E,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACzC,MAAM,MAAM,GAAiB,EAAE,CAAC;QAChC,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,IAAI,CAAC;YACH,OAAO,IAAI,EAAE,CAAC;gBACZ,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBACjC,IAAI,IAAI,CAAC,IAAI;oBAAE,MAAM;gBACrB,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;gBAC9B,IAAI,IAAI,GAAG,GAAG,GAAG,IAAI;oBAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;gBAC3E,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,CAAC;YACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAA0C,CAAC;YAC1G,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;gBAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;gBAAC,OAAO,GAAG,IAAI,CAAC;YAAC,CAAC;QAChK,CAAC;gBAAS,CAAC;YAAC,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAAC,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC,CAAC,iEAAiE,CAAC,CAAC;IAC7E,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACzD,2EAA2E;QAC3E,MAAM,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,UAAU,GAAG,cAAc,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACzI,CAAC;IAAC,MAAM,CAAC,CAAC,0BAA0B,CAAC,CAAC;IACtC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAe;IACzD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAChF,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,oBAAoB,OAAO,EAAE,EAAE,uCAAuC,CAAC,CAAC;IAC7G,2EAA2E;IAC3E,4EAA4E;IAC5E,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;IACjE,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACtG,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACjG,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC,CAAC,CAAC;QACzH,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,6IAA6I,CAAC,CAAC,CAAC,CAAC;IAC1N,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAGzC;IACC,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACpF,OAAO,CAAC,KAAK,CAAC,+CAA+C,OAAO,CAAC,OAAO,MAAM,OAAO,CAAC,MAAM,uDAAuD,CAAC,CAAC;IACzJ,IAAI,CAAC,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAC3E,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,qBAAqB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,OAAO,CAAC,KAAK,CAAC,4IAA4I,CAAC,CAAC;IAC5J,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/user-notices.d.ts

@@ -0,0 +1,53 @@
+/** What the person at this computer is told when Phigon acts on it. */
+export type UserNotice = Readonly<{
+    title: string;
+    body: string;
+}>;
+export type NoticeSender = (notice: UserNotice) => Promise<void>;
+/**
+ * Tells the person at this computer what Phigon did to it: an agent stopped,
+ * a command run, the computer about to restart. Notices are best effort: a
+ * computer with no desktop session, or an observer running as a service
+ * with no access to it, shows nothing, and a notice never affects the action.
+ */
+export declare class UserNotices {
+    #private;
+    constructor(options: Readonly<{
+        enabled: boolean;
+        send?: NoticeSender;
+        now?: () => number;
+    }>);
+    /** An agent Phigon stopped, because someone asked or a rule said so. */
+    agentStopped(input: Readonly<{
+        key: string;
+        agent: string;
+        forced: boolean;
+        reason: string;
+    }>): void;
+    /** A blocked agent Phigon stopped as soon as it started. */
+    agentBlocked(input: Readonly<{
+        key: string;
+        agent: string;
+        reason: string;
+    }>): void;
+    commandRan(input: Readonly<{
+        key: string;
+        program: string;
+        reason: string;
+    }>): void;
+    powerChange(input: Readonly<{
+        key: string;
+        restart: boolean;
+        reason: string;
+    }>): void;
+}
+/** One line of plain text: no control characters, and bounded. */
+export declare function plainText(value: string, limit: number): string;
+/** The name people know an agent by: "Claude Code · PID 4120" is "Claude Code". */
+export declare function noticeAgentName(displayName: string): string;
+/**
+ * The operating system's own notification, shown without a shell. The text
+ * travels in environment variables, never in the command line or a script.
+ */
+export declare function platformNoticeSender(platform?: NodeJS.Platform): NoticeSender | undefined;
+//# sourceMappingURL=user-notices.d.ts.map

package/dist/src/user-notices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-notices.d.ts","sourceRoot":"","sources":["../../src/user-notices.ts"],"names":[],"mappings":"AAGA,uEAAuE;AACvE,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEnE,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAKjE;;;;;GAKG;AACH,qBAAa,WAAW;;gBAKV,OAAO,EAAE,QAAQ,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,YAAY,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;KAAE,CAAC;IAK5F,wEAAwE;IACxE,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAOpG,4DAA4D;IAC5D,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAOnF,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAOnF,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;CAiBtF;AAED,kEAAkE;AAClE,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,YAAY,GAAG,SAAS,CAiB3G"}