Skip to content

Add Flow Visualization 2.0 and supervision workspace - #508

Merged
longquanzheng merged 18 commits into
mainfrom
codex/flow-viz-v2-supervision
Sep 19, 2026
Merged

longquanzheng merged 18 commits into
mainfrom
codex/flow-viz-v2-supervision

Conversation

@longquanzheng

@longquanzheng longquanzheng commented Sep 18, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Split Dex Web into /v1 (existing Flows workspace) and /v2 (operator workspace: listing + Flow Definition Graph canvas)
  • Add FDG 2.0 Go analyzer contracts (dex:group, dex:explanation, Summary/Display/Actions) and render run overlays on Steps
  • Make the v2 Step panel Definition/Execution split with execution picker, resizable width/height, and real WaitFor/Execute history payloads

Test plan

  • cd web && npm run check
  • make -C cli integration-test (FDG 2.0 visualize + explanations)
  • Open Dex Web v2 with --flow-rendering-dir, select a multi-execution Step, switch Instance dropdown
  • Drag panel left edge and Definition/Execution divider
  • Confirm Decision shows goTo (not "not returned yet") when nextSteps exist
  • Confirm Definition hides source paths and collapses many Execute branches

Follow-up

skill-dex-developer baseline update waits on an official Dex release tag that includes this change.

@codecov

codecov Bot commented Sep 18, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

Lazy loading leaves GetDexSummary and GetDexDisplay payloads as blob IDs, so the list treated them as a one-field object and showed summaryError.
Keep the existing operator UI on /v1 and copy the dexai canvas into /v2 as a listing-plus-definition split. Starting with --flow-rendering-dir opens /v2, with a Version menu back to /v1.
Keep the listing/canvas splitters and light-mode default, and copy the dexai detail panel so a selected run shows input, output, context, and earlier executions without dumping the previous run.
Extract shared StepMethod Input/Output/Context sections from v1 EventDetails and wire the hydrated WaitFor/Execute history into the dexai panel, including Details/Raw toggle and live next steps.
Replace Transitions/State/Definition peer tabs with a collapsible FDG definition
(WaitFor + Execute branches) above an execution dropdown and run-scoped tabs.
FDG 2.0 Steps must declare dex:explanation; Definition scrolls and collapses
long Execute branch lists so the execution picker stays reachable.
Drag the panel's left edge to widen or narrow it; the width persists and
fitView reserves the live overlay width.
Real history payloads have no stepDecision.type; goTo and close verbs
come from nextSteps and closeDecisionType instead.
Align HTTP paths, types, FDG JSON, and filenames with the /v1 and /v2 workspace split.
Drop the mock Overview, merge WaitUntil into WaitFor Output, and give each phase its own Input/Context/Output backed by the matching history event.
@longquanzheng
longquanzheng marked this pull request as ready for review September 19, 2026 06:40
@longquanzheng
longquanzheng merged commit d280a3f into main Sep 19, 2026
40 checks passed
@longquanzheng
longquanzheng deleted the codex/flow-viz-v2-supervision branch September 19, 2026 06:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant