Fusion - the Fusion 360 Bridge

@@ -0,0 +1,2442 @@+{+  "contract": "fusion-bridge verb catalog",+  "frozen": "2026-09-03",+  "note": "The Python bridge and the Rust bridge must both serve this catalog byte-for-byte in meaning: same names, same args, same result shapes, same timeouts. Regenerate ONLY from describe.py and diff in CI.",+  "source": "describe.py",+  "verbs": [+    {+      "example": {+        "libraryPath": "C:/Temp/PART.lbr"+      },+      "input": {+        "libraryPath": "str (Windows .lbr path)"+      },+      "longRunning": true,+      "name": "fusion_preflight_lbr",+      "output": {+        "preflight": "{ok, checks[], errors[]}",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "PRE-ANALYZE a .lbr: will Fusion open it? Offline and instant - no Fusion needed, nothing launched. Runs the named checks the bridge learned from real Fusion rejections: file-readable, size-sane (truncated-transfer corpse detection), xml-parses, root-is-eagle, packages-nonempty (Fusion's silent 'No Components'), symbols-present, devicesets-present (missing ones make EDIT raise Create-new prompts), connects-resolve (dead wiring renders fine and connects nothing). fusion_open_lbr and fusion_create_library run the same gate automatically; call this directly to gate a batch BEFORE staging.",+      "timeoutSeconds": 10+    },+    {+      "example": {+        "libraryName": "MyLib",+        "zipPath": "C:/Temp/MyLib.zip"+      },+      "input": {+        "capture": "optional bool (default true: bind + prove; false: place only)",+        "lbrPath": "str (staged .lbr, STEP models beside it)",+        "libraryName": "optional str (default: file stem)",+        "zipPath": "str (staged bundle zip on THIS machine) - or"+      },+      "longRunning": true,+      "name": "fusion_install_library_bundle",+      "output": {+        "fusion": "{installed, running, addinReady, status, message}",+        "installed": "bool",+        "libraryPath": "str",+        "partMetadata": "{ok, summary, warnings[]}",+        "partsToBind": "int",+        "partsTotal": "int",+        "runId": "str",+        "statusVerb": "fusion_prove_result",+        "unbound": "[{package, why}]"+      },+      "statusVerb": "fusion_prove_result",+      "summary": "COMPOSITE, the Fusion twin of kicad_install_library_bundle (#68): ONE call takes a staged Cloud Library bundle (zip of <Lib>.lbr + <Part>.step models, or a bare lbrPath with STEPs beside it), unpacks it safely, places it under ~/Documents/Adom Libraries/<name>/, pairs EVERY deviceset with its STEP by name (deviceset, package, normalised, prefix; a one-part library pairs its single model regardless), lints part numbers (partMetadata: MPN, manufacturer, Mouser/DigiKey/LCSC - reported, never blocking), pre-flights Fusion state (fusion{status}), and starts the same bind -> prove chain fusion_create_library runs. ASYNC BY CONTRACT: returns IMMEDIATELY with runId + statusVerb because a STEP bind is 3-15 minutes and cannot fit a relay window; poll fusion_prove_result (measured percent, four streamed proof frames per part, provedParts[], and an addin_restart_required payload the CALLER turns into the ask). PARTIAL SHIPS: a deviceset with no model is a NAMED skip in unbound[], the rest still bind; partsBound < partsTotal is the signal. Each part is minted on its own single-deviceset library (the Package3D generator loads the FIRST package of the open library, so a merged library would put every chip on part one's footprint), with the STEP placed exactly as published (orient:false, origin trusted), then all urns are bound into the merged library, and after prove the bound library is SAVED TO THE CLOUD under <project>/Adom Libraries so it appears in Fusion's Library Manager (cloudLibrary{saved, fileId, duplicatesBefore} in fusion_prove_result). Per-part scaffolding is deleted; the user is left with one library plus its per-package f3d folder. capture:false only places the files and returns. This is the one contract the wiki CLI (`library install --format fusion`) and the Export button both read; the recipe has one owner.",+      "timeoutSeconds": 60+    },+    {+      "example": {+        "libraryPath": "C:/Temp/PART.lbr",+        "stepPath": "C:/Temp/PART.step"+      },+      "input": {+        "kicadFootprintPath": "optional str",+        "kicadSymbolPath": "optional str",+        "libraryPath": "optional str (shape A, or output path for B)",+        "name": "optional str",+        "parts": "optional [{package, lbrPath, modelPath}] - THE canonical shape, any count",+        "pinMap": "optional {pinName: padName}",+        "stepPath": "optional str (required for proven)"+      },+      "longRunning": true,+      "name": "fusion_create_library",+      "output": {+        "started": "bool",+        "statusVerb": "str"+      },+      "statusVerb": "fusion_prove_result",+      "summary": "ONE-CALL library creation for web-control (one call = one consent). EVERY LIBRARY IS MULTI-PART - a single-part library is simply parts:[one entry], and there is no separate single-part verb to choose. Pass parts:[{package, lbrPath, modelPath}] for any number of parts; the older {libraryPath, stepPath} shape still works and is normalised into a one-element parts list, so both run the identical code path and the ETA scales with the part count either way. TWO entry shapes: A) {libraryPath, stepPath} - a ready .lbr plus the 3D; B) {kicadSymbolPath, kicadFootprintPath, stepPath, pinMap?} - KiCad sources; needs adom-lbr, which is Linux-container-only by platform rule, so on Windows/Mac boxes shape B refuses IMMEDIATELY (adom_lbr_unavailable, before any staging or Fusion launch - fusion_readiness reports kicadIngest up front). Convert at AUTHORING time in a container and use shape A. pinMap = explicit {pinName: padName} for when pin numbers do not match pad names (BGA-style). Chains convert -> bind 3D -> prove (four evidence frames + verdict) in the BACKGROUND and returns immediately; poll fusion_prove_result (stage narrates; top-level `verdict` proven/not_proven is the score - `stage:done` only means the chain finished). EVERY PART IS PROVED, not just the first: a 10-component library streams 40 evidence frames, FOUR per component (symbol, footprint, 3d, ganged) in assembly order, each tagged with `part` so a front end can group them as they arrive, and `provedParts[]` reports per-part pass/fail. The library is proven only if EVERY part is - one good part does not vouch for nine unchecked ones. On the FINAL fetch pass {inlineFrames:true} to get each evidence frame as a base64 thumbnailDataUrl a browser can render (plain polls return box paths only). The chain closes its library document on success AND failure - batches need no between-part sweeping. stepPath is required for a PROVEN library - no real 3D body without it.",+      "timeoutSeconds": 30+    },+    {+      "example": {},+      "input": {},+      "longRunning": true,+      "name": "fusion_start",+      "output": {+        "addinReady": "bool",+        "status": "str",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "Launch Fusion 360 (if needed) and wait for the AdomBridge add-in to be ready.",+      "timeoutSeconds": 150+    },+    {+      "example": {},+      "input": {+        "skipCleanClose": "optional bool"+      },+      "longRunning": false,+      "name": "fusion_stop",+      "output": {+        "output": "str",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "Gracefully STOP Fusion 360: close docs cleanly + WM_CLOSE, then wait. NO force-kill - the clean opposite of fusion_start. If a window will not close it returns failure; use fusion_kill then.",+      "timeoutSeconds": 60+    },+    {+      "example": {},+      "input": {+        "skipCleanClose": "optional bool"+      },+      "longRunning": false,+      "name": "fusion_kill",+      "output": {+        "output": "str",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "Force-KILL Fusion 360 (taskkill /F) - the desperate path for when fusion_stop cannot close it (stuck modal / wedged process). Closes docs cleanly first when reachable.",+      "timeoutSeconds": 30+    },+    {+      "example": {+        "hwnd": 123456+      },+      "input": {+        "hwnd": "required int (the dialog window)"+      },+      "longRunning": false,+      "name": "fusion_close_window",+      "output": {+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "Close a DIALOG window by hwnd (WM_CLOSE, like clicking X) - for dialogs without Cancel/Escape handling (e.g. Recovered Documents). NOT a document closer; refuses without hwnd. Get the hwnd from a screenshot's dialogs array or desktop_list_windows. (Doc drift caught by the verb test suite 2026-08-14: this was described as 'close the active document' while the handler required hwnd.)",+      "timeoutSeconds": 30+    },+    {+      "example": {},+      "input": {},+      "longRunning": false,+      "name": "fusion_get_app_state",+      "output": {+        "activeDocument": "str",+        "activeWorkspace": "str",+        "isElectronics": "bool"+      },+      "statusVerb": null,+      "summary": "Current app state: running, active document, workspace, isElectronics. The poll/status verb for long-running calls.",+      "timeoutSeconds": 20+    },+    {+      "example": {},+      "input": {},+      "longRunning": false,+      "name": "fusion_readiness",+      "output": {+        "bridgeVersion": "str",+        "hostApp": "str",+        "installed": "bool",+        "ready": "bool",+        "running": "bool"+      },+      "statusVerb": null,+      "summary": "FAST readiness check (does NOT launch Fusion): is the Fusion host app installed + running + the bridge ready to drive? ab DETECTS Fusion (never installs it) via bridge.json 'detect', and auto-installs Python if missing (ab >=1.9.47). Call this before driving Fusion; if installed-but-not-running, fusion_start. SELF-HEALS the seat/licensing dialog (background UIA + screenshot-verify) whenever it detects one. Pairs with ab's bridge_readiness.",+      "timeoutSeconds": 15+    },+    {+      "example": {+        "brdPath": "C:/Users/me/adom-lib/MyBoard.brd",+        "schPath": "C:/Users/me/adom-lib/MyBoard.sch"+      },+      "input": {+        "brdPath": "optional str (defaults to sibling .brd)",+        "schPath": "required str (Windows path to .sch)"+      },+      "longRunning": false,+      "name": "fusion_new_electronics_from_eagle",+      "output": {+        "imported": "list",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "Import a legacy EAGLE .sch (+ paired .brd) into a NEW Fusion electronics design so the parts INSTANTIATE (schematic + populated board, lands in the PCB editor). The ONLY way to author a board from EAGLE source: Document.newDesignFromLocal opens the schematic editor but does NOT instantiate parts, and the Fusion-native .fsch/.fbrd container is opaque binary you can't build offline. This fires Fusion's own ImportSCHAndBRDCmd and drives BOTH native Open dialogs (the .sch then the .brd) in the BACKGROUND via desktop_ui_click by accessible name (no foreground). Stage both files to Windows first (send_files). After: fusion_show_2d_board, RATSNEST + 'AUTO ;' to autoroute, fusion_show_3d_board for 3D.",+      "timeoutSeconds": 200+    },+    {+      "example": {+        "body": "Please complete the Autodesk 2FA prompt on winvm - everything else is done.",+        "title": "Fusion needs you"+      },+      "input": {+        "body": "required str",+        "level": "optional str info|warning|error",+        "title": "optional str"+      },+      "longRunning": false,+      "name": "fusion_notify_owner",+      "output": {+        "success": "bool",+        "targets": "list"+      },+      "statusVerb": null,+      "summary": "LAST-RESORT human escalation: toast the user's MAIN computer (fans out cross-ab to every peer on the relay, so it reaches them even when this bridge runs on an unattended VM). ONLY for true human walls - password/2FA entry, UAC elevation, a physical step. Exhaust programmatic options first (UIA background clicks, seat auto-resolve, warm-SSO sign-in). After sending, WAIT and poll fusion_readiness; do not re-toast within a few minutes.",+      "timeoutSeconds": 20+    },+    {+      "example": {},+      "input": {+        "auto": "optional bool (do click+capture+reopen in one on-box call - recommended)",+        "profile": "optional str (chrome:<email>/edge:<email> - the profile your Autodesk account is in; remembered)",+        "waitSec": "optional int (server-side poll budget for the fresh URL, default 32)"+      },+      "longRunning": true,+      "name": "fusion_signin",+      "output": {+        "done": "bool",+        "narrate": "str",+        "notifyDelivered": "bool",+        "signinAuthUrl": "str",+        "signinOpenedVia": "str (extension|extension_free)",+        "signinProfile": "str",+        "signinProfileReason": "str",+        "signinWall": "str|null (twofactor_email_code|credentials|protocol_handoff)",+        "signinWallHint": "str|null",+        "signinWhere": "str",+        "signinWrongBrowser": "str",+        "stage": "str"+      },+      "statusVerb": "fusion_signin",+      "summary": "SELF-DRIVING as of 1.9.32: launches Fusion if needed, clicks Sign In, opens the OAuth in the right profile, TYPES THE EMAIL and advances to the exact remaining wall (password/2FA/handoff), toasting the user at that step only - see signinWall + _hint in the response, and the fusion-autodesk-signin skill. Sign Fusion in through the CORRECT browser profile - the fix for Fusion's dumb OAuth that fires at the OS-DEFAULT browser and lands in the wrong Autodesk account. Fusion opens its sign-in in whatever browser is default (e.g. a personal Chrome), but a user's Autodesk seat often lives in a different profile (work). This verb reads the FULL authorize URL (client_id/PKCE/state/request_id) that Fusion wrote into that wrong browser's HISTORY and re-opens it in the RIGHT profile IN THE BACKGROUND; the URL completes back to the running Fusion via the idmgr/callback + autodesk:// handoff, so the browser no longer has to be the OS default. Pass {profile:'chrome:[email protected]'} to fix + remember your Autodesk profile; else it probes each profile for a live Autodesk session (or asks). Staged: if Fusion hasn't opened the browser yet it returns stage:'click_signin' so you click Fusion's Sign In first. BEST: pass {auto:true} to run the WHOLE chain in ONE server-side call - it clicks Fusion's Sign In, polls the browser history on-box for the fresh authorize URL, and re-opens it in the target profile, all without extra remote round-trips, so it fits inside Fusion's ~2-min OAuth request expiry even on a slow/flaky relay (the manual staged path is the fallback). Fusion's request EXPIRES in ~2 min, so a stale captured URL returns stage:'stale' - restart Fusion (fusion_stop/start) for a fresh request and retry auto PROMPTLY. See the 'fusion-multiprofile-signin' skill.",+      "timeoutSeconds": 120+    },+    {+      "example": {},+      "input": {},+      "longRunning": false,+      "name": "fusion_mcp_status",+      "output": {+        "enabled": "bool",+        "serverInfo": "obj",+        "toolCount": "int",+        "tools": "[{name,description}]"+      },+      "statusVerb": "fusion_mcp_status",+      "summary": "Is Autodesk's Fusion MCP server up, and what does it expose? Autodesk + Anthropic ship a LOCAL MCP server at http://127.0.0.1:27182/mcp exposing Fusion's own text-to-CAD surface (read geometry, execute/update features, read Electronics design data). It binds LOOPBACK on the user's machine and was built for Claude Desktop running there, so a CLOUD AI cannot reach it at all - this bridge runs on that machine and proxies it for you. Returns enabled, serverInfo and the live tool list. OFF by default: if it reports enabled:false, call fusion_mcp_enable and the bridge turns it on for the user.",+      "timeoutSeconds": 45+    },+    {+      "example": {},+      "input": {},+      "longRunning": true,+      "name": "fusion_mcp_enable",+      "output": {+        "alreadyOn": "bool",+        "enabled": "bool",+        "serverInfo": "obj",+        "steps": "list"+      },+      "statusVerb": "fusion_mcp_status",+      "summary": "Turn Autodesk's Fusion MCP server ON by driving Fusion's Preferences dialog for the user. Autodesk exposes NO API for this toggle, so the UI is the only route: this opens Preferences (Commands.Start PreferencesCommand), expands General, selects API, ticks 'Fusion MCP Server (runs locally on this device)', then clicks Apply and OK. Needs Fusion running; briefly uses the foreground and announces why with an on-screen caption. NEVER ask the user to do this by hand first - do it for them, then tell them it is handled. Note the setting is DISCARDED if Fusion is killed or restarted before Apply is clicked.",+      "timeoutSeconds": 180+    },+    {+      "example": {},+      "input": {},+      "longRunning": false,+      "name": "fusion_mcp_tools",+      "output": {+        "count": "int",+        "tools": "list"+      },+      "statusVerb": "fusion_mcp_status",+      "summary": "Full tool list from Autodesk's Fusion MCP server INCLUDING input schemas, so you can construct a valid fusion_mcp_call. These are Autodesk's tools, not this bridge's.",+      "timeoutSeconds": 45+    },+    {+      "example": {+        "arguments": {+          "queryType": "summary"+        },+        "tool": "fusion_mcp_read"+      },+      "input": {+        "arguments": "optional obj (per that tool's inputSchema)",+        "timeout": "optional int seconds, default 120",+        "tool": "required str (from fusion_mcp_tools)"+      },+      "longRunning": true,+      "name": "fusion_mcp_call",+      "output": {+        "result": "obj",+        "tool": "str"+      },+      "statusVerb": "fusion_mcp_status",+      "summary": "Call any tool on Autodesk's Fusion MCP server (fusion_mcp_read, fusion_mcp_update, fusion_mcp_execute, fusion_mcp_electronics_read). The bridge handles the MCP streamable-HTTP handshake for you (initialize -> MCP-Session-Id -> notifications/initialized) and re-establishes a dropped session automatically. MCP acts on the ACTIVE Fusion document, so open one first. PREFER a native fusion_* verb when one exists - they are tested here and return richer hints - and reach for MCP for Autodesk's text-to-CAD surface.",+      "timeoutSeconds": 150+    },+    {+      "example": {},+      "input": {+        "uri": "optional str (omit to list)"+      },+      "longRunning": false,+      "name": "fusion_mcp_resources",+      "output": {+        "count": "int",+        "resources": "[str]",+        "result": "obj"+      },+      "statusVerb": "fusion_mcp_status",+      "summary": "List Autodesk MCP resources, or read one by uri. These are mostly the Electronics entity schemas (resource://mcp.electronics_schema_*) that describe what fusion_mcp_electronics_read can return.",+      "timeoutSeconds": 60+    },+    {+      "example": {+        "section": "api"+      },+      "input": {+        "section": "optional str (see knownSections in the response)"+      },+      "longRunning": true,+      "name": "fusion_prefs_open",+      "output": {+        "hwnd": "int",+        "knownSections": "[str]",+        "screenshot": "str",+        "shotId": "str",+        "steps": "list"+      },+      "statusVerb": "fusion_get_preferences",+      "summary": "Open Fusion's Preferences dialog and optionally jump to a section, then hand back a SCREENSHOT + shotId you can click in. This is how you reach ANY Fusion preference: the Python API exposes only a thin slice (theme/orbit/units, debuggingPort, developer tools) and everything else, including the MCP server toggle, is UI-only. Sections: general, api, design, manufacture, electronics, render, drawing, material, graphics, network, preview features. Child sections under General are lazily rendered by Qt and never appear in the UIA tree, which is why this returns an image to click rather than control names. ALWAYS finish with fusion_prefs_close {save:true} - nothing is saved otherwise, and killing/restarting Fusion first discards the change.",+      "timeoutSeconds": 120+    },+    {+      "example": {+        "save": true+      },+      "input": {+        "save": "optional bool, default true"+      },+      "longRunning": false,+      "name": "fusion_prefs_close",+      "output": {+        "closed": "bool",+        "saved": "bool"+      },+      "statusVerb": "fusion_get_preferences",+      "summary": "Apply+OK (save:true, the default) or Cancel Fusion's Preferences dialog. Settings changed via fusion_prefs_open are NOT persisted until this is called with save:true.",+      "timeoutSeconds": 60+    },+    {+      "example": {+        "enabled": true+      },+      "input": {+        "enabled": "optional bool (omit to read current value)"+      },+      "longRunning": true,+      "name": "fusion_set_auto_update",+      "output": {+        "autoUpdateFusion": "bool",+        "narrate": "str"+      },+      "statusVerb": "fusion_readiness",+      "summary": "Turn AUTOMATIC Fusion updating on/off for this user. ON BY DEFAULT, and deliberately INVISIBLE: Fusion ships updates constantly and nags with an 'Update Now / Update Later' panel plus a '14 days until Fusion must update' countdown. Every fusion_readiness call checks for that offer and, if present, the bridge clicks it IN THE BACKGROUND (UIA, no foreground, no caption) so the download starts and the newer build comes up on the next launch. The user should never have to click it. Call with no args to read the current setting; {enabled:false} opts out and the choice is STICKY (~/.adom/fusion-bridge/prefs.json) - once a user opts out, NEVER click their update prompts again. Tell the user this is handled for them rather than asking them to update.",+      "timeoutSeconds": 30+    },+    {+      "example": {+        "code": "123456"+      },+      "input": {+        "code": "required str (the 6 digits; non-digits are stripped)",+        "hwnd": "optional int (the 2FA window; auto-detected)"+      },+      "longRunning": true,+      "name": "fusion_signin_2fa",+      "output": {+        "narrate": "str",+        "steps": "list",+        "submitted": "bool"+      },+      "statusVerb": "fusion_readiness",+      "summary": "Submit Autodesk's emailed 6-DIGIT verification code to finish a Fusion sign-in, typed IN THE BACKGROUND (UIA SetValue + Invoke - never steals the user's foreground or moves their cursor). Exists so you can finish a login END TO END for the user instead of parking them on a 2FA screen: if `adom-google` is available in your container, read the code out of their Gmail (`adom-google gmail search 'from:autodesk verification code' --limit 1`), pull the 6 digits, and call this. If adom-google is NOT installed, tell the user that installing it would let you automate logins like this, then let them type it. NEVER ask the user for a code you could read yourself. The bridge ALSO toasts the user's desktop whenever it hits a human wall, so you do not need to ask it to.",+      "timeoutSeconds": 90+    },+    {+      "example": {},+      "input": {+        "captions": "optional bool (default true: one desktop caption per stop)",+        "foreground": "optional bool (default false: background envelope, never steals focus)",+        "mode": "optional str ('tour' = the async showcase; poll fusion_demo_progress {demoId})",+        "preset": "optional str ('electronics' = library import, symbol, footprint, 3D chip, ganged component view, schematic, 2D board, 3D board - the eight-stop showcase; omit for the full tour incl. Data Hub, APS, MCP, exports)",+        "query": "optional str (design to demo; else picked from APS search)",+        "remote": "optional bool (tour mode: show ab's floaty glass PLAY/PAUSE/NEXT/BACK/STOP panel on the desktop; its presses drive the same transport flags as fusion_demo_control, so the dashboard buttons and the remote can be mixed)",+        "stage": "optional str ('skip_aps' to proceed without cloud search)"+      },+      "longRunning": true,+      "name": "fusion_demo",+      "output": {+        "apsSampleSearch": "[{name,project}]",+        "done": "bool",+        "narrate": "str",+        "screenshots": "[{label,path}]",+        "stage": "str",+        "steps": "[str]"+      },+      "statusVerb": "fusion_demo",+      "summary": "FIRST-TIME-USER DEMO in one verb - the thing to run when someone new wants to SEE what this bridge does (HD's installer calls this). Takes them from nothing to a real board: launches Fusion, FINISHES the Autodesk sign-in - it OPENS the sign-in in the user's NATIVE browser IN THE BACKGROUND (never interrupting their work) and returns signinWhere/signinProfile/signinSession so you can tell them exactly where it is waiting, then offer three paths: they finish it, you foreground it, or (with their OK) you drive it. Native browser via ABE/nbrowser_* because that profile is already signed into Autodesk - never pup, which is anonymous, sets up APS cloud search (or explains it if declined) and runs a LIVE sample search so they see 2-second results, then opens an electronics PROJECT and walks SCHEMATIC -> 2D BOARD -> 3D BOARD, screenshotting each view to show them. STAGED + RESUMABLE: every call advances as far as it safely can and returns stage/done/narrate/screenshots plus a _hint with the exact next action; keep calling it until done:true. NEVER leave a first-time user parked on the sign-in screen - that is the failure this verb exists to prevent. See the 'fusion-demo' skill. TOUR MODE (issue #29): pass {mode:'tour'} for the ASYNC six-content-type showcase - it stages the bundled sample library and walks symbol -> footprint -> device -> 3D package (plus schematic/2D/3D board when a query is given), returns {demoId, estimatedSec, steps} immediately, reports structured progress via fusion_demo_progress for a real progress bar, runs in the BACKGROUND by default (foreground:true only when the user wants to watch), and its final progress poll carries the screenshot array.",+      "timeoutSeconds": 240+    },+    {+      "example": {},+      "input": {},+      "longRunning": false,+      "name": "fusion_aps_status",+      "output": {+        "configured": "bool",+        "neverCharge": "bool",+        "signedIn": "bool"+      },+      "statusVerb": null,+      "summary": "APS state: configured, signed in, token live, never-charge meter.",+      "timeoutSeconds": 20+    },+    {+      "example": {+        "clientId": "D5nn...EPAq"+      },+      "input": {+        "clientId": "required str"+      },+      "longRunning": false,+      "name": "fusion_aps_set_client_id",+      "output": {+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "Set the org's APS (PKCE) client id used for cloud search.",+      "timeoutSeconds": 20+    },+    {+      "example": {},+      "input": {+        "allowDefaultBrowser": "optional bool",+        "exe": "optional str (browser binary to launch+remember)",+        "name": "optional str",+        "profileDir": "optional str (e.g. 'Default','Profile 2')"+      },+      "longRunning": false,+      "name": "fusion_aps_signin",+      "output": {+        "authUrl": "str",+        "needsExtensionOpen": "bool",+        "openedVia": "str",+        "success": "bool"+      },+      "statusVerb": "fusion_aps_status",+      "summary": "Open the Autodesk sign-in in the REMEMBERED browser+profile (not the OS default); a background listener captures the token. Pass {exe,profileDir,name} to use+remember a specific browser, or {allowDefaultBrowser:true} to fall back to the OS default. If nothing is remembered, returns needsExtensionOpen so the caller opens authUrl in the user's real browser via nbrowser_open_window.",+      "timeoutSeconds": 30+    },+    {+      "example": {+        "exe": "C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe",+        "name": "Edge",+        "profileDir": "Default"+      },+      "input": {+        "exe": "str (browser binary) OR how:'extension'",+        "how": "optional 'extension'|'launch'",+        "name": "optional str",+        "profileDir": "optional str"+      },+      "longRunning": false,+      "name": "fusion_aps_set_browser",+      "output": {+        "browser": "{name,exe,profileDir}",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "Remember the browser+profile that authed to Autodesk so every later sign-in reuses it (power users have many browsers/profiles; the OS default is usually the wrong one). Call after a driven sign-in succeeds.",+      "timeoutSeconds": 10+    },+    {+      "example": {},+      "input": {},+      "longRunning": false,+      "name": "fusion_aps_get_browser",+      "output": {+        "browser": "{name,exe,profileDir}|null",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "Show the remembered Autodesk sign-in browser (None until set).",+      "timeoutSeconds": 10+    },+    {+      "example": {},+      "input": {},+      "longRunning": false,+      "name": "fusion_aps_forget_browser",+      "output": {+        "cleared": "bool",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "Forget the remembered Autodesk sign-in browser (re-detect next time).",+      "timeoutSeconds": 10+    },+    {+      "example": {+        "limit": 10,+        "query": "Molecule"+      },+      "input": {+        "hubId": "optional str",+        "limit": "optional int (default 50)",+        "projectId": "optional str",+        "query": "required str"+      },+      "longRunning": false,+      "name": "fusion_aps_search",+      "output": {+        "count": "int",+        "results": "[{name,id,projectName,lastModified}]"+      },+      "statusVerb": null,+      "summary": "Server-indexed search across the whole team hub (seconds, not a 30-min folder walk).",+      "timeoutSeconds": 60+    },+    {+      "example": {+        "query": "BME690 Molecule"+      },+      "input": {+        "query": "required str",+        "wait": "optional bool"+      },+      "longRunning": true,+      "name": "fusion_aps_open",+      "output": {+        "match": "{name}",+        "opening": "bool",+        "statusVerb": "str"+      },+      "statusVerb": "fusion_get_app_state",+      "summary": "Find a cloud design by name and open it in Fusion (any folder depth). Fire-and-poll.",+      "timeoutSeconds": 60+    },+    {+      "example": {+        "urn": "urn:adsk.wipprod:fs.file:vf.xxxx?version=1"+      },+      "input": {+        "urn": "required str"+      },+      "longRunning": true,+      "name": "fusion_open_by_urn",+      "output": {+        "output": "str",+        "success": "bool"+      },+      "statusVerb": "fusion_get_app_state",+      "summary": "Open a cloud ELECTRONICS DESIGN by URN. PCB/ELECTRONICS NAV RULE: a board is NOT a standalone file - the schematic, 2D board and 3D board are VIEWS inside ONE electronics DESIGN. Open the DESIGN document first (fusion_open_cloud_file or fusion_open_by_urn), THEN switch to its schematic and its 2D board (fusion_show_2d_board) and 3D board (fusion_show_3d_board). A Select-Electronics-Design-File picker IS that design list of its schematic + board. An EMPTY 2D board usually means you opened a derivative or the wrong file, or it is out of sync - reopen the parent electronics DESIGN and switch to its board view; do NOT open a .brd or .sch as a standalone file.",+      "timeoutSeconds": 240+    },+    {+      "example": {},+      "input": {+        "folderId": "optional str",+        "hubId": "optional str",+        "projectId": "optional str"+      },+      "longRunning": false,+      "name": "fusion_aps_browse",+      "output": {+        "items": "[{name,type,id}]"+      },+      "statusVerb": null,+      "summary": "Browse hubs/projects/folders without launching Fusion.",+      "timeoutSeconds": 60+    },+    {+      "example": {+        "limit": 25+      },+      "input": {+        "limit": "optional int (default 25)"+      },+      "longRunning": false,+      "name": "fusion_aps_recent",+      "output": {+        "count": "int",+        "results": "[...]"+      },+      "statusVerb": null,+      "summary": "Most-recently-modified designs across the team hub, newest first.",+      "timeoutSeconds": 60+    },+    {+      "example": {+        "query": "BME690 Molecule"+      },+      "input": {+        "query": "str  OR  projectId+urn"+      },+      "longRunning": false,+      "name": "fusion_aps_file_info",+      "output": {+        "tip": "{...}",+        "versionCount": "int",+        "versions": "[...]"+      },+      "statusVerb": null,+      "summary": "Version history + who/when/size for a file (tip + recent versions).",+      "timeoutSeconds": 40+    },+    {+      "example": {+        "query": "BME690 Molecule"+      },+      "input": {+        "query": "str  OR  projectId+urn"+      },+      "longRunning": false,+      "name": "fusion_aps_versions",+      "output": {+        "versionCount": "int",+        "versions": "[...]"+      },+      "statusVerb": null,+      "summary": "Full (uncapped) version history of a file.",+      "timeoutSeconds": 40+    },+    {+      "example": {+        "query": "BME690 Molecule"+      },+      "input": {+        "fileName": "optional str",+        "query": "str OR projectId+urn",+        "saveDir": "optional str"+      },+      "longRunning": false,+      "name": "fusion_aps_download",+      "output": {+        "bytes": "int",+        "path": "str"+      },+      "statusVerb": null,+      "summary": "Download a cloud file to the local machine (no Fusion needed).",+      "timeoutSeconds": 90+    },+    {+      "example": {+        "folderId": "urn:...",+        "localPath": "C:/x.f3d",+        "projectId": "a.YnVz..."+      },+      "input": {+        "fileName": "optional str",+        "folderId": "required str (NON-ROOT subfolder)",+        "localPath": "required str",+        "projectId": "required str"+      },+      "longRunning": false,+      "name": "fusion_aps_upload",+      "output": {+        "bytes": "int",+        "itemUrn": "str"+      },+      "statusVerb": null,+      "summary": "Upload a local file as a NEW cloud file (free Data Management; needs data:write scope). \u26d4 FOLDER HYGIENE: NEVER pass a project ROOT folderId - the bridge REFUSES it (refused_root_upload). Loose files in a shared root clutter the team's cloud. Create/choose a real subfolder first (fusion_aps_create_folder under an 'Adom AI Workspace' folder), or just use fusion_make_3d_package / fusion_build_library_3d which auto-target a non-root workspace. To RELOCATE an existing file, MOVE it (preserves its urn) - do NOT delete + re-upload (mints a new urn, breaks 3D bindings). See the fusion-cloud-hygiene skill.",+      "timeoutSeconds": 90+    },+    {+      "example": {+        "name": "Adom AI Workspace",+        "parentFolderId": "urn:...",+        "projectId": "a.YnVz..."+      },+      "input": {+        "name": "required str",+        "parentFolderId": "required str",+        "projectId": "required str"+      },+      "longRunning": false,+      "name": "fusion_aps_create_folder",+      "output": {+        "folderId": "str"+      },+      "statusVerb": null,+      "summary": "Create a subfolder in a project (free; needs data:create scope). Use this to make an 'Adom AI Workspace' folder + per-task subfolders so the bridge never dumps loose files in the shared project root. See fusion-cloud-hygiene.",+      "timeoutSeconds": 50+    },+    {+      "example": {+        "path": "/project/v1/hubs"+      },+      "input": {+        "path": "required str"+      },+      "longRunning": false,+      "name": "fusion_aps_get",+      "output": {+        "body": "obj",+        "status": "int"+      },+      "statusVerb": null,+      "summary": "Raw authenticated GET against a free APS path (dev/verify helper).",+      "timeoutSeconds": 40+    },+    {+      "example": {},+      "input": {},+      "longRunning": false,+      "name": "fusion_walk_cloud_tree",+      "output": {+        "disabled": "bool"+      },+      "statusVerb": null,+      "summary": "\u26d4 DISABLED (returns an error): the in-app add-in walk took 30+ min and CRASHED Fusion (WinError 10054). It is hard-blocked in the bridge. Use fusion_aps_search / fusion_aps_open. See the 'fusion-aps-search' skill.",+      "timeoutSeconds": 15+    },+    {+      "example": {+        "query": "Molecule"+      },+      "input": {+        "query": "required str"+      },+      "longRunning": false,+      "name": "fusion_search_cloud_files",+      "output": {+        "disabled": "bool"+      },+      "statusVerb": null,+      "summary": "\u26d4 DISABLED (returns an error): the in-app add-in search took 30+ min and CRASHED Fusion (WinError 10054). It is hard-blocked in the bridge. Use fusion_aps_search {query} \u2014 server-indexed, seconds, no Fusion. See the 'fusion-aps-search' skill.",+      "timeoutSeconds": 15+    },+    {+      "example": {},+      "input": {+        "capture": "optional bool - ONE call = ONE consent: the bridge settles the surface (waits for the add-in main thread + a paint beat) and returns proof inline as shot:{title,image,thumbnailDataUrl,maxWidth} (base64 frame + a ready-to-use data: URL for BROWSER callers who cannot pull a file; set captureMaxWidth to shrink it - 320 keeps a /command body small, default 640. The bridge encodes PNG; the relay may transcode to WebP, so sniff rather than assume). Use this instead of polling fusion_state after a show - page-side settle polling costs one human consent per poll (issue #30)."+      },+      "longRunning": true,+      "name": "fusion_show_schematic",+      "output": {+        "activeWorkspace": "str",+        "productType": "str",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "Switch the OPEN electronics design to its SCHEMATIC view (the symmetric partner of fusion_show_2d_board / fusion_show_3d_board, via Fusion's SwitchSchDocCmd). A VIEW of the project, not a standalone file. Drive it for demos with fusion_electron_zoom / _pan / _select.",+      "timeoutSeconds": 70+    },+    {+      "example": {},+      "input": {+        "capture": "optional bool - ONE call = ONE consent: the bridge settles the surface (waits for the add-in main thread + a paint beat) and returns proof inline as shot:{title,image,thumbnailDataUrl,maxWidth} (base64 frame + a ready-to-use data: URL for BROWSER callers who cannot pull a file; set captureMaxWidth to shrink it - 320 keeps a /command body small, default 640. The bridge encodes PNG; the relay may transcode to WebP, so sniff rather than assume). Use this instead of polling fusion_state after a show - page-side settle polling costs one human consent per poll (issue #30)."+      },+      "longRunning": true,+      "name": "fusion_show_2d_board",+      "output": {+        "activeWorkspace": "str"+      },+      "statusVerb": null,+      "summary": "Switch the OPEN electronics design to its 2D PCB Editor (board layout) view. This is a VIEW of the project, not a file to open standalone - if the board is empty, you opened a child/derivative instead of the EcadDesignProductType PROJECT; reopen the project. Drive the view with fusion_electron_run WINDOW commands.",+      "timeoutSeconds": 70+    },+    {+      "example": {},+      "input": {+        "capture": "optional bool - ONE call = ONE consent: the bridge settles the surface (waits for the add-in main thread + a paint beat) and returns proof inline as shot:{title,image,thumbnailDataUrl,maxWidth} (base64 frame + a ready-to-use data: URL for BROWSER callers who cannot pull a file; set captureMaxWidth to shrink it - 320 keeps a /command body small, default 640. The bridge encodes PNG; the relay may transcode to WebP, so sniff rather than assume). Use this instead of polling fusion_state after a show - page-side settle polling costs one human consent per poll (issue #30)."+      },+      "longRunning": true,+      "name": "fusion_show_3d_board",+      "output": {+        "activeWorkspace": "str",+        "screenshots": "[...]"+      },+      "statusVerb": null,+      "summary": "Switch the OPEN electronics design to its 3D PCB view (populated board). A VIEW of the project, not a standalone file. Orbit it for demos via fusion_run_modeling_script (app.activeViewport.camera + vp.refresh()).",+      "timeoutSeconds": 70+    },+    {+      "example": {},+      "input": {},+      "longRunning": false,+      "name": "fusion_board_info",+      "output": {+        "rawXml": "str"+      },+      "statusVerb": null,+      "summary": "Raw board geometry XML (copper/arcs/lines) for the open board.",+      "timeoutSeconds": 60+    },+    {+      "example": {},+      "input": {+        "sinceSec": "optional float (default 300)"+      },+      "longRunning": false,+      "name": "fusion_alerts",+      "output": {+        "alerts": "[{at,text}]"+      },+      "statusVerb": null,+      "summary": "Fusion's OWN alert toasts, read from its log. Fusion draws error/warning toasts in CEF: they are invisible to Win32 enumeration AND to UIA, so a verb can look successful while Fusion is visibly complaining. This reads them, newest last.",+      "timeoutSeconds": 30+    },+    {+      "example": {+        "url": "https://library.io/"+      },+      "input": {+        "provider": "optional str google|password (default google)",+        "sessionId": "optional str (default autodesk-web)",+        "url": "required str (e.g. https://library.io/)",+        "username": "optional str (for the Google account chooser)"+      },+      "longRunning": true,+      "name": "fusion_web_signin",+      "output": {+        "errorCode": "str?",+        "steps": "[...]",+        "success": "bool",+        "url": "str"+      },+      "statusVerb": "fusion_get_app_state",+      "summary": "Sign a pup browser window into an Autodesk WEB surface (library.io, the hub portal at <hub>.autodesk360.com, Autodesk Account) via Google SSO. Fusion's DESKTOP app being signed in does NOT sign these in - they are separate web sessions. NEVER guesses a credential: a missing password or a 2FA challenge comes back as a typed stop (human_credential_required / second_factor_required / google_sso_unavailable) naming the one-time command the USER runs. The password never passes through this bridge or the AI - it is stored once with ab's credential_set and filled by pup in the background.",+      "timeoutSeconds": 240+    },+    {+      "example": {},+      "input": {+        "description": "optional str",+        "name": "optional str (defaults to the library's own name)"+      },+      "longRunning": true,+      "name": "fusion_managed_library_create",+      "output": {+        "alerts": "[...]",+        "library": "str",+        "success": "bool"+      },+      "statusVerb": "fusion_get_app_state",+      "summary": "Create a NEW managed library on library.io FROM the library in front (which must already be saved in a Fusion Hub). Drives MANAGE > LIBRARY.IO > Push, then completes Fusion's Create Managed Library dialog. PITFALL: a managed library created under one Autodesk account is NOT visible to another account until its managed FOLDER is shared on library.io - proven live, so do not assume hub membership shares it.",+      "timeoutSeconds": 240+    },+    {+      "example": {},+      "input": {+        "name": "optional str (exact library name from the picker; omit to list read-only)",+        "onUpdatePrompt": "optional str cancel|merge|replace (default cancel; replace OVERWRITES the local library)"+      },+      "longRunning": true,+      "name": "fusion_managed_library_link",+      "output": {+        "alerts": "[...]",+        "linkedTo": "str?",+        "listedOnly": "bool?",+        "managedLibraries": "[{name,type,version,managedFolder,description}]",+        "success": "bool",+        "updatePrompt": "obj?"+      },+      "statusVerb": "fusion_get_app_state",+      "summary": "Link the library IN FRONT to an existing managed library on library.io. With no name, opens Fusion's Select Managed Library picker, returns its rows as records (name/type/version/managedFolder/description) and CANCELS - a safe read-only listing of what this Autodesk account can reach. With name, selects that row and confirms. SAFETY: after linking, Fusion offers to force-update your library FROM the managed one; 'Replace Local Library' would destroy your parts, so this verb answers CANCEL by default - pass onUpdatePrompt to choose deliberately. A managed library owned by ANOTHER Autodesk account does NOT appear until its managed FOLDER is shared with this account on library.io; being in the same Fusion hub is not enough.",+      "timeoutSeconds": 180+    },+    {+      "example": {},+      "input": {},+      "longRunning": true,+      "name": "fusion_managed_library_unlink",+      "output": {+        "alerts": "[...]",+        "library": "str",+        "success": "bool"+      },+      "statusVerb": "fusion_get_app_state",+      "summary": "Unlink the library in front from its managed library on library.io. Fusion greys this out on a library that was never linked, so a silent no-op there is expected.",+      "timeoutSeconds": 180+    },+    {+      "example": {},+      "input": {+        "onConfirm": "optional str create|cancel (default create)"+      },+      "longRunning": true,+      "name": "fusion_managed_library_push",+      "output": {+        "alerts": "[...]",+        "confirmed": "obj",+        "library": "str",+        "success": "bool"+      },+      "statusVerb": "fusion_get_app_state",+      "summary": "Push a NEW VERSION of the library in front up to its linked managed library on library.io. Clicking the menu item alone does NOT push: Fusion raises a CEF 'Create New Version' confirmation and THAT is what creates the version, so this verb completes it and fails with confirm_missing rather than reporting a false pass. On a library that is not linked yet, Fusion offers Create Managed Library instead and this reports not_linked_yet - use fusion_managed_library_create. NOTE: Library Manager keeps showing the IMPORTED version number after a push, so the row gains an update-available badge instead of incrementing.",+      "timeoutSeconds": 240+    },+    {+      "example": {},+      "input": {+        "onUpdatePrompt": "optional str merge|replace|cancel (default merge)"+      },+      "longRunning": true,+      "name": "fusion_managed_library_pull",+      "output": {+        "alerts": "[...]",+        "library": "str",+        "success": "bool",+        "upToDate": "bool",+        "updatePrompt": "obj?"+      },+      "statusVerb": "fusion_get_app_state",+      "summary": "Pull the newest version FROM library.io into the linked library in front. A pull ends in ONE of two CEF dialogs and BOTH block the add-in until answered: the force-update prompt when content differs (answered MERGE by default, since pull is an explicit request for the managed content - pass onUpdatePrompt:'replace' to overwrite local parts entirely, or 'cancel' to back out), or 'Up to Date' when already current. If neither appears, nothing was pulled and this reports failure rather than a false pass - Fusion greys Pull out on a library that was never linked.",+      "timeoutSeconds": 240+    },+    {+      "example": {+        "tab": "private"+      },+      "input": {+        "tab": "optional str hub|public|private (default private)"+      },+      "longRunning": true,+      "name": "fusion_library_manager",+      "output": {+        "hwnd": "int",+        "libraries": "[str] (usually empty - see pitfall)",+        "success": "bool",+        "tab": "str",+        "tableReadable": "bool"+      },+      "statusVerb": "fusion_get_app_state",+      "summary": "Open Fusion's Library Manager and switch to one of its three tabs. Hub Libraries = libraries saved in the Fusion hub (what our bind chain produces, and what Autodesk recommends for sharing). Private Libraries = library.io managed libraries in folders THIS account belongs to. Public Libraries = library.io's public catalogue. PITFALL: the library TABLE is CEF-drawn and exposes NOTHING to UIA, so libraries[] is normally empty and that is not a failure - screenshot the returned hwnd to read the rows.",+      "timeoutSeconds": 240+    },+    {+      "example": {+        "filePath": "C:/Users/<user>/adom-lib/nRF54L15.lbr"+      },+      "input": {+        "filePath": "required str (.lbr WINDOWS path C:/...; stage from container first)",+        "symbolName": "optional str",+        "verify": "optional bool"+      },+      "longRunning": false,+      "name": "fusion_open_lbr",+      "output": {+        "postOpenScreenshot": "{savedTo}",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "Import an EAGLE .lbr library into Fusion's Electronics LIBRARY editor (Content Manager / Electronics Library workspace), not a PCB design. PITFALL: filePath MUST be a WINDOWS-local path (C:/...). The chip-fetcher/adom-lbr pipeline runs in the cloud container, and there is NO container-to-Windows push verb, so STAGE the .lbr onto Windows first (serve it on a proxied port + Invoke-WebRequest via shell_execute), then pass the C:/ path. PITFALL: an adom-lbr .lbr is 2D ONLY - symbol + footprint + a PLACEHOLDER 3D package; the real 3D chip is NOT attached (that needs a Fusion cloud URN). To attach the 3D, see the 'fusion-libraries' skill. Pass verify:true to round-trip-confirm Fusion parsed the deviceset, then check fusion_get_app_state (activeWorkspace 'Electronics Library').",+      "timeoutSeconds": 50+    },+    {+      "example": {+        "filePath": "C:/Users/<user>/adom-lib/ADS8588SIPM.fusion.lbr",+        "modelPath": "C:/Users/<user>/adom-lib/ADS8588SIPM.step",+        "packageName": "ADS8588SIPM"+      },+      "input": {+        "filePath": "required str (.lbr WINDOWS path C:/...)",+        "modelPath": "required str (.step WINDOWS path C:/...)",+        "packageName": "optional str"+      },+      "longRunning": true,+      "name": "fusion_attach_3d_package",+      "output": {+        "_hint": "the Save-dialog click + verify steps",+        "data": "{steps}",+        "savePending": "bool",+        "success": "bool"+      },+      "statusVerb": "fusion_get_app_state",+      "summary": "LOW-LEVEL primitive: attaches ONE model to ONE package. Prefer fusion_create_library with parts[]. Attach a real 3D chip model to a library package, end to end: opens the .lbr (library active), runs Electron.Create3DPackage to enter the Package3DEnvironment showing the footprint, imports the STEP + auto-orients it flat on the footprint, then executes Package3DStop (FINISH). This BINDS the 3D onto the deviceset (Content Manager shows the 3D nested under the package; the Packages 'Package' column flips Placeholder->part-name). ONE desktop-side step remains: Fusion pops a modal Save dialog (an OWNED popup) - the response _hint gives the exact desktop_ui_click to confirm it. AFTER: re-grab desktop_screenshot_window and check ownedPopupCount for errors; the 3D preview LAGS a beat before showing the real chip. Both paths (filePath/modelPath) are WINDOWS paths - stage from the container first.",+      "timeoutSeconds": 240+    },+    {+      "example": {},+      "input": {},+      "longRunning": true,+      "name": "fusion_install_fusion",+      "output": {+        "alreadyInstalled": "bool?",+        "installing": "bool",+        "mode": "globalinstall|per-user",+        "statusVerb": "str",+        "success": "bool"+      },+      "statusVerb": "fusion_get_app_state",+      "summary": "Install Fusion 360 FOR the user - downloads Autodesk's official Client Downloader and streams the free trial silently, with NO shell_execute and NO ab approval gate (runs inside the trusted bridge). Elevation-aware: --globalinstall when admin, PER-USER otherwise (a non-elevated globalinstall dies silently on UAC - learned live). Returns promptly; poll fusion_readiness (reports installing:true) until installed:true, then fusion_start. Declared as detect.installVerb so ab's bridge_readiness recommends it.",+      "timeoutSeconds": 90+    },+    {+      "example": {+        "etch": "103",+        "outputStep": "C:/tmp/ADOM-R0603-103.step",+        "params": {+          "A": 0.45,+          "D": 1.6,+          "E": 0.8,+          "L": 0.3,+          "L1": 0.3+        },+        "type": "chip"+      },+      "input": {+        "etch": "optional str (marking text on the chip top: MPN / '103'; multi-line with newline, e.g. MPN+variant - laid along the LONGEST face axis)",+        "etchDepthMm": "optional float (marking height/depth, default 0.03)",+        "etchHeightMm": "optional float (text height; default auto-fit: top-5%-band face, 10% margin, width-aware)",+        "etchStyle": "optional str raised|engraved (default raised = thin WHITE positive extrude, silkscreen-style contrast; engraved = sunken cut)",+        "outputStep": "optional str (WINDOWS path; exports STEP incl. the marking)",+        "params": "optional dict (generator dims in MM by default, e.g. chip: {D,E,A,L,L1}; soic: {A,A1,b,D,E,E1,e,L,DPins}; omitted keys use EPG defaults)",+        "type": "required str (EPG family, e.g. chip|soic|qfn|qfp|bga|sot23|dfn2|melf|ecap|crystal|header_straight - see supportedTypes in the error for the full list)",+        "unitsCm": "optional bool (params already EPG-native cm)"+      },+      "longRunning": true,+      "name": "fusion_generate_package",+      "output": {+        "bodies": "[{name,vol}]",+        "epgDir": "str",+        "etched": "str|null",+        "manifest": "obj (settings+why+bboxes; also written as <step>.manifest.json sidecar for marking refreshes)",+        "manifestPath": "str|null",+        "stepPath": "str|null",+        "success": "bool"+      },+      "statusVerb": "fusion_get_app_state",+      "summary": "Generate an IPC-7351-compliant parametric 3D package via Fusion's BUILT-IN ElectronicsPackageGenerator (EPG) - ~50 package families (chip/soic/qfn/qfp/bga/sot23/dfn/melf/ecap/crystal/headers/...), each a few seconds, ZERO GUI. Optionally LASER-ETCH a marking (MPN / '103') into the body top as REAL cut geometry (survives STEP), and export STEP in the same call - the royalty-free, license-clean path to a whole component library (our own generated output, not vendor models). Proven live: 0603 + '103' etch + STEP in ~2s.",+      "timeoutSeconds": 120+    },+    {+      "example": {+        "captureLabel": "R_4k7",+        "lbrPath": "C:/tmp/newlib/R_4k7.lbr",+        "modelPath": "C:/tmp/newlib/R_4k7.step"+      },+      "input": {+        "captureLabel": "optional str (capture before/after)",+        "fileName": "optional str",+        "folderId": "optional str (default upload folder)",+        "lbrPath": "required str (.lbr WINDOWS path; its FIRST package's footprint is loaded)",+        "modelPath": "required str (.step WINDOWS path)",+        "orient": "optional bool (default true)",+        "projectId": "optional str (default MAIN-project)"+      },+      "longRunning": true,+      "name": "fusion_make_3d_package",+      "output": {+        "after": "str|null",+        "before": "str|null",+        "dims_mm": "[x,y,z]",+        "f3d": "str",+        "success": "bool",+        "wip_urn": "str"+      },+      "statusVerb": "fusion_get_app_state",+      "summary": "Create a RENDERING component 3D package (FOOTPRINT + chip, aligned) for ONE part, fully programmatically with ZERO GUI dialogs. Opens the .lbr, runs Electron.Create3DPackage to load the package's footprint into a generator doc, imports the STEP onto it, orients it flat, saveAs an .f3d (skips the FINISH Save dialog + the two unbeatable 'Fusion360' CEF modals), uploads the f3d via APS, and returns an fs.file:vf wip_urn to hand-write into the library's <packages3d>. projectId/folderId default to the MAIN-project upload folder. Pass captureLabel to also get a BEFORE (footprint) + AFTER (chip placed) screenshot. PITFALL: a RAW STEP upload binds but renders NOTHING ('Thumbnail download failed') - this verb makes an f3d, which renders. Prefer fusion_build_library_3d for many parts.",+      "timeoutSeconds": 200+    },+    {+      "example": {+        "lbrPath": "C:/tmp/newlib/AdomBasicParts2.lbr",+        "parts": [+          {+            "lbrPath": "C:/tmp/newlib/R_4k7.lbr",+            "modelPath": "C:/tmp/newlib/R_4k7.step",+            "package": "R_4k7"+          }+        ]+      },+      "input": {+        "capture": "optional bool (default true)",+        "folderId": "optional str",+        "lbrPath": "required str (combined .lbr WINDOWS path to bind + open)",+        "openWhenDone": "optional bool (default true)",+        "outLbrPath": "optional str (default: overwrite lbrPath)",+        "parts": "required [{package, lbrPath (per-part footprint .lbr), modelPath (.step)}]",+        "projectId": "optional str"+      },+      "longRunning": true,+      "name": "fusion_build_library_3d",+      "output": {+        "boundLbr": "str",+        "opened": "bool",+        "parts": "[{package,success,wip_urn,dims_mm,error}]",+        "partsBound": "int",+        "partsTotal": "int",+        "screenshots": "[{package,stage,path}]",+        "success": "bool"+      },+      "statusVerb": "fusion_get_app_state",+      "summary": "Build a RENDERING multi-part 3D library in ONE call - the whole programmatic pipeline. For each part it makes the footprint+chip f3d package (no GUI dialogs, optional before/after screenshots) and collects the wip_urn, then injects ALL bindings into the combined .lbr in one pass (no hand XML surgery) and opens the finished library once. This is the verb for a basic-parts sampler / any many-part library; it replaces the per-part make_3d_package loop + manual binding. projectId/folderId default to the MAIN-project upload folder. Each part is independent, so re-run just the failed parts if Fusion resets mid-run.",+      "timeoutSeconds": 1800+    },+    {+      "example": {+        "packages": [+          "ESP32-S3FN8",+          "ATSAMD51J20A-AUT"+        ]+      },+      "input": {+        "packages": "required [<deviceset name>] (or 'package': single name)",+        "settle": "optional float secs after each EDIT before capture (default 1.5; raise if a shot shows the PREVIOUS part)",+        "views": "optional subset of ['symbol','footprint','3d','component'] (default ALL FOUR, in that assembly order - 3d is the dedicated full-size 3D-package render, component is the ganged view last)"+      },+      "longRunning": true,+      "name": "fusion_capture_library_views",+      "output": {+        "captured": "[{package,view,path,ok}]",+        "success": "bool"+      },+      "statusVerb": "fusion_get_app_state",+      "summary": "Capture the LIBRARY-EDITOR views EEs trust: the schematic SYMBOL (full pinout), the FOOTPRINT (pads + layer stack), and the COMPONENT/device view (Content Manager: symbol + the package table with the footprint<->package Mapped check + pin/pad counts). The 3D before/after shots don't show these. Requires the .lbr OPEN in the Electronics Library workspace (fusion_open_lbr first). Runs EDIT <pkg>.sym/.pac/.dev + WINDOW FIT + a background hwnd screenshot per view; returns the PNG paths on the box (C:/tmp/conduit-screenshots - pull with desktop_pull_file). EDIT uses the DEVICESET name (e.g. ESP32-S3FN8).",+      "timeoutSeconds": 300+    },+    {+      "example": {+        "fileIds": [+          "urn:adsk.wipprod:dm.lineage:abc123"+        ],+        "projectName": "Adom"+      },+      "input": {+        "fileIds": "required [<lineage urn>]",+        "folderPath": "optional str (default root - where the files live)",+        "projectName": "optional str (default active project)"+      },+      "longRunning": true,+      "name": "fusion_cleanup_cloud_files",+      "output": {+        "deletedCount": "int",+        "failed": "[{fileId,error}]",+        "failedCount": "int",+        "success": "bool"+      },+      "statusVerb": "fusion_get_app_state",+      "summary": "PRECISELY delete a list of cloud files by lineage urn - SAFE cleanup of AI-created clutter. Deletes ONLY the exact fileIds given (never name-guessing), so it can't touch a teammate's file in a shared folder. Loops server-side. Get the ids from fusion_aps_browse (item .id). Use this to remove f3d files the bridge created. A big list takes minutes (relay may time out at ~60s while deletes continue server-side - re-browse to confirm).",+      "timeoutSeconds": 1800+    },+    {+      "example": {+        "script": "import adsk.fusion\n# ...build geometry..."+      },+      "input": {+        "script": "required str (Python using adsk; globals: adsk, app, ui, design)"+      },+      "longRunning": true,+      "name": "fusion_run_modeling_script",+      "output": {+        "documentName": "str",+        "result": "obj"+      },+      "statusVerb": null,+      "summary": "Run an adsk.fusion modeling script in the live session (sketches/extrudes/params). Free programmatic CAD.",+      "timeoutSeconds": 180+    },+    {+      "example": {+        "includePhysicalProperties": true,+        "treatAsUnit": [+          "with fasteners"+        ]+      },+      "input": {+        "exclude": "optional [str] top-level name prefixes to skip",+        "includePhysicalProperties": "optional bool (adds volume_cm3/mass_kg per line)",+        "maxSeconds": "optional float (walk budget, default 20; the verb REFUSES fast with bom_walk_budget_exceeded + a fusion_export_bom redirect on electronics 3D PCBs instead of blocking Fusion for minutes - issue #659)",+        "outputPath": "optional str (Windows CSV path)",+        "treatAsUnit": "optional [str] name substrings counted as one unit (default ['with fasteners'])"+      },+      "longRunning": false,+      "name": "fusion_assembly_bom",+      "output": {+        "design": "str",+        "partCount": "int",+        "parts": "[{componentName, partNumber, description, material, quantity, bodies}]",+        "success": "bool",+        "totalInstances": "int"+      },+      "statusVerb": null,+      "summary": "Structured, kit-aware MECHANICAL bill of materials for the active Design assembly (the counterpart to the electronics-only fusion_export_bom). Recurses organizational subassemblies but counts a physical part or a purchased kit/unit ONCE, so hardware modeled inside a kit (a '... with fasteners' bracket, a bearing/pulley) is NOT double-counted the way a flat allOccurrences walk counts it. Matches Fusion's Manage -> BOM quantities. Optionally writes a CSV.",+      "timeoutSeconds": 120+    },+    {+      "example": {+        "accuracy": "low"+      },+      "input": {+        "accuracy": "optional low|medium|high|veryhigh (default low)",+        "names": "optional [str] component names to measure (default all)"+      },+      "longRunning": false,+      "name": "fusion_physical_properties",+      "output": {+        "count": "int",+        "properties": "{name: {volume_cm3, mass_kg, density, area_cm2, center_of_mass}}",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "Per-component physical properties (volume cm3, mass kg, density, area, center of mass) for the active design. Reads them directly so BOM/costing tools no longer have to run getPhysicalProperties inside a modeling script. Pass names to scope to specific components.",+      "timeoutSeconds": 120+    },+    {+      "example": {+        "theme": "dark"+      },+      "input": {+        "cameraPivot": "optional bool",+        "gestureNav": "optional bool",+        "invertScrollZoom": "optional bool",+        "lengthUnit": "optional str",+        "modelingOrientation": "optional str",+        "orbitScheme": "optional str",+        "theme": "optional str"+      },+      "longRunning": true,+      "name": "fusion_set_preference",+      "output": {+        "applied": "obj",+        "current": "obj"+      },+      "statusVerb": null,+      "summary": "Set Fusion appearance/navigation preferences in the LIVE session - applies immediately, NO restart. Keys: theme (light/darkblue/darkgray/classic/device/dark; some builds only ship LightGray/DarkBlue/Device, failures reported per-key), invertScrollZoom (bool - mouse scroll/zoom direction), orbitScheme (fusion360/alias/inventor/solidworks/tinkercad/powermill), modelingOrientation (yup/zup), gestureNav (bool), cameraPivot (bool), lengthUnit (mm/cm/m/in/ft - active design). Per-key outcome in `applied`, resulting state in `current`.",+      "timeoutSeconds": 30+    },+    {+      "example": {},+      "input": {},+      "longRunning": false,+      "name": "fusion_get_preferences",+      "output": {+        "current": "obj"+      },+      "statusVerb": null,+      "summary": "Read current Fusion appearance/navigation preferences (theme, activeTheme, invertScrollZoom, orbitScheme, modelingOrientation, gestureNav, cameraPivot, lengthUnit) as friendly values - the same keys fusion_set_preference accepts.",+      "timeoutSeconds": 20+    },+    {+      "example": {+        "outputPath": "C:/out/board.step"+      },+      "input": {+        "outputPath": "required str"+      },+      "longRunning": true,+      "name": "fusion_export_step",+      "output": {+        "fileSizeKB": "int",+        "format": "str"+      },+      "statusVerb": null,+      "summary": "Export the active design to STEP (needs the 3D view).",+      "timeoutSeconds": 300+    },+    {+      "example": {+        "filePath": "C:/Temp/part.step"+      },+      "input": {+        "filePath": "required str (WINDOWS path C:/...; stage from container first)"+      },+      "longRunning": true,+      "name": "fusion_import_step",+      "output": {+        "documentName": "str",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "Import a STEP/.stp (or other native-importable) file into a NEW Fusion design via the native import API. The open-electronics hints redirect .step here. (Was implemented but missing from this catalog until the verb suite's reverse-drift check caught it, 2026-08-14.)",+      "timeoutSeconds": 300+    },+    {+      "example": {+        "fileName": "BQ25792",+        "projectName": "Main"+      },+      "input": {+        "fileName": "required str",+        "folderPath": "optional str",+        "projectName": "optional str (defaults to active project)"+      },+      "longRunning": true,+      "name": "fusion_open_cloud_file",+      "output": {+        "documentName": "str",+        "success": "bool"+      },+      "statusVerb": "fusion_get_app_state",+      "summary": "Open a CLOUD file by name (the front door to every design flow). PCB/ELECTRONICS NAV RULE: open the electronics DESIGN document (EcadDesignProductType), never a child .brd/.sch/3D directly - then switch views with fusion_show_schematic / fusion_show_2d_board / fusion_show_3d_board. LONG-RUNNING: fire it, then poll fusion_get_app_state until activeDocument matches (cloud opens on electronics designs take 1-3 min). A crash-recovery modal can block the open - fusion_dismiss_blocking_dialogs.",+      "timeoutSeconds": 240+    },+    {+      "example": {+        "filePath": "C:/Temp/part.f3d"+      },+      "input": {+        "filePath": "required str (WINDOWS path)"+      },+      "longRunning": true,+      "name": "fusion_open_design",+      "output": {+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "Open a LOCAL design file (routes through the add-in import). Prefer cloud flows (fusion_open_cloud_file) for team designs; this is for local .f3d/.step style files.",+      "timeoutSeconds": 240+    },+    {+      "example": {+        "save": false+      },+      "input": {+        "name": "optional str (default: active document)",+        "save": "optional bool default false"+      },+      "longRunning": false,+      "name": "fusion_close_document",+      "output": {+        "closed": "str",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "Close ONE document WITHOUT the modal save dialog (save:false discards silently - the automation-safe close). Omit name to close the active document.",+      "timeoutSeconds": 60+    },+    {+      "example": {+        "closeUntitled": true+      },+      "input": {+        "closeUntitled": "optional bool default false - also close UNMODIFIED Untitled scratch docs",+        "force": "optional bool default false - with closeUntitled, also discard MODIFIED Untitled docs",+        "save": "optional bool default false"+      },+      "longRunning": false,+      "name": "fusion_close_all_documents",+      "output": {+        "closed": "[str]",+        "success": "bool",+        "wouldPrompt": "[str]|null"+      },+      "statusVerb": null,+      "summary": "Close ALL open documents without save dialogs. DESTRUCTIVE to unsaved user work - confirm with the human before calling on a box you do not own. By default it SKIPS scratch 'Untitled' docs; pass closeUntitled:true to close the UNMODIFIED ones too (page issue #59: the library/bind flow left ~5 per import, 16 after three, and no caller could clear them), and force:true to also discard MODIFIED Untitled docs, which may hold real unsaved work.",+      "timeoutSeconds": 60+    },+    {+      "example": {},+      "input": {+        "force": "optional bool default false - also discard MODIFIED Untitled docs"+      },+      "longRunning": false,+      "name": "fusion_reset_workspace",+      "output": {+        "closedByAddin": "list",+        "remaining": "list",+        "success": "bool",+        "untitledScratchClosed": "int"+      },+      "statusVerb": null,+      "summary": "Bring Fusion back to a clean slate between runs: closes named documents AND the Untitled scratch the library/bind flow leaves behind (page issue #59). Fusion always keeps ONE blank document alive, so a single remaining Untitled is correct rather than a failure. MODIFIED Untitled docs are left untouched unless force:true, because those can hold real unsaved work.",+      "timeoutSeconds": 90+    },+    {+      "example": {},+      "input": {},+      "longRunning": false,+      "name": "fusion_document_info",+      "output": {+        "isSaved": "bool",+        "name": "str",+        "productType": "str",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "Metadata for the ACTIVE document: name, product type, save state, version, parent project.",+      "timeoutSeconds": 30+    },+    {+      "example": {+        "command": "Electron.ImmediateRepaint /full"+      },+      "input": {+        "command": "required str",+        "expectDocument": "optional str (refuses wrong_document if the active doc does not match)"+      },+      "longRunning": false,+      "name": "fusion_execute_text_command",+      "output": {+        "output": "str",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "Run a raw Fusion TEXT COMMAND (app.executeTextCommand) - the escape hatch to Fusion internals (Electron.* electronics commands included). Electron.* commands need an ELECTRONICS document context (schematic/board view active). Guard risky calls with expectDocument.",+      "timeoutSeconds": 60+    },+    {+      "example": {},+      "input": {},+      "longRunning": false,+      "name": "fusion_get_design_info",+      "output": {+        "bodies": "int",+        "components": "int",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "Design-level summary of the active design: components, bodies, sketches, units, root name.",+      "timeoutSeconds": 60+    },+    {+      "example": {},+      "input": {},+      "longRunning": false,+      "name": "fusion_get_parameters",+      "output": {+        "parameters": "list",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "All user + model parameters of the active design (name, expression, value, unit).",+      "timeoutSeconds": 60+    },+    {+      "example": {},+      "input": {},+      "longRunning": true,+      "name": "fusion_list_cloud_projects",+      "output": {+        "projects": "list",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "List the cloud PROJECTS visible to the signed-in Fusion session (hub walk - slow on big teams; prefer fusion_aps_search for finding files).",+      "timeoutSeconds": 120+    },+    {+      "example": {+        "projectName": "Main"+      },+      "input": {+        "folderPath": "optional str",+        "projectName": "optional str (defaults to active project)"+      },+      "longRunning": true,+      "name": "fusion_list_cloud_files",+      "output": {+        "files": "list",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "List files/folders in a cloud project (optionally a subfolder).",+      "timeoutSeconds": 120+    },+    {+      "example": {+        "outputPath": "C:/out/design.f3d"+      },+      "input": {+        "outputPath": "required str"+      },+      "longRunning": true,+      "name": "fusion_export_f3d",+      "output": {+        "format": "str"+      },+      "statusVerb": null,+      "summary": "Export the active design as a Fusion archive (.f3d).",+      "timeoutSeconds": 300+    },+    {+      "example": {+        "outputPath": "C:/out/part.fbx"+      },+      "input": {+        "outputPath": "required str"+      },+      "longRunning": true,+      "name": "fusion_export_fbx",+      "output": {+        "format": "str"+      },+      "statusVerb": null,+      "summary": "Export to FBX mesh.",+      "timeoutSeconds": 300+    },+    {+      "example": {+        "outputPath": "C:/out/part.sat"+      },+      "input": {+        "outputPath": "required str"+      },+      "longRunning": true,+      "name": "fusion_export_sat",+      "output": {+        "format": "str"+      },+      "statusVerb": null,+      "summary": "Export to SAT (ACIS solid).",+      "timeoutSeconds": 300+    },+    {+      "example": {+        "outputPath": "C:/out/part.skp"+      },+      "input": {+        "outputPath": "required str"+      },+      "longRunning": true,+      "name": "fusion_export_skp",+      "output": {+        "format": "str"+      },+      "statusVerb": null,+      "summary": "Export to SketchUp (.skp).",+      "timeoutSeconds": 300+    },+    {+      "example": {+        "libraryPath": "C:/Temp/lib.lbr",+        "name": "ADS8588SIPM"+      },+      "input": {+        "capture": "optional bool - ONE call = ONE consent: the bridge settles the surface (waits for the add-in main thread + a paint beat) and returns proof inline as shot:{title,image,thumbnailDataUrl,maxWidth} (base64 frame + a ready-to-use data: URL for BROWSER callers who cannot pull a file; set captureMaxWidth to shrink it - 320 keeps a /command body small, default 640. The bridge encodes PNG; the relay may transcode to WebP, so sniff rather than assume). Use this instead of polling fusion_state after a show - page-side settle polling costs one human consent per poll (issue #30).",+        "foreground": "optional bool - DEFAULT IS BACKGROUND (no focus steal; response carries windowEtiquette:background). true REQUIRES foregroundReason and shows it to the user as a 3s ab caption before any focus change - only when the USER asked to watch",+        "foregroundReason": "required WITH foreground:true - a short user-facing sentence shown as the 3s caption (e.g. 'You asked to watch the 3D board build')",+        "libraryPath": "optional str (WINDOWS path .lbr)",+        "name": "str (deviceset/symbol name; optional if symbolXml carries name=)",+        "symbolXml": "optional str (bare <symbol ...>...</symbol>)"+      },+      "longRunning": true,+      "name": "fusion_show_symbol",+      "output": {+        "screenshot": "str path",+        "success": "bool",+        "view": "str",+        "wrappedLibrary": "str (when wrapped)"+      },+      "statusVerb": null,+      "summary": "Open a schematic SYMBOL in Fusion's library editor - first-class, no hand-built EDIT strings. Pass name + libraryPath (.lbr, opened first; omit libraryPath if a library is already open), OR pass a BARE <symbol> XML fragment as symbolXml and the bridge generates a minimal wrapper library around it (deviceset + gate synthesized) so it shows in the Library Manager. Background-safe: never steals the foreground.",+      "timeoutSeconds": 180+    },+    {+      "example": {+        "libraryPath": "C:/Temp/lib.lbr",+        "name": "ADS8588SIPM"+      },+      "input": {+        "capture": "optional bool - ONE call = ONE consent: the bridge settles the surface (waits for the add-in main thread + a paint beat) and returns proof inline as shot:{title,image,thumbnailDataUrl,maxWidth} (base64 frame + a ready-to-use data: URL for BROWSER callers who cannot pull a file; set captureMaxWidth to shrink it - 320 keeps a /command body small, default 640. The bridge encodes PNG; the relay may transcode to WebP, so sniff rather than assume). Use this instead of polling fusion_state after a show - page-side settle polling costs one human consent per poll (issue #30).",+        "foreground": "optional bool - DEFAULT IS BACKGROUND (no focus steal; response carries windowEtiquette:background). true REQUIRES foregroundReason and shows it to the user as a 3s ab caption before any focus change - only when the USER asked to watch",+        "foregroundReason": "required WITH foreground:true - a short user-facing sentence shown as the 3s caption (e.g. 'You asked to watch the 3D board build')",+        "libraryPath": "optional str",+        "name": "str",+        "packageXml": "optional str (bare <package ...>...</package>)"+      },+      "longRunning": true,+      "name": "fusion_show_footprint",+      "output": {+        "screenshot": "str path",+        "success": "bool",+        "view": "str",+        "wrappedLibrary": "str (when wrapped)"+      },+      "statusVerb": null,+      "summary": "Open a FOOTPRINT (package) in Fusion's library editor. Same contract as fusion_show_symbol: name + libraryPath, or a bare <package> fragment as packageXml (wrapper library generated).",+      "timeoutSeconds": 180+    },+    {+      "example": {+        "name": "MYCHIP",+        "stepPath": "C:/Temp/chip.step"+      },+      "input": {+        "capture": "optional bool - ONE call = ONE consent: the bridge settles the surface (waits for the add-in main thread + a paint beat) and returns proof inline as shot:{title,image,thumbnailDataUrl,maxWidth} (base64 frame + a ready-to-use data: URL for BROWSER callers who cannot pull a file; set captureMaxWidth to shrink it - 320 keeps a /command body small, default 640. The bridge encodes PNG; the relay may transcode to WebP, so sniff rather than assume). Use this instead of polling fusion_state after a show - page-side settle polling costs one human consent per poll (issue #30).",+        "foreground": "optional bool - DEFAULT IS BACKGROUND (no focus steal; response carries windowEtiquette:background). true REQUIRES foregroundReason and shows it to the user as a 3s ab caption before any focus change - only when the USER asked to watch",+        "foregroundReason": "required WITH foreground:true - a short user-facing sentence shown as the 3s caption (e.g. 'You asked to watch the 3D board build')",+        "libraryPath": "optional str (.lbr)",+        "name": "str",+        "packageXml": "optional str (bare <package> fragment)",+        "stepPath": "optional str (WINDOWS path .step to attach)"+      },+      "longRunning": true,+      "name": "fusion_show_3d_package",+      "output": {+        "screenshot": "str path",+        "success": "bool",+        "view": "str",+        "wrappedLibrary": "str"+      },+      "statusVerb": null,+      "summary": "Open the 3D CHIP view (Package3DEnvironment) for a library package - and the RELIABLE way to get a 3D model into a library: pass stepPath and it is attached AFTER the library opens (embedded <packages3d> in hand-built .lbr files is the Fusion quirk that fails; attach-after-open works). stepPath with no library/packageXml auto-generates a minimal 2-pad carrier footprint. Without stepPath it just enters the 3D view of the named package.",+      "timeoutSeconds": 300+    },+    {+      "example": {+        "demoId": "tour-abc123",+        "imagesAs": "base64",+        "sinceShot": 3+      },+      "input": {+        "demoId": "required str (from fusion_demo mode:tour; omitted = the single running tour)",+        "imagesAs": "optional str paths|base64|both",+        "sinceShot": "optional int - shots you already received; response windows to the new ones"+      },+      "longRunning": false,+      "name": "fusion_demo_progress",+      "output": {+        "done": "bool",+        "percent": "int",+        "shotCount": "int",+        "shots": "list",+        "step": "str",+        "stepLabel": "str",+        "stepShot": "dict|absent"+      },+      "statusVerb": null,+      "summary": "Poll a running fusion_demo tour: {percent, elapsedSec, estimatedSec, step, stepLabel, done, failed, shots, shotCount, stepShot}. Poll ~1-2.5s and render a REAL progress bar. LIVE EVIDENCE (issue #30): each frame MAY carry stepShot {step, title, image} - a ~640px base64 capture the BRIDGE took at that step's completion, one per step, riding the first frame after it completes (render these during the run; the page should not guess-snap). shots[] streams too: mid-run it carries paths for every completed step; pass imagesAs:base64 + sinceShot:<count you have> to receive only NEW shots fully encoded. done:true = the full gallery (base64 by default). Finished tours are DISK-SNAPSHOTTED, so the final frame stays pollable even across a bridge respawn.",+      "timeoutSeconds": 15+    },+    {+      "example": {+        "libraryPath": "C:/Temp/IN-S42ATR.lbr"+      },+      "input": {+        "device": "optional str: the DEVICE (package variant) to place, e.g. \"-HV\" (default: the deviceset's first device)",+        "deviceset": "optional str (defaults to the library's first deviceset)",+        "libraryPath": "required str (WINDOWS path .lbr; stage from container first)"+      },+      "longRunning": true,+      "name": "fusion_make_test_project",+      "output": {+        "brdPath": "str",+        "circuit": "str",+        "schPath": "str",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "Create a NEW electronics test project FROM SCRATCH around a library part - the Web Control demo's PROJECT button, and the answer to 'a customer only has a component page'. Generates a minimal test circuit server-side (the part + a generated 330R series resistor with VCC/GND stubs on a small board) as real EAGLE .sch/.brd, then imports the pair as a new electronics design. NO cloud, NO sign-in, no pre-existing content. After it, fusion_show_schematic / fusion_show_2d_board / fusion_show_3d_board all work on the result. Wiring uses the deviceset's own connects (first two pins), so 2-terminal parts get a real circuit and big ICs get a structurally-valid integration proof.",+      "timeoutSeconds": 300+    },+    {+      "example": {},+      "input": {+        "hwnd": "optional int (a dialog; default the main window)"+      },+      "longRunning": false,+      "name": "fusion_screenshot_fusion",+      "output": {+        "savedTo": "str",+        "sizeKB": "int",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "Background PrintWindow capture of Fusion's MAIN window (largest same-title window; works occluded/bottom-of-z-order, never raises anything) or a specific dialog by hwnd. Returns savedTo (PNG/WebP on the box; pull with pull_file). (Live since early versions but undescribed until 2026-08-15 - it was invisible to callers AND to the drift check.)",+      "timeoutSeconds": 60+    },+    {+      "example": {+        "libraryPath": "C:/Temp/PART.lbr",+        "stepPath": "C:/Temp/PART.step"+      },+      "input": {+        "deviceset": "optional str (defaults to the library's first)",+        "libraryPath": "required str (WINDOWS .lbr path)",+        "stepPath": "required str (WINDOWS .step path)"+      },+      "longRunning": true,+      "name": "fusion_bind_library_3d",+      "output": {+        "bound": "bool",+        "reopened": "bool",+        "success": "bool",+        "wip_urn": "str"+      },+      "statusVerb": null,+      "summary": "LOW-LEVEL primitive: binds ONE STEP onto one deviceset. Prefer fusion_create_library with parts[] (which handles one part or many through a single path); reach for this only when you are driving a single bind deliberately. The CORRECT library in ONE call (the Library button's real bar: the 3D chip renders in the Content Manager preview): mints the part's 3D as a cloud f3d (make_3d_package), injects the wip_urn binding into the .lbr ON DISK (packages3d + package3dinstances), and reopens the library. Needs a signed-in Fusion session - the one cloud-dependent step in the wiki-to-EE circle. Autodesk's thumbnail preview lags ~2-3 min behind a fresh mint. NOTE: distinct from the older fusion_build_library_3d (multi-part batch pipeline).",+      "timeoutSeconds": 480+    },+    {+      "example": {+        "libraryPath": "C:/Temp/PART.lbr"+      },+      "input": {+        "capture": "optional bool - ONE call = ONE consent: the bridge settles the surface (waits for the add-in main thread + a paint beat) and returns proof inline as shot:{title,image,thumbnailDataUrl,maxWidth} (base64 frame + a ready-to-use data: URL for BROWSER callers who cannot pull a file; set captureMaxWidth to shrink it - 320 keeps a /command body small, default 640. The bridge encodes PNG; the relay may transcode to WebP, so sniff rather than assume). Use this instead of polling fusion_state after a show - page-side settle polling costs one human consent per poll (issue #30).",+        "libraryPath": "optional str (WINDOWS .lbr)",+        "name": "optional str (already-open library name)"+      },+      "longRunning": true,+      "name": "fusion_show_library",+      "output": {+        "screenshot": "str",+        "success": "bool",+        "view": "str"+      },+      "statusVerb": null,+      "summary": "Eight-surfaces contract: the LIBRARY surface. libraryPath (WINDOWS .lbr) opens it; name alone handles the already-open case (symmetric with kicad_show_library). Background; returns a screenshot path.",+      "timeoutSeconds": 240+    },+    {+      "example": {+        "query": "BQ25792"+      },+      "input": {+        "capture": "optional bool - ONE call = ONE consent: the bridge settles the surface (waits for the add-in main thread + a paint beat) and returns proof inline as shot:{title,image,thumbnailDataUrl,maxWidth} (base64 frame + a ready-to-use data: URL for BROWSER callers who cannot pull a file; set captureMaxWidth to shrink it - 320 keeps a /command body small, default 640. The bridge encodes PNG; the relay may transcode to WebP, so sniff rather than assume). Use this instead of polling fusion_state after a show - page-side settle polling costs one human consent per poll (issue #30).",+        "fileName": "alias of query",+        "query": "optional str (cloud design name)",+        "urn": "optional str"+      },+      "longRunning": true,+      "name": "fusion_show_project",+      "output": {+        "document": "str",+        "screenshot": "str",+        "success": "bool",+        "view": "str"+      },+      "statusVerb": "fusion_get_app_state",+      "summary": "Eight-surfaces contract: bring the PROJECT/design to its top level. No args = activate this session's generated test project (fusion_make_test_project). query = cloud design name (already-open match wins, else fire-and-poll open). urn = open_by_urn passthrough. Background; returns a screenshot path.",+      "timeoutSeconds": 240+    },+    {+      "example": {},+      "input": {+        "enabled": "optional bool (omit to read)"+      },+      "longRunning": false,+      "name": "fusion_set_window_sizing",+      "output": {+        "sizeFusionWindow": "bool",+        "success": "bool"+      },+      "statusVerb": "fusion_state",+      "summary": "Read/toggle auto-sizing Fusion's WINDOW after launch (STICKY, default ON). Fusion opens at whatever geometry it last had, which after an automated launch is often a small default; the bridge grows it to ~92% of the monitor work area, centered, using SetWindowPos with NOACTIVATE (never ShowWindow/maximize) so focus is never stolen. A window the user maximized, or already sized to >=60% of the work area, is left alone. No args = read.",+      "timeoutSeconds": 15+    },+    {+      "example": {},+      "input": {+        "enabled": "optional bool (omit to read)"+      },+      "longRunning": false,+      "name": "fusion_set_driving_badge",+      "output": {+        "showDrivingBadge": "bool",+        "success": "bool"+      },+      "statusVerb": "fusion_state",+      "summary": "Read/toggle the 'Adom is driving Fusion' TASKBAR OVERLAY BADGE (STICKY per user, default ON). While the bridge drives Fusion, its Windows taskbar button wears a small Adom mark so the user knows at a glance who is in control; it sheds automatically after 5 minutes of driving-verb idle. No args = read. Turning it off clears any badge immediately.",+      "timeoutSeconds": 15+    },+    {+      "example": {},+      "input": {+        "enabled": "optional bool (omit to read)"+      },+      "longRunning": false,+      "name": "fusion_set_seat_takeover",+      "output": {+        "autoTakeOverSeat": "bool",+        "success": "bool"+      },+      "statusVerb": "fusion_readiness",+      "summary": "Read/toggle the mid-session Autodesk seat-takeover sweep (STICKY per user, default ON). When Autodesk pops 'Active Sessions Exceeded' mid-session, the bridge clicks Continue through BOTH dialogs in the background: this machine takes the seat, the other machine's Fusion suspends RESUMABLY, the user gets one toast. No args = read current value. Gates only the passive sweep - a verb-driven fusion_start still grabs the seat (the user asked for Fusion, so the seat is implied).",+      "timeoutSeconds": 15+    },+    {+      "example": {},+      "input": {+        "imageAs": "optional str path|base64 (default path)",+        "screenshot": "optional bool (default true)"+      },+      "longRunning": false,+      "name": "fusion_state",+      "output": {+        "activeDocument": "str",+        "blockingDialogs": "list",+        "focusEvents": "list - the QUIETNESS AUDIT LOG (SDK canonical): every time this bridge took the user's foreground, or refused a bare foreground:true, as {at, verb, outcome: foreground|refused, reason}. Audit how quiet the bridge actually was instead of trusting that it was.",+        "mainThreadBusy": "dict|null",+        "running": "bool",+        "screenshot": "str path",+        "screenshotBase64": "str (imageAs:base64 only)",+        "success": "bool",+        "timings": "dict - measured launch history on THIS machine (p50/p90 per phase, cold vs warm)"+      },+      "statusVerb": null,+      "summary": "The RENDER-ME verb (kicad_state parity, issues #28/#30): running + window + dialog + busy state PLUS a fresh background screenshot of whatever Fusion is showing - the one verb that makes every background fusion_show_* result visible. SERVER-SIDE ONLY by design: it answers even while the add-in main thread is busy or wedged (activeDocument is best-effort with a short budget and skipped when busy). blockingDialogs carries the CLASSIFIED modal list (cause + resolution). imageAs:base64 inlines the PNG (auto-refused over 4MB - pull the screenshot path via pull_file instead).",+      "timeoutSeconds": 60+    },+    {+      "example": {+        "outputPath": "C:/out/board.iges"+      },+      "input": {+        "outputPath": "required str"+      },+      "longRunning": true,+      "name": "fusion_export_iges",+      "output": {+        "format": "str"+      },+      "statusVerb": null,+      "summary": "Export to IGES.",+      "timeoutSeconds": 300+    },+    {+      "example": {+        "outputPath": "C:/out/part.stl"+      },+      "input": {+        "outputPath": "required str"+      },+      "longRunning": true,+      "name": "fusion_export_stl",+      "output": {+        "format": "str"+      },+      "statusVerb": null,+      "summary": "Export to STL mesh.",+      "timeoutSeconds": 300+    },+    {+      "example": {+        "outputPath": "C:/out/part.3mf"+      },+      "input": {+        "outputPath": "required str"+      },+      "longRunning": true,+      "name": "fusion_export_3mf",+      "output": {+        "format": "str"+      },+      "statusVerb": null,+      "summary": "Export to 3MF mesh.",+      "timeoutSeconds": 300+    },+    {+      "example": {+        "outputPath": "C:/out/part.usdz"+      },+      "input": {+        "outputPath": "required str"+      },+      "longRunning": true,+      "name": "fusion_export_usdz",+      "output": {+        "format": "str"+      },+      "statusVerb": null,+      "summary": "Export to USDZ (AR / Hydrogen 3D).",+      "timeoutSeconds": 300+    },+    {+      "example": {+        "outputPath": "C:/out/board.glb"+      },+      "input": {+        "async": "bool - RECOMMENDED true: fires the whole export+optimize pipeline in the background and returns {exportId} instantly (the sync form can outlive the relay window on a cold Fusion session); poll fusion_fetch_optimized_glb {exportId}",+        "outputPath": "required str (.glb)",+        "pin": "str medium|large default medium",+        "silkscreen": "bool default true",+        "wait": "int seconds default 15 (keep under the ~60s relay timeout; re-call fetch until complete)"+      },+      "longRunning": true,+      "name": "fusion_export_optimized_glb",+      "output": {+        "glbPath": "str",+        "jobId": "str",+        "meshesAfter": "int",+        "moleculeAnchored": "bool",+        "pending": "bool",+        "silkscreenApplied": "bool",+        "sizeBytes": "int"+      },+      "statusVerb": null,+      "summary": "Fusion board -> wiki-grade optimized GLB. Exports STEP (+ optional silkscreen) and submits it to service-step2glb molecule mode (anchor to MP pins + silk bake + gold pins + join/weld/prune + Draco): ~465KB/~31 draw calls vs a raw ~16MB/~25000 that halts the viewer. Bounded-waits `wait`s (default 90); small boards return complete, big boards return {pending, jobId} - finish with fusion_fetch_optimized_glb. Use for a component page's component.parts.model_3d. STACKUP RULE (John 2026-07-15, see pcb-stackup skill): board bbox = the FR4 body, NEVER the whole assembly (components overhang edges + tower above); each overlay goes at ITS layer's z (copper at FR4-top, silk above mask); copper traces are REAL 35um 3D bodies colored like the FR4 - recolor them + translucent mask in the RAW GLB before optimizing to make routing visible; put the measured stackup table on the board's wiki page. PUBLISH EVERYTHING: a board's wiki page repo must carry EVERY exportable design file (.f3d/.step/.usdz/EAGLE .brd+.sch/Fusion .fbrd+.fsch/gerbers/BOM/CPL/GLBs/renders), not just the 3D - the page exists to share the design.",+      "timeoutSeconds": 200+    },+    {+      "example": {+        "jobId": "abc123",+        "outputPath": "C:/out/board.glb"+      },+      "input": {+        "exportId": "str (async form from export_optimized_glb async:true - returns {phase, done, glbPath} instantly per poll)",+        "jobId": "str (service job form)",+        "outputPath": "str (.glb)",+        "wait": "int seconds default 15 (keep under the ~60s relay timeout; re-call fetch until complete)"+      },+      "longRunning": false,+      "name": "fusion_fetch_optimized_glb",+      "output": {+        "glbPath": "str",+        "pending": "bool",+        "sizeBytes": "int",+        "status": "str"+      },+      "statusVerb": null,+      "summary": "Finish a fusion_export_optimized_glb job: bounded-poll the optimizer by jobId and write the GLB to outputPath when complete. Re-call until status=complete (big boards tessellate a few minutes). No Fusion needed.",+      "timeoutSeconds": 150+    },+    {+      "example": {},+      "input": {},+      "longRunning": true,+      "name": "fusion_board_stackup",+      "output": {+        "copperCount": "int",+        "copperLayers": "list",+        "copperThickness_mm": "list",+        "dielectricBonds": "list (prepreg/core order)",+        "fr4": "{x_mm,y_mm,dielectric_mm}",+        "layerSetup": "str"+      },+      "statusVerb": null,+      "summary": "Read a board's PHYSICAL fabrication stackup (see the pcb-stackup skill): copper layer count + copper/dielectric thicknesses from the EAGLE design rules (layerSetup/mtCopper/mtIsolate) plus the measured FR4 extent. A PCB is Cu/prepreg/Cu/core/.../Cu - the FR4 is NOT one slab. Use to build the stackup table + real-thickness exploded 3D view, and put a stackup table on every exported board's wiki page.",+      "timeoutSeconds": 200+    },+    {+      "example": {+        "outputPath": "C:/out/part.obj"+      },+      "input": {+        "outputPath": "required str"+      },+      "longRunning": true,+      "name": "fusion_export_obj",+      "output": {+        "format": "str"+      },+      "statusVerb": null,+      "summary": "Export to OBJ mesh.",+      "timeoutSeconds": 300+    },+    {+      "example": {+        "outputPath": "C:/out/sketch.dxf"+      },+      "input": {+        "outputPath": "required str"+      },+      "longRunning": true,+      "name": "fusion_export_dxf",+      "output": {+        "format": "str"+      },+      "statusVerb": null,+      "summary": "Export 2D DXF.",+      "timeoutSeconds": 120+    },+    {+      "example": {+        "outputPath": "C:/out/sketch.dwg"+      },+      "input": {+        "outputPath": "required str"+      },+      "longRunning": true,+      "name": "fusion_export_dwg",+      "output": {+        "format": "str"+      },+      "statusVerb": null,+      "summary": "Export 2D DWG.",+      "timeoutSeconds": 120+    },+    {+      "example": {+        "outputDir": "C:/tmp/jlc"+      },+      "input": {+        "outputDir": "optional str (default C:/tmp/adom-gerbers)"+      },+      "longRunning": true,+      "name": "fusion_export_gerbers",+      "output": {+        "fileCount": "int",+        "files": "[{name,size}]",+        "zipPath": "str"+      },+      "statusVerb": null,+      "summary": "Run the bundled JLCPCB CAM job (auto 2/4-layer) to produce the gerber + drill ZIP.",+      "timeoutSeconds": 180+    },+    {+      "example": {+        "outputPath": "C:/tmp/bom.csv"+      },+      "input": {+        "grouped": "optional bool (default true)",+        "outputPath": "optional str"+      },+      "longRunning": false,+      "name": "fusion_export_bom",+      "output": {+        "componentCount": "int",+        "grouped": "bool"+      },+      "statusVerb": null,+      "summary": "Export a Bill of Materials CSV (grouped by value+package) from the open board.",+      "timeoutSeconds": 60+    },+    {+      "example": {+        "outputPath": "C:/tmp/cpl.csv"+      },+      "input": {+        "outputPath": "optional str",+        "side": "optional str (all|top|bottom)"+      },+      "longRunning": false,+      "name": "fusion_export_cpl",+      "output": {+        "bottomCount": "int",+        "topCount": "int"+      },+      "statusVerb": null,+      "summary": "Export the Component Placement List (pick-and-place) CSV.",+      "timeoutSeconds": 60+    },+    {+      "example": {+        "action": "apply",+        "layers": "2"+      },+      "input": {+        "action": "optional str (apply|export|show)",+        "layers": "optional str (auto|2|4)"+      },+      "longRunning": false,+      "name": "fusion_set_design_rules",+      "output": {+        "activeWorkspace": "str",+        "description": "str"+      },+      "statusVerb": null,+      "summary": "Load manufacturing-grade DRC into the open board (JLCPCB 2/4-layer profiles).",+      "timeoutSeconds": 90+    },+    {+      "example": {},+      "input": {},+      "longRunning": false,+      "name": "fusion_detect_layers",+      "output": {+        "copperLayers": "[int]",+        "layerCount": "int"+      },+      "statusVerb": null,+      "summary": "Detect 2-layer vs 4-layer board (ULP + CAM comparison).",+      "timeoutSeconds": 90+    },+    {+      "example": {},+      "input": {},+      "longRunning": false,+      "name": "fusion_dismiss_blocking_dialogs",+      "output": {+        "dialogs": "[...]"+      },+      "statusVerb": null,+      "summary": "Detect + classify (and optionally dismiss) blocking Fusion dialogs.",+      "timeoutSeconds": 30+    },+    {+      "example": {+        "command": "set confirm yes;RUN 'C:/tmp/jlcpcb_smta_exporter.ulp' 'C:/tmp/jlc'"+      },+      "input": {+        "command": "required str"+      },+      "longRunning": false,+      "name": "fusion_electron_run",+      "output": {+        "output": "str",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "Run an EAGLE/Electron command in the open board (the generic extension point, e.g. RUN <ulp>).",+      "timeoutSeconds": 90+    },+    {+      "example": {+        "factor": 3,+        "steps": 20+      },+      "input": {+        "factor": "float (default 2.0)",+        "fit": "optional bool",+        "frameDelayMs": "optional int (default 35)",+        "steps": "optional int (default 16)"+      },+      "longRunning": true,+      "name": "fusion_electron_zoom",+      "output": {+        "output": "str",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "Smoothly ZOOM the schematic/2D board for a recording (the whole motion is one call). factor>1 zooms in, <1 out; or fit:true. The loop runs in the add-in with a repaint per frame.",+      "timeoutSeconds": 60+    },+    {+      "example": {+        "x1": 0,+        "x2": 10,+        "y1": 0,+        "y2": 8+      },+      "input": {+        "frameDelayMs": "optional int (default 35)",+        "steps": "optional int (default 16)",+        "x1": "float",+        "x2": "float",+        "y1": "float",+        "y2": "float"+      },+      "longRunning": true,+      "name": "fusion_electron_pan",+      "output": {+        "box": "[...]",+        "output": "str",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "Smoothly PAN + zoom the view to frame a board-coordinate box (mm; get part positions from fusion_board_info). Animates from where the view last was.",+      "timeoutSeconds": 60+    },+    {+      "example": {+        "name": "U1"+      },+      "input": {+        "name": "str (refdes, e.g. R1)",+        "properties": "optional bool (default true)",+        "x": "optional float",+        "y": "optional float"+      },+      "longRunning": true,+      "name": "fusion_electron_select",+      "output": {+        "deviceInfo": "str",+        "output": "str",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "SELECT a part (by reference designator, or x/y board mm) and surface its properties - the way clicking a part reveals the properties panel. Great for showing life in a recording.",+      "timeoutSeconds": 30+    },+    {+      "example": {+        "runId": "a3f1c2d4e5b6"+      },+      "input": {+        "inlineFrames": "optional bool",+        "runId": "optional str (omit for the latest run)",+        "shots": "optional int",+        "sinceShot": "optional int"+      },+      "longRunning": true,+      "name": "fusion_prove_result",+      "output": {+        "etaSec": "float",+        "evidence": "[]",+        "percent": "float",+        "stage": "str",+        "verdict": "str"+      },+      "statusVerb": null,+      "summary": "POLL a background run started by fusion_create_library or the detached fusion_build_library_3d. Returns stage + stageLabel, plan[] with measured per-stage estimates, stagesDone, percent, etaSec, confidence, and evidence[] filling in AS EACH ARTIFACT LANDS (symbol -> footprint -> 3d -> ganged). For a 3D build it carries per-part progress (minting X (3/7)), partsDone/partsTotal and parts[] with each wip_urn. stage:done only means the chain FINISHED - the top-level verdict (proven/not_proven) is the score, and a run that captured zero frames lands stage:failed with blocked_by_dialog (carrying the dialog text) or no_evidence_captured rather than reporting done. Pass inlineFrames:true on the final fetch for base64 thumbnails a browser can render.",+      "timeoutSeconds": 20+    },+    {+      "example": {+        "runId": "a3f1c2d4e5b6"+      },+      "input": {+        "runId": "optional str (omit for the latest run in flight)"+      },+      "longRunning": true,+      "name": "fusion_cancel_run",+      "output": {+        "cancelRequested": "bool",+        "runId": "str",+        "stage": "str at the time of the request",+        "statusVerb": "fusion_prove_result"+      },+      "statusVerb": "fusion_prove_result",+      "summary": "STOP a library import that is in flight (fusion_install_library_bundle / fusion_create_library) - the user's escape hatch from a long run, wired to a Cancel button in web control. Cooperative, not a kill: the run finishes the part it is on (a STEP import cannot be interrupted mid-command without leaving a half-made design, up to ~60s), keeps every 3D package already minted and binds them into the library, closes its scratch documents, and leaves the library open in Fusion (not saved to the cloud). The run then reports stage:cancelled, verdict:cancelled, errorCode cancelled_by_user, cancelledAt (which stage) and how many parts were done, on the same fusion_prove_result poll the caller already makes; cancelRequested:true shows on the very next poll before the boundary is reached. Omit runId to cancel the latest run still in flight. Idempotent; a run that already ended answers alreadyFinished.",+      "timeoutSeconds": 10+    },+    {+      "example": {},+      "input": {},+      "longRunning": true,+      "name": "fusion_addin_status",+      "output": {+        "addinReady": "bool",+        "busy": "bool",+        "port": "int",+        "version": "str"+      },+      "statusVerb": null,+      "summary": "Is the AdomBridge add-in loaded and answering inside Fusion? Reports addinReady, port and version, plus busy when a long command holds the main thread. If Fusion is running but this says not ready, the add-in was installed while Fusion was open - Fusion loads add-ins only at launch - so call fusion_restart_for_addin (ask the user first when one is present).",+      "timeoutSeconds": 15+    },+    {+      "example": {+        "name": "TJA1050"+      },+      "input": {+        "name": "required str (document name as reported by fusion_get_app_state)"+      },+      "longRunning": false,+      "name": "fusion_activate_document",+      "output": {+        "activeDocument": "str",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "Make a named open document the ACTIVE one before driving it. EDIT and most modelling verbs act on whatever is active, so in a batch with several documents open this is how you stop a verb landing in the wrong file (page issue #47). Prefer passing expectDocument on the verb itself, which fails closed instead of merely re-targeting.",+      "timeoutSeconds": 60+    },+    {+      "example": {+        "limit": 20+      },+      "input": {+        "limit": "optional int (default 50)"+      },+      "longRunning": true,+      "name": "fusion_action_ledger",+      "output": {+        "actions": "[{at, action, detail}]"+      },+      "statusVerb": null,+      "summary": "Read the append-only record of what the bridge did in the BACKGROUND on this machine - dialogs it answered, Untitled scratch docs it swept, Fusion auto-starts, add-in restarts. Survives bridge respawns (~/.adom/fusion-bridge/actions.jsonl). This is the audit trail for why something changed on the user screen.",+      "timeoutSeconds": 15+    },+    {+      "example": {+        "name": "TJA1050",+        "projectName": "Main"+      },+      "input": {+        "description": "optional str",+        "folderPath": "optional str",+        "name": "required str",+        "projectName": "optional str"+      },+      "longRunning": false,+      "name": "fusion_save_to_cloud",+      "output": {+        "success": "bool",+        "urn": "str"+      },+      "statusVerb": null,+      "summary": "Save the ACTIVE document to Autodesk cloud storage with an explicit name and destination. Dialog-free precisely because you supply what the Save box would ask for - use it before closing or restarting when a document has never been saved (fusion_close_all_documents refuses such a document with unsaved_named_document rather than discarding it).",+      "timeoutSeconds": 180+    },+    {+      "example": {},+      "input": {+        "outputPath": "optional str"+      },+      "longRunning": true,+      "name": "fusion_take_screenshot",+      "output": {+        "path": "str",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "Screenshot the Fusion window in the BACKGROUND (no focus steal, reads through occlusion). Use it to VERIFY your own work: geometry at the wrong Z, an empty view, or a Placeholder 3D body all render successfully and only a look at the pixels catches them.",+      "timeoutSeconds": 60+    },+    {+      "example": {},+      "input": {},+      "longRunning": true,+      "name": "fusion_verb_times",+      "output": {+        "stages": "{name: {count, p50, p90}}"+      },+      "statusVerb": null,+      "summary": "This machine MEASURED timings per verb/stage - the same store that paces every progress bar and ETA. Read it to see whether an estimate is measured (this box has run it) or typical (still the seeded literal), and to explain a slow run.",+      "timeoutSeconds": 15+    },+    {+      "example": {+        "libraryPath": "C:/tmp/TJA1050.lbr"+      },+      "input": {+        "libraryPath": "required str (also accepts lbrPath/filePath/path)"+      },+      "longRunning": true,+      "name": "fusion_library_parts",+      "output": {+        "devicesets": "[{name, description, variants:[{fullName, device, technology, package, attributes, missing}]}]",+        "metadataOk": "bool",+        "success": "bool",+        "totals": "{devicesets, variants, withMpn, withDistributor}",+        "warnings": "[]"+      },+      "statusVerb": null,+      "summary": "Every ORDERABLE variant in a .lbr with its part numbers - offline, no Fusion needed. For an EE this is the point of the library: two variants can share ONE symbol, ONE footprint and ONE 3D body and still be different products (an AEC-Q100 automotive part vs the baseline one), and that difference lives ENTIRELY in the metadata. EAGLE spells the orderable identity as deviceset + device + technology: <device> carries the PACKAGE variant, <technology> carries the GRADE/temperature variant, and attributes hang off <technology>. Reports per-variant MPN / MANUFACTURER / MOUSER_PN / DIGIKEY_PN / LCSC_PN (the exact names this bridge's own BOM export reads), plus warnings when variants are indistinguishable, share an MPN, or a deviceset has no description. These warnings never block the library from opening - they say whether an EE could actually order from it.",+      "timeoutSeconds": 15+    },+    {+      "example": {+        "parts": [+          {+            "lbrPath": "C:/tmp/al8843.lbr",+            "modelPath": "C:/tmp/al8843.step",+            "package": "AL8843SP-13"+          }+        ]+      },+      "input": {+        "libraryPath": "optional .lbr for context",+        "parts": "optional [{package, lbrPath, modelPath}] - the parts you intend to import (drives the estimate)",+        "stepPath": "optional single .step when not passing parts[]"+      },+      "longRunning": true,+      "name": "fusion_plan_library_import",+      "output": {+        "estimatedSec": "float",+        "estimatedSecIfAlreadyOpen": "float",+        "fusion": "{installed, running, addinReady, status, message}",+        "plan": "[{stage, label, estimatedSec, confidence, needsUserConsent?}]",+        "success": "bool",+        "summary": "str"+      },+      "statusVerb": null,+      "summary": "PRE-FLIGHT for a library import: does NO work and changes nothing. Reports whether Fusion is installed, running, or needs its add-in loaded (with a plain-language message you can show the user), plus a per-stage plan with MEASURED per-machine time estimates scaled to the number of parts you are sending - a multi-part library does one STEP import per part, which is the slowest stage, so the estimate grows with the library. Call this FIRST so the wiki can render the summary and the progress bar's steps, then run the import and poll fusion_prove_result, which reports the SAME stage names.",+      "timeoutSeconds": 20+    },+    {+      "example": {+        "action": "frames",+        "since": 0+      },+      "input": {+        "action": "start|stop|status|frames",+        "intervalSec": "optional float (default 1.0)",+        "maxSec": "optional float (default 600)",+        "since": "frames only: return ticks newer than this"+      },+      "longRunning": true,+      "name": "fusion_live_feed",+      "output": {+        "frames": "[{tick, kind:main|popup, path, title, at}]",+        "running": "bool",+        "success": "bool",+        "tick": "int"+      },+      "statusVerb": null,+      "summary": "A ~1 fps look INTO Fusion while the bridge drives it, kept as a BOX-SIDE ring buffer (~10 min). Each tick records the Fusion main window (kind:main - the video) and every owned popup over it (kind:popup - dialogs, Browser/tool panels, the Adom banner; Fusion draws these as separate windows a main capture omits), each a path on this machine tied to its tick. Drain from the container with {action:frames, since:<tick>}, read_file each path, and publish where a human looks - tools/live_feed_drain.py does exactly that into shotlog. Proof frames are NOT here: fusion_prove_result evidence[] carries kind:proof with step labels, so the three kinds are distinguishable at the source. Exists so a human can see open tabs and dialogs during boot or a restart instead of guessing.",+      "timeoutSeconds": 15+    },+    {+      "example": {+        "save": true+      },+      "input": {+        "save": "optional bool (default true) - save open documents before restarting"+      },+      "longRunning": false,+      "name": "fusion_restart_for_addin",+      "output": {+        "addinReady": "bool",+        "steps": "[{step, ok}]",+        "success": "bool",+        "tookSec": "float"+      },+      "statusVerb": null,+      "summary": "ASYNC: returns immediately (started:true) and restarts Fusion in the background, SAVING the user's open documents first; poll fusion_readiness until ready with the new addinVersion (a restart takes 60-120s, longer than the relay budget; pass wait:true for the old blocking form). Finish add-in setup by restarting Fusion. Call this when any verb returns errorCode addin_restart_required (the add-in was installed/updated while Fusion was already open, and Fusion only loads add-ins at launch). ASK THE USER FIRST when a human is present - the failing verb's payload carries userMessage plus openDocuments/unsavedDocuments so you can show them what is open. Refuses with unsaved_named_document rather than discarding a never-saved document.",+      "timeoutSeconds": 300+    },+    {+      "example": {+        "worldSpace": true+      },+      "input": {+        "occurrence": "optional str (substring filter on occurrence name, worldSpace only)",+        "worldSpace": "optional bool (resolve through occurrence transforms; default false = root component only)"+      },+      "longRunning": false,+      "name": "fusion_inspect_bodies",+      "output": {+        "bodies": "[{name,owner,bbox:{x,y,z},sizeMm,volumeMm3,areaMm2,faceCount,cylindricalFaceCount,appearance,material,isVisible}]",+        "bodyCount": "int",+        "documentName": "str",+        "success": "bool",+        "units": "str (mm)"+      },+      "statusVerb": "fusion_get_app_state",+      "summary": "GEOMETRY READ-BACK: what actually got built, in MILLIMETRES. Per body: bbox, sizeMm, volumeMm3, areaMm2, faceCount, cylindricalFaceCount, appearance, material, isVisible. Use this to VERIFY your own modelling - a body at the wrong Z (a double-applied offset, a part buried inside another) renders perfectly and is INVISIBLE in a screenshot, and this work is often matte-black parts on a dark canvas where pixels are a weak check. cylindricalFaceCount is the cheap way to confirm holes were actually cut: a symmetric cut that reaches nothing fails SILENTLY with no exception. Pass worldSpace:true to resolve bodies through their occurrence transforms (assembly placement); optionally filter with occurrence. Fusion's API is centimetres - this converts for you.",+      "timeoutSeconds": 130+    },+    {+      "example": {+        "dryRun": true+      },+      "input": {+        "cascade": "optional bool (set by ab)",+        "dryRun": "optional bool (report the paths, delete nothing)",+        "name": "optional str (set by ab)"+      },+      "longRunning": false,+      "name": "fusion_uninstall",+      "output": {+        "dryRun": "bool",+        "failed": "[{path,kind,error}]",+        "fusionRunning": "bool",+        "removed": "[{path,kind}]",+        "skipped": "[{path,kind,why}]",+        "success": "bool"+      },+      "statusVerb": null,+      "summary": "CASCADE CLEANUP, called by ab's bridge_uninstall BEFORE this bridge's cache is deleted (ab 2.0.35+). Removes the artifacts this bridge planted OUTSIDE its cache: the Fusion ADD-IN in Autodesk's AddIns directories (all three historical locations), plus this bridge's prefs (~/.adom/fusion-bridge) and APS OAuth tokens (~/.adom/fusion-aps). This matters more here than for most bridges: a stale AdomBridge add-in keeps loading on every Fusion launch and binding its port long after the bridge is gone. Fusion itself is never touched. Pass dryRun:true to see exactly what would be removed. If Fusion is RUNNING it holds the add-in files open, so removal may fail - the response says so and names the remedy.",+      "timeoutSeconds": 60+    },+    {+      "example": {},+      "input": {},+      "longRunning": false,+      "name": "fusion_describe",+      "output": {+        "success": "bool",+        "verbs": "[{name,summary,input,output,timeoutSeconds,statusVerb,longRunning,example}]"+      },+      "statusVerb": null,+      "summary": "Self-describe every verb the bridge exposes (this list) for ab's Verbs tab + runner.",+      "timeoutSeconds": 20+    }+  ]+}\ No newline at end of file

@@ -0,0 +1,198 @@+//! The bridge exe (spawn.kind: exe) - Phase 1, the plumbing shell.+//!+//! What it owns today: the HTTP surface ab talks to (GET /status + /health, POST /command+//! with X-Adom-Caller-* identity), the loopback ab client, the frozen verb catalog, and a+//! PROXY to the Python bridge running as a sidecar child for every verb not yet ported.+//! Users feel a faster, lighter bridge; nothing behavioural changes. Each later phase moves+//! verbs from the proxy table into native handlers until the sidecar is empty.+//!+//! Contract (proved by the Python bridge in production):+//!   - bind ADOM_BIND_HOST (always 127.0.0.1) on the port ab passes as --port; never 0.0.0.0+//!   - /status must answer 2xx whenever this process is up, with {status, busy, led, summary,+//!     tooltip, bridgeVersion, ...}: ab paints the chip from it verbatim+//!   - /command body {command, args}; the response is the verb's JSON as-is++use fusion_core::ab::Caller;+use fusion_core::{HostPaths, HostProcess};+use serde_json::{json, Value};+use std::process::{Child, Command, Stdio};+use std::sync::{Arc, Mutex};+use std::time::{Duration, Instant};+use tiny_http::{Header, Method, Response, Server};++const VERSION: &str = env!("CARGO_PKG_VERSION");++#[cfg(windows)]+fn host() -> Box<dyn HostBoth> { Box::new(fusion_os_win::WindowsHost) }+#[cfg(target_os = "macos")]+fn host() -> Box<dyn HostBoth> { Box::new(fusion_os_mac::MacHost) }+#[cfg(not(any(windows, target_os = "macos")))]+fn host() -> Box<dyn HostBoth> { Box::new(NoHost) }++trait HostBoth: HostProcess + HostPaths {}+impl<T: HostProcess + HostPaths> HostBoth for T {}++/// Linux is the CI/build host, never a Fusion host: a stub so the workspace builds here.+struct NoHost;+impl HostProcess for NoHost {+    fn fusion_processes(&self) -> Vec<fusion_core::host::FusionProcess> { vec![] }+    fn launch_fusion(&self) -> Result<fusion_core::host::FusionProcess, fusion_core::host::HostError> {+        Err(fusion_core::host::HostError::NotInstalled("this OS does not run Fusion".into()))+    }+    fn is_elevated(&self) -> bool { false }+}+impl HostPaths for NoHost {+    fn fusion_executable(&self) -> Option<std::path::PathBuf> { None }+    fn addin_dirs(&self) -> Vec<std::path::PathBuf> { vec![] }+    fn fusion_log_dir(&self) -> Option<std::path::PathBuf> { None }+    fn bridge_state_dir(&self) -> std::path::PathBuf { std::env::temp_dir() }+    fn scratch_dir(&self) -> std::path::PathBuf { std::env::temp_dir() }+}++/// The Python bridge as a child process, proxied until each verb is ported.+struct Sidecar {+    /// Held so the child is reaped with this process (dropping the handle would orphan it).+    #[allow(dead_code)]+    child: Option<Child>,+    port: u16,+    started: Instant,+}++impl Sidecar {+    /// ab provisions Python for kind:python bridges only; a kind:exe bridge that still needs+    /// the sidecar finds ab's portable copy itself (`~/.adom/adom-runtimes/python-*/`).+    fn python_exe() -> Option<std::path::PathBuf> {+        if let Ok(p) = std::env::var("ADOM_SIDECAR_PYTHON") { return Some(p.into()); }+        let home = std::env::var("USERPROFILE").or_else(|_| std::env::var("HOME")).ok()?;+        let dir = std::path::Path::new(&home).join(".adom").join("adom-runtimes");+        let mut best: Option<std::path::PathBuf> = None;+        for e in std::fs::read_dir(&dir).ok()?.flatten() {+            let n = e.file_name().to_string_lossy().to_string();+            if n.starts_with("python-") {+                for cand in ["python.exe", "bin/python3", "python3"] {+                    let p = e.path().join(cand);+                    if p.exists() { best = Some(p); }+                }+            }+        }+        best+    }++    fn spawn(bind: &str) -> Option<Sidecar> {+        let py = Self::python_exe()?;+        let here = std::env::current_exe().ok()?.parent()?.to_path_buf();+        // The sidecar's server.py sits beside this exe in the bridge dir during the port.+        let server_py = here.join("server.py");+        if !server_py.exists() { return None; }+        let port = pick_free_port();+        let child = Command::new(py)+            .arg(&server_py).arg("--port").arg(port.to_string())+            .env("ADOM_BIND_HOST", bind)+            .current_dir(&here)+            .stdin(Stdio::null()).stdout(Stdio::null()).stderr(Stdio::null())+            .spawn().ok()?;+        Some(Sidecar { child: Some(child), port, started: Instant::now() })+    }++    fn url(&self, path: &str) -> String { format!("http://127.0.0.1:{}{}", self.port, path) }+}++fn pick_free_port() -> u16 {+    std::net::TcpListener::bind("127.0.0.1:0").and_then(|l| l.local_addr()).map(|a| a.port()).unwrap_or(8773)+}++fn caller_from(req: &tiny_http::Request) -> Caller {+    let mut c = Caller::default();+    for h in req.headers() {+        let k = h.field.as_str().to_ascii_lowercase();+        let v = h.value.as_str().to_string();+        match k.as_str() {+            "x-adom-caller-thread" => c.thread = v,+            "x-adom-caller-container" => c.container = v,+            "x-adom-caller-reason" => c.reason = v,+            _ => {}+        }+    }+    c+}++fn json_response(status: u16, v: &Value) -> Response<std::io::Cursor<Vec<u8>>> {+    let body = serde_json::to_vec(v).unwrap_or_default();+    Response::from_data(body).with_status_code(status)+        .with_header(Header::from_bytes("Content-Type", "application/json").unwrap())+}++fn main() {+    let args: Vec<String> = std::env::args().collect();+    if args.iter().any(|a| a == "--version") { println!("adom-fusion-bridge v{VERSION}"); return; }+    let port: u16 = args.iter().position(|a| a == "--port")+        .and_then(|i| args.get(i + 1)).and_then(|p| p.parse().ok()).unwrap_or(8773);+    let bind = std::env::var("ADOM_BIND_HOST").unwrap_or_else(|_| "127.0.0.1".into());+    let catalog = fusion_core::contract::load().expect("frozen verb catalog");+    let h = host();+    let sidecar = Arc::new(Mutex::new(Sidecar::spawn(&bind)));+    let server = Server::http(format!("{bind}:{port}")).expect("bind loopback");+    eprintln!("[fusion-bridge] v{VERSION} listening on {bind}:{port}; contract frozen {}; sidecar {}",+              catalog.frozen,+              sidecar.lock().unwrap().as_ref().map(|s| format!("python on :{}", s.port)).unwrap_or("absent".into()));++    for mut req in server.incoming_requests() {+        let path = req.url().split('?').next().unwrap_or("/").to_string();+        match (req.method(), path.as_str()) {+            (Method::Get, "/status") | (Method::Get, "/health") => {+                // Prefer the sidecar's rich status (Fusion/add-in probe) while it exists;+                // this process is up regardless, so the answer is ALWAYS 2xx.+                let mut body = json!({+                    "status": "ok", "busy": false, "led": "yellow",+                    "summary": "Fusion bridge (Rust shell) starting",+                    "tooltip": "The Rust bridge is up; its Python sidecar is still coming up.",+                    "bridgeVersion": VERSION, "shell": "rust",+                    "fusion": {"installed": h.fusion_executable().is_some(),+                               "running": !h.fusion_processes().is_empty()},+                });+                if let Some(sc) = sidecar.lock().unwrap().as_ref() {+                    if let Ok(r) = ureq::get(&sc.url("/status")).timeout(Duration::from_secs(4)).call() {+                        if let Ok(mut v) = r.into_json::<Value>() {+                            v["shell"] = json!("rust"); v["sidecarPort"] = json!(sc.port);+                            v["sidecarUptimeSec"] = json!(sc.started.elapsed().as_secs());+                            body = v;+                        }+                    }+                }+                let _ = req.respond(json_response(200, &body));+            }+            (Method::Post, "/command") => {+                let caller = caller_from(&req);+                let mut raw = String::new();+                let _ = req.as_reader().read_to_string(&mut raw);+                let parsed: Value = serde_json::from_str(&raw).unwrap_or(json!({}));+                let verb = parsed.get("command").and_then(|c| c.as_str()).unwrap_or("").to_string();+                let reply = match verb.as_str() {+                    "shell_info" => json!({"success": true, "shell": "rust", "bridgeVersion": VERSION,+                                          "contractFrozen": catalog.frozen,+                                          "_hint": "Rust plumbing shell; every catalogued verb is served, natively or via the Python sidecar."}),+                    _ => proxy(&sidecar, &raw, &caller),+                };+                let _ = req.respond(json_response(200, &reply));+            }+            _ => { let _ = req.respond(json_response(404, &json!({"error": "not found"}))); }+        }+    }+}++/// Forward an unported verb to the Python sidecar, identity headers intact.+fn proxy(sidecar: &Arc<Mutex<Option<Sidecar>>>, raw: &str, caller: &Caller) -> Value {+    let url = match sidecar.lock().unwrap().as_ref() { Some(s) => s.url("/command"), None => return json!({+        "success": false, "errorCode": "sidecar_absent",+        "error": "This verb is not ported yet and the Python sidecar is not running.",+        "_hint": "Set ADOM_SIDECAR_PYTHON to ab's provisioned python.exe, or run the Python bridge directly until this verb is ported."}) };+    let mut r = ureq::post(&url).timeout(Duration::from_secs(600)).set("Content-Type", "application/json");+    if !caller.thread.is_empty() { r = r.set("X-Adom-Caller-Thread", &caller.thread); }+    if !caller.container.is_empty() { r = r.set("X-Adom-Caller-Container", &caller.container); }+    if !caller.reason.is_empty() { r = r.set("X-Adom-Caller-Reason", &caller.reason); }+    match r.send_string(raw) {+        Ok(resp) => resp.into_json::<Value>().unwrap_or(json!({"success": false, "error": "sidecar returned non-JSON"})),+        Err(ureq::Error::Status(code, resp)) => resp.into_json::<Value>().unwrap_or(json!({"success": false, "error": format!("sidecar HTTP {code}")})),+        Err(e) => json!({"success": false, "errorCode": "sidecar_unreachable", "error": e.to_string()}),+    }+}

@@ -0,0 +1,81 @@+//! Calling Adom Bridge ("ab") verbs from inside the bridge. ab is the host app; every+//! desktop-shaped thing (windows, clicks, UIA, screenshots, processes, captions, the demo+//! panel) is one of its verbs, identical on Windows and macOS. This module is the ONLY+//! way the core touches the desktop.+//!+//! Naming: the host app is Adom Bridge, "ab". None of its retired names appear anywhere+//! in this workspace, not even in comments; `tools/check-naming.sh` fails the build if+//! one does (which is why this comment does not spell them out).+//!+//! Wire contract (mirrors what the Python bridge proved in production): POST+//! `<ADOM_DIRECT_API_URL>/command` with `{"command", "args"}`, `X-Adom-Bridge-Token` from+//! `ADOM_BRIDGE_TOKEN`, the caller's `X-Adom-Caller-Thread/Container/Reason` forwarded so+//! ab records the delegation chain, and `X-Adom-Caller-Delegate: fusion`.++use serde_json::{json, Value};+use std::time::Duration;++#[derive(Debug, thiserror::Error)]+pub enum AbError {+    #[error("ab loopback API unreachable: {0}")]+    Unreachable(String),+    #[error("verb {verb} refused: {code}: {message}")]+    Refused { verb: String, code: String, message: String },+    #[error("verb {0} failed: {1}")]+    Failed(String, String),+}++/// The caller this bridge is currently acting FOR (ab stamps it on every inbound verb).+#[derive(Debug, Clone, Default)]+pub struct Caller {+    pub thread: String,+    pub container: String,+    pub reason: String,+}++pub trait AbClient: Send + Sync {+    fn call(&self, verb: &str, args: Value, caller: &Caller, timeout_secs: u64) -> Result<Value, AbError>;+}++/// The loopback direct-API client. Reads its base URL and token from the environment ab+/// sets on every bridge it spawns.+pub struct Loopback {+    pub base: String,+    pub token: String,+}++impl Loopback {+    pub fn from_env() -> Option<Loopback> {+        let base = std::env::var("ADOM_DIRECT_API_URL").ok()?.trim().trim_end_matches('/').to_string();+        if base.is_empty() { return None; }+        Some(Loopback { base, token: std::env::var("ADOM_BRIDGE_TOKEN").unwrap_or_default() })+    }+}++impl AbClient for Loopback {+    fn call(&self, verb: &str, args: Value, caller: &Caller, timeout_secs: u64) -> Result<Value, AbError> {+        let agent = ureq::AgentBuilder::new().timeout(Duration::from_secs(timeout_secs.max(1))).build();+        let mut req = agent.post(&format!("{}/command", self.base))+            .set("Content-Type", "application/json")+            .set("X-Adom-Caller-Delegate", "fusion");+        if !self.token.is_empty() { req = req.set("X-Adom-Bridge-Token", &self.token); }+        if !caller.thread.is_empty() { req = req.set("X-Adom-Caller-Thread", &caller.thread); }+        if !caller.container.is_empty() { req = req.set("X-Adom-Caller-Container", &caller.container); }+        if !caller.reason.is_empty() { req = req.set("X-Adom-Caller-Reason", &caller.reason); }+        let resp = req.send_json(json!({"command": verb, "args": args}))+            .map_err(|e| AbError::Unreachable(e.to_string()))?;+        let mut v: Value = resp.into_json().map_err(|e| AbError::Failed(verb.into(), e.to_string()))?;+        // ab wraps a bridge verb's JSON in an envelope whose `output` is a JSON STRING; unwrap it.+        if let Some(inner) = v.get("output").and_then(|o| o.as_str()) {+            if inner.trim_start().starts_with('{') {+                if let Ok(parsed) = serde_json::from_str::<Value>(inner) { v = parsed; }+            }+        }+        if v.get("success") == Some(&Value::Bool(false)) || v.get("status") == Some(&Value::String("error".into())) {+            let code = v.get("errorCode").and_then(|c| c.as_str()).unwrap_or("error").to_string();+            let message = v.get("error").and_then(|c| c.as_str()).unwrap_or("").to_string();+            return Err(AbError::Refused { verb: verb.into(), code, message });+        }+        Ok(v)+    }+}