Author tools and recipes

Where in the UI. Header Author chat; CLI from a source checkout.

Chat read tools

Tool	Role
`context`	Export the live project: templates, elements, categories, classes, scripts, layouts.
`validate`	Run authoring diagnostics on the open project.
`advise`	Heuristic plan from an intent string.
`describe_blocks`	Look up Blockly blocks by query/tag (never dumps the full catalog).
`recipes`	List YAML script recipes (alerts, timers, rollups, …).
`inspect_script`	Explain a script’s blocks and host calls.
`layout_describe`	Summarize a layout’s components.
`retrieve_docs`	Search packed editor help (bindings, Blockly API, expressions, …).
`list_docs`	List those help documents.

Chat write tools (confirm required)

Tool	Role
`propose_apply`	Draft allowlisted plan steps. You confirm in the editor before anything is written.
`propose_rename_entity`	Rename with reference updates.
`propose_identity_cleanup`	Fix duplicate/conflicting ids.
`propose_smoke_fix`	Apply a known smoke-test repair.

MCP / CLI tools

export_context · validate · smoke · advise · apply_plan · propose_apply · propose_rename_entity · propose_identity_cleanup · propose_smoke_fix · list_recipes · catalog_blocks · describe_blocks · inspect_script · compose_script · translate_workspace · layout_describe · retrieve_docs · list_docs · pilot_trackme · author_live_connect · author_live_resume · author_live_disconnect · live_send · get_session · get_view_hint · get_mutation_status

Recipe files

YAML under app/lib/agent/blockly/recipes/ (wishlist, stats, inventory, collections, folder counts, …). Agents should pick a recipe id rather than invent JS. After adding recipes: yarn generate:agent-assets.

Packed docs: packs/containd-author-v1/PROMPT.md, skills/containd-author/SKILL.md, docs/planning/EDITOR_SCRIPT_BLOCK_API.md.