puzzlebox
Puzzlebox is an MCP server managing finite state machines as dynamic resources, facilitating coordination among multiple agents. It allows clients to create, manage, and subscribe to shared state resources, ensuring coordinated transitions for complex processes like software development.
What is a puzzle in the context of Puzzlebox?
A puzzle is a finite state machine with a finite number of discrete states and actions that initiate transitions between states.
How does Puzzlebox ensure valid state transitions?
Puzzlebox uses optional exit and enter guards that may send sampling requests to clients, ensuring transitions are valid and can be canceled if necessary.
Can multiple clients connect to a single Puzzlebox server?
Yes, Puzzlebox supports multiple client connections, allowing them to create and monitor shared dynamic resources.
What happens when a client performs an action on a puzzle?
The server checks if the action is valid for the current state. If valid, a state transition is initiated, and clients are notified of the state change.
How can clients receive updates on puzzle state changes?
Clients can subscribe to a puzzle to receive updates when its state changes, or they can poll the get_puzzle_snapshot tool for state changes.