mayatnikovandClaude Opus 4.7
0834bb6b73
Phase 2 of plans/autonomous-survival-bot-prd.md. Establishes the
composable skill contract from PRD §5.2 and ports three reference
skills so future phases can layer survival behaviour on top instead of
adding more ad-hoc branches to reflex.js.
New: runtime/skills/
- index.js: skill registry + runSkill(id, ctx, args) wrapper. Enforces
preconditions, hard timeout, normalises {ok, code, detail, worldDelta}
on every result, runs validate() and calls recover() on failure.
Stable failure codes live in RUNNER_CODES (unknown_skill,
precondition_failed, timeout, threw, validation_failed, done).
- groups.js: registry-derived item/block sets — logs/planks/sticks/beds
derived by suffix; foods intersects a curated allowlist with the live
bot.registry; axes/pickaxes/swords scoped to whatever the connected
server's item table actually ships. Empty set instead of throwing on
missing registry, so skills can emit code:"unsupported_version".
- chop-logs.js: gather.logs reference skill (wraps chopNearestTree).
- eat.js: survive.eat (wraps eatBestFood, preconditions check carrying
edible food from the registry-derived set).
- wander.js: explore.wander (wraps wander).
- contract.test.js + groups.test.js: 14 tests covering precondition
gating, timeout firing recover(), execute exceptions, validate
flipping ok→false, dynamic group filtering across mock registries.
package.json: `npm test` runs the new contract + groups suites.
docs/runtime.md: documents the skill contract, runner, dynamic groups
and the reference skills.
Reflex.js still calls actions.js directly — wiring the scheduler to
runSkill() lands in later phases when the survival curriculum kicks in.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
55 lines
1.6 KiB
JavaScript
55 lines
1.6 KiB
JavaScript
// gather.logs — find the nearest log block matching the server's log
|
|
// registry, path to it, mine it. Wraps the existing actions.js primitive
|
|
// while exposing the survival-skill contract (preconditions, timeout,
|
|
// structured worldDelta, recovery hint).
|
|
|
|
import { chopNearestTree } from "../actions.js";
|
|
import { logs as logBlocks } from "./groups.js";
|
|
|
|
export const skill = Object.freeze({
|
|
id: "gather.logs",
|
|
title: "Gather logs",
|
|
timeoutMs: 60_000,
|
|
preconditions(ctx) {
|
|
if (!ctx?.bot) return { ok: false, code: "no_bot", detail: "bot missing" };
|
|
const known = logBlocks(ctx.bot);
|
|
if (known.size === 0) {
|
|
return { ok: false, code: "unsupported_version", detail: "no log blocks in registry" };
|
|
}
|
|
return { ok: true };
|
|
},
|
|
async execute(ctx) {
|
|
const res = await chopNearestTree(ctx.bot);
|
|
if (res.ok) {
|
|
return {
|
|
ok: true,
|
|
code: "done",
|
|
detail: res.detail,
|
|
worldDelta: {
|
|
choppedAt: res.detail?.at ?? null,
|
|
logType: res.detail?.logType ?? null,
|
|
},
|
|
};
|
|
}
|
|
const msg = String(res.detail ?? "");
|
|
const code = msg.includes("no reachable log")
|
|
? "no_target"
|
|
: msg.includes("timed out")
|
|
? "timeout"
|
|
: "failed";
|
|
return { ok: false, code, detail: res.detail, worldDelta: null };
|
|
},
|
|
validate(ctx, result) {
|
|
return result.ok && !!result.worldDelta?.logType;
|
|
},
|
|
recover(ctx, result) {
|
|
// Tell the caller: if there was no reachable log, switching to wander
|
|
// for ~60 s is the right next move — same heuristic the autonomous
|
|
// reflex already uses.
|
|
if (result.code === "no_target") {
|
|
return { hint: "wander", reason: "no log within 32 blocks" };
|
|
}
|
|
return null;
|
|
},
|
|
});
|