pepa-pi-bot/runtime/reflex.js

// Reflex layer: priority-ordered list of pure-script behaviors. Each reflex
// inspects the latest snapshot and either returns a no-op, dispatches an
// async action via ctx.dispatch, or completes synchronously.
//
// LLM is NOT called here. If every reflex declines, the tick yields and we
// try again next interval. The bot.js layer tracks consecutive noops and
// escalates to Pi after a threshold (see ESCALATE_AFTER_NOOPS).

import { info, warn } from "./log.js";
import { attackNearest, fleeFrom, eatBestFood, sleepInBed, goTo, chopNearestTree, wander } from "./actions.js";

const REFLEX_LOG = "reflex";

// A reflex returns one of:
//   { action: "noop" }                       — nothing to do
//   { action: "dispatched", kind, label }    — dispatched an async action
//   { action: "completed", kind, detail }    — fully sync, already done
// Reflexes must NEVER throw — they log and return noop on failure.

// ---- operator goal reflex --------------------------------------------------

// Highest priority: if the operator gave a "come here" / "follow me" command,
// satisfy that before anything else (except defending if HP is critical).
function operatorGoalReflex(ctx) {
	const goal = ctx.operatorGoal;
	if (!goal) return { action: "noop" };
	if (goal.kind === "come") {
		ctx.dispatch(
			() => goTo(ctx.bot, goal.x, goal.y, goal.z, 2),
			`operator-come(${goal.from})`,
			{
				onComplete: (res) => {
					if (res.ok) {
						ctx.bot.chat(`${goal.from}: arrived.`);
					} else {
						ctx.bot.chat(`${goal.from}: couldn't reach you (${res.detail}).`);
					}
					ctx.clearOperatorGoal();
				},
			},
		);
		return { action: "dispatched", kind: "operator-come", label: `come ${goal.x},${goal.y},${goal.z}` };
	}
	return { action: "noop" };
}

// ---- defend ----------------------------------------------------------------

function defendReflex(ctx) {
	const s = ctx.snapshot;
	if (!s.connected) return { action: "noop" };
	if (!s.closestHostile) return { action: "noop" };

	const dist = s.closestHostile.distance;
	const lowHp = (s.health ?? 20) <= 8;

	// Three regimes — tightened to avoid the "82 distant hostiles → constant
	// flee" pathology observed at this spawn:
	//   - within 4m: melee attack
	//   - within 8m (and visibly hostile to us): flee
	//   - low-HP fallback: flee anything within 12m
	// Anything beyond 8m with full HP is ignored regardless of how many
	// hostiles the perceive snapshot enumerates.
	if (dist <= 4) {
		ctx.dispatch(
			() => attackNearest(ctx.bot, s.closestHostile.name),
			`attack ${s.closestHostile.name}`,
		);
		return { action: "dispatched", kind: "defend-attack", label: s.closestHostile.name };
	}
	const shouldFlee = (dist <= 8) || (lowHp && dist <= 12);
	if (!shouldFlee) return { action: "noop" };

	// Cooldown — if we just fled from this same mob type and it didn't work
	// (timed out), don't immediately re-fire. Let other reflexes run.
	const lastFlee = ctx.lastFleeAttempt;
	if (lastFlee && lastFlee.name === s.closestHostile.name && Date.now() - lastFlee.ts < 60_000) {
		return { action: "noop" };
	}
	ctx.lastFleeAttempt = { name: s.closestHostile.name, ts: Date.now() };

	const fromEntity = Object.values(ctx.bot.entities).find(
		(e) =>
			e.name === s.closestHostile.name &&
			e.position &&
			Math.abs(e.position.distanceTo(ctx.bot.entity.position) - dist) < 1.5,
	);
	ctx.dispatch(
		() => fleeFrom(ctx.bot, fromEntity, 16),
		`flee from ${s.closestHostile.name}`,
	);
	return { action: "dispatched", kind: "defend-flee", label: s.closestHostile.name };
}

// ---- eat -------------------------------------------------------------------

function eatReflex(ctx) {
	const s = ctx.snapshot;
	if (!s.connected) return { action: "noop" };
	if (s.food === undefined || s.food >= 16) return { action: "noop" };
	// Don't eat if we just ate (the food bar refresh on the server has a
	// small lag — re-firing within 5s would just fail bot.consume).
	const since = Date.now() - (ctx.lastEatAt ?? 0);
	if (since < 5000) return { action: "noop" };

	ctx.dispatch(
		() => eatBestFood(ctx.bot),
		"eat",
		{
			onComplete: (res) => {
				if (res.ok) ctx.lastEatAt = Date.now();
			},
		},
	);
	return { action: "dispatched", kind: "eat", label: `food=${s.food}` };
}

// ---- sleep -----------------------------------------------------------------

