labgate 0.5.31 → 0.5.33

package/dist/lib/explorer-lock.d.ts

@@ -0,0 +1,5 @@
+export interface ExplorerLock {
+    lockPath: string;
+    release: () => void;
+}
+export declare function acquireExperimentLock(experimentId: string, lockName?: string): ExplorerLock | null;

package/dist/lib/explorer-lock.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.acquireExperimentLock = acquireExperimentLock;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const config_js_1 = require("./config.js");
+function parseLockPid(raw) {
+    const firstLine = raw.split(/\r?\n/, 1)[0] || '';
+    const pid = Number(firstLine.trim());
+    if (!Number.isFinite(pid) || pid <= 0)
+        return null;
+    return Math.floor(pid);
+}
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        if (err?.code === 'ESRCH')
+            return false;
+        if (err?.code === 'EPERM')
+            return true;
+        return true;
+    }
+}
+function clearStaleLockIfPossible(lockPath) {
+    try {
+        const raw = (0, fs_1.readFileSync)(lockPath, 'utf-8');
+        const pid = parseLockPid(raw);
+        if (pid !== null && isProcessAlive(pid)) {
+            return false;
+        }
+        (0, fs_1.unlinkSync)(lockPath);
+        return true;
+    }
+    catch (err) {
+        if (err?.code === 'ENOENT')
+            return true;
+        return false;
+    }
+}
+function acquireExperimentLock(experimentId, lockName = 'autopilot.lock') {
+    const lockDir = (0, config_js_1.getExplorerLockDir)(experimentId);
+    (0, fs_1.mkdirSync)(lockDir, { recursive: true, mode: 0o700 });
+    const lockPath = (0, path_1.join)(lockDir, lockName);
+    let fd = null;
+    for (let attempt = 0; attempt < 2; attempt++) {
+        try {
+            fd = (0, fs_1.openSync)(lockPath, 'wx', 0o600);
+            break;
+        }
+        catch (err) {
+            if (err?.code !== 'EEXIST')
+                throw err;
+            const recovered = attempt === 0 && clearStaleLockIfPossible(lockPath);
+            if (!recovered)
+                return null;
+        }
+    }
+    if (fd === null) {
+        return null;
+    }
+    try {
+        (0, fs_1.writeFileSync)(fd, `${process.pid}\n`, { encoding: 'utf-8' });
+    }
+    catch (err) {
+        try {
+            (0, fs_1.closeSync)(fd);
+        }
+        catch {
+            // Best effort.
+        }
+        try {
+            (0, fs_1.unlinkSync)(lockPath);
+        }
+        catch {
+            // Best effort.
+        }
+        throw err;
+    }
+    return {
+        lockPath,
+        release: () => {
+            try {
+                (0, fs_1.closeSync)(fd);
+            }
+            catch {
+                // Best effort.
+            }
+            try {
+                (0, fs_1.unlinkSync)(lockPath);
+            }
+            catch {
+                // Best effort.
+            }
+        },
+    };
+}
+//# sourceMappingURL=explorer-lock.js.map

package/dist/lib/explorer-lock.js.map

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

package/dist/lib/explorer-mcp.d.ts

@@ -0,0 +1,11 @@
+/**
+ * LabGate Explorer MCP Server
+ *
+ * Experiment orchestration primitives for Solution Explorer:
+ * - experiment lifecycle
+ * - git/worktree helpers
+ * - eval execution
+ * - run/tree/leaderboard queries
+ * - manual run step execution
+ */
+export declare function main(args?: string[]): Promise<void>;