Workbench

The Workbench is the local Graph Definition editor and Run debugger. It is a separate Bun/React application under internal/web/ and connects directly to the debug server API.

Start the debug server

go run ./cmd/server -data .local/server

To preload a graph:

go run ./cmd/server -data .local/server -graph examples/supervisor_mode/graph.json

Start the WebUI

cd internal/web
bun install
bun run dev

Open the printed URL. The application redirects to /app/graph and connects to http://localhost:8080 by default. Change the Backend base URL in Workbench settings when the server uses another origin or route prefix.

For a single-origin packaged deployment, open the WebUI URL supplied by the reverse proxy. For a separate development server, set the backend to the complete API origin, including a prefix such as http://localhost:8080/debug.

What you can inspect

• Graph nodes, edges, conditions, State Modules, and State Bindings
• Immutable Graph Sessions and runtime settings
• Run status, events, checkpoints, artifacts, and state
• Paused runs that require user input or approval

Recommended workflow

1. Open Registry and confirm the State Modules, node types, conditions, capabilities, and reducers available on the server.
2. Import or edit a Graph Definition. Keep state paths in the State Bindings panels, not in node config.
3. Resolve lint errors before creating a Session. Warnings about missing producers may require Trigger or initial State changes.
4. Create a Session and record its ID with the definition revision.
5. Run with minimal initial State, then inspect the selected Run's Steps, Events, State, Checkpoints, and Artifacts.
6. Pause, resume, or cancel from the Run panel only after checking the current status and last checkpoint.

The JSON editor and structured inspectors share one definition source. Use the JSON editor for bulk changes, then return to the inspector to catch contract diagnostics.

Browser configuration

The browser stores a Backend base URL override locally and takes precedence over generated config.js. For a deployment default, set backendBaseUrl in the unbundled config generated by the WebUI build. When origins differ, configure the server's -cors-origins allowlist.

The hosted entry point is playground.weaveflow.space.

This hosted environment is for experimentation. Do not place production credentials or sensitive business data there; run the server in an environment you control for durable workloads.