@mono-agent/agent-app 0.6.2 → 0.9.0

package/dist/process-incarnation.d.ts

@@ -0,0 +1,23 @@
+export declare const PROCESS_INCARNATION_SCHEMA = "mono-agent.process-incarnation.v1";
+/** Stable OS evidence that distinguishes one use of a PID from every later reuse. */
+export interface ProcessIncarnation {
+    readonly schema: typeof PROCESS_INCARNATION_SCHEMA;
+    readonly bootSessionId: string;
+    readonly processStartId: string;
+}
+export type SameProcessIncarnation = (pid: number, expected: ProcessIncarnation) => boolean | Promise<boolean>;
+/** Capture the current process's boot-session and process-birth identity. */
+export declare function currentProcessIncarnation(): Promise<ProcessIncarnation>;
+/**
+ * Read one PID incarnation without mistaking `kill(pid, 0)` for owner identity.
+ * Linux exposes a boot UUID and per-process start tick directly. Darwin/BSD use
+ * the kernel boot time plus `ps`'s stable long-start field. Windows uses native
+ * process/OS creation timestamps through PowerShell.
+ */
+export declare function readProcessIncarnation(pid: number): Promise<ProcessIncarnation | undefined>;
+/** True only when PID, boot session, and process birth all still identify the owner. */
+export declare function isSameProcessIncarnation(pid: number, expected: ProcessIncarnation): Promise<boolean>;
+export declare function processIncarnationsEqual(left: ProcessIncarnation, right: ProcessIncarnation): boolean;
+/** Fail-closed parser for persisted lock-owner data. */
+export declare function processIncarnationFromJson(value: unknown): ProcessIncarnation | undefined;
+//# sourceMappingURL=process-incarnation.d.ts.map

package/dist/process-incarnation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-incarnation.d.ts","sourceRoot":"","sources":["../src/process-incarnation.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,0BAA0B,sCAAsC,CAAC;AAE9E,qFAAqF;AACrF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,OAAO,0BAA0B,CAAC;IACnD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,MAAM,sBAAsB,GAAG,CACnC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,kBAAkB,KACzB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAIhC,6EAA6E;AAC7E,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAM7E;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAajG;AAED,wFAAwF;AACxF,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,kBAAkB,EACxB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAIT;AAED,wDAAwD;AACxD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAUzF"}

package/dist/process-incarnation.js

