agentrinse 0.4.0 → 0.5.0

package/dist/core/provider-file-recovery.js

@@ -0,0 +1,393 @@
+import { createHash } from "node:crypto";
+import { constants } from "node:fs";
+import { lstat } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { providerFileQuarantineEntrySchema, } from "../contracts/provider-file-quarantine.js";
+import { writeJsonAtomic } from "../state/json-file.js";
+import { renameAtNoReplace } from "./no-clobber-rename.js";
+import { openPinnedProviderFile, openPinnedProviderParent, } from "./pinned-file.js";
+import { inspectProviderFile, providerFileIdentityMatches, providerFileStatsMatch, } from "./provider-file-identity.js";
+import { providerFileQuarantinePath } from "./provider-file-executor.js";
+import { inspectProviderProcesses } from "./provider-processes.js";
+import { findProcessesUsingFile } from "./process-ownership.js";
+export function providerFilePurgeIsolationPath(quarantineDirectory, entryId) {
+    return join(quarantineDirectory, `${entryId}.payload.purging`);
+}
+const EMPTY_FILE_SHA256 = createHash("sha256").digest("hex");
+function isMissing(error) {
+    return (error instanceof Error && "code" in error && error.code === "ENOENT");
+}
+async function pathExists(path) {
+    try {
+        await lstat(path);
+        return true;
+    }
+    catch (error) {
+        if (isMissing(error)) {
+            return false;
+        }
+        throw error;
+    }
+}
+async function openValidatedFile(path, ownerRoot, identity, allowSealedMode = false) {
+    const handle = await openPinnedProviderFile(path, ownerRoot);
+    try {
+        const stats = await handle.stat();
+        if (!stats.isFile()) {
+            throw new Error(`provider-file recovery target is not a regular file: ${path}`);
+        }
+        if (!providerFileStatsMatch(stats, identity, allowSealedMode)) {
+            throw new Error(`provider-file descriptor identity changed: ${path}`);
+        }
+        return handle;
+    }
+    catch (error) {
+        await handle.close().catch(() => undefined);
+        throw error;
+    }
+}
+async function openValidatedWritableFile(path, ownerRoot, identity, readHandle) {
+    const openWritable = () => openPinnedProviderFile(path, ownerRoot, constants.O_RDWR);
+    let writeHandle;
+    let modeAdjusted = false;
+    try {
+        try {
+            writeHandle = await openWritable();
+        }
+        catch (error) {
+            if (!(error instanceof Error) ||
+                !("code" in error) ||
+                !["EACCES", "EPERM"].includes(error.code ?? "")) {
+                throw error;
+            }
+            await readHandle.chmod((identity.mode & 0o7777) | 0o200);
+            await readHandle.sync();
+            modeAdjusted = true;
+            writeHandle = await openWritable();
+        }
+        const writableMode = modeAdjusted ? identity.mode | 0o200 : identity.mode;
+        if (!providerFileStatsMatch(await writeHandle.stat(), { ...identity, mode: writableMode })) {
+            throw new Error(`provider-file writable descriptor identity changed: ${path}`);
+        }
+        await readHandle.chmod(identity.mode & ~0o222);
+        await readHandle.sync();
+        if (!providerFileStatsMatch(await readHandle.stat(), identity, true) ||
+            !providerFileStatsMatch(await writeHandle.stat(), identity, true)) {
+            throw new Error(`provider-file descriptor identity changed while sealing purge: ${path}`);
+        }
+        return writeHandle;
+    }
+    catch (error) {
+        await writeHandle?.close().catch(() => undefined);
+        if (modeAdjusted) {
+            await readHandle.chmod(identity.mode & 0o7777).catch(() => undefined);
+            await readHandle.sync().catch(() => undefined);
+        }
+        throw error;
+    }
+}
+async function restoreValidatedMode(path, identity) {
+    const handle = await openValidatedFile(path, identity.ownerRoot, identity, true);
+    try {
+        await handle.chmod(identity.mode & 0o7777);
+        await handle.sync();
+        if (!providerFileStatsMatch(await handle.stat(), identity)) {
+            throw new Error(`provider-file mode repair changed descriptor identity: ${path}`);
+        }
+    }
+    finally {
+        await handle.close();
+    }
+}
+function assertOwnedPaths(entry, options) {
+    const expectedManifest = join(options.quarantineDirectory, `${entry.entryId}.json`);
+    const expectedPayload = providerFileQuarantinePath(options.quarantineDirectory, entry.entryId);
+    if (resolve(options.manifestPath) !== resolve(expectedManifest) ||
+        resolve(entry.quarantinePath) !== resolve(expectedPayload) ||
+        resolve(entry.originalPath) !== resolve(entry.target.path)) {
+        throw new Error("provider-file recovery manifest contains paths outside its owned set");
+    }
+}
+async function persist(entry, options) {
+    const parsed = providerFileQuarantineEntrySchema.parse(entry);
+    assertOwnedPaths(parsed, options);
+    await writeJsonAtomic(options.manifestPath, parsed, {
+        privateDirectories: [options.quarantineDirectory],
+    });
+    return parsed;
+}
+function movedIdentityMatches(actual, entry) {
+    const expected = entry.target;
+    return (actual.provider === expected.provider &&
+        actual.device === expected.device &&
+        actual.inode === expected.inode &&
+        actual.linkCount === expected.linkCount &&
+        (actual.mode === expected.mode || actual.mode === (expected.mode & ~0o222)) &&
+        actual.mtimeMs === expected.mtimeMs &&
+        actual.measuredBytes === expected.measuredBytes &&
+        actual.contentSha256 === expected.contentSha256);
+}
+function purgedMarkerMatches(actual, entry) {
+    const expected = entry.target;
+    return (actual.provider === expected.provider &&
+        actual.device === expected.device &&
+        actual.inode === expected.inode &&
+        actual.linkCount === expected.linkCount &&
+        actual.mode === (expected.mode & ~0o222) &&
+        actual.measuredBytes === 0 &&
+        actual.contentSha256 === EMPTY_FILE_SHA256);
+}
+async function inspectOriginal(entry) {
+    if (!(await pathExists(entry.originalPath))) {
+        return undefined;
+    }
+    return inspectProviderFile(entry.originalPath, entry.target.ownerRoot, entry.target.provider);
+}
+async function inspectQuarantine(entry, options) {
+    return inspectPayload(entry.quarantinePath, entry, options);
+}
+async function inspectPurgeIsolation(entry, options) {
+    return inspectPayload(providerFilePurgeIsolationPath(options.quarantineDirectory, entry.entryId), entry, options);
+}
+async function inspectPayload(path, entry, options) {
+    if (!(await pathExists(path))) {
+        return undefined;
+    }
+    return inspectProviderFile(path, options.quarantineDirectory, entry.target.provider);
+}
+async function reconcile(entry, options) {
+    assertOwnedPaths(entry, options);
+    const [original, quarantine, purgeIsolation] = await Promise.all([
+        inspectOriginal(entry),
+        inspectQuarantine(entry, options),
+        inspectPurgeIsolation(entry, options),
+    ]);
+    const occupiedPathCount = [original, quarantine, purgeIsolation].filter((identity) => identity !== undefined).length;
+    if (occupiedPathCount > 1) {
+        throw new Error("provider-file recovery state is ambiguous: multiple paths are occupied");
+    }
+    if (occupiedPathCount === 0) {
+        if (entry.status === "purging" || entry.status === "purged") {
+            return persist({
+                ...entry,
+                status: "purged",
+                purgedAt: entry.purgedAt ?? (options.dependencies?.clock ?? (() => new Date()))().toISOString(),
+            }, options);
+        }
+        throw new Error("provider-file recovery state is ambiguous: both paths are missing");
+    }
+    if (original !== undefined) {
+        if (!providerFileIdentityMatches(original, entry.target, true)) {
+            throw new Error("provider-file original path no longer matches the recovery manifest");
+        }
+        await assertOffline(entry, entry.originalPath, options.dependencies ?? {});
+        await restoreValidatedMode(entry.originalPath, entry.target);
+        if (["preparing", "restoring", "restored"].includes(entry.status)) {
+            return persist({
+                ...entry,
+                status: "restored",
+                restoredAt: entry.restoredAt ?? (options.dependencies?.clock ?? (() => new Date()))().toISOString(),
+                diagnostic: undefined,
+            }, options);
+        }
+        throw new Error("provider-file recovery found unexpected content at the original path");
+    }
+    if (purgeIsolation !== undefined) {
+        if (["purging", "purged"].includes(entry.status) &&
+            purgedMarkerMatches(purgeIsolation, entry)) {
+            return persist({
+                ...entry,
+                status: "purged",
+                purgedAt: entry.purgedAt ?? (options.dependencies?.clock ?? (() => new Date()))().toISOString(),
+                quarantineIdentity: purgeIsolation,
+                diagnostic: undefined,
+            }, options);
+        }
+        if (entry.status !== "purging" || !movedIdentityMatches(purgeIsolation, entry)) {
+            throw new Error("provider-file purge isolation payload does not match its manifest");
+        }
+        return persist({
+            ...entry,
+            status: "purging",
+            quarantineIdentity: purgeIsolation,
+        }, options);
+    }
+    if (quarantine === undefined || !movedIdentityMatches(quarantine, entry)) {
+        throw new Error("provider-file quarantine payload no longer matches the recovery manifest");
+    }
+    if (["preparing", "quarantined", "restoring", "purging", "partial"].includes(entry.status)) {
+        return persist({
+            ...entry,
+            status: ["restoring", "purging"].includes(entry.status) ? entry.status : "quarantined",
+            quarantineIdentity: quarantine,
+        }, options);
+    }
+    return entry;
+}
+async function assertOffline(entry, path, dependencies) {
+    const processes = await (dependencies.inspectProcesses ?? inspectProviderProcesses)(entry.target.provider);
+    if (processes.status !== "idle") {
+        throw new Error(processes.status === "busy"
+            ? `${entry.target.provider} is running; provider-file recovery is refused`
+            : `${entry.target.provider} process state is unknown: ${processes.reason}`);
+    }
+    const handles = await (dependencies.inspectOpenHandles ?? findProcessesUsingFile)(path);
+    if (handles.status !== "idle") {
+        throw new Error(handles.status === "busy"
+            ? "a process has the provider-file recovery path open"
+            : `provider-file descriptor state is unknown: ${handles.reason}`);
+    }
+}
+export async function undoProviderFileQuarantine(input, options) {
+    const dependencies = options.dependencies ?? {};
+    const clock = dependencies.clock ?? (() => new Date());
+    let entry = await reconcile(providerFileQuarantineEntrySchema.parse(input), options);
+    if (entry.status === "restored") {
+        return entry;
+    }
+    if (entry.status !== "quarantined" &&
+        entry.status !== "restoring" &&
+        entry.status !== "partial") {
+        throw new Error(`provider-file quarantine entry cannot be restored from ${entry.status}`);
+    }
+    await assertOffline(entry, entry.quarantinePath, dependencies);
+    const sourceHandle = await openValidatedFile(entry.quarantinePath, options.quarantineDirectory, entry.quarantineIdentity, true);
+    const destination = await openPinnedProviderParent(entry.target.ownerRoot, entry.target.relativePath);
+    try {
+        await sourceHandle.chmod(entry.target.mode & ~0o222);
+        await sourceHandle.sync();
+        if (!providerFileStatsMatch(await sourceHandle.stat(), entry.target, true)) {
+            throw new Error("provider-file payload changed while it was sealed for restore");
+        }
+        entry = await persist({ ...entry, status: "restoring", quarantineIdentity: entry.quarantineIdentity }, options);
+        if (dependencies.move !== undefined) {
+            await dependencies.move(entry.quarantinePath, entry.originalPath);
+        }
+        else {
+            await renameAtNoReplace(sourceHandle.parent.fd, sourceHandle.basename, destination.parent.fd, destination.basename, dependencies.platform ?? process.platform);
+        }
+        const restoredHandle = await openPinnedProviderFile(entry.originalPath, entry.target.ownerRoot).catch(() => undefined);
+        const restoredStats = await restoredHandle?.stat().catch(() => undefined);
+        await restoredHandle?.close().catch(() => undefined);
+        if (restoredStats === undefined || !providerFileStatsMatch(restoredStats, entry.target, true)) {
+            if (dependencies.move !== undefined) {
+                await dependencies.move(entry.originalPath, entry.quarantinePath);
+            }
+            else {
+                await renameAtNoReplace(destination.parent.fd, destination.basename, sourceHandle.parent.fd, sourceHandle.basename, dependencies.platform ?? process.platform);
+            }
+            throw new Error("provider-file restore pathname changed before the atomic move");
+        }
+        await Promise.all([destination.parent.sync(), sourceHandle.parent.sync()]);
+        const sealedRestored = await inspectProviderFile(entry.originalPath, entry.target.ownerRoot, entry.target.provider);
+        if (!providerFileIdentityMatches(sealedRestored, entry.target, true)) {
+            throw new Error("restored provider file no longer matches the recovery manifest");
+        }
+        await sourceHandle.chmod(entry.target.mode & 0o7777);
+        await sourceHandle.sync();
+        const finalHandle = await openPinnedProviderFile(entry.originalPath, entry.target.ownerRoot).catch(() => undefined);
+        const finalStats = await finalHandle?.stat().catch(() => undefined);
+        await finalHandle?.close().catch(() => undefined);
+        if (!providerFileStatsMatch(await sourceHandle.stat(), entry.target) ||
+            finalStats === undefined ||
+            !providerFileStatsMatch(finalStats, entry.target)) {
+            throw new Error("restored provider file mode changed before recovery completed");
+        }
+    }
+    finally {
+        await Promise.all([
+            sourceHandle.close().catch(() => undefined),
+            destination.parent.close().catch(() => undefined),
+        ]);
+    }
+    return persist({
+        ...entry,
+        status: "restored",
+        restoredAt: clock().toISOString(),
+        diagnostic: undefined,
+    }, options);
+}
+export async function purgeProviderFileQuarantine(input, options) {
+    const dependencies = options.dependencies ?? {};
+    const clock = dependencies.clock ?? (() => new Date());
+    let entry = await reconcile(providerFileQuarantineEntrySchema.parse(input), options);
+    if (entry.status === "purged") {
+        return { entry, reclaimedBytes: 0 };
+    }
+    if (entry.status !== "quarantined" && entry.status !== "purging") {
+        throw new Error(`provider-file quarantine entry cannot be purged from ${entry.status}`);
+    }
+    if (!options.allowUnexpired && Date.parse(entry.expiresAt) > clock().getTime()) {
+        throw new Error(`provider-file quarantine entry has not expired: ${entry.entryId}`);
+    }
+    const purgeIsolationPath = providerFilePurgeIsolationPath(options.quarantineDirectory, entry.entryId);
+    const alreadyIsolated = await pathExists(purgeIsolationPath);
+    const payloadPath = alreadyIsolated ? purgeIsolationPath : entry.quarantinePath;
+    await assertOffline(entry, payloadPath, dependencies);
+    const payloadHandle = await openValidatedFile(payloadPath, options.quarantineDirectory, entry.quarantineIdentity, true);
+    let writableHandle;
+    try {
+        writableHandle = await openValidatedWritableFile(payloadPath, options.quarantineDirectory, entry.target, payloadHandle);
+        entry = await persist({ ...entry, status: "purging", quarantineIdentity: entry.quarantineIdentity }, options);
+        if (!alreadyIsolated) {
+            if (dependencies.move !== undefined) {
+                await dependencies.move(entry.quarantinePath, purgeIsolationPath);
+            }
+            else {
+                await renameAtNoReplace(payloadHandle.parent.fd, payloadHandle.basename, payloadHandle.parent.fd, `${entry.entryId}.payload.purging`, dependencies.platform ?? process.platform);
+            }
+            const isolatedHandle = await openPinnedProviderFile(purgeIsolationPath, options.quarantineDirectory).catch(() => undefined);
+            const isolatedStats = await isolatedHandle?.stat().catch(() => undefined);
+            await isolatedHandle?.close().catch(() => undefined);
+            if (isolatedStats === undefined ||
+                !providerFileStatsMatch(isolatedStats, entry.target, true) ||
+                !providerFileStatsMatch(await payloadHandle.stat(), entry.target, true)) {
+                let rollbackError;
+                try {
+                    if (dependencies.move !== undefined) {
+                        await dependencies.move(purgeIsolationPath, entry.quarantinePath);
+                    }
+                    else {
+                        await renameAtNoReplace(payloadHandle.parent.fd, `${entry.entryId}.payload.purging`, payloadHandle.parent.fd, payloadHandle.basename, dependencies.platform ?? process.platform);
+                    }
+                    await payloadHandle.parent.sync();
+                }
+                catch (error) {
+                    rollbackError = error;
+                }
+                if (rollbackError !== undefined) {
+                    throw new AggregateError([new Error("provider-file purge claimed an unexpected inode"), rollbackError], "provider-file purge claim rollback failed");
+                }
+                throw new Error("provider-file purge pathname changed before the atomic claim; the unexpected inode was restored");
+            }
+            await payloadHandle.parent.sync();
+        }
+        await (dependencies.truncateHandle ?? ((handle) => handle.truncate(0)))(writableHandle);
+        await writableHandle.sync();
+        const truncatedStats = await writableHandle.stat();
+        if (!truncatedStats.isFile() ||
+            truncatedStats.dev !== entry.target.device ||
+            truncatedStats.ino !== entry.target.inode ||
+            truncatedStats.nlink !== entry.target.linkCount ||
+            truncatedStats.size !== 0) {
+            throw new Error("provider-file purge did not truncate the claimed inode");
+        }
+        const purgedMarker = await inspectProviderFile(purgeIsolationPath, options.quarantineDirectory, entry.target.provider);
+        if (!purgedMarkerMatches(purgedMarker, entry)) {
+            throw new Error("provider-file purge marker no longer names the claimed inode");
+        }
+        entry = await persist({
+            ...entry,
+            status: "purged",
+            purgedAt: clock().toISOString(),
+            quarantineIdentity: purgedMarker,
+            diagnostic: undefined,
+        }, options);
+    }
+    finally {
+        await writableHandle?.close().catch(() => undefined);
+        await payloadHandle.close();
+    }
+    return { entry, reclaimedBytes: entry.target.measuredBytes };
+}
+//# sourceMappingURL=provider-file-recovery.js.map

package/dist/core/provider-file-recovery.js.map

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

package/dist/core/provider-file-revalidation.d.ts

@@ -0,0 +1,20 @@
+import type { ProviderFileQuarantineAction } from "../contracts/action.js";
+import type { Diagnostic } from "../contracts/diagnostic.js";
+import type { AgentRinseConfig } from "../config/schema.js";
+import { type ProviderProcessResult } from "./provider-processes.js";
+import { type ProcessOwnershipResult } from "./process-ownership.js";
+export type ProviderFileRevalidationResult = {
+    status: "ready";
+} | {
+    status: "stale";
+    diagnostic: Diagnostic;
+};
+export type ProviderFileRevalidationDependencies = {
+    clock?: () => Date;
+    authorizeTarget?: (action: ProviderFileQuarantineAction) => Promise<void>;
+    allowedHandlePids?: ReadonlySet<number>;
+    inspectProcesses?: (provider: ProviderFileQuarantineAction["adapter"]) => Promise<ProviderProcessResult>;
+    inspectOpenHandles?: (path: string) => Promise<ProcessOwnershipResult>;
+};
+export declare function revalidateProviderFileQuarantine(action: ProviderFileQuarantineAction, home?: string, config?: AgentRinseConfig, dependencies?: ProviderFileRevalidationDependencies): Promise<ProviderFileRevalidationResult>;
+//# sourceMappingURL=provider-file-revalidation.d.ts.map

