Skip to content

Conversation

@michaeljabbour
Copy link
Contributor

Summary

Adds hooks-ui-bridge to the community modules catalog.

Module Description

Universal event bridge that transforms Amplifier events to JSON-serializable UIEvents for consumption by any UI framework:

  • Textual TUI - asyncio.Queue adapter for Python TUIs
  • Tauri Desktop/Mobile - stdin/stdout JSON lines for sidecar architecture
  • WebSocket - Real-time streaming for web dashboards
  • VS Code Extension - stdio adapter

Features

  • Three customization levels (config → handlers → adapters)
  • Event correlation (start/end events)
  • Bidirectional commands (UI → Amplifier)
  • Deep config merging for nested settings
  • Event history and replay support

Checklist

  • Follows Amplifier module conventions
  • Comprehensive README
  • Includes tests (45 passing)
  • Only depends on amplifier-core
  • Source code publicly available

Adds hooks-ui-bridge to the community modules catalog.

Universal event bridge that transforms Amplifier events to JSON-serializable
UIEvents for consumption by any UI framework (Textual, Tauri, WebSocket, etc.)

Features:
- QueueAdapter (Textual TUI)
- TauriIPCAdapter (Desktop/Mobile sidecar)
- WebSocketAdapter (Web dashboard)
- Three customization levels (config → handlers → adapters)
Copy link
Collaborator

@bkrabach bkrabach left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review: amplifier-module-hooks-ui-bridge

Thanks for contributing this module! I've had our agents do a thorough review.

Security Review ✅

  • Risk Level: Low
  • No critical/high issues, no hardcoded secrets, no malicious patterns
  • Dependencies are minimal and trustworthy (amplifier-core, websockets)
  • Design trade-offs (dynamic loading, local WebSocket) are appropriate for dev tools

Ecosystem Review ✅

  • Convention Compliance: Yes - proper mount(), entry point, amplifier-core dependency only
  • Ecosystem Value: High - fills a genuine gap for UI framework integration
  • Documentation: Adequate
  • Tests: Good coverage (~45 passing)

Required Change Before Merge

Please fix the installation URL in your README.md:

- amplifier module add git+https://github.com/microsoft/amplifier-module-hooks-ui-bridge
+ amplifier module add git+https://github.com/michaeljabbour/amplifier-module-hooks-ui-bridge

The org should be michaeljabbour, not microsoft.

Once that's fixed, this is good to merge. Great work on the module!

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.

2 participants