browser/run/AGENTS.md

AGENTS.md for run

This file applies to run/.

Channel Rules

Do not rebuild the old all-in-one WebSocket model. Keep these workloads separate:

• Control: hello, heartbeat, version, capabilities, capacity.
• Job: claim, ack, progress, result, cancel, reconcile.
• Logs: local spool, batch upload, sequence acknowledgement, retry.
• Artifacts: chunks, checksums, resume, throttling.
• Game client bridge: optional in-game command/snapshot channel.

Artifact transfer must not block control heartbeats, job result reporting, or log upload.

Structure Rules

Protocol structs live in protocol/. Local runtime types live in runtime/ or domain/. Shared helpers live in shared/ only when needed by multiple packages.

Safety Rules

Run must enforce scoped paths and never expose raw host paths, local secrets, or unrestricted command execution to platform_web or plugins.