Callback Events
Developmentcallback-eventsCallback Events is an Agent Skill for development published in the fossasia/visdom repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Implement and debug browser-to-Python callback routing for clicks, key presses, property updates, and close events
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/fossasia/visdom/blob/HEAD/.agents/skills/callback-events/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/callback-events, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Skill: Callback and Event Roundtrip
When to Use
Use this skill when changing event callbacks or pane interactivity.
Core Workflow
- Register callback handlers via
register_event_handler()on the Python side. - Ensure frontend emits correct event payloads (
event_type,target, and event-specific fields). - Route browser events through socket command forwarding (
forward_to_vis). - Keep server forwarding logic from browser socket to Python source sockets intact.
- Validate event names/fields against existing callback contracts.
Guardrails
- Callback handlers run in a background socket thread; avoid unsafe shared state writes.
- Do not rename event keys without coordinated client/server/docs updates.
- Preserve existing event types (
Click,KeyPress,PropertyUpdate,Close, etc.).
Documentation
- Skill reference
py/visdom/__init__.pypy/visdom/server/handlers/socket_handlers.pyjs/api/ApiProvider.jsjs/EventSystem.jsAGENTS.mdCONTRIBUTING.md
Assets
- See
assets/README.mdand store templates/resources inassets/.
Tests
- Follow the default flow in
references/TESTS.md.