fix(runtime): escape-pit fallback for wedged bot

When probe-cardinal shows all 4 directions blocked (the bot is in a
1×1 pit, surrounded by leaves, or in a corridor corner), don't just
hold forward+jump — actually dig the block above the bot's head,
jump into the new gap, repeat up to 3 times. Both wander and
explore.far now call escapePit() in this branch.

Observed live: bot fell into a pit at (623,71,106) after first
explore.far and looped wedged-jump→still-wedged→wedged-jump for 60s
before this fix. With escape-pit, the bot now actually breaks out.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

runtime/actions.js

@@ -426,23 +426,13 @@ export async function wander(bot, radius = 12) {
 	const trials = await probeCardinalSteps(bot, 800);
 	const best = trials.reduce((b, t) => (t.dist > b.dist ? t : b), { dist: 0 });
 
-	// If nothing moved at all, the bot is wedged in all four cardinal
+	// If nothing moved at all, the bot is wedged — pit, corridor corner,
-	// directions (corner of a corridor, surrounded by leaves, hole). Try
+	// surrounded by leaves. Try to escape: dig the block straight above
-	// to jump + go in the most-promising direction (>0 movement) — gravity
+	// + jump, repeat up to 3 times, then try forward+jump.
-	// will help us drop to a lower y where there's space.
 	if (best.dist < 0.5) {
-		const fallback = trials.reduce((b, t) => (t.dist > b.dist ? t : b), { dist: 0, yaw: 0 });
+		info("action", `wander: all cardinals blocked → escape-pit (dig up + jump)`);
-		info("action", `wander: all cardinals blocked, jumping fallback yaw=${fallback.yaw?.toFixed?.(2)}`);
+		await escapePit(bot, 3);
-		try { await bot.look(fallback.yaw ?? 0, 0, true); } catch {}
+		return { ok: true, detail: { mode: "escape-pit", trials } };
-		bot.setControlState("forward", true);
-		bot.setControlState("jump", true);
-		try {
-			await new Promise((r) => setTimeout(r, 2_500));
-		} finally {
-			bot.setControlState("forward", false);
-			bot.setControlState("jump", false);
-		}
-		return { ok: true, detail: { mode: "wedged-jump", trials } };
 	}
 
 	// Commit to best direction.
@@ -481,6 +471,43 @@ const CARDINAL_YAWS = [
 	{ name: "W", yaw: Math.PI / 2 },
 ];
 
+// escapePit — dig the block right above the bot's head, jump into the
+// newly empty slot, repeat. Useful when the bot is in a 1x1 pit / surrounded
+// by leaves above its head / standing inside a tree canopy. We use bot.dig
+// directly (not collectBlock) because we don't care about pickup here.
+async function escapePit(bot, maxSteps = 3) {
+	for (let i = 0; i < maxSteps; i++) {
+		const head = bot.entity.position.offset(0, 1.7, 0);
+		const above = bot.blockAt(head.offset(0, 0.5, 0));
+		if (!above || above.name === "air" || above.name === "cave_air") {
+			// Already clear above. Just jump+forward in case bot is in a
+			// horizontal pit (gap in floor).
+			bot.setControlState("jump", true);
+			bot.setControlState("forward", true);
+			await new Promise((r) => setTimeout(r, 700));
+			bot.setControlState("jump", false);
+			bot.setControlState("forward", false);
+			continue;
+		}
+		// Try to break the block above us. Force lookAt + 1-tick wait so the
+		// server accepts the dig packet on protocol 775.
+		try {
+			await withTimeout(bot.lookAt(above.position.offset(0.5, 0.5, 0.5), true), 1_500, "lookAt-up");
+		} catch {}
+		try {
+			await withTimeout(bot.dig(above), 8_000, "dig-up");
+		} catch (e) {
+			warn("action", `escape-pit dig-up failed: ${e.message}`);
+			break;
+		}
+		// jump into the now-empty slot
+		bot.setControlState("jump", true);
+		await new Promise((r) => setTimeout(r, 600));
+		bot.setControlState("jump", false);
+		await new Promise((r) => setTimeout(r, 400));
+	}
+}
+
 async function probeCardinalSteps(bot, durationMs = 800) {
 	const trials = [];
 	for (const { name, yaw } of CARDINAL_YAWS) {

runtime/skills/explore-far.js

@@ -73,18 +73,11 @@ export const skill = Object.freeze({
 		info("action", `explore.far: cardinal probe trials=${trials.map((t) => `${t.name}:${t.dist.toFixed(1)}`).join(" ")} best=${best.name}`);
 
 		if (best.dist < 0.5) {
-			// All cardinals blocked. Same wedged-jump as wander.
+			// All cardinals blocked → escape pit: dig the block above the
-			info("action", "explore.far: wedged — jump fallback");
+			// bot's head (if any), jump into the gap, repeat. Then break.
-			try { await bot.look(best.yaw ?? 0, 0, true); } catch {}
+			info("action", "explore.far: wedged — escape-pit (dig up + jump)");
-			bot.setControlState("forward", true);
+			await escapePit(bot, 3);
-			bot.setControlState("jump", true);
+			return { ok: true, code: "done", detail: { mode: "escape-pit", trials }, worldDelta: null };
-			try {
-				await new Promise((r) => setTimeout(r, 3_000));
-			} finally {
-				bot.setControlState("forward", false);
-				bot.setControlState("jump", false);
-			}
-			return { ok: true, code: "done", detail: { mode: "wedged-jump", trials }, worldDelta: { movedTo: null } };
 		}
 
 		const here = bot.entity.position.clone();
@@ -131,6 +124,32 @@ const CARDINAL_YAWS = [
 	{ name: "W", yaw: Math.PI / 2 },
 ];
 
+async function escapePit(bot, maxSteps = 3) {
+	for (let i = 0; i < maxSteps; i++) {
+		const head = bot.entity.position.offset(0, 1.7, 0);
+		const above = bot.blockAt(head.offset(0, 0.5, 0));
+		if (!above || above.name === "air" || above.name === "cave_air") {
+			bot.setControlState("jump", true);
+			bot.setControlState("forward", true);
+			await new Promise((r) => setTimeout(r, 700));
+			bot.setControlState("jump", false);
+			bot.setControlState("forward", false);
+			continue;
+		}
+		try { await withTimeout(bot.lookAt(above.position.offset(0.5, 0.5, 0.5), true), 1_500, "lookAt-up"); } catch {}
+		try {
+			await withTimeout(bot.dig(above), 8_000, "dig-up");
+		} catch (e) {
+			warn("action", `escape-pit dig-up failed: ${e.message}`);
+			break;
+		}
+		bot.setControlState("jump", true);
+		await new Promise((r) => setTimeout(r, 600));
+		bot.setControlState("jump", false);
+		await new Promise((r) => setTimeout(r, 400));
+	}
+}
+
 async function probeCardinalStep(bot, durationMs = 800) {
 	const trials = [];
 	for (const { name, yaw } of CARDINAL_YAWS) {