Skip to content

Open-source Revit MCP server: let Claude and other AI assistants read and edit BIM models, with human approval on every change.

feat(addin): add workflow ribbon commands (P16.3)

A. Sam Mohammad0a5c720edade
diff --git a/packages/revit-bridge-addin/src/Bridge/AdditionalCommands.cs b/packages/revit-bridge-addin/src/Bridge/AdditionalCommands.cs
index 5c376d8..43c3d93 100644
--- a/packages/revit-bridge-addin/src/Bridge/AdditionalCommands.cs
+++ b/packages/revit-bridge-addin/src/Bridge/AdditionalCommands.cs
@@ -14,7 +14,42 @@ namespace RevitBridge.Bridge
{
public Result Execute(ExternalCommandData commandData, ref string message, ElementSet elements)
{
- if (BridgePanelProvider.Show(commandData.Application, out var error))
+ return PanelCommand.Show(commandData, ref message);
+ }
+ }
+
+ [Transaction(TransactionMode.Manual)]
+ public class CommandRunHealthCheck : IExternalCommand
+ {
+ public Result Execute(ExternalCommandData commandData, ref string message, ElementSet elements)
+ {
+ return PanelCommand.Show(commandData, ref message, "findings", "qaqc.runHealthCheck");
+ }
+ }
+
+ [Transaction(TransactionMode.Manual)]
+ public class CommandReviewPendingActions : IExternalCommand
+ {
+ public Result Execute(ExternalCommandData commandData, ref string message, ElementSet elements)
+ {
+ return PanelCommand.Show(commandData, ref message, "plans", "plans.refresh");
+ }
+ }
+
+ [Transaction(TransactionMode.Manual)]
+ public class CommandOpenReports : IExternalCommand
+ {
+ public Result Execute(ExternalCommandData commandData, ref string message, ElementSet elements)
+ {
+ return PanelCommand.Show(commandData, ref message, "reports", "reports.refresh");
+ }
+ }
+
+ internal static class PanelCommand
+ {
+ public static Result Show(ExternalCommandData commandData, ref string message, string view = "", string action = "")
+ {
+ if (BridgePanelProvider.Show(commandData.Application, out var error, view, action))
{
return Result.Succeeded;
}
diff --git a/packages/revit-bridge-addin/src/Bridge/App.cs b/packages/revit-bridge-addin/src/Bridge/App.cs
index 66cdd7d..3fe0064 100644
--- a/packages/revit-bridge-addin/src/Bridge/App.cs
+++ b/packages/revit-bridge-addin/src/Bridge/App.cs
@@ -89,6 +89,7 @@ namespace RevitBridge.Bridge
// Create panels
RibbonPanel connectionPanel = app.CreateRibbonPanel(tabName, "Connection");
+ RibbonPanel workflowPanel = app.CreateRibbonPanel(tabName, "Workflows");
RibbonPanel toolsPanel = app.CreateRibbonPanel(tabName, "Tools");
string assemblyPath = System.Reflection.Assembly.GetExecutingAssembly().Location;
@@ -194,6 +195,39 @@ namespace RevitBridge.Bridge
panelBtnData.Image = brandIcon16;
panelBtnData.LargeImage = brandIcon32;
+ PushButtonData healthBtnData = new PushButtonData(
+ "cmdRunHealthCheck",
+ "Health Check",
+ assemblyPath,
+ "RevitBridge.Bridge.CommandRunHealthCheck"
+ );
+ healthBtnData.ToolTip = "Open the panel and start a model health check";
+ healthBtnData.LongDescription = "Opens the findings view and requests a QA/QC health check.";
+ healthBtnData.Image = statusIcon16;
+ healthBtnData.LargeImage = statusIcon32;
+
+ PushButtonData pendingBtnData = new PushButtonData(
+ "cmdReviewPendingActions",
+ "Pending Actions",
+ assemblyPath,
+ "RevitBridge.Bridge.CommandReviewPendingActions"
+ );
+ pendingBtnData.ToolTip = "Review pending ActionPlans";
+ pendingBtnData.LongDescription = "Opens the approval queue in the AEC Model Bridge panel.";
+ pendingBtnData.Image = brandIcon16;
+ pendingBtnData.LargeImage = brandIcon32;
+
+ PushButtonData reportsBtnData = new PushButtonData(
+ "cmdReports",
+ "Reports",
+ assemblyPath,
+ "RevitBridge.Bridge.CommandOpenReports"
+ );
+ reportsBtnData.ToolTip = "Open report tools";
+ reportsBtnData.LongDescription = "Opens report export controls in the AEC Model Bridge panel.";
+ reportsBtnData.Image = settingsIcon16;
+ reportsBtnData.LargeImage = settingsIcon32;
+
// Settings Button (future)
PushButtonData settingsBtnData = new PushButtonData(
"cmdSettings",
@@ -231,8 +265,12 @@ namespace RevitBridge.Bridge
aboutBtnData.Image = brandIcon16;
aboutBtnData.LargeImage = brandIcon32;
- toolsPanel.AddItem(panelBtnData);
- toolsPanel.AddSeparator();
+ workflowPanel.AddItem(panelBtnData);
+ workflowPanel.AddItem(healthBtnData);
+ workflowPanel.AddItem(pendingBtnData);
+ workflowPanel.AddSeparator();
+ workflowPanel.AddItem(reportsBtnData);
+
toolsPanel.AddItem(settingsBtnData);
toolsPanel.AddItem(helpBtnData);
toolsPanel.AddSeparator();
diff --git a/packages/revit-bridge-addin/src/UI/BridgePanel.xaml.cs b/packages/revit-bridge-addin/src/UI/BridgePanel.xaml.cs
index 58976f0..ec9718e 100644
--- a/packages/revit-bridge-addin/src/UI/BridgePanel.xaml.cs
+++ b/packages/revit-bridge-addin/src/UI/BridgePanel.xaml.cs
@@ -1,4 +1,5 @@
using System;
+using System.Collections.Generic;
using System.IO;
using System.Text.Json;
using System.Threading.Tasks;
@@ -13,6 +14,8 @@ namespace RevitBridge.UI
public partial class BridgePanel : UserControl
{
private bool _initialized;
+ private bool _pageReady;
+ private readonly Queue<string> _pendingMessages = new Queue<string>();
public BridgePanel()
{
@@ -33,6 +36,12 @@ namespace RevitBridge.UI
{
await Browser.EnsureCoreWebView2Async();
Browser.CoreWebView2.WebMessageReceived += OnWebMessageReceived;
+ Browser.CoreWebView2.NavigationCompleted += (_, _) =>
+ {
+ _pageReady = true;
+ FlushPendingMessages();
+ PostHostStatus();
+ };
LoadPanelApp();
}
catch (Exception ex)
@@ -74,6 +83,26 @@ namespace RevitBridge.UI
Browser.CoreWebView2?.PostWebMessageAsJson(payload);
}
+ public void PostToPanel(object payload)
+ {
+ var json = JsonSerializer.Serialize(payload);
+ if (!_pageReady || Browser.CoreWebView2 == null)
+ {
+ _pendingMessages.Enqueue(json);
+ return;
+ }
+
+ Browser.CoreWebView2.PostWebMessageAsJson(json);
+ }
+
+ private void FlushPendingMessages()
+ {
+ while (_pendingMessages.Count > 0 && Browser.CoreWebView2 != null)
+ {
+ Browser.CoreWebView2.PostWebMessageAsJson(_pendingMessages.Dequeue());
+ }
+ }
+
private void LoadPanelApp()
{
var panelPath = Path.Combine(AppContext.BaseDirectory, "panel", "index.html");
diff --git a/packages/revit-bridge-addin/src/UI/BridgePanelProvider.cs b/packages/revit-bridge-addin/src/UI/BridgePanelProvider.cs
index 7848165..e13c2e8 100644
--- a/packages/revit-bridge-addin/src/UI/BridgePanelProvider.cs
+++ b/packages/revit-bridge-addin/src/UI/BridgePanelProvider.cs
@@ -9,17 +9,39 @@ namespace RevitBridge.UI
public static readonly DockablePaneId PaneId = new DockablePaneId(
new Guid("4E6D3F28-1C74-4B41-9B6E-7B1D3A2C0C4F"));
+ private static BridgePanel? _panel;
+ private static object? _pendingPayload;
+
public static void Register(UIControlledApplication application)
{
application.RegisterDockablePane(PaneId, "AEC Model Bridge", new BridgePanelProvider());
Log.Information("AEC Model Bridge dockable pane registered");
}
- public static bool Show(UIApplication application, out string error)
+ public static bool Show(UIApplication application, out string error, string view = "", string action = "")
{
try
{
application.GetDockablePane(PaneId).Show();
+ if (!string.IsNullOrWhiteSpace(view) || !string.IsNullOrWhiteSpace(action))
+ {
+ var payload = new
+ {
+ type = "panel.view",
+ view,
+ action
+ };
+
+ if (_panel != null)
+ {
+ _panel.PostToPanel(payload);
+ }
+ else
+ {
+ _pendingPayload = payload;
+ }
+ }
+
error = "";
return true;
}
@@ -33,7 +55,14 @@ namespace RevitBridge.UI
public void SetupDockablePane(DockablePaneProviderData data)
{
- data.FrameworkElement = new BridgePanel();
+ _panel = new BridgePanel();
+ if (_pendingPayload != null)
+ {
+ _panel.PostToPanel(_pendingPayload);
+ _pendingPayload = null;
+ }
+
+ data.FrameworkElement = _panel;
data.InitialState = new DockablePaneState
{
DockPosition = DockPosition.Right
diff --git a/panel/app.js b/panel/app.js
index b65a30a..7b2a8c7 100644
--- a/panel/app.js
+++ b/panel/app.js
@@ -2,6 +2,7 @@ const views = {
chat: { title: "Chat", subtitle: "AEC Model Bridge" },
plans: { title: "Pending Actions", subtitle: "Approval queue" },
findings: { title: "Findings", subtitle: "Model health" },
+ reports: { title: "Reports", subtitle: "Exports" },
log: { title: "Run Log", subtitle: "Recent activity" },
settings: { title: "Settings", subtitle: "Local bridge" }
};
@@ -27,6 +28,10 @@ const state = {
{ id: "f-002", severity: "warning", title: "Views not on sheets", detail: "8 views are not placed on sheets." },
{ id: "f-003", severity: "info", title: "Unplaced rooms", detail: "3 rooms are unplaced in the active model." }
],
+ reports: [
+ { id: "r-001", title: "Model health workbook", detail: "Excel export with elements, types, and QA/QC issues." },
+ { id: "r-002", title: "SQLite model summary", detail: "Local database export for downstream reporting." }
+ ],
log: [
{ at: "09:00", title: "Panel loaded", detail: "Waiting for host status." }
]
@@ -40,6 +45,7 @@ const chatForm = document.getElementById("chat-form");
const chatInput = document.getElementById("chat-input");
const planList = document.getElementById("plan-list");
const findingList = document.getElementById("finding-list");
+const reportList = document.getElementById("report-list");
const runLog = document.getElementById("run-log");
const severityFilter = document.getElementById("severity-filter");
const settingsForm = document.getElementById("settings-form");
@@ -142,6 +148,24 @@ function renderFindings() {
});
}
+function renderReports() {
+ reportList.innerHTML = "";
+ state.reports.forEach((report) => {
+ const item = document.createElement("article");
+ item.className = "item";
+ item.innerHTML = `
+ <div class="item-head">
+ <h2>${escapeHtml(report.title)}</h2>
+ <span class="badge info">report</span>
+ </div>
+ <p>${escapeHtml(report.detail)}</p>
+ <div class="item-actions">
+ <button type="button" data-report="${escapeHtml(report.id)}">Open</button>
+ </div>`;
+ reportList.appendChild(item);
+ });
+}
+
function renderLog() {
runLog.innerHTML = "";
state.log.forEach((event) => {
@@ -175,6 +199,14 @@ document.body.addEventListener("click", (event) => {
postToHost("qaqc.runHealthCheck");
addLog("Health check requested", "QA/QC run sent to the host.");
}
+ if (action === "export-excel") {
+ postToHost("reports.exportExcel");
+ addLog("Report export requested", "Excel export sent to the host.");
+ }
+ if (action === "refresh-reports") {
+ postToHost("reports.refresh");
+ addLog("Reports refreshed", "Requested available reports from the host.");
+ }
const planId = target.dataset.plan;
if (planId) {
@@ -182,6 +214,12 @@ document.body.addEventListener("click", (event) => {
postToHost(`plan.${decision}`, { planId });
addLog(`Plan ${decision}`, planId);
}
+
+ const reportId = target.dataset.report;
+ if (reportId) {
+ postToHost("reports.open", { reportId });
+ addLog("Report opened", reportId);
+ }
});
chatForm.addEventListener("submit", (event) => {
@@ -215,12 +253,20 @@ if (window.chrome && window.chrome.webview) {
renderHostStatus();
addLog("Host status updated", state.host.activeDocument || "No active document");
}
+ if (event.data?.type === "panel.view" && views[event.data.view]) {
+ setView(event.data.view);
+ if (event.data.action) {
+ postToHost(event.data.action);
+ addLog("Ribbon command", event.data.action);
+ }
+ }
});
}
renderChat();
renderPlans();
renderFindings();
+renderReports();
renderLog();
renderHostStatus();
postToHost("panel.loaded");
diff --git a/panel/index.html b/panel/index.html
index 3780cc1..78bd013 100644
--- a/panel/index.html
+++ b/panel/index.html
@@ -21,6 +21,9 @@
<button class="nav" type="button" data-view="findings" title="Findings" aria-label="Findings">
<span aria-hidden="true">F</span>
</button>
+ <button class="nav" type="button" data-view="reports" title="Reports" aria-label="Reports">
+ <span aria-hidden="true">R</span>
+ </button>
<button class="nav" type="button" data-view="log" title="Run Log" aria-label="Run Log">
<span aria-hidden="true">L</span>
</button>
@@ -70,6 +73,14 @@
<div class="list" id="finding-list"></div>
</section>
+ <section class="view" id="view-reports" aria-labelledby="view-title">
+ <div class="toolbar">
+ <button type="button" data-action="export-excel">Export Excel</button>
+ <button type="button" data-action="refresh-reports">Refresh</button>
+ </div>
+ <div class="list" id="report-list"></div>
+ </section>
+
<section class="view" id="view-log" aria-labelledby="view-title">
<div class="timeline" id="run-log"></div>
</section>
diff --git a/panel/styles.css b/panel/styles.css
index a81e732..32b9b11 100644
--- a/panel/styles.css
+++ b/panel/styles.css
@@ -61,7 +61,7 @@ select {
.rail {
display: grid;
- grid-template-rows: 58px repeat(5, 44px) 1fr;
+ grid-template-rows: 58px repeat(6, 44px) 1fr;
gap: 6px;
padding: 8px;
border-right: 1px solid var(--line);