Fusion - the Fusion 360 Bridge

@@ -3005,6 +3005,54 @@ def _orchestrate_open_lbr(args: dict) -> dict:     return _post_open_screenshot(response)  ++def _ensure_library_active(lbr_path: str, timeout_s: int = 60) -> dict:+    """Make the .lbr the ACTIVE document - verified, not assumed (caught live 2026-08-21).++    open_lbr returning success does NOT mean the library is in front: the open is async, and+    when the library is ALREADY open the call short-circuits leaving whatever document was+    active. Create3DPackage then refuses with "Please run the command in library document" -+    exactly what the first live bind of adom-lbr output hit, with Untitled still active.+    Polls until activeDocument matches, activating by name if open-but-not-front.+    """+    import time as _t+    stem = lbr_path.replace("\\", "/").rsplit("/", 1)[-1].rsplit(".", 1)[0].lower()+    deadline = _t.time() + timeout_s+    tried_activate = False+    while _t.time() < deadline:+        try:+            st = _proxy_to_addin("get_app_state", {}, timeout=6)+            active = str((st.get("data") or {}).get("activeDocument") or "")+            if st.get("success") and stem in active.lower():+                return {"ok": True, "activeDocument": active}+            if st.get("success") and not tried_activate:+                tried_activate = True+                _proxy_to_addin("activate_document", {"name": stem}, timeout=10)+        except Exception:+            pass+        _t.sleep(2)+    return {"ok": False, "activeDocument": None}+++def _create_3d_package(lbr_path: str, timeout: int = 60) -> dict:+    """The ONLY way to run Electron.Create3DPackage: verify the library is active first.++    Five call sites each did open-then-hope with their own sleep; this replaces all of them+    so the precondition cannot be forgotten at the next one.+    """+    act = _ensure_library_active(lbr_path)+    if not act.get("ok"):+        return {"success": False, "errorCode": "library_not_active",+                "error": "The library opened but never became the ACTIVE document, so "+                         "Create3DPackage would refuse ('Please run the command in library "+                         "document').",+                "_hint": "Another document may be mid-operation on Fusion's main thread. "+                         "Retry: the bridge polls 60s and activates by name before giving up."}+    return _proxy_to_addin("execute_text_command",+                           {"command": "Electron.Create3DPackage %s" % lbr_path},+                           timeout=timeout)++ def _orchestrate_attach_3d_package(args: dict) -> dict:     """Attach a real 3D model to a library package, end to end. @@ -3037,7 +3085,7 @@ def _orchestrate_attach_3d_package(args: dict) -> dict:         return {"success": False, "error": "open_lbr failed: " + str(open_res.get("error")), "data": {"steps": steps}}     steps.append("open_lbr: ok (library active)")     time.sleep(1)-    cp = _proxy_to_addin("execute_text_command", {"command": f"Electron.Create3DPackage {file_path}"}, timeout=40)+    cp = _create_3d_package(file_path, timeout=40)     if not cp.get("success"):         return {"success": False, "error": "Create3DPackage failed: " + str(cp.get("error")),                 "_hint": "The library document must be ACTIVE, and the .lbr must be adom-lbr-generated "@@ -3278,7 +3326,7 @@ def _orchestrate_make_3d_package(args: dict) -> dict:     if not op.get("success"):         return {"success": False, "error": "open_lbr failed: " + str(op.get("error"))}     _time.sleep(1)-    cp = _proxy_to_addin("execute_text_command", {"command": f"Electron.Create3DPackage {lbr_path}"}, timeout=40)+    cp = _create_3d_package(lbr_path, timeout=40)     if not cp.get("success"):         return {"success": False, "error": "Create3DPackage failed: " + str(cp.get("error")),                 "_hint": "The .lbr must be adom-lbr-generated; its FIRST package's footprint is loaded into the generator."}@@ -7103,7 +7151,7 @@ def _orchestrate_show_3d_package(args: dict) -> dict:                           "the footprint, then shows it. A Placeholder rendering LOOKS like a "                           "successful 3D view in a screenshot, which is why this refuses "                           "rather than letting a caller count it as proof.")}-    cp = _proxy_to_addin("execute_text_command", {"command": "Electron.Create3DPackage %s" % library_path}, timeout=60)+    cp = _create_3d_package(library_path, timeout=60)     if not cp.get("success"):         return {"success": False, "error": "Create3DPackage failed: " + str(cp.get("error")),                 "_hint": "The library must be Fusion-parseable (adom-lbr style); raw vendor .lbr files fail Fusion's parser."}@@ -7449,8 +7497,7 @@ def _orchestrate_demo_tour(args: dict) -> dict:                     if r.get("screenshot"):                         state["shots"].append({"title": label, "label": label, "path": r["screenshot"]})                 elif key == "3d-package":-                    cp = _proxy_to_addin("execute_text_command",-                                         {"command": "Electron.Create3DPackage %s" % state["sampleLbr"]}, timeout=60)+                    cp = _create_3d_package(state["sampleLbr"], timeout=60)                     if cp.get("success"):                         time.sleep(3)                         _snap(label)@@ -8981,8 +9028,7 @@ def _handle_prove_library(fusion_info: dict, args: dict) -> dict:     # 3: the 3D editor. Only reachable when a real package3d is bound - with none, Fusion     #    shows its Placeholder, which is exactly the false pass this verb exists to prevent.     if artifacts["package3d"]["present"]:-        cp = _proxy_to_addin("execute_text_command",-                             {"command": "Electron.Create3DPackage %s" % lbr}, timeout=90)+        cp = _create_3d_package(lbr, timeout=90)         if cp.get("success"):             evidence.append(_prove_capture("package3d", "3d-editor"))         else: