# 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.