function sleepReflex(ctx) {
	const s = ctx.snapshot;
	if (!s.connected) return { action: "noop" };
	if (s.isDay) return { action: "noop" };
	if (s.closestHostile && s.closestHostile.distance < 8) return { action: "noop" }; // not safe
	// Longer cooldown after a failure — if there's no bed nearby, retrying
	// every 30s blocks autonomous behaviour without ever succeeding.
	const since = Date.now() - (ctx.lastSleepAttemptAt ?? 0);
	if (since < 5 * 60_000) return { action: "noop" };

	ctx.lastSleepAttemptAt = Date.now();
	ctx.dispatch(
		() => sleepInBed(ctx.bot),
		"sleep",
		{
			onComplete: (res) => {
				if (res.ok) info(REFLEX_LOG, `sleep: success (${JSON.stringify(res.detail)})`);
				else info(REFLEX_LOG, `sleep: declined (${res.detail})`);
			},
		},
	);
	return { action: "dispatched", kind: "sleep", label: "night" };
}

// ---- autonomous "live your best life" --------------------------------------

// Triggered when no reactive reflex (operator/defend/eat/sleep) wants to act.
// Picks ONE small proactive action and runs it. Cooldown so we don't fire on
// every 3s tick — actions take 15-45s themselves and we want some breathing
// room between them.
const AUTONOMOUS_COOLDOWN_MS = 10_000;

function autonomousReflex(ctx) {
	const s = ctx.snapshot;
	if (!s.connected) return { action: "noop" };

	// Only suppress autonomous work at night when a hostile is in actual reach
	// (within 16m). Distant mobs the perception layer happens to enumerate
	// don't count — at this spawn there can be 80+ mobs visible but irrelevant
	// to local action.
	const nightClose = !s.isDay && s.closestHostile && s.closestHostile.distance <= 16;
	if (nightClose) return { action: "noop" };

	const since = Date.now() - (ctx.lastAutonomousAt ?? 0);
	if (since < AUTONOMOUS_COOLDOWN_MS) return { action: "noop" };
	ctx.lastAutonomousAt = Date.now();

	// What to do: gather wood until we have a small stockpile, then wander a
	// bit to find new chunks. If a recent chop attempt reported "no reachable
	// log", switch to wander for the next 60s — chopping the same not-found
	// position over and over is what the user observed live.
	const inv = s.inventory ?? {};
	const logCount = Object.entries(inv)
		.filter(([name]) => name.endsWith("_log"))
		.reduce((sum, [, n]) => sum + n, 0);

	const noTreesRecently = ctx.noTreesUntil && Date.now() < ctx.noTreesUntil;
	const wantChop = logCount < 16 && !noTreesRecently;
	if (wantChop) {
		ctx.dispatch(() => chopNearestTree(ctx.bot), "chop tree", {
			onComplete: (res) => {
				if (res.ok) {
					info(REFLEX_LOG, `chopped ${res.detail?.logType ?? "log"}`);
					ctx.noTreesUntil = 0; // success ⇒ trees exist around us
				} else if (typeof res.detail === "string" && res.detail.includes("no reachable")) {
					// No log within 32 blocks of the current position. Don't try
					// again for 60s — wander first to find a new biome / chunk.
					ctx.noTreesUntil = Date.now() + 60_000;
				}
			},
		});
		return { action: "dispatched", kind: "autonomous-chop", label: "chop tree" };
	}
	ctx.dispatch(() => wander(ctx.bot, 16), "wander", {});
	return { action: "dispatched", kind: "autonomous-wander", label: "wander" };
}

// ---- idle ------------------------------------------------------------------

function idleReflex(ctx) {
	const s = ctx.snapshot;
	if (!s.connected) return { action: "noop" };
	ctx.idleCounter = (ctx.idleCounter ?? 0) + 1;
	if (ctx.idleCounter % 20 !== 0) return { action: "noop" };
	info(
		REFLEX_LOG,
		`idle: hp=${s.health} food=${s.food} pos=${s.position?.x},${s.position?.y},${s.position?.z} time=${s.time}`,
	);
	return { action: "completed", kind: "idle-heartbeat" };
}

const REFLEXES = [
	{ name: "operator-goal", fn: operatorGoalReflex },
	{ name: "defend", fn: defendReflex },
	{ name: "eat", fn: eatReflex },
	{ name: "sleep", fn: sleepReflex },
	{ name: "autonomous", fn: autonomousReflex },
	{ name: "idle", fn: idleReflex },
];

export function runTick(ctx) {
	// Bot is in the middle of an async action — don't dispatch another.
	if (ctx.busy) {
		return { reflex: "busy", action: "skipped", label: ctx.currentActionLabel ?? "(?)" };
	}
	for (const reflex of REFLEXES) {
		let outcome;
		try {
			outcome = reflex.fn(ctx);
		} catch (e) {
			warn(REFLEX_LOG, `reflex ${reflex.name} threw: ${e?.message ?? e}`);
			continue;
		}
		if (!outcome || outcome.action === "noop") continue;
		ctx.lastReflex = { name: reflex.name, label: outcome.label ?? outcome.kind, ts: Date.now() };
		return { reflex: reflex.name, ...outcome };
	}
	return null;
}