@@ -0,0 +1,208 @@
+import { execFile } from "node:child_process";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import process from "node:process";
+export const PROCESS_INCARNATION_SCHEMA = "mono-agent.process-incarnation.v1";
+let bootSessionIdPromise;
+/** Capture the current process's boot-session and process-birth identity. */
+export async function currentProcessIncarnation() {
+    const incarnation = await readProcessIncarnation(process.pid);
+    if (incarnation === undefined) {
+        throw new Error(`Cannot read process incarnation for current pid ${process.pid}.`);
+    }
+    return incarnation;
+}
+/**
+ * Read one PID incarnation without mistaking `kill(pid, 0)` for owner identity.
+ * Linux exposes a boot UUID and per-process start tick directly. Darwin/BSD use
+ * the kernel boot time plus `ps`'s stable long-start field. Windows uses native
+ * process/OS creation timestamps through PowerShell.
+ */
+export async function readProcessIncarnation(pid) {
+    assertPid(pid);
+    if (!processExists(pid))
+        return undefined;
+    const [bootSessionId, processStartId] = await Promise.all([
+        currentBootSessionId(),
+        processStartIdentifier(pid),
+    ]);
+    if (processStartId === undefined)
+        return undefined;
+    return {
+        schema: PROCESS_INCARNATION_SCHEMA,
+        bootSessionId,
+        processStartId,
+    };
+}
+/** True only when PID, boot session, and process birth all still identify the owner. */
+export async function isSameProcessIncarnation(pid, expected) {
+    const actual = await readProcessIncarnation(pid);
+    return actual !== undefined && processIncarnationsEqual(actual, expected);
+}
+export function processIncarnationsEqual(left, right) {
+    return left.schema === right.schema
+        && left.bootSessionId === right.bootSessionId
+        && left.processStartId === right.processStartId;
+}
+/** Fail-closed parser for persisted lock-owner data. */
+export function processIncarnationFromJson(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    const record = value;
+    return record.schema === PROCESS_INCARNATION_SCHEMA
+        && typeof record.bootSessionId === "string"
+        && record.bootSessionId.length > 0
+        && typeof record.processStartId === "string"
+        && record.processStartId.length > 0
+        ? record
+        : undefined;
+}
+async function currentBootSessionId() {
+    bootSessionIdPromise ??= readBootSessionId();
+    return await bootSessionIdPromise;
+}
+async function readBootSessionId() {
+    if (process.platform === "linux") {
+        const value = (await readFile("/proc/sys/kernel/random/boot_id", "utf8")).trim();
+        if (!/^[a-zA-Z0-9-]+$/u.test(value)) {
+            throw new Error("Linux boot session id is malformed.");
+        }
+        return `linux:${value}`;
+    }
+    if (process.platform === "darwin") {
+        const output = await execFileText("/usr/sbin/sysctl", ["-n", "kern.boottime"], posixEnvironment());
+        const match = /sec\s*=\s*(\d+)\s*,\s*usec\s*=\s*(\d+)/u.exec(output);
+        if (match?.[1] === undefined || match[2] === undefined) {
+            throw new Error("Darwin boot session identity is malformed.");
+        }
+        return `darwin:${match[1]}:${match[2]}`;
+    }
+    if (process.platform === "win32") {
+        const output = await execFileText(windowsPowerShellPath(), [
+            "-NoProfile",
+            "-NonInteractive",
+            "-Command",
+            "(Get-CimInstance Win32_OperatingSystem).LastBootUpTime.ToUniversalTime().Ticks",
+        ]);
+        return `win32:${requiredDecimal(output, "Windows boot session identity")}`;
+    }
+    // PID 1 is recreated once per POSIX boot, so its birth is a stable fallback
+    // on BSD-like platforms that lack Linux's boot UUID and Darwin's sysctl path.
+    const pidOneStart = await posixProcessStartIdentifier(1);
+    if (pidOneStart === undefined) {
+        throw new Error(`Cannot determine the ${process.platform} boot session identity.`);
+    }
+    return `${process.platform}:pid1:${pidOneStart}`;
+}
+async function processStartIdentifier(pid) {
+    if (process.platform === "linux")
+        return await linuxProcessStartIdentifier(pid);
+    if (process.platform === "win32")
+        return await windowsProcessStartIdentifier(pid);
+    return await posixProcessStartIdentifier(pid);
+}
+async function linuxProcessStartIdentifier(pid) {
+    let stat;
+    try {
+        stat = await readFile(`/proc/${pid}/stat`, "utf8");
+    }
+    catch (error) {
+        if (isErrno(error, "ENOENT") || isErrno(error, "ESRCH"))
+            return undefined;
+        throw error;
+    }
+    // `comm` is parenthesized and may itself contain spaces or `)`, so split only
+    // after its final close paren. The remaining token at index 19 is field 22,
+    // the kernel start tick since boot.
+    const close = stat.lastIndexOf(")");
+    if (close < 0)
+        throw new Error(`Linux process stat for pid ${pid} is malformed.`);
+    const fields = stat.slice(close + 1).trim().split(/\s+/u);
+    const startTicks = fields[19];
+    if (startTicks === undefined || !/^\d+$/u.test(startTicks)) {
+        throw new Error(`Linux process start identity for pid ${pid} is malformed.`);
+    }
+    return `linux-ticks:${startTicks}`;
+}
+async function posixProcessStartIdentifier(pid) {
+    try {
+        const output = await execFileText("/bin/ps", ["-p", String(pid), "-o", "lstart="], posixEnvironment());
+        const normalized = output.trim().replace(/\s+/gu, " ");
+        if (normalized.length === 0) {
+            if (!processExists(pid))
+                return undefined;
+            throw new Error(`POSIX process start identity for pid ${pid} is empty.`);
+        }
+        return `posix-lstart:${normalized}`;
+    }
+    catch (error) {
+        if (!processExists(pid))
+            return undefined;
+        throw error;
+    }
+}
+async function windowsProcessStartIdentifier(pid) {
+    try {
+        const output = await execFileText(windowsPowerShellPath(), [
+            "-NoProfile",
+            "-NonInteractive",
+            "-Command",
+            `$process = Get-Process -Id ${pid} -ErrorAction Stop; $process.StartTime.ToUniversalTime().Ticks`,
+        ]);
+        return `win32-ticks:${requiredDecimal(output, `Windows process start identity for pid ${pid}`)}`;
+    }
+    catch (error) {
+        if (!processExists(pid))
+            return undefined;
+        throw error;
+    }
+}
+function processExists(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        if (isErrno(error, "ESRCH"))
+            return false;
+        if (isErrno(error, "EPERM"))
+            return true;
+        throw error;
+    }
+}
+function assertPid(pid) {
+    if (!Number.isSafeInteger(pid) || pid <= 0) {
+        throw new Error(`Process incarnation pid must be a positive safe integer; received ${String(pid)}.`);
+    }
+}
+function posixEnvironment() {
+    return { PATH: "/usr/bin:/bin", LANG: "C", LC_ALL: "C" };
+}
+function windowsPowerShellPath() {
+    const systemRoot = process.env.SystemRoot ?? process.env.SYSTEMROOT ?? "C:\\Windows";
+    return join(systemRoot, "System32", "WindowsPowerShell", "v1.0", "powershell.exe");
+}
+function requiredDecimal(output, label) {
+    const normalized = output.trim();
+    if (!/^\d+$/u.test(normalized))
+        throw new Error(`${label} is malformed.`);
+    return normalized;
+}
+function execFileText(executable, args, env) {
+    return new Promise((resolvePromise, reject) => {
+        execFile(executable, [...args], {
+            encoding: "utf8",
+            windowsHide: true,
+            ...(env === undefined ? {} : { env }),
+        }, (error, stdout) => {
+            if (error !== null)
+                reject(error);
+            else
+                resolvePromise(stdout);
+        });
+    });
+}
+function isErrno(error, code) {
+    return error?.code === code;
+}
+//# sourceMappingURL=process-incarnation.js.map

