| name | tinyworld-auto-batching |
| description | Use when changing Tiny World Builder Auto palette behavior, model inference, suggestions, or provider/model/API-key logic. |
Tiny World Auto Batching
Auto should not call the model on every placement.
Current intended model:
- Capture the current home board as sparse 8x8 JSON using
snapshotCells().
- Ask the model for a ranked batch of candidate tile actions matching
AUTO_SUGGESTIONS_SCHEMA.
- Spend
autoSuggestionQueue locally for multiple Auto placements.
- Refresh after
AUTO_REFRESH_EVERY Auto placements or when the queue runs out.
- Auto still places on the clicked cell. The model suggests tile/action definitions, not coordinates.
Implementation guardrails:
- Keep provider/model/key state shared with the Generate modal via
AI_LS.
- Use
normalizeAutoAction before applying model output.
- Use
adaptAutoSuggestionToCell(action, x, z) so same-kind clicks increase local intensity.
- If no API key exists, open the Generate modal with the Auto key message.
- Do not add a backend or new dependency.
Validation:
- Stub
generateAutoSuggestions in browser eval and verify two Auto suggestions only call the stub once.
- Verify no network call is needed while spending cached suggestions.
