Files
pepa-pi-bot/runtime/ipc-protocol.js
T
mayatnikovandClaude Opus 4.7 86f0c1799e fix(runtime): pin MC_VERSION=1.21.4 + ground-truth probe + close-loop dig
Two-pronged response to user-confirmed "bot stands still, doesn't actually
chop" on play.xmatic.team:

1. Pin protocol — .env now sets MC_VERSION=1.21.4. minecraft-data has
   wrong packet ID mappings for protocol 775 (server 26.1.2 via
   ViaBackwards 5.9.1) — see mineflayer#3888 and #3717. 1.21.5 also has
   an enchants decoder bug that breaks bot.dig. 1.21.4 is the last
   protocol mineflayer 4.37.1 can speak cleanly through VIA.

2. Don't trust dig success — runtime/actions.js chopNearestTree and
   runtime/skills/gather-stone.js now lookAt(face center)+forceLook,
   await collectBlock, then re-read the target block. If the log/stone
   is STILL there, return ok:false code:"silent_dig_failure" and
   blacklist the position. Prevents the curriculum from reporting
   "wood.16 in progress" while the world hasn't actually changed.

3. Defensive default — runtime/movement-profiles.js: canDig=false on
   every profile until dig is confirmed working live. Otherwise
   pathfinder schedules paths through must-dig blocks and the bot loops.

4. Ground-truth probe — runtime/skills/diagnose-physics.js dispatches
   forward/jump/dig probes and writes the result to the diary. New
   IPC command cmd:run-skill lets the operator (or a future curriculum
   trigger) fire any skill on demand; it waits for the current action
   to finish before dispatching. /tmp/pepa-runskill.mjs is a one-shot
   client.

Live probe on play.xmatic.team confirmed: forward Δ=0.003 over 2s
(BROKEN — server rejects movement packets), jump ΔY=0.42 (likely
physics jitter, not a real jump). Strongly suggests an anti-cheat
plugin gating bot-style movements server-side — beyond protocol pin.

npm test 124/124.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-26 11:51:43 +03:00

55 lines
2.1 KiB
JavaScript

// Shared IPC contract between runtime/bot.js (server) and tui/tui.tsx (client).
// Frame format: one JSON object per line over a Unix-domain socket.
// Socket path: state/<server-key>/bot.sock (created by server, removed on shutdown).
export const SOCKET_BASENAME = "bot.sock";
// Server → client messages.
export const EVENT_TYPES = Object.freeze({
STATUS: "status", // periodic snapshot (HP/food/pos/task/connection)
LOG: "log", // free-form log line { level, source, text }
CHAT: "chat", // MC chat { from, text, kind: "player" | "system" }
DEATH: "death", // death event { reason, position }
ERROR: "error", // recoverable runtime error { source, text }
ASK_PI_CHUNK: "ask-pi-chunk", // streamed stdout chunk from Pi subprocess
ASK_PI_DONE: "ask-pi-done", // Pi subprocess exited { code, durationMs }
HELLO: "hello", // sent on client connect with current snapshot
PROPOSAL: "proposal", // pending proposal payload { filename, body }
});
// Client → server commands.
export const COMMAND_TYPES = Object.freeze({
PAUSE: "cmd:pause", // reflex loop stops ticking; connection stays
RESUME: "cmd:resume", // reflex loop resumes
STOP: "cmd:stop", // graceful disconnect + process exit
CHAT: "cmd:chat", // { text } sent into MC as bot
ASK_PI: "cmd:ask-pi", // { prompt } spawn `pi -p` and stream output
SNAPSHOT: "cmd:snapshot", // request immediate STATUS event
PROPOSAL_LATEST: "cmd:proposal-latest", // request latest pending proposal
PROPOSAL_APPROVE: "cmd:proposal-approve", // { filename } move to approved/
RUN_SKILL: "cmd:run-skill", // { skillId, args? } dispatch a skill once (operator ground-truth probes)
});
export function encodeFrame(obj) {
return JSON.stringify(obj) + "\n";
}
// Stateful line splitter — instance per socket.
export function createLineParser(onObject) {
let buf = "";
return (chunk) => {
buf += chunk.toString("utf8");
let idx;
while ((idx = buf.indexOf("\n")) !== -1) {
const line = buf.slice(0, idx).trim();
buf = buf.slice(idx + 1);
if (!line) continue;
try {
onObject(JSON.parse(line));
} catch (e) {
onObject({ __parseError: true, raw: line, err: String(e) });
}
}
};
}