humanish 0.35.0 → 0.36.0

package/dist/reclaim.js

@@ -0,0 +1,90 @@
+// `humanish reclaim` (#358 salvage tier): kill an interrupted run's sandboxes by the EXACT ids the
+// run journaled at create time (sandbox-receipts.ndjson), and say honestly what happened to each.
+// The lane loop lives in the operator's local process, so a sleeping laptop or a crash orphans
+// every sandbox with the ids trapped in dead memory; before this command the only remedies were
+// the server-side create-time TTL (slow, spend keeps burning) or account enumeration (which this
+// codebase never does — an account-wide operation once destroyed unrelated infrastructure). This
+// reads one file inside the managed run dir, kills by id, and never lists anything.
+import { loadE2BDesktopModule } from "./e2b-desktop-launch.js";
+import { readContainedRegularFile, writeContainedOutputFile } from "./selected-output-paths.js";
+import { resolveRunPath } from "./run.js";
+import { parseSandboxReceipts, SANDBOX_RECEIPTS_ARTIFACT } from "./sandbox-receipts.js";
+import path from "node:path";
+import { toErrorMessage } from "./command-failure.js";
+import { redactText } from "./redaction.js";
+export const RECLAIM_RESULT_SCHEMA = "humanish.reclaim-result.v1";
+export const RECLAIM_RECEIPT_ARTIFACT = "reclaim-receipt.json";
+export async function reclaimRunSandboxes(cwd, runInput, hooks = {}) {
+    const warnings = [];
+    const base = { schema: RECLAIM_RESULT_SCHEMA, cwd, runId: runInput, receiptCount: 0, outcomes: [], warnings };
+    const runPaths = await resolveRunPath(cwd, runInput);
+    if (!runPaths) {
+        return {
+            ...base,
+            ok: false,
+            error: { code: "HUMANISH_RECLAIM_RUN_NOT_FOUND", message: `No run found for "${runInput}" (use \`humanish runs\` to list runs).` }
+        };
+    }
+    const runId = path.basename(runPaths.absoluteRunRoot);
+    const bytes = await readContainedRegularFile(runPaths, SANDBOX_RECEIPTS_ARTIFACT);
+    if (bytes === null) {
+        // Honest empty: nothing journaled means either no sandbox was ever created (cheap interrupt —
+        // nothing to reclaim) or the run predates receipts (0.35.x and earlier — the create-time TTL
+        // is the only backstop for those). Either way there is no id to act on, and saying so beats
+        // pretending a scan happened.
+        warnings.push("No sandbox-receipts.ndjson in this run dir: either no sandbox was created before the interrupt, or the run predates create-time receipts. Nothing to reclaim by id; server-side kill-on-timeout covers anything that did exist.");
+        return { ...base, runId, ok: true };
+    }
+    const receipts = parseSandboxReceipts(bytes.toString("utf8"));
+    let sandboxModule;
+    try {
+        sandboxModule = await (hooks.loadModule ?? loadE2BDesktopModule)();
+    }
+    catch (error) {
+        return {
+            ...base,
+            runId,
+            receiptCount: receipts.length,
+            ok: false,
+            error: { code: "HUMANISH_RECLAIM_MODULE_UNAVAILABLE", message: `Cannot load @e2b/desktop to kill by id: ${redactText(toErrorMessage(error))}` }
+        };
+    }
+    const requestTimeoutMs = hooks.requestTimeoutMs ?? 60_000;
+    const kill = sandboxModule.Sandbox.kill;
+    const outcomes = [];
+    const seen = new Set();
+    for (const receipt of receipts) {
+        if (seen.has(receipt.sandboxId))
+            continue; // one attempt per id, however many receipts raced
+        seen.add(receipt.sandboxId);
+        if (typeof kill !== "function") {
+            outcomes.push({ sandboxId: receipt.sandboxId, laneId: receipt.laneId, state: "kill-failed", detail: "installed @e2b/desktop SDK does not expose Sandbox.kill; server-side kill-on-timeout will reclaim the sandbox" });
+            continue;
+        }
+        try {
+            const killed = (await kill.call(sandboxModule.Sandbox, receipt.sandboxId, { requestTimeoutMs })) === true;
+            outcomes.push({ sandboxId: receipt.sandboxId, laneId: receipt.laneId, state: killed ? "killed" : "already-gone" });
+        }
+        catch (error) {
+            const detail = redactText(toErrorMessage(error));
+            const gone = /not.?found|does not exist|404/i.test(detail);
+            outcomes.push({
+                sandboxId: receipt.sandboxId,
+                laneId: receipt.laneId,
+                state: gone ? "already-gone" : "kill-failed",
+                ...(gone ? {} : { detail })
+            });
+        }
+    }
+    const ok = outcomes.every((outcome) => outcome.state !== "kill-failed");
+    const result = { ...base, runId, receiptCount: receipts.length, outcomes, ok };
+    // Keep the reclaim record next to the run it cleaned: what was attempted, what happened, when.
+    try {
+        await writeContainedOutputFile(runPaths, RECLAIM_RECEIPT_ARTIFACT, `${JSON.stringify({ schema: RECLAIM_RESULT_SCHEMA, at: new Date().toISOString(), runId, receiptCount: receipts.length, outcomes }, null, 2)}\n`, "utf8");
+    }
+    catch (error) {
+        warnings.push(`Reclaim ran but its receipt could not be written: ${redactText(toErrorMessage(error))}`);
+    }
+    return result;
+}
+//# sourceMappingURL=reclaim.js.map

package/dist/reclaim.js.map

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

package/dist/run.d.ts

@@ -970,4 +970,7 @@ export declare function readReview(cwdInput: string, runInput: string): Promise<
     runId: string;
 })>;
 export declare function doctor(cwdInput: string): Promise<DoctorResult>;
+/** Resolve "latest" or an explicit run id to its prepared artifact paths. Exported for the
+ *  reclaim command (#358), which must locate a run WITHOUT trusting anything but the managed dir. */
+export declare function resolveRunPath(cwd: string, runInput: string): Promise<PreparedRunArtifactPaths | null>;
 export {};

package/dist/run.js

@@ -3147,7 +3147,9 @@ function parsePersonaYaml(text) {
 function escapeRegExp(value) {
     return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-async function resolveRunPath(cwd, runInput) {
+/** Resolve "latest" or an explicit run id to its prepared artifact paths. Exported for the
+ *  reclaim command (#358), which must locate a run WITHOUT trusting anything but the managed dir. */
+export async function resolveRunPath(cwd, runInput) {
     if (runInput === "latest") {
         const runsRoot = await bindExistingManagedHumanishOutputDirectory(cwd, "runs");
         if (!runsRoot) {