package/dist/core/provider-file-revalidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-file-revalidation.d.ts","sourceRoot":"","sources":["../../src/core/provider-file-revalidation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,OAAO,EAA4B,KAAK,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC/F,OAAO,EAA0B,KAAK,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAE7F,MAAM,MAAM,8BAA8B,GACtC;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GACnB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,CAAC;AAEhD,MAAM,MAAM,oCAAoC,GAAG;IACjD,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,4BAA4B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,iBAAiB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACxC,gBAAgB,CAAC,EAAE,CACjB,QAAQ,EAAE,4BAA4B,CAAC,SAAS,CAAC,KAC9C,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACpC,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACxE,CAAC;AAmBF,wBAAsB,gCAAgC,CACpD,MAAM,EAAE,4BAA4B,EACpC,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,gBAAgB,EACzB,YAAY,GAAE,oCAAyC,GACtD,OAAO,CAAC,8BAA8B,CAAC,CA6EzC"}

package/dist/core/provider-file-revalidation.js

@@ -0,0 +1,60 @@
+import { inspectProviderFile, providerFileIdentityMatches } from "./provider-file-identity.js";
+import { authorizeProviderFileAction } from "./provider-file-policy.js";
+import { inspectProviderProcesses } from "./provider-processes.js";
+import { findProcessesUsingFile } from "./process-ownership.js";
+function stale(action, code, message) {
+    return {
+        status: "stale",
+        diagnostic: {
+            severity: "warning",
+            code,
+            message,
+            adapter: action.adapter,
+            resourceId: action.resourceId,
+        },
+    };
+}
+export async function revalidateProviderFileQuarantine(action, home, config, dependencies = {}) {
+    try {
+        const authorizeTarget = dependencies.authorizeTarget ??
+            (home !== undefined && config !== undefined
+                ? (selectedAction) => authorizeProviderFileAction(selectedAction, home, config, process.platform, process.env, (dependencies.clock ?? (() => new Date()))())
+                : undefined);
+        if (authorizeTarget === undefined) {
+            throw new Error("provider-file execution requires an approved provider policy");
+        }
+        await authorizeTarget(action);
+    }
+    catch (error) {
+        return stale(action, "PROVIDER_FILE_POLICY_REFUSED", error instanceof Error ? error.message : String(error));
+    }
+    try {
+        const actual = await inspectProviderFile(action.target.path, action.target.ownerRoot, action.target.provider);
+        if (!providerFileIdentityMatches(actual, action.target)) {
+            return stale(action, "PROVIDER_FILE_IDENTITY_CHANGED", "provider file identity changed");
+        }
+    }
+    catch (error) {
+        return stale(action, "PROVIDER_FILE_IDENTITY_CHANGED", error instanceof Error ? error.message : String(error));
+    }
+    const processes = await (dependencies.inspectProcesses ?? inspectProviderProcesses)(action.adapter);
+    if (processes.status !== "idle") {
+        return stale(action, processes.status === "busy" ? "PROVIDER_ACTIVE" : "PROVIDER_STATE_UNKNOWN", processes.status === "busy"
+            ? `${action.adapter} is running`
+            : `${action.adapter} process state is unknown: ${processes.reason}`);
+    }
+    const handles = await (dependencies.inspectOpenHandles ?? findProcessesUsingFile)(action.target.path);
+    const externalMatches = handles.status === "busy"
+        ? handles.matches.filter((match) => !dependencies.allowedHandlePids?.has(match.pid))
+        : [];
+    if (handles.status === "unknown" || externalMatches.length > 0) {
+        const message = handles.status === "unknown"
+            ? `provider file descriptor state is unknown: ${handles.reason}`
+            : "a process has the provider file open";
+        return stale(action, externalMatches.length > 0
+            ? "PROVIDER_FILE_DESCRIPTOR_ACTIVE"
+            : "PROVIDER_FILE_DESCRIPTOR_STATE_UNKNOWN", message);
+    }
+    return { status: "ready" };
+}
+//# sourceMappingURL=provider-file-revalidation.js.map

