← Commit history
README.md+1−1
@@ -311,7 +311,7 @@ _78 verbs._ - `fusion_board_info` - Raw board geometry XML (copper/arcs/lines) for the open board. - `fusion_open_lbr` - Import an EAGLE .lbr library into Fusion's Electronics LIBRARY editor (Content Manager / Electronics Library workspace), - `fusion_attach_3d_package` - Attach a real 3D chip model to a library package, end to end: opens the .lbr (library active), runs Electron.Create3DPac-- `fusion_install_fusion` - Reports install state; there is no documented silent macOS installer, so it returns `fusion_install_manual_on_macos` and the AI drives Autodesk's dmg per the fusion-onboarding skill+- `fusion_install_fusion` - Installs Fusion: downloads Autodesk's signed downloader, verifies its signature and notarization, runs it quietly in the background, and waits for the streamed app. Progress via `fusion_install_status`. - `fusion_generate_package` - Generate an IPC-7351-compliant parametric 3D package via Fusion's BUILT-IN ElectronicsPackageGenerator (EPG) - ~50 packa - `fusion_make_3d_package` - Create a RENDERING component 3D package (FOOTPRINT + chip, aligned) for ONE part, fully programmatically with ZERO GUI d - `fusion_build_library_3d` - Build a RENDERING multi-part 3D library in ONE call - the whole programmatic pipeline
SKILL.md+4−3
@@ -24,7 +24,7 @@ Branch on the stable `errorCode`, never the prose: | `ready:true` (fusion_readiness) | Fusion up + add-in current | drive | | `running:false` / `fusion_not_running` | installed, not launched | `fusion_start` (returns when the add-in is ready, or `stillLaunching` on a slow first launch) | | `stillLaunching:true` (fusion_start) | first launch, add-in not up yet (can take 2-4 min) | do NOT re-call `fusion_start`; POLL `fusion_readiness` every ~10s until `ready:true` |-| `installed:false` / `host_app_not_installed` (Adom Bridge >=1.9.79, + a `hostApp` field) | no Fusion host app | Install it FOR them: follow [fusion-onboarding](skills/fusion-onboarding/SKILL.md) (Autodesk dmg -> `Install Autodesk Fusion.app`) -> poll `fusion_readiness` until `installed:true` -> `fusion_start`. (`fusion_install_fusion` only reports state; there is no documented silent mac installer.) Details: [fusion-onboarding](skills/fusion-onboarding/SKILL.md) |+| `installed:false` / `host_app_not_installed` (Adom Bridge >=1.9.79, + a `hostApp` field) | no Fusion host app | Install it FOR them: `fusion_install_fusion` -> poll `fusion_install_status` until `done:true` -> `fusion_start`. Never curl or run the installer yourself. Details: [fusion-onboarding](skills/fusion-onboarding/SKILL.md) | | `needsSignin:true` (`fusion_start` **and** `fusion_readiness`) | Fusion is running but stuck at the first-run Autodesk sign-in (main UI blocked, add-in can't serve, so `ready:false`) | AUTOMATE it (proven sequence, see [fusion-onboarding](skills/fusion-onboarding/SKILL.md)): (1) clear STALE `signin.autodesk.com` tabs (a dead tab = expired code = "Sign-in request expired"); (2) `desktop_ui_click` "Retry browser sign-in" / "Sign In" for ONE fresh request; (3) click "Open Product" with **`desktop_click` (a real CGEvent click)** — an Accessibility press (`ui_click`) is not a user gesture, so the browser blocks the protocol launch; (4) on the in-page "Open Autodesk Identity Manager?" sheet (part of the browser window, so no window-list scan will show it) tick "Always allow" + "Open" via `desktop_click`, FAST; (5) poll `fusion_readiness`. `nbrowser` (CDP) can do 3-4 headlessly if it's on the SAME browser window. NEVER auto-enter password/2FA. To ask the user, `notify_user` works directly (Adom Bridge ≥1.9.84); add a cross-Bridge `target` if you're on a VM | | `addinStale:true` / `addin_stale` | Fusion runs an OLD add-in that never re-synced (silent-failure risk) | `fusion_stop` then `fusion_start` — the bridge re-syncs the add-in from cache on start (Fusion must be CLOSED) | | `bridge_restarting` + `stillRunning:true` (Adom Bridge ≥1.9.77) | the bridge is respawning after a `bridge_install` | NEVER a not-installed/fatal signal: poll `fusion_readiness` until `ready:true`, then retry. Read-only verbs (`fusion_readiness`/`fusion_describe`/`fusion_get_app_state`) forward straight through even mid-respawn — no sleep-and-recheck hacks needed |@@ -97,8 +97,9 @@ APS search** — everything this bridge does for *reading* works. Read-only ONLY blocks **save, export, modify, and creating new designs** (the Save/Export buttons are dimmed). So: -- ⛔ **NEVER tell the user an `open` / `view` / `search` failed "because the Fusion subscription-  is expired / read-only."** That is FALSE and confuses users (it's been said wrongly many times).+- ⛔ **An `open` / `view` / `search` failure is never caused by an expired / read-only Fusion+  subscription — so never report it to the user that way.** That claim is FALSE and confuses users+  (it has been made wrongly many times).   If `fusion_aps_open` / `fusion_open_cloud_file` hangs or fails, it is a **code / approach   problem in the open path** (URN resolution, the Electronics design picker, a slow assembly   download, a stuck main thread) — debug/fix THAT, not the license. Try harder; don't blame the
VERBS.md+52−7
@@ -13,11 +13,11 @@ adom-bridge fusion_<verb> '<input json>' `statusVerb`.  -_78 verbs._+_79 verbs._  ## Index -`fusion_start` `fusion_stop` `fusion_kill` `fusion_close_window` `fusion_get_app_state` `fusion_readiness` `fusion_new_electronics_from_eagle` `fusion_notify_owner` `fusion_signin` `fusion_mcp_status` `fusion_mcp_enable` `fusion_mcp_tools` `fusion_mcp_call` `fusion_mcp_resources` `fusion_prefs_open` `fusion_prefs_close` `fusion_set_auto_update` `fusion_signin_2fa` `fusion_demo` `fusion_aps_status` `fusion_aps_set_client_id` `fusion_aps_signin` `fusion_aps_set_browser` `fusion_aps_get_browser` `fusion_aps_forget_browser` `fusion_aps_search` `fusion_aps_open` `fusion_open_by_urn` `fusion_aps_browse` `fusion_aps_recent` `fusion_aps_file_info` `fusion_aps_versions` `fusion_aps_download` `fusion_aps_upload` `fusion_aps_create_folder` `fusion_aps_get` `fusion_walk_cloud_tree` `fusion_search_cloud_files` `fusion_show_schematic` `fusion_show_2d_board` `fusion_show_3d_board` `fusion_board_info` `fusion_open_lbr` `fusion_attach_3d_package` `fusion_install_fusion` `fusion_generate_package` `fusion_make_3d_package` `fusion_build_library_3d` `fusion_capture_library_views` `fusion_cleanup_cloud_files` `fusion_run_modeling_script` `fusion_assembly_bom` `fusion_physical_properties` `fusion_set_preference` `fusion_get_preferences` `fusion_export_step` `fusion_export_iges` `fusion_export_stl` `fusion_export_3mf` `fusion_export_usdz` `fusion_export_optimized_glb` `fusion_fetch_optimized_glb` `fusion_board_stackup` `fusion_export_obj` `fusion_export_dxf` `fusion_export_dwg` `fusion_export_gerbers` `fusion_export_bom` `fusion_export_cpl` `fusion_set_design_rules` `fusion_load_design_rules` `fusion_detect_layers` `fusion_dismiss_blocking_dialogs` `fusion_electron_run` `fusion_electron_zoom` `fusion_electron_pan` `fusion_electron_select` `fusion_describe`+`fusion_start` `fusion_stop` `fusion_kill` `fusion_close_window` `fusion_get_app_state` `fusion_readiness` `fusion_new_electronics_from_eagle` `fusion_notify_owner` `fusion_signin` `fusion_mcp_status` `fusion_mcp_enable` `fusion_mcp_tools` `fusion_mcp_call` `fusion_mcp_resources` `fusion_prefs_open` `fusion_prefs_close` `fusion_set_auto_update` `fusion_signin_2fa` `fusion_demo` `fusion_aps_status` `fusion_aps_set_client_id` `fusion_aps_signin` `fusion_aps_set_browser` `fusion_aps_get_browser` `fusion_aps_forget_browser` `fusion_aps_search` `fusion_aps_open` `fusion_open_by_urn` `fusion_aps_browse` `fusion_aps_recent` `fusion_aps_file_info` `fusion_aps_versions` `fusion_aps_download` `fusion_aps_upload` `fusion_aps_create_folder` `fusion_aps_get` `fusion_walk_cloud_tree` `fusion_search_cloud_files` `fusion_show_schematic` `fusion_show_2d_board` `fusion_show_3d_board` `fusion_board_info` `fusion_open_lbr` `fusion_attach_3d_package` `fusion_install_fusion` `fusion_install_status` `fusion_generate_package` `fusion_make_3d_package` `fusion_build_library_3d` `fusion_capture_library_views` `fusion_cleanup_cloud_files` `fusion_run_modeling_script` `fusion_assembly_bom` `fusion_physical_properties` `fusion_set_preference` `fusion_get_preferences` `fusion_export_step` `fusion_export_iges` `fusion_export_stl` `fusion_export_3mf` `fusion_export_usdz` `fusion_export_optimized_glb` `fusion_fetch_optimized_glb` `fusion_board_stackup` `fusion_export_obj` `fusion_export_dxf` `fusion_export_dwg` `fusion_export_gerbers` `fusion_export_bom` `fusion_export_cpl` `fusion_set_design_rules` `fusion_load_design_rules` `fusion_detect_layers` `fusion_dismiss_blocking_dialogs` `fusion_electron_run` `fusion_electron_zoom` `fusion_electron_pan` `fusion_electron_select` `fusion_describe`  --- @@ -1419,12 +1419,15 @@ _timeout 240s_ · _long-running_  ### `fusion_install_fusion` -Reports whether Fusion is already installed, and otherwise returns errorCode fusion_install_manual_on_macos: Autodesk publishes NO documented silent-install switches for the mac streamer, so this bridge does not pretend to have one. The INSTALL IS STILL THE AI'S JOB - follow the fusion-onboarding skill (curl the Fusion Client Downloader dmg, hdiutil attach, open 'Install Autodesk Fusion.app', poll fusion_readiness until installed:true). Declared as detect.installVerb so Adom Bridge's bridge_readiness points here.+INSTALL Autodesk Fusion on this Mac - the only supported way; never curl or run the installer yourself. Returns at once and runs a background job: downloads Autodesk's 'Fusion Client Downloader.dmg' (~31 MB, retries), mounts it read-only with no Finder window, VERIFIES it (bundle com.Autodesk.streamer, codesign --deep --strict, Autodesk team XXKJ396S2Y, Gatekeeper-notarized; refuses anything else), runs the streamer in its quiet mode (no window, no focus change), then waits until the bridge's completeness test passes (10-30 min, several GB). Poll fusion_install_status. Already installed -> alreadyInstalled:true. A second call while one runs returns the running job (never a second installer). quiet:false runs the installer app with its progress window instead (still backgrounded). verifyOnly:true downloads + verifies and runs nothing (works even when Fusion is installed). Declared as detect.installVerb so Adom Bridge's bridge_readiness points here.  **Input** (schema):  ```json-{}+{+  "quiet": "optional bool (default true)",+  "verifyOnly": "optional bool"+} ```  **Example call:**@@ -1438,15 +1441,57 @@ adom-bridge fusion_install_fusion '{}' ```json {   "success": "bool",+  "started": "bool?",   "alreadyInstalled": "bool?",-  "errorCode": "fusion_install_manual_on_macos?",+  "alreadyRunning": "bool?",+  "jobId": "str?",+  "phase": "str?",+  "statusVerb": "fusion_install_status",   "_hint": "str" } ``` -_timeout 90s_+_timeout 30s_++**If the relay cuts it:** The install job runs in the bridge, not the call. Poll fusion_install_status; calling fusion_install_fusion again only returns the running job.++### `fusion_install_status`++Progress of the fusion_install_fusion job: phase (queued|downloading|mounting|verifying|launching|starting|streaming|finishing|installed|failed|verified; finishing = the app binary is complete but Autodesk's installer is still writing the ~/Applications launcher, and the image stays mounted until it exits), bytesDone/bytesTotal while downloading, streamedMB + elapsedSeconds while streaming, done, success, errorCode + error + logTail on failure (fusion_installer_download_failed|_mount_failed|_untrusted|_unexpected_layout|_launch_failed|_exited|fusion_install_timeout), and on success appPath/launcherPath/launcherMissing/installScope, installerExitCode, mountLeft, focusChanged, fusionLaunchedByInstaller. Also returns the live installed flag. Survives a bridge restart (state in ~/.adom/fusion-bridge/install-job.json; the quiet installer runs in its own session).++**Input** (schema):++```json+{}+```++**Example call:**++```+adom-bridge fusion_install_status '{}'+```++**Output** (shape):++```json+{+  "success": "bool",+  "phase": "str",+  "done": "bool",+  "installed": "bool",+  "bytesDone": "int?",+  "bytesTotal": "int?",+  "streamedMB": "float?",+  "elapsedSeconds": "int?",+  "errorCode": "str?",+  "logTail": "[str]?",+  "_hint": "str"+}+```++_timeout 15s_ -**If the relay cuts it:** No automated mac install path — see the fusion-onboarding skill.+**If the relay cuts it:** The install job runs in the bridge, not the call. Poll fusion_install_status; calling fusion_install_fusion again only returns the running job.  ### `fusion_generate_package` 
package.json+1−1
@@ -1,6 +1,6 @@ {   "slug": "fusion-bridge-macos",-  "version": "1.8.6",+  "version": "1.8.7",   "files": [     "SKILL.md",     "skills/**",
page.json+1−1
@@ -1,6 +1,6 @@ {   "slug": "fusion-bridge-macos",-  "version": "1.8.6",+  "version": "1.8.7",   "type": "app",   "description": "This package installs the bridge's SKILLS into your container so your AI knows how to drive it; Adom Bridge loads the bridge runtime itself from the release zip.",   "dependencies": {
skills/fusion-demo/SKILL.md+3−3
@@ -145,9 +145,9 @@ Do not just report "not installed". OFFER, and be concrete AND honest about the - **Even an expired / read-only install still OPENS and VIEWS designs** (it only blocks   save/export/modify), so nothing they make gets locked away. -Then run the mac install yourself per **fusion-onboarding** (curl the Autodesk dmg, `hdiutil-attach`, `open "Install Autodesk Fusion.app"` — it streams for 10-30 min), poll `fusion_readiness`-until `installed:true`, and call `fusion_demo` again to pick the tour back up.+Then call `fusion_install_fusion` (it downloads, verifies and runs Autodesk's installer in the+background; never curl it yourself), poll `fusion_install_status` every ~30 s until `done:true`+(10-30 min), and call `fusion_demo` again to pick the tour back up. Full flow: **fusion-onboarding**.  ## If something else is missing
skills/fusion-onboarding/SKILL.md+31−26
@@ -31,38 +31,43 @@ but **never installs it** — and it provisions Python for the bridge itself (no with the `runtimes` verb), so **never** download or bootstrap Python here. Onboarding is only about Fusion itself + the Autodesk login + deploying the add-in. -`fusion_install_fusion` on this line returns `fusion_install_manual_on_macos` on purpose: Autodesk-ships no documented silent-install switches for the mac streamer, so the bridge does not pretend-to have one. **This skill is the automation** — the AI runs the steps below itself instead of-handing the user a download link.+**Install with `fusion_install_fusion`. Never curl, mount or run the installer yourself** (an agent+that hand-rolled `curl … Fusion Client Downloader.dmg` through the Bridge shell on a fresh Mac,+2026-10-27, got nothing: the download silently never landed). The verb does it properly and+reports progress. -## Step 1 — Download the Fusion installer-Autodesk's mac installer is a small disk image that streams the full app during install:+## Steps 1-2 — Install Fusion ```-https://dl.appstreaming.autodesk.com/production/installers/Fusion%20Client%20Downloader.dmg+fusion_install_fusion {} ```-```-shell_execute {"command":"curl -L -o /tmp/FusionDL.dmg \"https://dl.appstreaming.autodesk.com/production/installers/Fusion%20Client%20Downloader.dmg\""}-```-(~28 MB; `curl` ships with macOS.)+Returns at once with `started:true` and a `jobId`. In the background the bridge:+1. downloads Autodesk's `Fusion Client Downloader.dmg` (~31 MB, retried) into+   `~/Library/Caches/adom-fusion-bridge/installer/`;+2. mounts it read-only with no Finder window;+3. **verifies** it: bundle `com.Autodesk.streamer`, `codesign --deep --strict`, Autodesk's team+   `XXKJ396S2Y`, Gatekeeper-notarized. Anything else is refused (`fusion_installer_untrusted`);+4. runs Autodesk's streamer in its quiet mode (no window, no focus change) — it streams **several+   GB** into `~/Library/Application Support/Autodesk/webdeploy/production/<hash>/` (10-30 min) and+   puts a small launcher in `~/Applications`;+5. waits until the bundle binary is complete, then unmounts and deletes the dmg. -## Step 2 — Mount it and run the installer+Then poll — **monitor, don't block**: ```-shell_execute {"command":"hdiutil attach -nobrowse -mountpoint /tmp/fusion-installer /tmp/FusionDL.dmg && open \"/tmp/fusion-installer/Install Autodesk Fusion.app\""}+fusion_install_status {} ```-- The dmg contains **`Install Autodesk Fusion.app`** (Autodesk's "Fusion Client Downloader"-  streamer). Launching it opens a small progress window and streams **several GB** into-  `~/Library/Application Support/Autodesk/webdeploy/production/<hash>/` — 10-30 min on a normal-  connection. **Monitor, don't block**: poll `fusion_readiness` until `installed:true` (the bridge-  flips it the moment the bundle binary is complete).-- No admin/elevation is involved (per-user install). If macOS shows a Gatekeeper prompt for the-  installer app, that is a genuine wall — `notify_user` the user to click Open.-- Don't invent silent flags for the streamer binary; none are documented for macOS. If the-  installer wants the Autodesk sign-in *before* streaming, continue with Step 3 in the installer's-  window — same mechanism.-- Afterwards: `shell_execute {"command":"hdiutil detach /tmp/fusion-installer; rm -f /tmp/FusionDL.dmg"}`.-- Uninstall (if ever needed): remove the `webdeploy/production/<hash>` dirs and-  `~/Library/Application Support/Autodesk/Autodesk Fusion*`; there is no separate uninstaller.+every ~30 s until `done:true`. While working it reports `phase` (`downloading` with+`bytesDone/bytesTotal`, `verifying`, `streaming` with `streamedMB`, …). On success: `phase:+"installed"`, `appPath`, `launcherPath`. On failure: `errorCode`, `error`, `logTail` and a `_hint`.++- **Never start a second installer.** Calling `fusion_install_fusion` again while a job runs just+  returns that job. If the bridge restarted mid-install, `fusion_install_status` still reports it.+- If quiet mode fails on some macOS build (`fusion_installer_exited`), retry with+  `fusion_install_fusion {"quiet": false}`: the installer runs with its own small progress window,+  opened in the background (it does not take focus).+- No admin/elevation is involved (per-user install). `fusion_install_fusion {"verifyOnly": true}`+  downloads and verifies without running anything (safe on a Mac that already has Fusion).+- Uninstall (if ever needed): `~/Applications/Remove Autodesk Fusion.app`, or remove the+  `webdeploy/production/<hash>` dirs and `~/Library/Application Support/Autodesk/Autodesk Fusion*`.  ## Step 3 — First launch + Autodesk login (free account / trial) `fusion_start` launches it (in the background — no focus steal); the first run needs an Autodesk