How mikamika06/ploshcha works
Площа is an interactive Ukrainian village that presents agent-core telemetry as a living scene. A visitor posts a topic on the bulletin board; the live service queues it, the simulation runs a village discussion, and events stream back for the browser to validate, reduce into state, and render as movement and dialogue. The repository also contains a research/evaluation mode separate from the production viche. Connections among unsampled server and storage internals are limited to documented README behavior; paths identify their existing source areas.
Main entry points: server.py Live API · SimStore.ts Event state · LiveDriver.ts Live driver · main.ts Village app
Components 26
Village frontend
- Village app
apps/web/src/main.ts - Bulletin board
apps/web/src/interact/Board.ts - Group dialogue
apps/web/src/interact/GroupTalk.ts - Living room
apps/web/src/interact/LivingRoom.ts - Villager inspector
apps/web/src/interact/Inspector.ts - Agent movement
apps/web/src/agents/AgentDirector.ts - Walk grid
apps/web/src/agents/WalkGrid.ts - Village scene
apps/web/src/scene/SceneRenderer.ts - Event state
apps/web/src/store/SimStore.ts - Live driver
apps/web/src/net/LiveDriver.ts - Fixture driver
apps/web/src/net/FixtureDriver.ts - Guest session
apps/web/src/net/session.ts
Live runtime
- Live API
services/sim/ploshcha_sim/live/server.py - Work queue
services/sim/ploshcha_sim/adapters/queue_sqlite.py - Live runner
services/sim/ploshcha_sim/live/runner.py - Runtime composition
services/sim/ploshcha_sim/compose.py
Simulation agents
- Village simulation
services/sim/ploshcha_sim/agents/viche.py - Task orchestration
services/sim/ploshcha_sim/agents/orchestrator.py
Ports and state
- Model routing
services/sim/ploshcha_sim/adapters/router_profile.py - Language model port
services/sim/ploshcha_sim/ports/llm.py - Village memory
services/sim/ploshcha_sim/adapters/memory_sqlite.py
Contracts and research
- Event contract
packages/contract-ts/src/events.ts - Event validation
apps/web/src/net/validate.ts - Research evaluation
services/sim/evalkit/conditions.py
Other components
- Visitor
- Mamay and Lapa
Connections 26
- Visitor → Bulletin board: posts topic
- Bulletin board → Live driver: submits command
- Village app → Live driver: sends commands
apps/web/src/main.ts - Village app → Village scene: mounts scene
apps/web/src/main.ts - Village app → Event state: updates from events
apps/web/src/main.ts - Live driver → Live API: requests events
- Guest session → Live API: identifies guest
apps/web/src/net/session.ts - Live API → Work queue: queues topic
- Live API → Live runner: serves live runtime
- Live runner → Village simulation: runs discussion
- Live runner → Work queue: processes queued work
- Runtime composition → Village simulation: builds simulation
services/sim/ploshcha_sim/compose.py - Runtime composition → Model routing: configures routing
services/sim/ploshcha_sim/compose.py - Village simulation → Mamay and Lapa: requests model output
- Task orchestration → Model routing: routes model steps
services/sim/ploshcha_sim/agents/orchestrator.py - Model routing → Language model port: selects model port
services/sim/ploshcha_sim/adapters/router_profile.py - Live API → Village memory: persists village state
- Live driver → Event validation: validates events
apps/web/src/net/LiveDriver.ts - Fixture driver → Event validation: validates fixture events
apps/web/src/net/FixtureDriver.ts - Event validation → Event contract: checks event shapes
apps/web/src/net/validate.ts - Event state → Event contract: reduces typed events
apps/web/src/store/SimStore.ts - Event state → Villager inspector: provides villager state
apps/web/src/interact/Inspector.ts - Event state → Group dialogue: provides dialogue state
apps/web/src/main.ts - Agent movement → Walk grid: plans movement
apps/web/src/agents/AgentDirector.ts - Village scene → Walk grid: uses path grid
apps/web/src/main.ts - Research evaluation → Runtime composition: defines research conditions
services/sim/evalkit/conditions.py