# Sim Sim assets for AI agents

Start with https://simsim.deovia.com/assets.json. Every record includes an agent object linking to its per-asset manifest, editing guide, instructions and complete ZIP kit. These are public, static HTTPS downloads; no account, API key or JavaScript rendering is needed. Private editor notes are excluded.

## Understand → download → revise

1. GET /assets.json and select the stable asset ID. Read agent.manifest, then the manifest's guide and instructions.
2. Download agent.bundle and compare SHA-256 with agent.bundle_sha256 before extracting. Extract into a new directory. Every kit includes asset.json, EDITING.md, AGENTS.md, source/reference files and the offline asset.py tool.
3. Inspect the helper, then run python3 asset.py verify. Each file's relative path, public download URL, media type, byte size and SHA-256 are in asset.json.
4. Follow EDITING.md. Hearth can rebuild geometry from editable JSON. Listener and First Light expose editable PNGs; use an image editor or an authorized image-generation tool. Missing layered or 3D sources are stated explicitly.
5. Run the kit's revision command to record the base fingerprint, change summary, tool provenance and output hashes. Return the candidate directory to the studio editor.

## Current assets

- ENV-001 / Hearth: https://simsim.deovia.com/assets/hearth/asset.json
- PROP-001 / Listener: https://simsim.deovia.com/assets/listener/asset.json
- first-light-concept-v01 / First Light: https://simsim.deovia.com/assets/first-light/asset.json

## Publishing contract

Downloading and creating a local candidate do not alter the archive. There is no public asset-write or upload endpoint. An authorized studio publishing agent checks the candidate against the current source fingerprint, reviews its actual files, and adds a new version through the existing source repository and Sites publishing workflow. Preserve old version URLs. A changed source returns to review; a website publication is not approval for inclusion in the game.

Asset IDs remain stable, including the existing first-light-concept-v01 identifier. Versions and kit revisions are separate: an improved helper need not pretend that the artwork changed. Checksums establish file identity, not quality, safety or legal rights. Current assets are early candidates; engine import and player validation remain unrun.

The helper performs no downloads, model calls or publication. No image-generation API is configured. Never expose editor cookies, secrets or private notes in an asset kit. The public site does not supply an agent identity or grant publishing permissions.