Skip to content

feat(ag-ui): add multi-step wizard interactions#349

Merged
vincentgrobler merged 1 commit intomainfrom
feat/ag-ui-wizard
Apr 10, 2026
Merged

feat(ag-ui): add multi-step wizard interactions#349
vincentgrobler merged 1 commit intomainfrom
feat/ag-ui-wizard

Conversation

@vincentgrobler
Copy link
Copy Markdown
Collaborator

@vincentgrobler vincentgrobler commented Apr 10, 2026

Description

Add a new 'wizard' interaction type to the AG-UI protocol, enabling agents to present chained, branching prompts to users during execution.

Backend:

  • Add WizardStep, WizardField, WizardCondition, WizardDefinition types
  • Add WIZARD_STEP_ADVANCE, WIZARD_COMPLETE, WIZARD_CANCELLED events
  • Add requestWizard() helper that loops through steps with conditional branching and returns aggregated WizardResult
  • Update /respond endpoint to accept wizardStepId and wizardCancelled

Frontend:

  • Add wizardState to useAgentStream hook with wizard event handling
  • Create WizardModal component with stepper progress indicator, 5 step types (approval, confirm_data, choice, text_input, form), conditional step branching, and back/next/cancel navigation
  • Glassmorphism styling matching existing InteractionModal

No database migration required — wizard context stored in existing interaction_context JSONB column. Fully backward compatible.

Related Issue

Type of Change

  • 🐛 Bug fix (non-breaking change that fixes an issue)
  • ✨ New feature (non-breaking change that adds functionality)
  • 💥 Breaking change (fix or feature that would cause existing functionality to change)
  • 📝 Documentation update
  • ♻️ Refactor (no functional changes)
  • 🧪 Test update

How Has This Been Tested?

  • Unit tests
  • Manual testing
  • Browser testing (specify browsers)

Screenshots (if applicable)

Checklist

  • My code follows the project's coding standards
  • I have run npm run lint and there are no errors
  • I have run npm run test and all tests pass
  • I have added tests for my changes (if applicable)
  • I have updated the documentation (if applicable)
  • My source files have AGPL licence headers
  • My changes generate no new TypeScript errors

@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 10, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
crewform Ready Ready Preview, Comment Apr 10, 2026 9:54pm

Add a new 'wizard' interaction type to the AG-UI protocol, enabling
agents to present chained, branching prompts to users during execution.

Backend:
- Add WizardStep, WizardField, WizardCondition, WizardDefinition types
- Add WIZARD_STEP_ADVANCE, WIZARD_COMPLETE, WIZARD_CANCELLED events
- Add requestWizard() helper that loops through steps with conditional
  branching and returns aggregated WizardResult
- Update /respond endpoint to accept wizardStepId and wizardCancelled

Frontend:
- Add wizardState to useAgentStream hook with wizard event handling
- Create WizardModal component with stepper progress indicator,
  5 step types (approval, confirm_data, choice, text_input, form),
  conditional step branching, and back/next/cancel navigation
- Glassmorphism styling matching existing InteractionModal

No database migration required — wizard context stored in existing
interaction_context JSONB column. Fully backward compatible.
@vincentgrobler vincentgrobler merged commit ce67379 into main Apr 10, 2026
8 checks passed
@vincentgrobler vincentgrobler deleted the feat/ag-ui-wizard branch April 10, 2026 22:07
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