Coworld Tools

This repository collects shared Coworld game and supporting-role implementations in one public place.

The old standalone role repos (players, commissioners, reporters, graders, and diagnosers) are archived pointers to this repo. New shared role work belongs here. Game-specific pieces belong beside their game in the relevant Metta-AI/coworld-<slug> repo.

The canonical Coworld rebuild flow is to start from a packages/coworld template, the Paint Arena example, or the closest implementation in this repo, then copy any Coworld-specific piece into the owning coworld-<slug> repo before customizing it.

When rebuilding a Coworld, choose exactly one source owner for each runnable:

• use a coworld-tools/... path for a shared implementation; or
• use a coworld-<slug>/... path for a game-local implementation.

Do not patch archived role repos, and do not keep one runnable split between coworld-tools and the game repo. The Coworld manifest's source_url should point to the chosen owner and be pinned to a commit SHA before certification.

Intended Coworld Workflow

This repository is the shared source for Coworld examples and reusable pieces, not the final home for a specific Coworld's production code.

When creating or updating a Coworld, start from:

• the templates in packages/coworld in the metta repo;
• the PaintArena example in packages/coworld, when it is the closest shape for the piece you are building;
• an existing game, player, commissioner, reporter, grader, or diagnoser implementation in this coworld-tools repo.

Copy the relevant piece into the specific Coworld repository and keep it there under the matching role folder. For example, a new coworld-muster repo should own its commissioner code under a path like commissioner/, copied from the closest template or existing implementation. That Coworld repo is then the canonical place to evolve the bespoke code for that Coworld.

Layout

• games/ - imported from Metta-AI/games
• players/ - imported from Metta-AI/players
• commissioners/ - imported from Metta-AI/commissioners
• reporters/ - imported from Metta-AI/reporters
• graders/ - imported from Metta-AI/graders
• diagnosers/ - imported from Metta-AI/diagnosers

Each source repository's main branch history was rewritten under its folder and merged into this repository.

See IMPORTED_REPOS.md for source commit provenance.