package/dist/core/provider-file-revalidation.js.map

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

package/dist/core/provider-processes.d.ts

@@ -0,0 +1,18 @@
+import type { ProviderMutationId } from "../contracts/action.js";
+export type ProviderProcessResult = {
+    status: "idle";
+    pids: [];
+} | {
+    status: "busy";
+    pids: number[];
+} | {
+    status: "unknown";
+    pids: [];
+    reason: string;
+};
+export type ProviderProcessOptions = {
+    runPs?: () => Promise<string>;
+};
+export declare function providerProcessListArguments(): string[];
+export declare function inspectProviderProcesses(provider: ProviderMutationId, options?: ProviderProcessOptions): Promise<ProviderProcessResult>;
+//# sourceMappingURL=provider-processes.d.ts.map

package/dist/core/provider-processes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-processes.d.ts","sourceRoot":"","sources":["../../src/core/provider-processes.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAIjE,MAAM,MAAM,qBAAqB,GAC7B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,EAAE,CAAA;CAAE,GAC5B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpD,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/B,CAAC;AAiCF,wBAAgB,4BAA4B,IAAI,MAAM,EAAE,CAEvD;AAcD,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CA0ChC"}

package/dist/core/provider-processes.js

@@ -0,0 +1,90 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+const COMMAND_PATTERNS = {
+    claude: [
+        /(?:^|\s)(?:\S*[/\\])?claude(?:\.exe)?(?:\s|$)/iu,
+        /(?:^|\s)(?:\S*[/\\])?claude-code(?:\.exe)?(?:\s|$)/iu,
+        /@anthropic-ai[/\\]claude-code/iu,
+        /Claude\.app[/\\]Contents[/\\]MacOS[/\\]Claude/iu,
+    ],
+    cursor: [
+        /(?:^|\s)(?:\S*[/\\])?cursor(?:\.exe)?(?:\s|$)/iu,
+        /cursor-agent/iu,
+        /Cursor\.app[/\\]Contents[/\\]MacOS[/\\]Cursor/iu,
+        /Cursor Helper/iu,
+    ],
+    copilot: [
+        /(?:^|\s)(?:\S*[/\\])?copilot(?:\.exe)?(?:\s|$)/iu,
+        /@github[/\\]copilot/iu,
+        /github-copilot/iu,
+    ],
+    zed: [
+        /(?:^|\s)(?:\S*[/\\])?zed(?:\.exe)?(?:\s|$)/iu,
+        /zed-editor/iu,
+        /Zed\.app[/\\]Contents[/\\]MacOS[/\\]zed/iu,
+    ],
+    opencode: [/(?:^|\s)(?:\S*[/\\])?opencode(?:\.exe)?(?:\s|$)/iu],
+    grok: [/(?:^|\s)(?:\S*[/\\])?grok(?:\.exe)?(?:\s|$)/iu, /grok-build/iu],
+};
+function commandMatches(provider, commandLine) {
+    return COMMAND_PATTERNS[provider].some((pattern) => pattern.test(commandLine));
+}
+export function providerProcessListArguments() {
+    return ["-ww", "-axo", "pid=,args="];
+}
+async function defaultPs() {
+    const result = await execFileAsync("ps", providerProcessListArguments(), {
+        encoding: "utf8",
+        maxBuffer: 4 * 1024 * 1024,
+        timeout: 10_000,
+    });
+    if (result.stderr !== "") {
+        throw new Error(`ps reported incomplete process data: ${result.stderr.trim()}`);
+    }
+    return result.stdout;
+}
+export async function inspectProviderProcesses(provider, options = {}) {
+    try {
+        const output = await (options.runPs ?? defaultPs)();
+        const pids = [];
+        let observed = 0;
+        let incomplete = false;
+        for (const line of output.split("\n")) {
+            if (line.trim() === "") {
+                continue;
+            }
+            const match = /^\s*(\d+)\s+(.+?)\s*$/u.exec(line);
+            if (match === null) {
+                incomplete = true;
+                continue;
+            }
+            observed += 1;
+            const pid = Number.parseInt(match[1], 10);
+            if (pid !== process.pid && commandMatches(provider, match[2])) {
+                pids.push(pid);
+            }
+        }
+        if (pids.length > 0) {
+            return { status: "busy", pids };
+        }
+        if (observed === 0 || incomplete) {
+            return {
+                status: "unknown",
+                pids: [],
+                reason: observed === 0
+                    ? "ps returned no process records"
+                    : "ps returned an unparseable process record",
+            };
+        }
+        return { status: "idle", pids: [] };
+    }
+    catch (error) {
+        return {
+            status: "unknown",
+            pids: [],
+            reason: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+//# sourceMappingURL=provider-processes.js.map

package/dist/core/provider-processes.js.map

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