LudoWeave Engine

One canonical world for humans and agents

LudoWeave gives its application runner, command line, tests, rendering adapters, and agent interface the same authoritative world and command contracts. Deterministic clocks, stable entity identity, immutable schemas, and explicit ownership make state changes inspectable rather than implicit.

• Atomic command transactions with dry-run, optimistic hashes, semantic diffs, and receipts
• Complete snapshots, state hashes, verified replay files, and parent-referenced timeline branches
• Backend-neutral rendering with an optional pinned wgpu adapter and offscreen capture
• A fixed-seed Clockwork Arena example with replay and stress evidence

Agent control is a capability boundary

The typed agent service declares capabilities, quotas, redaction, and serialized mutation. Its local MCP adapter uses standard input and output, opens no network listener, and remains read-only unless the trusted composition root explicitly enables writes.

The Agent World Builder example closes the loop from typed creation and validation through capture, query, adjustment, diff, telemetry, tests, and replay evidence.

Experimental by explicit contract

The repository records the current baseline as a community-alpha release candidate and marks every Python API and wire format experimental. Packaging, CI, checksums, an SPDX SBOM, installed-artifact smoke tests, and a pinned provenance workflow support evaluation without implying production stability.

Networking, remote agent transport, production audio, rigid-body physics, editor tooling, 3D, and automatic GPU recovery are listed as not implemented.