Fusion - the Fusion 360 Bridge

@@ -18,7 +18,7 @@       },       "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.",-      "timeoutSec": 15+      "timeoutSeconds": 15     },     {       "example": {@@ -35,7 +35,7 @@       },       "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.",-      "timeoutSec": 60+      "timeoutSeconds": 60     },     {       "example": {},@@ -50,7 +50,7 @@       },       "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).",-      "timeoutSec": 15+      "timeoutSeconds": 15     },     {       "example": {},@@ -64,7 +64,7 @@       },       "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.",-      "timeoutSec": 30+      "timeoutSeconds": 30     },     {       "example": {},@@ -80,7 +80,7 @@       },       "statusVerb": null,       "summary": "Browse hubs/projects/folders without launching Fusion.",-      "timeoutSec": 60+      "timeoutSeconds": 60     },     {       "example": {@@ -100,7 +100,7 @@       },       "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.",-      "timeoutSec": 50+      "timeoutSeconds": 50     },     {       "example": {@@ -119,7 +119,7 @@       },       "statusVerb": null,       "summary": "Download a cloud file to the local machine (no Fusion needed).",-      "timeoutSec": 90+      "timeoutSeconds": 90     },     {       "example": {@@ -137,7 +137,7 @@       },       "statusVerb": null,       "summary": "Version history + who/when/size for a file (tip + recent versions).",-      "timeoutSec": 40+      "timeoutSeconds": 40     },     {       "example": {},@@ -150,7 +150,7 @@       },       "statusVerb": null,       "summary": "Forget the remembered Autodesk sign-in browser (re-detect next time).",-      "timeoutSec": 10+      "timeoutSeconds": 10     },     {       "example": {@@ -167,7 +167,7 @@       },       "statusVerb": null,       "summary": "Raw authenticated GET against a free APS path (dev/verify helper).",-      "timeoutSec": 40+      "timeoutSeconds": 40     },     {       "example": {},@@ -180,7 +180,7 @@       },       "statusVerb": null,       "summary": "Show the remembered Autodesk sign-in browser (None until set).",-      "timeoutSec": 10+      "timeoutSeconds": 10     },     {       "example": {@@ -199,7 +199,7 @@       },       "statusVerb": "fusion_get_app_state",       "summary": "Find a cloud design by name and open it in Fusion (any folder depth). Fire-and-poll.",-      "timeoutSec": 60+      "timeoutSeconds": 60     },     {       "example": {@@ -216,7 +216,7 @@       },       "statusVerb": null,       "summary": "Most-recently-modified designs across the team hub, newest first.",-      "timeoutSec": 60+      "timeoutSeconds": 60     },     {       "example": {@@ -237,7 +237,7 @@       },       "statusVerb": null,       "summary": "Server-indexed search across the whole team hub (seconds, not a 30-min folder walk).",-      "timeoutSec": 60+      "timeoutSeconds": 60     },     {       "example": {@@ -259,7 +259,7 @@       },       "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.",-      "timeoutSec": 10+      "timeoutSeconds": 10     },     {       "example": {@@ -275,7 +275,7 @@       },       "statusVerb": null,       "summary": "Set the org's APS (PKCE) client id used for cloud search.",-      "timeoutSec": 20+      "timeoutSeconds": 20     },     {       "example": {},@@ -295,7 +295,7 @@       },       "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.",-      "timeoutSec": 30+      "timeoutSeconds": 30     },     {       "example": {},@@ -309,7 +309,7 @@       },       "statusVerb": null,       "summary": "APS state: configured, signed in, token live, never-charge meter.",-      "timeoutSec": 20+      "timeoutSeconds": 20     },     {       "example": {@@ -331,7 +331,7 @@       },       "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.",-      "timeoutSec": 90+      "timeoutSeconds": 90     },     {       "example": {@@ -348,7 +348,7 @@       },       "statusVerb": null,       "summary": "Full (uncapped) version history of a file.",-      "timeoutSec": 40+      "timeoutSeconds": 40     },     {       "example": {@@ -375,7 +375,7 @@       },       "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.",-      "timeoutSec": 120+      "timeoutSeconds": 120     },     {       "example": {@@ -398,7 +398,7 @@       },       "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.",-      "timeoutSec": 240+      "timeoutSeconds": 240     },     {       "example": {@@ -420,7 +420,7 @@       },       "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).",-      "timeoutSec": 480+      "timeoutSeconds": 480     },     {       "example": {},@@ -432,7 +432,7 @@       },       "statusVerb": null,       "summary": "Raw board geometry XML (copper/arcs/lines) for the open board.",-      "timeoutSec": 60+      "timeoutSeconds": 60     },     {       "example": {},@@ -449,7 +449,7 @@       },       "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.",-      "timeoutSec": 200+      "timeoutSeconds": 200     },     {       "example": {@@ -484,7 +484,7 @@       },       "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.",-      "timeoutSec": 1800+      "timeoutSeconds": 1800     },     {       "example": {@@ -503,7 +503,7 @@       },       "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.",-      "timeoutSec": 10+      "timeoutSeconds": 10     },     {       "example": {@@ -525,7 +525,7 @@       },       "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).",-      "timeoutSec": 300+      "timeoutSeconds": 300     },     {       "example": {@@ -549,7 +549,7 @@       },       "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).",-      "timeoutSec": 1800+      "timeoutSeconds": 1800     },     {       "example": {@@ -569,7 +569,7 @@       },       "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.",-      "timeoutSec": 60+      "timeoutSeconds": 60     },     {       "example": {@@ -587,7 +587,7 @@       },       "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.",-      "timeoutSec": 60+      "timeoutSeconds": 60     },     {       "example": {@@ -603,7 +603,7 @@       },       "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.)",-      "timeoutSec": 30+      "timeoutSeconds": 30     },     {       "example": {@@ -627,7 +627,7 @@       },       "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.",-      "timeoutSec": 30+      "timeoutSeconds": 30     },     {       "example": {},@@ -652,7 +652,7 @@       },       "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.",-      "timeoutSec": 240+      "timeoutSeconds": 240     },     {       "example": {@@ -678,7 +678,7 @@       },       "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.",-      "timeoutSec": 15+      "timeoutSeconds": 15     },     {       "example": {},@@ -691,7 +691,7 @@       },       "statusVerb": null,       "summary": "Self-describe every verb the bridge exposes (this list) for ab's Verbs tab + runner.",-      "timeoutSec": 20+      "timeoutSeconds": 20     },     {       "example": {},@@ -704,7 +704,7 @@       },       "statusVerb": null,       "summary": "Detect 2-layer vs 4-layer board (ULP + CAM comparison).",-      "timeoutSec": 90+      "timeoutSeconds": 90     },     {       "example": {},@@ -716,7 +716,7 @@       },       "statusVerb": null,       "summary": "Detect + classify (and optionally dismiss) blocking Fusion dialogs.",-      "timeoutSec": 30+      "timeoutSeconds": 30     },     {       "example": {},@@ -731,7 +731,7 @@       },       "statusVerb": null,       "summary": "Metadata for the ACTIVE document: name, product type, save state, version, parent project.",-      "timeoutSec": 30+      "timeoutSeconds": 30     },     {       "example": {@@ -757,7 +757,7 @@       },       "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.",-      "timeoutSec": 60+      "timeoutSeconds": 60     },     {       "example": {@@ -774,7 +774,7 @@       },       "statusVerb": null,       "summary": "Run an EAGLE/Electron command in the open board (the generic extension point, e.g. RUN <ulp>).",-      "timeoutSec": 90+      "timeoutSeconds": 90     },     {       "example": {@@ -795,7 +795,7 @@       },       "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.",-      "timeoutSec": 30+      "timeoutSeconds": 30     },     {       "example": {@@ -816,7 +816,7 @@       },       "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.",-      "timeoutSec": 60+      "timeoutSeconds": 60     },     {       "example": {@@ -834,7 +834,7 @@       },       "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.",-      "timeoutSec": 60+      "timeoutSeconds": 60     },     {       "example": {@@ -850,7 +850,7 @@       },       "statusVerb": null,       "summary": "Export to 3MF mesh.",-      "timeoutSec": 300+      "timeoutSeconds": 300     },     {       "example": {@@ -868,7 +868,7 @@       },       "statusVerb": null,       "summary": "Export a Bill of Materials CSV (grouped by value+package) from the open board.",-      "timeoutSec": 60+      "timeoutSeconds": 60     },     {       "example": {@@ -886,7 +886,7 @@       },       "statusVerb": null,       "summary": "Export the Component Placement List (pick-and-place) CSV.",-      "timeoutSec": 60+      "timeoutSeconds": 60     },     {       "example": {@@ -902,7 +902,7 @@       },       "statusVerb": null,       "summary": "Export 2D DWG.",-      "timeoutSec": 120+      "timeoutSeconds": 120     },     {       "example": {@@ -918,7 +918,7 @@       },       "statusVerb": null,       "summary": "Export 2D DXF.",-      "timeoutSec": 120+      "timeoutSeconds": 120     },     {       "example": {@@ -934,7 +934,7 @@       },       "statusVerb": null,       "summary": "Export the active design as a Fusion archive (.f3d).",-      "timeoutSec": 300+      "timeoutSeconds": 300     },     {       "example": {@@ -950,7 +950,7 @@       },       "statusVerb": null,       "summary": "Export to FBX mesh.",-      "timeoutSec": 300+      "timeoutSeconds": 300     },     {       "example": {@@ -968,7 +968,7 @@       },       "statusVerb": null,       "summary": "Run the bundled JLCPCB CAM job (auto 2/4-layer) to produce the gerber + drill ZIP.",-      "timeoutSec": 180+      "timeoutSeconds": 180     },     {       "example": {@@ -984,7 +984,7 @@       },       "statusVerb": null,       "summary": "Export to IGES.",-      "timeoutSec": 300+      "timeoutSeconds": 300     },     {       "example": {@@ -1000,7 +1000,7 @@       },       "statusVerb": null,       "summary": "Export to OBJ mesh.",-      "timeoutSec": 300+      "timeoutSeconds": 300     },     {       "example": {@@ -1026,7 +1026,7 @@       },       "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.",-      "timeoutSec": 200+      "timeoutSeconds": 200     },     {       "example": {@@ -1042,7 +1042,7 @@       },       "statusVerb": null,       "summary": "Export to SAT (ACIS solid).",-      "timeoutSec": 300+      "timeoutSeconds": 300     },     {       "example": {@@ -1058,7 +1058,7 @@       },       "statusVerb": null,       "summary": "Export to SketchUp (.skp).",-      "timeoutSec": 300+      "timeoutSeconds": 300     },     {       "example": {@@ -1075,7 +1075,7 @@       },       "statusVerb": null,       "summary": "Export the active design to STEP (needs the 3D view).",-      "timeoutSec": 300+      "timeoutSeconds": 300     },     {       "example": {@@ -1091,7 +1091,7 @@       },       "statusVerb": null,       "summary": "Export to STL mesh.",-      "timeoutSec": 300+      "timeoutSeconds": 300     },     {       "example": {@@ -1107,7 +1107,7 @@       },       "statusVerb": null,       "summary": "Export to USDZ (AR / Hydrogen 3D).",-      "timeoutSec": 300+      "timeoutSeconds": 300     },     {       "example": {@@ -1130,7 +1130,7 @@       },       "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.",-      "timeoutSec": 150+      "timeoutSeconds": 150     },     {       "example": {@@ -1168,7 +1168,7 @@       },       "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.",-      "timeoutSec": 120+      "timeoutSeconds": 120     },     {       "example": {},@@ -1182,7 +1182,7 @@       },       "statusVerb": null,       "summary": "Current app state: running, active document, workspace, isElectronics. The poll/status verb for long-running calls.",-      "timeoutSec": 20+      "timeoutSeconds": 20     },     {       "example": {},@@ -1196,7 +1196,7 @@       },       "statusVerb": null,       "summary": "Design-level summary of the active design: components, bodies, sketches, units, root name.",-      "timeoutSec": 60+      "timeoutSeconds": 60     },     {       "example": {},@@ -1209,7 +1209,7 @@       },       "statusVerb": null,       "summary": "All user + model parameters of the active design (name, expression, value, unit).",-      "timeoutSec": 60+      "timeoutSeconds": 60     },     {       "example": {},@@ -1221,7 +1221,7 @@       },       "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.",-      "timeoutSec": 20+      "timeoutSeconds": 20     },     {       "example": {@@ -1238,7 +1238,7 @@       },       "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.)",-      "timeoutSec": 300+      "timeoutSeconds": 300     },     {       "example": {@@ -1259,7 +1259,7 @@       },       "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.",-      "timeoutSec": 130+      "timeoutSeconds": 130     },     {       "example": {},@@ -1275,7 +1275,7 @@       },       "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.",-      "timeoutSec": 90+      "timeoutSeconds": 90     },     {       "example": {@@ -1303,7 +1303,7 @@       },       "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.",-      "timeoutSec": 60+      "timeoutSeconds": 60     },     {       "example": {},@@ -1318,7 +1318,7 @@       },       "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.",-      "timeoutSec": 30+      "timeoutSeconds": 30     },     {       "example": {@@ -1338,7 +1338,7 @@       },       "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.",-      "timeoutSec": 240+      "timeoutSeconds": 240     },     {       "example": {@@ -1358,7 +1358,7 @@       },       "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.",-      "timeoutSec": 15+      "timeoutSeconds": 15     },     {       "example": {@@ -1376,7 +1376,7 @@       },       "statusVerb": null,       "summary": "List files/folders in a cloud project (optionally a subfolder).",-      "timeoutSec": 120+      "timeoutSeconds": 120     },     {       "example": {},@@ -1389,7 +1389,7 @@       },       "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).",-      "timeoutSec": 120+      "timeoutSeconds": 120     },     {       "example": {@@ -1412,7 +1412,7 @@       },       "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.",-      "timeoutSec": 15+      "timeoutSeconds": 15     },     {       "example": {@@ -1441,7 +1441,7 @@       },       "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.",-      "timeoutSec": 200+      "timeoutSeconds": 200     },     {       "example": {@@ -1462,7 +1462,7 @@       },       "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.",-      "timeoutSec": 300+      "timeoutSeconds": 300     },     {       "example": {},@@ -1479,7 +1479,7 @@       },       "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.",-      "timeoutSec": 240+      "timeoutSeconds": 240     },     {       "example": {},@@ -1499,7 +1499,7 @@       },       "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.",-      "timeoutSec": 180+      "timeoutSeconds": 180     },     {       "example": {},@@ -1517,7 +1517,7 @@       },       "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.",-      "timeoutSec": 240+      "timeoutSeconds": 240     },     {       "example": {},@@ -1534,7 +1534,7 @@       },       "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.",-      "timeoutSec": 240+      "timeoutSeconds": 240     },     {       "example": {},@@ -1548,7 +1548,7 @@       },       "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.",-      "timeoutSec": 180+      "timeoutSeconds": 180     },     {       "example": {@@ -1570,7 +1570,7 @@       },       "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.",-      "timeoutSec": 150+      "timeoutSeconds": 150     },     {       "example": {},@@ -1585,7 +1585,7 @@       },       "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.",-      "timeoutSec": 180+      "timeoutSeconds": 180     },     {       "example": {},@@ -1601,7 +1601,7 @@       },       "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.",-      "timeoutSec": 60+      "timeoutSeconds": 60     },     {       "example": {},@@ -1616,7 +1616,7 @@       },       "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.",-      "timeoutSec": 45+      "timeoutSeconds": 45     },     {       "example": {},@@ -1629,7 +1629,7 @@       },       "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.",-      "timeoutSec": 45+      "timeoutSeconds": 45     },     {       "example": {@@ -1648,7 +1648,7 @@       },       "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.",-      "timeoutSec": 200+      "timeoutSeconds": 200     },     {       "example": {@@ -1668,7 +1668,7 @@       },       "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.",-      "timeoutSec": 20+      "timeoutSeconds": 20     },     {       "example": {@@ -1685,7 +1685,7 @@       },       "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.",-      "timeoutSec": 240+      "timeoutSeconds": 240     },     {       "example": {},@@ -1695,7 +1695,7 @@       "output": {},       "statusVerb": null,       "summary": "(see fusion_open_by_urn)",-      "timeoutSec": 30+      "timeoutSeconds": 30     },     {       "example": {@@ -1715,7 +1715,7 @@       },       "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.",-      "timeoutSec": 240+      "timeoutSeconds": 240     },     {       "example": {@@ -1731,7 +1731,7 @@       },       "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.",-      "timeoutSec": 240+      "timeoutSeconds": 240     },     {       "example": {@@ -1750,7 +1750,7 @@       },       "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').",-      "timeoutSec": 50+      "timeoutSeconds": 50     },     {       "example": {@@ -1769,7 +1769,7 @@       },       "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.",-      "timeoutSec": 120+      "timeoutSeconds": 120     },     {       "example": {@@ -1798,7 +1798,7 @@       },       "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.",-      "timeoutSec": 20+      "timeoutSeconds": 20     },     {       "example": {@@ -1815,7 +1815,7 @@       },       "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.",-      "timeoutSec": 10+      "timeoutSeconds": 10     },     {       "example": {@@ -1832,7 +1832,7 @@       },       "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.",-      "timeoutSec": 60+      "timeoutSeconds": 60     },     {       "example": {@@ -1852,7 +1852,7 @@       },       "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.",-      "timeoutSec": 120+      "timeoutSeconds": 120     },     {       "example": {@@ -1875,7 +1875,7 @@       },       "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.",-      "timeoutSec": 20+      "timeoutSeconds": 20     },     {       "example": {},@@ -1891,7 +1891,7 @@       },       "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.",-      "timeoutSec": 15+      "timeoutSeconds": 15     },     {       "example": {},@@ -1908,7 +1908,7 @@       },       "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.",-      "timeoutSec": 90+      "timeoutSeconds": 90     },     {       "example": {@@ -1927,7 +1927,7 @@       },       "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.",-      "timeoutSec": 300+      "timeoutSeconds": 300     },     {       "example": {@@ -1944,7 +1944,7 @@       },       "statusVerb": null,       "summary": "Run an adsk.fusion modeling script in the live session (sketches/extrudes/params). Free programmatic CAD.",-      "timeoutSec": 180+      "timeoutSeconds": 180     },     {       "example": {@@ -1965,7 +1965,7 @@       },       "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).",-      "timeoutSec": 180+      "timeoutSeconds": 180     },     {       "example": {},@@ -1981,7 +1981,7 @@       },       "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.)",-      "timeoutSec": 60+      "timeoutSeconds": 60     },     {       "example": {@@ -1997,7 +1997,7 @@       },       "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.",-      "timeoutSec": 15+      "timeoutSeconds": 15     },     {       "example": {@@ -2014,7 +2014,7 @@       },       "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.",-      "timeoutSec": 30+      "timeoutSeconds": 30     },     {       "example": {@@ -2037,7 +2037,7 @@       },       "statusVerb": null,       "summary": "Load a FAB's design rules (DRC) into the open board. The rule packs live on the wiki page adom/pcb-design-rules (JLCPCB, PCBWay, OSH Park, Seeed, Eurocircuits, Aisler, Elecrow, Advanced Circuits, Sierra, MacroFab, NextPCB, ALLPCB and Adom InstaPCB; one .edru per vendor/process/layer count, every number citing the vendor's own capabilities page): the bridge fetches the pack, stages it on the box, and the add-in runs `drc load`. {action:'list'} answers with every (fab, process, layers) row so you can offer the user a real choice; no fab means the bundled Adom InstaPCB rules; druPath loads a local .edru. Layers auto-detects from the open board. ALWAYS confirm with fusion_alerts afterwards: a refused file is an in-canvas toast, never a dialog.",-      "timeoutSec": 90+      "timeoutSeconds": 90     },     {       "example": {},@@ -2052,7 +2052,7 @@       },       "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.",-      "timeoutSec": 15+      "timeoutSeconds": 15     },     {       "example": {@@ -2075,7 +2075,7 @@       },       "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`.",-      "timeoutSec": 30+      "timeoutSeconds": 30     },     {       "example": {},@@ -2090,7 +2090,7 @@       },       "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).",-      "timeoutSec": 15+      "timeoutSeconds": 15     },     {       "example": {},@@ -2105,7 +2105,7 @@       },       "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.",-      "timeoutSec": 15+      "timeoutSeconds": 15     },     {       "example": {},@@ -2119,7 +2119,7 @@       },       "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.",-      "timeoutSec": 70+      "timeoutSeconds": 70     },     {       "example": {},@@ -2134,7 +2134,7 @@       },       "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()).",-      "timeoutSec": 70+      "timeoutSeconds": 70     },     {       "example": {@@ -2160,7 +2160,7 @@       },       "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.",-      "timeoutSec": 300+      "timeoutSeconds": 300     },     {       "example": {@@ -2185,7 +2185,7 @@       },       "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).",-      "timeoutSec": 180+      "timeoutSeconds": 180     },     {       "example": {@@ -2205,7 +2205,7 @@       },       "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.",-      "timeoutSec": 240+      "timeoutSeconds": 240     },     {       "example": {@@ -2227,7 +2227,7 @@       },       "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.",-      "timeoutSec": 240+      "timeoutSeconds": 240     },     {       "example": {},@@ -2243,7 +2243,7 @@       },       "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.",-      "timeoutSec": 70+      "timeoutSeconds": 70     },     {       "example": {@@ -2268,7 +2268,7 @@       },       "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.",-      "timeoutSec": 180+      "timeoutSeconds": 180     },     {       "example": {},@@ -2295,7 +2295,7 @@       },       "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.",-      "timeoutSec": 120+      "timeoutSeconds": 120     },     {       "example": {@@ -2314,7 +2314,7 @@       },       "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.",-      "timeoutSec": 90+      "timeoutSeconds": 90     },     {       "example": {},@@ -2328,7 +2328,7 @@       },       "statusVerb": null,       "summary": "Launch Fusion 360 (if needed) and wait for the AdomBridge add-in to be ready.",-      "timeoutSec": 150+      "timeoutSeconds": 150     },     {       "example": {},@@ -2351,7 +2351,7 @@       },       "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).",-      "timeoutSec": 60+      "timeoutSeconds": 60     },     {       "example": {},@@ -2366,7 +2366,7 @@       },       "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.",-      "timeoutSec": 60+      "timeoutSeconds": 60     },     {       "example": {},@@ -2381,7 +2381,7 @@       },       "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.",-      "timeoutSec": 60+      "timeoutSeconds": 60     },     {       "example": {@@ -2404,7 +2404,7 @@       },       "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.",-      "timeoutSec": 60+      "timeoutSeconds": 60     },     {       "example": {},@@ -2416,7 +2416,7 @@       },       "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.",-      "timeoutSec": 15+      "timeoutSeconds": 15     },     {       "example": {},@@ -2428,7 +2428,7 @@       },       "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.",-      "timeoutSec": 15+      "timeoutSeconds": 15     },     {       "example": {@@ -2450,7 +2450,7 @@       },       "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.",-      "timeoutSec": 240+      "timeoutSeconds": 240     }   ] }

@@ -246,6 +246,15 @@ fn main() {                     "fusion_preflight_lbr" | "preflight_lbr" => native_preflight_lbr(&parsed["args"]),                     // Native since Phase 2: the raw authenticated APS GET (never-charge guarded).                     "fusion_aps_get" | "aps_get" => native_aps_get(&parsed["args"]),+                    // Native since Phase 2: cloud discovery on the Data Management API.+                    "fusion_aps_browse" | "aps_browse" => native_aps_browse(&parsed["args"]),+                    "fusion_aps_search" | "aps_search" => native_aps_search(&parsed["args"]),+                    "fusion_aps_recent" | "aps_recent" => native_aps_recent(&parsed["args"]),+                    "fusion_aps_file_info" | "aps_file_info" => native_aps_file_info(&parsed["args"], false),+                    "fusion_aps_versions" | "aps_versions" => native_aps_file_info(&parsed["args"], true),+                    "fusion_aps_download" | "aps_download" => native_aps_download(&parsed["args"]),+                    "fusion_aps_create_folder" | "aps_create_folder" => native_aps_create_folder(&parsed["args"]),+                    "fusion_aps_upload" | "aps_upload" => native_aps_upload(&parsed["args"]),                     "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."}),@@ -475,3 +484,228 @@ fn native_aps_get(args: &Value) -> Value { fn proxy_unavailable(why: &str) -> Value {     json!({"success": false, "errorCode": "not_native_yet", "error": why, "shell": "rust"}) }+++fn not_signed_in() -> Value {+    json!({"success": false, "error": "Not signed in to APS.", "errorCode": "aps_not_signed_in", "_hint": fusion_core::aps::APS_REQUIRED_HINT, "shell": "rust"})+}++/// `fusion_aps_browse`: hubs+projects → top folders → folder contents, no Fusion needed.+fn native_aps_browse(args: &Value) -> Value {+    use fusion_core::aps::*;+    let store = ApsStore::default_location();+    if store.valid_access_token().is_none() { return not_signed_in(); }+    let (hub_id, project_id, folder_id) = (args["hubId"].as_str(), args["projectId"].as_str(), args["folderId"].as_str());+    if let (Some(pid), Some(fid)) = (project_id, folder_id) {+        let (s, b) = aps_get(&store, &format!("/data/v1/projects/{pid}/folders/{fid}/contents"), &[("page[limit]", "200")]).unwrap_or((0, json!({})));+        let items: Vec<Value> = b["data"].as_array().cloned().unwrap_or_default().iter().map(|x| {+            let name = x["attributes"]["displayName"].as_str().or(x["attributes"]["name"].as_str());+            json!({"name": name, "type": x["type"], "id": x["id"]}) }).collect();+        return json!({"success": s == 200, "output": format!("{} item(s)", items.len()), "data": {"level": "folder", "projectId": pid, "folderId": fid, "items": items}, "shell": "rust"});+    }+    if let Some(pid) = project_id {+        let hid = match hub_id { Some(h) => Some(h.to_string()), None => list_hubs(&store).ok().and_then(|hs| hs.first().and_then(|h| h["id"].as_str().map(str::to_string))) };+        let folders = hid.as_deref().map(|h| top_folders(&store, h, pid)).unwrap_or_default();+        let items: Vec<Value> = folders.iter().map(|f| json!({"name": f["attributes"]["name"], "type": "folder", "id": f["id"]})).collect();+        return json!({"success": true, "output": format!("{} top folder(s)", items.len()), "data": {"level": "project", "hubId": hid, "projectId": pid, "items": items}, "shell": "rust"});+    }+    let hubs = match list_hubs(&store) { Ok(h) => h, Err((_, body)) => return json!({"success": false, "error": "APS hubs request failed.", "data": {"body": body}, "shell": "rust"}) };+    let mut out = Vec::new();+    for h in &hubs {+        let hid = h["id"].as_str().unwrap_or("");+        if let Some(f) = hub_id { if hid != f { continue; } }+        let projs: Vec<Value> = list_projects(&store, hid).iter().map(|p| json!({"name": p["attributes"]["name"], "id": p["id"]})).collect();+        out.push(json!({"hub": h["attributes"]["name"], "hubId": hid, "projects": projs}));+    }+    let nproj: usize = out.iter().map(|x| x["projects"].as_array().map(|a| a.len()).unwrap_or(0)).sum();+    json!({"success": true, "output": format!("{} hub(s), {} project(s)", out.len(), nproj), "data": {"level": "hubs", "hubs": out}, "shell": "rust"})+}++/// `fusion_aps_search`: the server-indexed name search across the hub, newest first.+fn native_aps_search(args: &Value) -> Value {+    use fusion_core::aps::*;+    let query = args["query"].as_str().unwrap_or("").trim().to_string();+    if query.is_empty() { return json!({"success": false, "error": "Missing query.", "shell": "rust"}); }+    let store = ApsStore::default_location();+    if store.valid_access_token().is_none() { return not_signed_in(); }+    let limit = args["limit"].as_u64().unwrap_or(50) as usize;+    let hubs = match list_hubs(&store) { Ok(h) => h, Err((s, body)) => return json!({"success": false, "error": "APS hubs request failed.", "data": {"httpStatus": s, "body": body},+        "_hint": "Token may lack data:read scope or the app isn't Data-Management-enabled.", "shell": "rust"}) };+    let mut scanned = (0, 0, 0);+    let tasks = scan_tasks(&store, &hubs, args["hubId"].as_str(), args["projectId"].as_str(), &mut scanned);+    let mut results = scan_parallel(&store, tasks, &query, limit, true);+    results.sort_by(|a, b| b["lastModified"].as_str().unwrap_or("").cmp(a["lastModified"].as_str().unwrap_or("")));+    let n = results.len();+    let shown: Vec<Value> = results.into_iter().take(limit).collect();+    json!({"success": true, "output": format!("{n} match(es) for '{query}'"),+           "data": {"query": query, "count": n, "results": shown, "scanned": {"hubs": scanned.0, "projects": scanned.1, "folders": scanned.2}}, "shell": "rust",+           "_hint": format!("Found {n} match(es) via the APS server index across {} project(s), newest first. Pass projectId to scope to one project (faster). Use fusion_aps_open to open a hit in Fusion.", scanned.1)})+}++/// `fusion_aps_recent`: most-recently-modified files across the hub (or one project).+fn native_aps_recent(args: &Value) -> Value {+    use fusion_core::aps::*;+    let store = ApsStore::default_location();+    if store.valid_access_token().is_none() { return not_signed_in(); }+    let limit = args["limit"].as_u64().unwrap_or(25) as usize;+    let hubs = match list_hubs(&store) { Ok(h) => h, Err((_, body)) => return json!({"success": false, "error": "APS hubs request failed.", "data": {"body": body}, "shell": "rust"}) };+    let mut scanned = (0, 0, 0);+    let tasks = scan_tasks(&store, &hubs, args["hubId"].as_str(), args["projectId"].as_str(), &mut scanned);+    let mut items: Vec<Value> = scan_parallel(&store, tasks, "", 200, false).into_iter().filter(|i| i["lastModified"].as_str().map(|s| !s.is_empty()).unwrap_or(false)).collect();+    items.sort_by(|a, b| b["lastModified"].as_str().unwrap_or("").cmp(a["lastModified"].as_str().unwrap_or("")));+    let items: Vec<Value> = items.into_iter().take(limit).collect();+    json!({"success": true, "output": format!("{} recent file(s)", items.len()), "data": {"count": items.len(), "results": items}, "shell": "rust",+           "_hint": "Most-recently-modified designs across the team hub, newest first."})+}+++/// `fusion_aps_file_info` (tip + up to 20 versions) and `fusion_aps_versions` (every version):+/// who last changed a file, when, how many versions. `query` resolves through the native+/// search (newest match), else projectId + urn (a version urn is reduced to its lineage).+fn native_aps_file_info(args: &Value, full: bool) -> Value {+    use fusion_core::aps::*;+    let store = ApsStore::default_location();+    if store.valid_access_token().is_none() { return not_signed_in(); }+    let (mut project_id, mut urn, mut name) = (args["projectId"].as_str().map(str::to_string), args["urn"].as_str().map(str::to_string), args["name"].as_str().map(str::to_string));+    let query = args["query"].as_str().unwrap_or("").trim().to_string();+    if !query.is_empty() && !(project_id.is_some() && urn.is_some()) {+        let found = native_aps_search(&json!({"query": query, "limit": 5}));+        let first = found["data"]["results"].as_array().and_then(|a| a.first().cloned());+        let Some(m) = first else { return json!({"success": false, "error": format!("No cloud file matching '{query}'."), "shell": "rust"}) };+        project_id = m["projectId"].as_str().map(str::to_string); urn = m["id"].as_str().map(str::to_string); name = m["name"].as_str().map(str::to_string);+    }+    let (Some(pid), Some(urn)) = (project_id, urn) else { return json!({"success": false, "error": "Provide query, or projectId + urn.", "shell": "rust"}) };+    let raw = urn.split('?').next().unwrap_or("").to_string();+    let item_urn = match raw.find("fs.file:vf.") { Some(i) => format!("urn:adsk.wipprod:dm.lineage:{}", &raw[i + "fs.file:vf.".len()..]), None => urn.clone() };+    let enc = urlencode(&item_urn);+    let q: &[(&str, &str)] = if full { &[("page[limit]", "200")] } else { &[] };+    let (s, b) = aps_get(&store, &format!("/data/v1/projects/{pid}/items/{enc}/versions"), q).unwrap_or((0, json!({})));+    if s != 200 || !b.is_object() {+        return json!({"success": false, "error": "Could not fetch versions.", "data": {"httpStatus": s, "body": b, "itemUrn": item_urn}, "shell": "rust"});+    }+    let mut versions: Vec<Value> = b["data"].as_array().cloned().unwrap_or_default().iter().map(|v| {+        let a = &v["attributes"];+        let mut row = json!({"versionNumber": a["versionNumber"], "lastModifiedTime": a["lastModifiedTime"], "lastModifiedUserName": a["lastModifiedUserName"],+                             "createTime": a["createTime"], "createUserName": a["createUserName"], "storageSize": a["storageSize"]});+        if full { row["id"] = v["id"].clone(); }+        row }).collect();+    versions.sort_by(|x, y| y["versionNumber"].as_i64().unwrap_or(0).cmp(&x["versionNumber"].as_i64().unwrap_or(0)));+    let n = versions.len();+    let label = name.clone().unwrap_or_else(|| item_urn.clone());+    if full {+        json!({"success": true, "output": format!("{label}: {n} version(s)"),+               "data": {"name": name, "projectId": pid, "itemUrn": item_urn, "versionCount": n, "versions": versions}, "shell": "rust",+               "_hint": "Complete version history, newest-first."})+    } else {+        let tip = versions.first().cloned().unwrap_or(json!({}));+        let shown: Vec<Value> = versions.iter().take(20).cloned().collect();+        json!({"success": true, "output": format!("{label}: {n} version(s), last by {}", tip["lastModifiedUserName"].as_str().unwrap_or("None")),+               "data": {"name": name, "projectId": pid, "itemUrn": item_urn, "versionCount": n, "tip": tip, "versions": shown}, "shell": "rust",+               "_hint": "Version history newest-first; tip = current version (who/when/size)."})+    }+}+++/// `fusion_aps_download`: a cloud file to the local machine, no Fusion needed. query or+/// projectId + urn; the tip version's storage object is fetched through a signed S3 URL.+fn native_aps_download(args: &Value) -> Value {+    use fusion_core::aps::*;+    let store = ApsStore::default_location();+    if store.valid_access_token().is_none() { return not_signed_in(); }+    let (mut project_id, mut urn, mut name) = (args["projectId"].as_str().map(str::to_string), args["urn"].as_str().map(str::to_string), args["name"].as_str().map(str::to_string));+    let query = args["query"].as_str().unwrap_or("").trim().to_string();+    if !query.is_empty() && !(project_id.is_some() && urn.is_some()) {+        let found = native_aps_search(&json!({"query": query, "limit": 5}));+        let Some(m) = found["data"]["results"].as_array().and_then(|a| a.first().cloned()) else { return json!({"success": false, "error": format!("No cloud file matching '{query}'."), "shell": "rust"}) };+        project_id = m["projectId"].as_str().map(str::to_string); urn = m["id"].as_str().map(str::to_string); name = m["name"].as_str().map(str::to_string);+    }+    let (Some(pid), Some(urn)) = (project_id, urn) else { return json!({"success": false, "error": "Provide query, or projectId + urn.", "shell": "rust"}) };+    let version_urn = match tip_version_urn(&store, &pid, &urn) { Ok(v) => v, Err(e) => return json!({"success": false, "error": "Could not resolve a version.", "data": {"detail": [e.0, e.1]}, "shell": "rust"}) };+    let (storage, vname) = match storage_of_version(&store, &pid, &version_urn) { Ok(x) => x, Err(e) => return json!({"success": false, "error": "Could not find storage for this version.", "data": {"detail": [e.0, e.1]}, "shell": "rust"}) };+    let (bucket, obj) = parse_oss(&storage);+    let (s, b) = aps_get(&store, &format!("/oss/v2/buckets/{bucket}/objects/{}/signeds3download", urlencode(&obj)), &[]).unwrap_or((0, json!({})));+    let Some(url) = b["url"].as_str().filter(|_| s == 200) else { return json!({"success": false, "error": "Could not get a download URL.", "data": {"httpStatus": s, "body": b}, "shell": "rust"}) };+    let home = std::env::var("USERPROFILE").or_else(|_| std::env::var("HOME")).unwrap_or_default();+    let save_dir = args["saveDir"].as_str().map(str::to_string).unwrap_or_else(|| format!("{home}/Downloads"));+    let fname = args["fileName"].as_str().map(str::to_string).or(vname).or(name).unwrap_or_else(|| "download.bin".into());+    let _ = std::fs::create_dir_all(&save_dir);+    let out_path = std::path::Path::new(&save_dir).join(&fname);+    let (st, data) = http_bytes(url);+    if st != 200 { return json!({"success": false, "error": format!("Download failed (HTTP {st})."), "data": {"bytes": data.len()}, "shell": "rust"}); }+    if let Err(e) = std::fs::write(&out_path, &data) { return json!({"success": false, "error": format!("Could not write {}: {e}", out_path.display()), "shell": "rust"}); }+    let n = data.len();+    let pretty = { let s = n.to_string(); let mut o = String::new(); for (i, c) in s.chars().enumerate() { if i > 0 && (s.len() - i) % 3 == 0 { o.push(','); } o.push(c); } o };+    json!({"success": true, "output": format!("Downloaded {fname} ({pretty} bytes) to {}", out_path.to_string_lossy()),+           "data": {"path": out_path.to_string_lossy(), "bytes": n, "name": fname, "version": version_urn}, "shell": "rust",+           "_hint": "Saved to the local machine; opening in Fusion is a separate step (fusion_aps_open)."})+}+++fn aps_err(e: fusion_core::aps::ApsError) -> (u16, Value) { (0, json!({"error": e.to_string()})) }++/// `fusion_aps_create_folder {projectId, parentFolderId, name}`: a subfolder in a project.+fn native_aps_create_folder(args: &Value) -> Value {+    use fusion_core::aps::*;+    let store = ApsStore::default_location();+    if store.valid_access_token().is_none() { return not_signed_in(); }+    let pid = args["projectId"].as_str().unwrap_or("");+    let parent = args["parentFolderId"].as_str().or(args["folderId"].as_str()).unwrap_or("");+    let name = args["name"].as_str().unwrap_or("").trim().to_string();+    if pid.is_empty() || parent.is_empty() || name.is_empty() { return json!({"success": false, "error": "Provide projectId, parentFolderId, name.", "shell": "rust"}); }+    let body = json!({"jsonapi": {"version": "1.0"}, "data": {"type": "folders",+        "attributes": {"name": name, "extension": {"type": "folders:autodesk.core:Folder", "version": "1.0"}},+        "relationships": {"parent": {"data": {"type": "folders", "id": parent}}}}});+    let (s, b) = aps_call(&store, "POST", &format!("/data/v1/projects/{pid}/folders"), &[], Some(&body)).unwrap_or_else(aps_err);+    if !(s == 200 || s == 201) || !b.is_object() {+        return json!({"success": false, "error": "Create folder failed.", "data": {"httpStatus": s, "body": b}, "shell": "rust",+                      "_hint": "HTTP 403 = sign-in lacks data:write/data:create (fusion_aps_signin again). 409 = a folder with that name already exists here."});+    }+    json!({"success": true, "output": format!("Created folder '{name}'"), "data": {"folderId": b["data"]["id"], "name": name, "projectId": pid}, "shell": "rust"})+}++/// `fusion_aps_upload {projectId, folderId, localPath, fileName?}`: a local file as a NEW+/// cloud file: reserve storage, signed S3 PUT, complete, create the item (version 1).+fn native_aps_upload(args: &Value) -> Value {+    use fusion_core::aps::*;+    let store = ApsStore::default_location();+    if store.valid_access_token().is_none() { return not_signed_in(); }+    let (pid, fid, local) = (args["projectId"].as_str().unwrap_or(""), args["folderId"].as_str().unwrap_or(""), args["localPath"].as_str().unwrap_or(""));+    if pid.is_empty() || fid.is_empty() || local.is_empty() { return json!({"success": false, "error": "Provide projectId, folderId, localPath.", "shell": "rust"}); }+    // FOLDER HYGIENE: never dump loose files into a shared project ROOT (fusion-cloud-hygiene).+    if fid == "urn:adsk.wipprod:fs.folder:co.jyO4vxQXR6S9zFpTQWnZAg" {+        return json!({"success": false, "errorCode": "refused_root_upload", "shell": "rust",+            "error": "REFUSED: that folderId is a shared project ROOT - the bridge never writes loose files there (it clutters the team's cloud).",+            "_hint": "Create/choose a real subfolder first (fusion_aps_create_folder under an 'Adom AI Workspace' folder), or just call fusion_make_3d_package / fusion_build_library_3d, which now default to a non-root workspace folder. See the fusion-cloud-hygiene skill."});+    }+    let Ok(data) = std::fs::read(local) else { return json!({"success": false, "error": format!("Local file not found: {local}"), "shell": "rust"}) };+    let fname = args["fileName"].as_str().map(str::to_string).unwrap_or_else(|| std::path::Path::new(local).file_name().map(|f| f.to_string_lossy().to_string()).unwrap_or_default());+    let sbody = json!({"jsonapi": {"version": "1.0"}, "data": {"type": "objects", "attributes": {"name": fname}, "relationships": {"target": {"data": {"type": "folders", "id": fid}}}}});+    let (s, b) = aps_call(&store, "POST", &format!("/data/v1/projects/{pid}/storage"), &[], Some(&sbody)).unwrap_or_else(aps_err);+    if !(s == 200 || s == 201) || !b.is_object() {+        return json!({"success": false, "error": "Storage reservation failed.", "data": {"httpStatus": s, "body": b}, "shell": "rust",+                      "_hint": "HTTP 403 = sign-in lacks data:write/data:create - fusion_aps_signin again."});+    }+    let storage_urn = b["data"]["id"].as_str().unwrap_or("").to_string();+    let (bucket, obj) = parse_oss(&storage_urn);+    let objenc = urlencode(&obj);+    let (s, b) = aps_get(&store, &format!("/oss/v2/buckets/{bucket}/objects/{objenc}/signeds3upload"), &[]).unwrap_or_else(aps_err);+    let (Some(upload_key), Some(put_url)) = (b["uploadKey"].as_str(), b["urls"][0].as_str()) else {+        return json!({"success": false, "error": "Could not get an upload URL.", "data": {"httpStatus": s, "body": b}, "shell": "rust"}) };+    let st = http_put_bytes(put_url, &data);+    if !(st == 200 || st == 201) { return json!({"success": false, "error": format!("S3 upload PUT failed (HTTP {st})."), "shell": "rust"}); }+    let (s, b) = aps_call_ct(&store, "POST", &format!("/oss/v2/buckets/{bucket}/objects/{objenc}/signeds3upload"), &[], Some(&json!({"uploadKey": upload_key})), "application/json").unwrap_or_else(aps_err);+    if !(s == 200 || s == 201 || s == 202) { return json!({"success": false, "error": "Upload completion failed.", "data": {"httpStatus": s, "body": b}, "shell": "rust"}); }+    let ibody = json!({"jsonapi": {"version": "1.0"},+        "data": {"type": "items", "attributes": {"displayName": fname, "extension": {"type": "items:autodesk.core:File", "version": "1.0"}},+                 "relationships": {"tip": {"data": {"type": "versions", "id": "1"}}, "parent": {"data": {"type": "folders", "id": fid}}}},+        "included": [{"type": "versions", "id": "1", "attributes": {"name": fname, "extension": {"type": "versions:autodesk.core:File", "version": "1.0"}},+                      "relationships": {"storage": {"data": {"type": "objects", "id": storage_urn}}}}]});+    let (s, b) = aps_call(&store, "POST", &format!("/data/v1/projects/{pid}/items"), &[], Some(&ibody)).unwrap_or_else(aps_err);+    if !(s == 200 || s == 201) || !b.is_object() {+        return json!({"success": false, "error": "Create item failed (this verb uploads NEW files; the name may already exist).", "data": {"httpStatus": s, "body": b}, "shell": "rust"});+    }+    let n = data.len();+    let pretty = { let t = n.to_string(); let mut o = String::new(); for (i, c) in t.chars().enumerate() { if i > 0 && (t.len() - i) % 3 == 0 { o.push(','); } o.push(c); } o };+    json!({"success": true, "output": format!("Uploaded '{fname}' ({pretty} bytes) as a new cloud file."),+           "data": {"itemUrn": b["data"]["id"], "name": fname, "bytes": n, "projectId": pid, "folderId": fid}, "shell": "rust"})+}

@@ -146,6 +146,11 @@ pub fn aps_get(store: &ApsStore, path: &str, query: &[(&str, &str)]) -> Result<( }  pub fn aps_call(store: &ApsStore, method: &str, path: &str, query: &[(&str, &str)], body: Option<&Value>) -> Result<(u16, Value), ApsError> {+    aps_call_ct(store, method, path, query, body, "application/vnd.api+json")+}++/// `aps_call` with an explicit Content-Type (OSS upload completion wants plain JSON).+pub fn aps_call_ct(store: &ApsStore, method: &str, path: &str, query: &[(&str, &str)], body: Option<&Value>, content_type: &str) -> Result<(u16, Value), ApsError> {     let at = store.valid_access_token().ok_or(ApsError::NotSignedIn)?;     if !is_free_endpoint(path) { return Err(ApsError::BlockedNonFree(only_path(path))); }     if store.cap_remaining() == 0 { return Err(ApsError::UsageCap); }@@ -158,7 +163,7 @@ pub fn aps_call(store: &ApsStore, method: &str, path: &str, query: &[(&str, &str     let agent = ureq::AgentBuilder::new().timeout(Duration::from_secs(120)).build();     let req = agent.request(method, &url).set("Authorization", &format!("Bearer {at}"));     let resp = match body {-        Some(b) => req.set("Content-Type", "application/vnd.api+json").send_string(&b.to_string()),+        Some(b) => req.set("Content-Type", content_type).send_string(&b.to_string()),         None => req.call(),     };     let (status, text) = match resp {@@ -206,3 +211,186 @@ mod tests {     #[test]     fn urlencode_is_form_safe() { assert_eq!(urlencode("a b/c?d=e&f"), "a%20b%2Fc%3Fd%3De%26f"); assert_eq!(urlencode("abc-_.~"), "abc-_.~"); } }+++// ───────────────────────── cloud discovery on the Data Management API ─────────────────────────++/// The Python bridge's APS_REQUIRED_HINT, verbatim.+pub const APS_REQUIRED_HINT: &str = "APS IS MANDATORY for cloud file search/browse/recent - SET IT UP, do not give up, do not fall back. ⛔ NEVER enumerate cloud files via app.data (dataProjects/dataFiles) in fusion_run_modeling_script: the DEPRECATED method holds Fusion's main thread for minutes, times out, and locks the app. AUTO-RECOVER APS instead: (1) NOT configured? The org Client ID is a PUBLIC PKCE id - pull it from a peer that has it: read ~/.adom/fusion-aps/config.json (key 'client_id') off another ab desktop (adom-desktop status lists them) via shell_execute/pull_file, then fusion_aps_set_client_id {clientId}. (2) fusion_aps_signin -> open the returned authUrl in the user's REAL browser with a warm Autodesk session; INSTALL + USE the adom-browser-extension (nbrowser/ABE, https://wiki.adom.inc/adom/adom-browser-extension) to drive it reliably (recommend it - coordinate-clicking a browser is fragile). The localhost listener captures the token; poll fusion_aps_status until signedIn:true. (3) retry. If authorize returns AUTH-001 'client_id does not have access to the api product': the APS app at aps.autodesk.com/myapps lost its Data Management API product - re-commit its API Access + Save, wait a few minutes to propagate, retry.";++fn data_array(v: &Value) -> Vec<Value> { v["data"].as_array().cloned().unwrap_or_default() }+fn attr<'a>(it: &'a Value, k: &str) -> &'a str { it["attributes"][k].as_str().unwrap_or("") }++/// GET /project/v1/hubs → (hubs, error) exactly like `_list_hubs`.+pub fn list_hubs(store: &ApsStore) -> Result<Vec<Value>, (u16, Value)> {+    match aps_get(store, "/project/v1/hubs", &[]) {+        Ok((200, body)) if body.is_object() => Ok(data_array(&body)),+        Ok((s, body)) => Err((s, body)),+        Err(e) => Err((0, json!({"error": e.to_string()}))),+    }+}+pub fn list_projects(store: &ApsStore, hub_id: &str) -> Vec<Value> {+    match aps_get(store, &format!("/project/v1/hubs/{hub_id}/projects"), &[]) { Ok((200, b)) => data_array(&b), _ => vec![] }+}+pub fn top_folders(store: &ApsStore, hub_id: &str, project_id: &str) -> Vec<Value> {+    match aps_get(store, &format!("/project/v1/hubs/{hub_id}/projects/{project_id}/topFolders"), &[]) { Ok((200, b)) => data_array(&b), _ => vec![] }+}++/// Recursive name search within a folder: the folder's DIRECT contents first (`:search`+/// only recurses subfolders), then APS's server-side recursive index, paged, filtered+/// client-side by case-insensitive substring (the server-side displayName filter proved+/// unreliable). Stops at `limit` matches. An empty query matches everything.+pub fn folder_search(store: &ApsStore, project_id: &str, folder_id: &str, query: &str, limit: usize) -> (Vec<Value>, Option<(u16, Value)>) {+    let ql = query.to_lowercase();+    let mut matches: Vec<Value> = Vec::new();+    let mut seen: std::collections::HashSet<String> = std::collections::HashSet::new();+    let mut take = |it: &Value, matches: &mut Vec<Value>| -> bool {+        let id = it["id"].as_str().unwrap_or("").to_string();+        if seen.contains(&id) { return false; }+        if attr(it, "displayName").to_lowercase().contains(&ql) { seen.insert(id); matches.push(it.clone()); }+        matches.len() >= limit+    };+    if let Ok((200, body)) = aps_get(store, &format!("/data/v1/projects/{project_id}/folders/{folder_id}/contents"), &[("page[limit]", "200")]) {+        for it in data_array(&body) { if it["type"].as_str() == Some("items") && take(&it, &mut matches) { return (matches, None); } }+    }+    let mut url = format!("/data/v1/projects/{project_id}/folders/{folder_id}/search");+    let mut first = true;+    for _ in 0..25 {+        let q: &[(&str, &str)] = if first { &[("page[limit]", "200")] } else { &[] };+        first = false;+        match aps_get(store, &url, q) {+            Ok((200, body)) if body.is_object() => {+                for it in data_array(&body) { if take(&it, &mut matches) { return (matches, None); } }+                let nxt = &body["links"]["next"];+                let href = nxt["href"].as_str().or_else(|| nxt.as_str()).map(str::to_string);+                match href { Some(h) if !h.is_empty() => url = h, _ => break }+            }+            Ok((s, body)) => return (matches.clone(), if matches.is_empty() { Some((s, body)) } else { None }),+            Err(e) => return (matches.clone(), if matches.is_empty() { Some((0, json!({"error": e.to_string()}))) } else { None }),+        }+    }+    (matches, None)+}++/// One (hub, project, folder) to scan; what `handle_search` / `handle_recent` build.+#[derive(Clone)]+pub struct ScanTask { pub hub_id: String, pub project_id: String, pub project_name: String, pub folder_id: String }++/// The (hub, project, top folder) task list, honouring hub/project filters like Python.+pub fn scan_tasks(store: &ApsStore, hubs: &[Value], hub_filter: Option<&str>, project_filter: Option<&str>, scanned: &mut (usize, usize, usize)) -> Vec<ScanTask> {+    let mut tasks = Vec::new();+    for hub in hubs {+        let hid = hub["id"].as_str().unwrap_or("").to_string();+        if let Some(f) = hub_filter { if hid != f { continue; } }+        scanned.0 += 1;+        let mut projects = list_projects(store, &hid);+        if let Some(pf) = project_filter {+            let kept: Vec<Value> = projects.iter().filter(|p| p["id"].as_str() == Some(pf)).cloned().collect();+            projects = if kept.is_empty() { vec![json!({"id": pf, "attributes": {"name": pf}})] } else { kept };+        }+        for p in projects {+            let pid = p["id"].as_str().unwrap_or("").to_string();+            let pname = attr(&p, "name").to_string();+            scanned.1 += 1;+            for f in top_folders(store, &hid, &pid) {+                scanned.2 += 1;+                tasks.push(ScanTask { hub_id: hid.clone(), project_id: pid.clone(), project_name: pname.clone(), folder_id: f["id"].as_str().unwrap_or("").to_string() });+            }+        }+    }+    tasks+}++/// Scan every task in parallel (12 workers, like the Python pool), dedupe by id, newest first.+pub fn scan_parallel(store: &ApsStore, tasks: Vec<ScanTask>, query: &str, per_folder_limit: usize, with_hub: bool) -> Vec<Value> {+    use std::sync::{Arc, Mutex};+    let queue = Arc::new(Mutex::new(tasks));+    let out = Arc::new(Mutex::new(Vec::<(usize, Vec<Value>)>::new()));+    let dir = store.dir.clone();+    let query = query.to_string();+    let mut handles = Vec::new();+    let total = queue.lock().unwrap().len();+    let mut idx = 0usize;+    let indexed: Vec<(usize, ScanTask)> = queue.lock().unwrap().drain(..).map(|t| { idx += 1; (idx - 1, t) }).collect();+    let queue = Arc::new(Mutex::new(indexed));+    for _ in 0..12.min(total.max(1)) {+        let (queue, out, dir, query) = (queue.clone(), out.clone(), dir.clone(), query.clone());+        handles.push(std::thread::spawn(move || {+            let store = ApsStore { dir };+            loop {+                let next = queue.lock().unwrap().pop();+                let Some((i, t)) = next else { break };+                let (hits, _) = folder_search(&store, &t.project_id, &t.folder_id, &query, per_folder_limit);+                let rows: Vec<Value> = hits.iter().map(|h| {+                    let mut r = json!({"name": attr(h, "displayName"), "type": h["type"], "id": h["id"],+                                       "projectId": t.project_id, "projectName": t.project_name, "lastModified": h["attributes"]["lastModifiedTime"]});+                    if with_hub { r["hubId"] = json!(t.hub_id); }+                    r+                }).collect();+                out.lock().unwrap().push((i, rows));+            }+        }));+    }+    for h in handles { let _ = h.join(); }+    let mut chunks = out.lock().unwrap().clone();+    chunks.sort_by_key(|c| c.0); // pool.map order, so the first-seen dedupe matches Python+    let mut seen = std::collections::HashSet::new();+    let mut results = Vec::new();+    for (_, rows) in chunks { for r in rows { let id = r["id"].as_str().unwrap_or("").to_string(); if seen.insert(id) { results.push(r); } } }+    results+}+++/// A version urn stays; a lineage urn resolves to its tip version (like `_tip_version_urn`).+pub fn tip_version_urn(store: &ApsStore, project_id: &str, urn: &str) -> Result<String, (u16, Value)> {+    let raw = urn.split('?').next().unwrap_or("");+    if urn.contains("?version=") || raw.contains("fs.file:vf.") { return Ok(urn.to_string()); }+    let lineage = match raw.find("fs.file:vf.") { Some(i) => format!("urn:adsk.wipprod:dm.lineage:{}", &raw[i + 11..]), None => urn.to_string() };+    match aps_get(store, &format!("/data/v1/projects/{project_id}/items/{}", urlencode(&lineage)), &[]) {+        Ok((200, b)) if b.is_object() => b["data"]["relationships"]["tip"]["data"]["id"].as_str().map(str::to_string).ok_or((200, b.clone())),+        Ok((s, b)) => Err((s, b)),+        Err(e) => Err((0, json!({"error": e.to_string()}))),+    }+}++/// (storage urn, file name) of a concrete version.+pub fn storage_of_version(store: &ApsStore, project_id: &str, version_urn: &str) -> Result<(String, Option<String>), (u16, Value)> {+    match aps_get(store, &format!("/data/v1/projects/{project_id}/versions/{}", urlencode(version_urn)), &[]) {+        Ok((200, b)) if b.is_object() => {+            let d = &b["data"];+            let storage = d["relationships"]["storage"]["data"]["id"].as_str().map(str::to_string).ok_or((200, b.clone()))?;+            Ok((storage, d["attributes"]["name"].as_str().map(str::to_string)))+        }+        Ok((s, b)) => Err((s, b)),+        Err(e) => Err((0, json!({"error": e.to_string()}))),+    }+}++/// urn:adsk.objects:os.object:<bucketKey>/<objectKey> → (bucket, object)+pub fn parse_oss(storage_urn: &str) -> (String, String) {+    let tail = storage_urn.rsplit("os.object:").next().unwrap_or("").to_string();+    match tail.find('/') { Some(i) => (tail[..i].to_string(), tail[i + 1..].to_string()), None => (tail, String::new()) }+}++/// Raw binary GET of a presigned S3 URL (the transfer itself is outside APS, so it is not+/// gated or counted; obtaining the URL was). Returns (status, bytes).+pub fn http_bytes(url: &str) -> (u16, Vec<u8>) {+    let agent = ureq::AgentBuilder::new().timeout(Duration::from_secs(300)).build();+    let mut buf = Vec::new();+    match agent.get(url).call() {+        Ok(r) => { let s = r.status(); let _ = std::io::Read::read_to_end(&mut r.into_reader(), &mut buf); (s, buf) }+        Err(ureq::Error::Status(s, r)) => { let _ = std::io::Read::read_to_end(&mut r.into_reader(), &mut buf); (s, buf) }+        Err(e) => (0, e.to_string().into_bytes()),+    }+}+++/// Raw binary PUT to a presigned S3 URL (outside APS: not gated, not counted).+pub fn http_put_bytes(url: &str, data: &[u8]) -> u16 {+    let agent = ureq::AgentBuilder::new().timeout(Duration::from_secs(600)).build();+    match agent.put(url).set("Content-Type", "application/octet-stream").send_bytes(data) {+        Ok(r) => r.status(),+        Err(ureq::Error::Status(s, _)) => s,+        Err(_) => 0,+    }+}