Closes the awareness → LLM → action loop that the rc.1/2/3 sequence
left as a followup. When the bot is wedged, looping, or just suffered
a preempt-then-retry, the reflex fires advise() in the background;
when the recommendation lands it overrides the next dispatch.
Async by design: advise() takes 5-15s on TimeWeb's hosted endpoint —
too slow for a synchronous reflex tick. tickAdvisor() is fire-and-
forget, the result lands on ctx.advisorRecommendation, and the *next*
tick reads and consumes it. Recommendations age out after 60s.
Components:
- runtime/coach/advisor-trigger.js — policy + async fire path
- tickAdvisor(ctx, {plannedSkillId}) checks three triggers:
1. wedged > 60s (no significant move)
2. last 4+ dispatches are the same skill AND it's planned again
3. preempt within last 30s + same skill being retried
- 90s trigger cooldown, single-in-flight guard
- consumeFreshRecommendation(ctx) reads/clears the cache
- runtime/reflex.js — curriculumReflex calls tickAdvisor() every tick
and consumes a fresh recommendation BEFORE dispatching. ctx flag
disableAdvisor=true for tests.
- runtime/bot.js — dispatchAction maintains a rolling 8-slot
reflexCtx.recentSkillIds for the loop-detection trigger.
Token usage:
- runtime/llm/provider.js — normaliseUsage() reads OpenAI/TimeWeb-
style {prompt_tokens, completion_tokens, total_tokens} from the
response. Returned on every complete() result and logged at info
level as "in=Nt/out=Mt".
- runtime/coach/fast-advisor.js — getUsageSnapshot() aggregates
total tokens across all calls in the session.
Measured on live TimeWeb endpoint (gpt-5.4-mini agent):
per call: ~705 input + 45 output = ~750 tokens
rate limit: 6 calls/hour
worst case at full budget: ~108K tokens/day
estimated cost (OpenAI gpt-5-mini reference price): ~$0.60/month
Well within any reasonable budget — model can run hot 24/7.
Smoke verified: scripts/check-timeweb.js probe 4 produces
trigger fired: true (wedged_90s)
recommendation: recovery.tunnel-out
rationale: "Stuck wedged for 90s; exploration is failing."
latency: 5302ms
Tests: 345 green (was 332, +13 advisor-trigger).
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
53 lines
2.5 KiB
JSON
53 lines
2.5 KiB
JSON
{
|
|
"name": "pepa-pi-bot",
|
|
"version": "0.3.0-rc.3",
|
|
"private": true,
|
|
"description": "An autonomous, self-extending Minecraft player powered by Pi and Mineflayer.",
|
|
"license": "MIT",
|
|
"type": "module",
|
|
"engines": {
|
|
"node": ">=20"
|
|
},
|
|
"scripts": {
|
|
"agent": "pi",
|
|
"agent:resume": "pi -c",
|
|
"bot": "node runtime/supervisor.js",
|
|
"bot:bare": "node runtime/bot.js",
|
|
"tui": "tsx tui/tui.tsx",
|
|
"propose:apply": "node scripts/propose-apply.js",
|
|
"stop": "bash scripts/stop.sh",
|
|
"test": "node --test runtime/skills/contract.test.js runtime/skills/groups.test.js runtime/skills/compat.test.js runtime/skills/recovery-tunnel-out.test.js runtime/skills/pillar-up.test.js runtime/curriculum.test.js runtime/social/social.test.js runtime/social/conversation.test.js runtime/social/chat-history.test.js runtime/social/reply-pi.test.js runtime/stuck-incident.test.js runtime/compat.test.js runtime/reflex.test.js runtime/base-site.test.js runtime/locations.test.js runtime/watch-filter.test.js runtime/world-journal.test.js runtime/scenario-memory.test.js runtime/critic.test.js runtime/skill-library.test.js runtime/skill-registry.test.js runtime/modes.test.js runtime/pathfinder-watchdog.test.js runtime/manifesto/needs.test.js runtime/manifesto/state.test.js runtime/awareness/events.test.js runtime/knowledge/knowledge.test.js runtime/llm/provider.test.js runtime/coach/postmortem.test.js runtime/coach/advice.test.js runtime/coach/reflect.test.js runtime/coach/fast-advisor.test.js runtime/coach/advisor-trigger.test.js runtime/persona/chatter.test.js scripts/edit-scope.test.js scripts/lint-patch.test.js"
|
|
},
|
|
"dependencies": {
|
|
"better-sqlite3": "^11.10.0",
|
|
"canvas": "^3.2.3",
|
|
"dotenv": "^16.4.5",
|
|
"ink": "^7.0.4",
|
|
"ink-text-input": "^6.0.0",
|
|
"minecraft-data": "^3.110.2",
|
|
"mineflayer": "^4.37.1",
|
|
"mineflayer-armor-manager": "^2.0.1",
|
|
"mineflayer-auto-eat": "^5.0.3",
|
|
"mineflayer-collectblock": "^1.6.0",
|
|
"mineflayer-pathfinder": "^2.4.5",
|
|
"mineflayer-pvp": "^1.3.2",
|
|
"mineflayer-tool": "^1.2.0",
|
|
"prismarine-item": "^1.18.0",
|
|
"prismarine-viewer": "^1.33.0",
|
|
"react": "^19.2.6",
|
|
"vec3": "^0.2.0"
|
|
},
|
|
"repository": {
|
|
"type": "git",
|
|
"url": "git+https://github.com/xmatic-squad/pepa-pi-bot.git"
|
|
},
|
|
"bugs": {
|
|
"url": "https://github.com/xmatic-squad/pepa-pi-bot/issues"
|
|
},
|
|
"homepage": "https://github.com/xmatic-squad/pepa-pi-bot#readme",
|
|
"devDependencies": {
|
|
"@types/react": "^19.2.15",
|
|
"tsx": "^4.22.3"
|
|
}
|
|
}
|