package/dist/process-incarnation.js.map

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

package/dist/project-skills.d.ts

@@ -0,0 +1,40 @@
+import type { GeneratedFile } from "./modules/types.js";
+export declare const PROJECT_SKILL_VERSION = "1.1.0";
+export declare const PROJECT_SKILL_MANIFEST_PATH = "skills/.mono-agent-managed.json";
+export declare const PROJECT_SKILL_NAMES: readonly ["mono-agent-configure", "mono-agent-memory"];
+export type ProjectSkillName = (typeof PROJECT_SKILL_NAMES)[number];
+interface BundledProjectSkill {
+    readonly name: ProjectSkillName;
+    readonly contents: string;
+}
+export declare const BUNDLED_PROJECT_SKILLS: readonly BundledProjectSkill[];
+export type ProjectSkillStatusKind = "ready" | "missing" | "stale" | "modified" | "collision";
+export interface ProjectSkillStatus {
+    readonly name: ProjectSkillName;
+    readonly path: string;
+    readonly status: ProjectSkillStatusKind;
+    readonly installedSha256?: string;
+    readonly expectedSha256: string;
+}
+export interface CheckProjectSkillsResult {
+    readonly manifestPath: string;
+    readonly manifestVersion?: string;
+    readonly statuses: readonly ProjectSkillStatus[];
+    readonly ok: boolean;
+}
+export interface UpdateProjectSkillsResult extends CheckProjectSkillsResult {
+    readonly updated: readonly string[];
+    readonly backupDir?: string;
+}
+export interface UpdateManagedProjectSkillsOptions {
+    /** Fault-injection seam invoked before the built-in compare-and-swap writer. */
+    readonly beforeActivate?: (path: string, contents: string) => Promise<void>;
+}
+export declare function managedProjectSkillFiles(): readonly GeneratedFile[];
+export declare function checkManagedProjectSkills(cwd: string): Promise<CheckProjectSkillsResult>;
+/** Fail before init writes anything when an existing skill would be claimed or overwritten. */
+export declare function assertManagedProjectSkillInitSafe(cwd: string): Promise<void>;
+export declare function updateManagedProjectSkills(cwd: string, options?: UpdateManagedProjectSkillsOptions): Promise<UpdateProjectSkillsResult>;
+export declare function managedProjectSkillsExist(cwd: string): Promise<boolean>;
+export {};
+//# sourceMappingURL=project-skills.d.ts.map

package/dist/project-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-skills.d.ts","sourceRoot":"","sources":["../src/project-skills.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAC7C,eAAO,MAAM,2BAA2B,oCAAoC,CAAC;AAE7E,eAAO,MAAM,mBAAmB,wDAGtB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AA4CD,eAAO,MAAM,sBAAsB,EAAE,SAAS,mBAAmB,EAGhE,CAAC;AAQF,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC;AAE9F,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACjD,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,yBAA0B,SAAQ,wBAAwB;IACzE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iCAAiC;IAChD,gFAAgF;IAChF,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7E;AAuBD,wBAAgB,wBAAwB,IAAI,SAAS,aAAa,EAAE,CAYnE;AAED,wBAAsB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAoC9F;AAED,+FAA+F;AAC/F,wBAAsB,iCAAiC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQlF;AAED,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,iCAAsC,GAC9C,OAAO,CAAC,yBAAyB,CAAC,CAIpC;AA2eD,wBAAsB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ7E"}