Altium - the Altium Bridge

@@ -1,5 +1,18 @@ # Changelog +## 0.2.45 (2026-10-15)+First live run since 0.2.39 on a licensed Altium (Altium Designer Develop, Colby-ROG2). It verified the held 0.2.40-0.2.44 features and fixed what the run and two new issues found.++- **A save into a missing folder no longer fails silently.** `altium_test_board {pcbPath}` and `altium_place_on_sch {schPath}` answered with the path while Altium's save wrote nothing (the folder did not exist), so the next "append" found no board and started a new one. The bridge now creates the folder first and checks the file on disk: `saved:true`, or `errorCode: not_saved`. A document that is open but not yet saved now counts as existing for append.+- **Appending to a schematic grows the sheet** (`sheetGrown`), so the added parts stay inside the drawing frame instead of landing in the gray past its right edge.+- **`altium_board_shape` proves its own result** (adom/altium-bridge#16). It, `pcb_report {want:'board'}` and `read_board`'s outline now read the outline's vertices: `BoardOutline.BoundingRectangle` is cached and kept the 6000 x 4000 mil default after a reshape, on AD 26.9.1 and Altium Develop alike. New `mechOutline:true` draws the rectangle on Mechanical 1 so the fab Gerber has an outline (the board shape alone is plotted into none).+- **`altium_test_board` parts carry their own name and footprint** (adom/altium-bridge#17). The part name is the component's Comment, so it moves with the part (loose overlay text stayed behind and piled up in the silkscreen Gerber), and `Pattern` is the footprint name (it was empty, so BOM, STEP naming and footprint comparison saw nothing).+- **New `altium_uninstall_library` and `altium_list_installed_libraries`** (adom/altium-bridge#14). Uninstall matches `libraryName` (file stem: the SchLib and the PcbLib together) or an exact `libraryPath`, closes any open document for the library first, never touches the files, and answers `notInstalled:true` when nothing matches. Verified across a clean restart. It also cleared two dead "UI" entries left behind when 0.2.9 flattened the bundle folder.+- **The "X2 / Continue execution?" script box is classified** (`script_runtime_error`, safe action Cancel) instead of scanning as unknown: its text is painted, so it is only in the photo.+- `altium_panel`'s timeout now says why: on Altium Develop a UI Automation search of the main window takes over 20 s, and no Altium process switches a docked tab; opening a library already brings its panel to the front.+- Verified live, no code change: append on board and sheet (#11), focus kept on the user's window through document opens and agent restarts (#12), `altium_panel` answers inside its budget and the next verb is not delayed (#13).++ ## 0.2.44 (2026-09-29) - **The Altium extension DLL is signed too.** `extension/AdomBridge/AdomBridge.dll` now carries the same Adom Industries, Inc. signature as `altium-bridge.exe`: Windows Smart App Control checks the DLLs a program loads, not only the exe it starts, so an unsigned plugin could be refused on a PC where it is on. The release script signs and verifies every exe and DLL it ships and refuses to package any that is unsigned. Code otherwise identical to 0.2.43. 

@@ -60,7 +60,8 @@ All 16 named pins (GND/TXD/RXD/V3/UD+/UD-/XI/XO · VCC/R232/RTS#/DTR#/DCD#/RI#/D  The symbol placed as U1 on a fresh sheet (per-primitive copy — the engine's group `Replicate` drops children; the bridge handles that for you). `symbolName` takes a `;` list-(from 0.2.13): every part lands on the same new sheet as U1..Un.+(from 0.2.13): every part lands on the same sheet as U1..Un. Pass an existing `schPath` to ADD+symbols to that sheet; it grows to keep them inside the frame (from 0.2.45).  Sheet sizing (from 0.2.16 / 0.2.17): the sheet is sized from the parts, not the parts from the sheet. The agent first measures every symbol's bounding box (pins included, plus 250 mil a side@@ -87,11 +88,11 @@ rounded pads, sixteen through-hole heatsink vias in the EP (all designator 49 � silk pin-1 dot, and the PIN1 / GND_EP stub tracks that survived both swaps untouched.  `altium_test_board` takes a `;` list in `footprintName` (from 0.2.13): the parts are spread-evenly along X on one new board. From 0.2.18 / 0.2.19 the parts are designated U1..Un (so-`component_pins` and `footprint_primitives` can address each one) and each part's name is-written on the Top Overlay under its footprint: 35 mil stroke text, centred on the part from-the text's measured width, its top 2.5 mm below the part centre so it clears the courtyard of-a 3 mm part.+evenly along X on one board. The parts are designated U1..Un (so `component_pins` and+`footprint_primitives` can address each one). Each part's name is its own Comment on the Top+Overlay under its footprint, so it moves with the part, and its `Pattern` is the footprint name+(from 0.2.45). Pass an existing `pcbPath` to ADD parts to that board (from 0.2.40), and+`altium_board_shape {mechOutline:true}` to give the fab Gerber an outline (from 0.2.45).  ![LAN7800 2D board](https://wiki.adom.inc/blob/app/altium-bridge/docs/img/lan7800-board-2d.png) 

@@ -32,7 +32,7 @@ Altium is a licensed host app. The bridge never installs it silently; it detects ## The 8 conventions  1. **Poll readiness, don't launch blindly.** `altium_readiness` → act on the row above → drive.-2. **Background by default.** Every `show_*` opens in the background and hands focus back; `windowEtiquette` in the response says where the window went. Only Altium's own cold launch foregrounds. If you must foreground, toast the user first (`notify_user`) and say why.+2. **Background by default.** Every `show_*` opens in the background and hands focus back; `windowEtiquette` in the response says where the window went. From 0.2.40 every driving verb does the same: if Altium took the foreground during the verb, the user's window is handed back and the reply carries `foregroundReturnedTo`. Only Altium's own cold launch foregrounds. If you must foreground, toast the user first (`notify_user`) and say why. 3. **`ok:true` is not enough — verify.** `show_*` and `state` return frames; look at them. `run_outjob` returns `files[]` actually written. 4. **One script at a time.** While the agent is resident, never run `altium_run_script`; it raises Altium's "Another script executing now" modal. Send work through `altium_eval` / `altium_run_command`. 5. **Never leave a modal.** Prefer commands that carry their parameters (`altium_run_command` with `params`) so no picker opens. After any mutating step, `altium_check_dialogs`.@@ -62,13 +62,14 @@ Altium is a licensed host app. The bridge never installs it silently; it detects | `altium_set_params` | parameters (LCSC Part #, MPN, …), comment, footprint link on a symbol | `libraryPath`, `symbolName`, `params`, `footprint` | | `altium_add_body` | 3D body on a footprint — STEP model or extruded box | `libraryPath`, `footprintName`, `step` \| `bwMil,bhMil,hMil` | | `altium_install_library` / `altium_compile_intlib` / `altium_extract_intlib` | Installed Libraries, .LibPkg → .IntLib, .IntLib → sources | `libraryPath` / `libpkgPath` / `intlibPath` |+| `altium_list_installed_libraries` / `altium_uninstall_library` | read Installed Libraries / remove entries (from 0.2.45; files never touched, any open document for the library is closed first, nothing matching answers `notInstalled:true`). Close Altium with a plain `altium_close` afterwards: a discard close can bring the entry back | (none) / `libraryName` (file stem: SchLib AND PcbLib) or `libraryPath`, `dryRun` | | `altium_build_footprint` / `altium_build_symbol_modes` | author a footprint from a `tools/kicad2altium.py` spec (via pads, roundrect, mech layers) / ONE symbol with N display modes | `libraryPath`, `spec` | | `altium_add_models` / `altium_symbol_mode` | N footprint models + params on a symbol / switch display mode + frame | `symbolName`, `models[]`, `params` / `mode` | | `altium_add_symbol_art` / `altium_symbol_prims` (from 0.2.15) | draw the chip outline adom-symbol baked into the KiCad symbol onto a SchLib component (replaces earlier art unless `clear:false`) / read-only primitive counts, body rectangle, polyline bbox, models | `libraryPath`, `symbolName`, `kicadSym`, `clear`, `mode:"lines"\|"polyline"` / `models:true` | | `altium_set_models` (from 0.2.15) | replace every footprint model on a symbol with ONE PCBLIB model (`set_params` footprint and `add_models` append) | `libraryPath`, `symbolName`, `footprint` | | `altium_plate_vias` (from 0.2.20) | every drilled pad in a PcbLib that loaded on the Top Layer becomes a plated Multi-Layer pad (heatsink vias); `altium_save` afterwards | `libraryPath`, `footprintName` (optional filter) |-| `altium_place_on_sch` | one symbol or a `;` list on ONE new sheet as U1..Un; the sheet is sized from the measured parts (500 mil gaps, 600 mil margins, A4 minimum), designator above and part number below each body, title block filled | `libraryPath`, `symbolName`, `schPath`, `title`, `number`, `revision`, `drawnBy`, `description` |-| `altium_test_board` / `altium_board_shape` / `altium_swap_footprint` | wired test board (one footprint or a `;` list, parts U1..Un with each part's name on the Top Overlay under its footprint), rectangular board shape, footprint swap keeping nets | `footprintName`, `wMm`,`hMm`, `pcbPath`, `assigns`, `stubs` |+| `altium_place_on_sch` | one symbol or a `;` list on ONE sheet as U1..Un (an existing `schPath` is APPENDED to, the sheet grows to fit); the sheet is sized from the measured parts (500 mil gaps, 600 mil margins, A4 minimum), designator above and part number below each body, title block filled | `libraryPath`, `symbolName`, `schPath`, `title`, `number`, `revision`, `drawnBy`, `description` |+| `altium_test_board` / `altium_board_shape` / `altium_swap_footprint` | wired test board (one footprint or a `;` list, parts U1..Un, each named by its own Comment with `Pattern` set; an existing `pcbPath` is APPENDED to), rectangular board shape (outline read back from its vertices; `mechOutline:true` adds a Mechanical 1 fab outline), footprint swap keeping nets | `footprintName`, `wMm`,`hMm`, `pcbPath`, `assigns`, `stubs` / `mechOutline` | | `altium_clone_symbol` / `altium_rename_symbol` / `altium_remove_symbol` / `altium_read_symbol` | library manipulation on a SchLib (clone carries every display mode) | `from`,`to` / `symbolName` | | `altium_copy_footprint` / `altium_rename_footprint` / `altium_remove_footprint` | the same for a PcbLib (copy carries pads, bodies, drawing) | `from`,`to` / `footprintName` | | `altium_pcb_report` / `altium_normalize_bodies` | ground truth (pads/bodies/nets/tracks with bboxes) / centre bodies on pads | `want:"board"`, `footprintName` |

@@ -195,6 +195,14 @@ fn scan_impl(main_pid_only: bool, sel_pid: Option<u64>) -> Vec<Value> {             safe_action = Some("Choose a license".into());             meaning = "Altium's 'You are not currently using an Altium Designer license' prompt (Choose a license | Continue). Choose a license opens the License Management page; the reaper then presses Use License via UIA. 'Continue' would leave Altium in Viewer mode, where scripting is refused — never the right answer for a bridge user.".into();         }+        if category == "unknown" && title.trim() == "X2" && btns.len() == 2+            && btns.iter().any(|b| b.eq_ignore_ascii_case("ok")) && btns.iter().any(|b| b.eq_ignore_ascii_case("cancel")) {+            // the script debugger's "<error> at Line:N ... Continue execution?" box: its text is+            // painted, so it scanned as unknown (seen 2026-10-15 after a bad altium_eval)+            category = "script_runtime_error".into();+            safe_action = Some("Cancel".into());+            meaning = "A script hit a runtime error and Altium's debugger asks 'Continue execution?'. Cancel stops the script cleanly; the resident agent survives. Photograph it first: the error text is only in the picture.".into();+        }         if category == "unknown" && title.to_lowercase().contains("renewal failed") {             category = "licence_seat_stranded".into();             safe_action = Some("OK".into());

@@ -29,7 +29,7 @@ use tiny_http::{Header, Method, Response, Server}; /// Attached to every failed reply (see the /command handler). const REPORT_ISSUES: &str = "If this looks like an altium-bridge BUG (not a refusal you expected), report it: check for a duplicate with `adom-wiki issue list adom/altium-bridge`, then `adom-wiki issue create adom/altium-bridge --title \"<verb>: <one-line symptom>\" --category bug-report --body \"<what you ran, what you expected, what happened, the VERBATIM response JSON (and errorShot if present), bridgeVersion, the Altium version from altium_status, the OS>\"`. A relay, routing, toast or lifecycle problem belongs on adom/adom-bridge instead. Reports from real machines are how this bridge gets correct: three different Altium builds behaved three different ways in one weekend."; -pub const BRIDGE_VERSION: &str = "0.2.44";+pub const BRIDGE_VERSION: &str = "0.2.45";  fn json_response(status: u16, body: &serde_json::Value) -> Response<std::io::Cursor<Vec<u8>>> {     let data = serde_json::to_vec(body).unwrap_or_else(|_| b"{}".to_vec());

@@ -164,7 +164,7 @@ pub fn panel(args: &Value) -> Value {     }     let timed_out = |stage: &str, t0: std::time::Instant| json!({"success": false, "errorCode": "panel_search_timeout",         "panel": name, "stage": stage, "elapsedSec": t0.elapsed().as_secs_f64(), "ensured": ensured,-        "_hint": "Altium's UIA tree did not answer inside the panel budget. The tab may be undocked, hidden, or the caption spelled differently (case matters). Pass ensureId (e.g. TSchLibPanel) if the panel may not exist yet; the search is abandoned, nothing was clicked."});+        "_hint": "A UI Automation search of Altium's main window did not finish inside the panel budget, so the tab could not be reached; nothing was clicked. On Altium Designer Develop this is the normal case (one search measured over 20 s on 2026-10-15), and no Altium process switches a docked tab either (Client:CustomizeResources Show/Toggle only ensures the panel exists). What does work: opening a library document brings its own panel to the front, so altium_show_library / show_symbol lands on SCH Library and show_footprint on PCB Library."});     // 1. discovery: existence + selection in one search     let tab = match find_tab(hwnd, &name, left().min(10)) {         Err(_) => return timed_out("find", t0),

@@ -275,9 +275,10 @@ pub fn board_shape(args: &Value) -> Value {     if let Some(p) = s(args, "pcbPath") {         if let Some(e) = support::must_open(&p, 60) { return e; }     }+    let mech = if args.get("mechOutline").and_then(|b| b.as_bool()) == Some(true) { "1" } else { "0" };     agent::call("board_shape",         &[("x0Mm", s_or(args, "x0Mm", "0")), ("y0Mm", s_or(args, "y0Mm", "0")),-          ("wMm", s_or(args, "wMm", "15")), ("hMm", s_or(args, "hMm", "15"))],+          ("wMm", s_or(args, "wMm", "15")), ("hMm", s_or(args, "hMm", "15")), ("mechOutline", mech.into())],         None, timeout_of(args, 120)) } 

@@ -11,7 +11,7 @@ use std::time::Duration; pub const KNOWN: &[&str] = &[     // health / lifecycle     "readiness", "status", "diagnostics", "window_info", "state", "check_dialogs",-    "dismiss_dialogs", "launch", "close", "instances", "dialog_log", "uninstall", "describe", "panel",+    "dismiss_dialogs", "launch", "close", "instances", "dialog_log", "uninstall", "describe", "panel", "list_installed_libraries", "uninstall_library",     // agent / REPL     "agent_start", "agent_stop", "agent_status", "agent_recover",     "eval", "run_command", "run_script", "list_commands", "open_document", "open_project", "close_document",@@ -87,12 +87,22 @@ fn describe() -> Value {             &["run_command"], &["An undeclared identifier HALTS the engine with a modal that Try/Except cannot catch.", "ShowMessage blocks the loop behind a modal - never use it."], json!({"text": "Begin PCBServer.GetCurrentPCBBoard.ViewManager_FullUpdate; End;"})),         verb_doc("run_command", "Run an Altium process (Server:Command) through the agent.", json!({"command": "string - e.g. PCB:Zoom", "params": "string or object"}),             json!({"success": "bool"}), 60, "Params are pipe-joined key=value pairs. altium_list_commands searches the catalog.", &["eval", "list_commands"], &["Some processes open a modal dialog and block the loop until it is answered."], json!({"command": "PCB:Zoom", "params": {"Action": "All"}})),+        verb_doc("list_installed_libraries", "Every library in Altium's Installed Libraries list (read-only).", json!({}),+            json!({"count": "int", "libraries": "[path]"}), 30,+            "Check before and after altium_install_library / altium_uninstall_library without a screenshot.",+            &["uninstall_library", "install_library", "install_library_bundle"], &["Needs the agent (it reads IntegratedLibraryManager inside Altium)."], json!({})),+        verb_doc("uninstall_library", "Remove libraries from Altium's Installed Libraries: the inverse of install_library / install_library_bundle. Library files are never touched.",+            json!({"libraryPath": "exact registered path", "libraryName": "file stem: matches X.SchLib AND X.PcbLib", "dryRun": "bool"}),+            json!({"removed": "[path]", "closedDocuments": "[path]", "remaining": "int", "notInstalled": "bool"}), 60,+            "Any open document for a removed library is closed first. Close Altium with a plain altium_close afterwards: a close that discards changes can drop the unregistration.",+            &["list_installed_libraries", "install_library", "close"], &["Nothing matching answers notInstalled:true (success), so a cleanup can run twice.", "discardChanges:true on altium_close can bring the removed library back on the next launch."],+            json!({"libraryName": "Adom_ToF"})),         verb_doc("panel", "Activate a docked panel TAB (SCH Library, PCB Library, Components, Projects, Properties) in the BACKGROUND - the 'ganged-up view' needs the right panels in front, and no Altium server process switches a tab.",             json!({"name": "string - the tab caption exactly as painted, e.g. 'SCH Library'", "ensureId": "string optional - panel ID for Client:CustomizeResources (e.g. TSchLibPanel) when the panel may not exist yet"}),             json!({"selected": "bool", "lane": "already | ui_select | ui_select_raised", "verified": "bool (false when the tab exposes no selection state)", "elapsedSec": "float"}), 30,             "One UIA search reads the tab's existence AND selection, then at most one SelectionItemPattern select and one verify, all inside a 24 s budget: every exit is a named answer (panel_not_found, panel_search_timeout, ui_select_gated, panel_not_selected), never ab's generic timeout.",             &["show_symbol", "show_footprint", "run_command"],-            &["ab gates desktop_ui_select behind the shell approval grant; without it the verb reports ui_select_gated instead of pretending.", "A plain click does not switch panel tabs - that is why this verb exists.", "lane ui_select_raised means ab fell back to a synthetic click that foregrounded Altium; the dispatch wrapper hands the user's window back."],+            &["ab gates desktop_ui_select behind the shell approval grant; without it the verb reports ui_select_gated instead of pretending.", "A plain click does not switch panel tabs - that is why this verb exists.", "On Altium Designer Develop the UI Automation search does not finish in time (panel_search_timeout, measured 2026-10-15); opening a library document already brings its library panel to the front.", "lane ui_select_raised means ab fell back to a synthetic click that foregrounded Altium; the dispatch wrapper hands the user's window back."],             json!({"name": "SCH Library"})),         verb_doc("read_board", "ONE round trip: components, nets, layers, copper, rules, occupancy, outline.", json!({"sections": "string csv - optional", "limit": "int"}), board.clone(), 120,             "The primitive every board view derives from; board_summary / rules_by_kind / layers_in_use are shaped from the same read.",@@ -107,9 +117,9 @@ fn describe() -> Value {             &["read_symbol", "show_symbol"], &["add_models APPENDS on every call (not idempotent) - repair is remove_symbol + re-import.", "The first part into a NEW library can silently skip models+params if the bridge restarted mid-flight - verify with read_symbol."], json!({})),         verb_doc("test_board", "Place one footprint, or a ';' list, from the open PcbLib on ONE board: a NEW board (wMm x hMm outline) when pcbPath is new or omitted, APPENDED to the existing board when pcbPath already exists (issue 11).",             json!({"libraryPath": "path (.PcbLib)", "footprintName": "string | 'A;B;C'", "wMm": "number (new board only)", "hMm": "number (new board only)", "pcbPath": "path (.PcbDoc) - existing = append, new = create+save", "assigns": "des=NET;...", "stubs": "des=x,y;..."}),-            json!({"placed": "string", "count": "int", "pcb": "path", "appended": "bool", "existingParts": "int", "padsOnComp": "int", "bodiesOnComp": "int"}), 240,+            json!({"placed": "string", "count": "int", "pcb": "path", "saved": "bool (checked on disk)", "appended": "bool", "existingParts": "int", "padsOnComp": "int", "bodiesOnComp": "int"}), 240,             "Three parts on one board: footprintName 'VL53L5CX;VL53L7CX;VL53L8CX' + pcbPath, then altium_show_3d_board {filePath: pcbPath}. Run it again with the same pcbPath to ADD parts: they land right of the current ones, designators continue (U4...).",-            &["place_on_sch", "show_3d_board", "add_body"], &["assigns/stubs apply to the LAST part placed.", "pcb is empty when pcbPath is omitted: the board exists only unsaved as PCB<n>.PcbDoc.", "Appending ignores wMm/hMm and does not grow the outline: parts can land outside it - resize with altium_board_shape if needed."],+            &["place_on_sch", "show_3d_board", "add_body"], &["assigns/stubs apply to the LAST part placed.", "pcb is empty when pcbPath is omitted: the board exists only unsaved as PCB<n>.PcbDoc.", "Appending ignores wMm/hMm and does not grow the outline: parts can land outside it - resize with altium_board_shape if needed.", "Each part's name is its own Comment (moves with the part) and its Pattern is the footprint name.", "errorCode not_saved: the board was built but the file did not land; the folder is created automatically."],             json!({"libraryPath": "C:/lib/Adom_ToF.PcbLib", "footprintName": "VL53L5CX;VL53L7CX;VL53L8CX", "wMm": 39, "hMm": 14, "pcbPath": "C:/proj/tof.PcbDoc"})),         verb_doc("plate_vias", "Make every drilled pad in a PcbLib a plated MULTI-LAYER pad (all footprints, or footprintName). adom-lbr writes heatsink vias as pads with a hole; Altium loaded them on the Top Layer, so a thermal pad's vias were not through-holes until this ran.",             json!({"libraryPath": "path (.PcbLib)", "footprintName": "string (optional filter)"}), json!({"holes": "int", "plated": "int", "fixed": "Fp:Pad;..."}), 90,@@ -468,11 +478,11 @@ fn describe() -> Value {             &["close_document", "check_dialogs", "close"], &["Without filePath it saves whatever has focus, which may be the user's document rather than yours.", "success only means the save process was dispatched; a Save As dialog blocks the engine until answered."],             json!({"filePath": "C:/lib/Adom_ToF.SchLib"})),         verb_doc("board_shape", "Redefine the CURRENT board's outline as a wMm x hMm rectangle at (x0Mm, y0Mm) by rewriting the board outline's segments.",-            json!({"pcbPath": "path to a .PcbDoc - optional; opened first", "x0Mm": "number, default 0", "y0Mm": "number, default 0", "wMm": "number, default 15", "hMm": "number, default 15", "timeout": "seconds, default 120"}),-            json!({"data": "{outlineMil: [left, bottom, right, top]}", "roundtripMs": "int"}), 120,+            json!({"pcbPath": "path to a .PcbDoc - optional; opened first", "x0Mm": "number, default 0", "y0Mm": "number, default 0", "wMm": "number, default 15", "hMm": "number, default 15", "mechOutline": "bool - also draw the rectangle as 0.1 mm tracks on Mechanical 1 so the fab Gerber (.GM1) has an outline", "timeout": "seconds, default 120"}),+            json!({"data": "{outlineMil: [left, bottom, right, top] read from the outline vertices, outlineSource, mechOutlineTracks}", "roundtripMs": "int"}), 120,             "Then altium_save {filePath: pcbPath} and altium_show_2d_board {filePath} to see it. altium_pcb_report {want:'board'} reads outlineMil back.",             &["test_board", "pcb_report", "show_2d_board", "save"],-            &["errorCode no_board_outline: the current document is a PcbLib (its internal board has no outline) - pass pcbPath.", "bad_size = wMm/hMm not greater than 0; bad_number = a value was not numeric.", "It REPLACES the outline; the previous shape is not kept."],+            &["errorCode no_board_outline: the current document is a PcbLib (its internal board has no outline) - pass pcbPath.", "bad_size = wMm/hMm not greater than 0; bad_number = a value was not numeric.", "It REPLACES the outline; the previous shape is not kept.", "The board shape alone is NOT plotted into any Gerber: pass mechOutline:true (once, at the final size: each call adds a new set of tracks)."],             json!({"pcbPath": "C:/proj/tof.PcbDoc", "wMm": 39, "hMm": 14})),         verb_doc("pcb_report", "Numbers instead of pixels: for a PcbLib, every footprint's pads, pad bounding box, primitive census and 3D bodies; for a board, outline, components with nets and bodies, census and tracks.",             json!({"path": "path to a .PcbLib or .PcbDoc - optional; opened first", "name": "string - footprint name filter (library form)", "want": "'board' - report the focused BOARD even though a PcbLib is also answering", "timeout": "seconds, default 60"}),@@ -931,6 +941,8 @@ pub fn dispatch(command: &str, args: &Value, _forwarded: &[(String, String)]) ->         "instances" => misc::instances_verb(args),         "dialog_log" => misc::dialog_log(args),         "panel" => misc::panel(args),+        "list_installed_libraries" => library::list_installed_libraries(args),+        "uninstall_library" => library::uninstall_library(args),         "launch" => misc::launch(args),         "close" => misc::close(args),         "uninstall" => misc::uninstall_verb(args),

@@ -1,6 +1,6 @@ {   "slug": "altium-bridge",-  "version": "0.2.44",+  "version": "0.2.45",   "type": "app",   "description": "Skills for your container so your AI knows how to drive the Altium Designer bridge (altium_* verbs). The bridge runtime itself is the release zip; Adom Bridge loads that.",   "tags": [

@@ -4,7 +4,7 @@   "type": "app",   "title": "Altium - the Altium Bridge",   "brief": "Adom Bridge for Altium Designer: a resident DelphiScript agent gives the AI eval, the 1,100-command process launcher, all 8 EDA surfaces with screenshots, compile/ERC, DRC, OutJob outputs, native SchLib/PcbLib authoring with STEP 3D bodies, and dialog handling by PID.",-  "version": "0.2.44",+  "version": "0.2.45",   "hero": {     "type": "image",     "path": "screenshots/hero.png"

@@ -25,12 +25,21 @@ courtyard + 3 mm margin so the pin-1 dot is visible on the 3D board.  `footprintName` takes a `;` list (from 0.2.13): the parts are spread evenly along X inside the wMm x hMm outline on one new board, and `assigns` / `stubs` apply to the LAST part-placed. From 0.2.18 / 0.2.19 the parts are designated U1..Un (the designator text stays-hidden) with the footprint name as Comment, and each part's name is written on the Top-Overlay under its footprint: 35 mil stroke text, centred on the part using the text's-measured bounding rectangle, its top 2.5 mm below the part centre, clear of a 3 mm part's-courtyard. Size `hMm` so that label fits on the board. Every call creates a NEW PcbDoc;-without `pcbPath` it stays unsaved.+placed. The parts are designated U1..Un (the designator text stays hidden). Each part's name+is its own Comment, shown on the Top Overlay under its footprint (35 mil stroke, its top+2.5 mm below the part centre, clear of a 3 mm part's courtyard), so it moves with the part;+from 0.2.45 it is no longer loose overlay text, which stayed behind when parts were moved and+piled up in the silkscreen Gerber. From 0.2.45 each part's `Pattern` is the footprint name+too (BOM, STEP naming and footprint comparison read it). Size `hMm` so the label fits.++**Append to an existing board (from 0.2.40, verified live 0.2.45).** When `pcbPath` already+exists, or is already open in Altium, the parts are ADDED to that board: placed to the right+of the rightmost existing part at the same height, designators continuing (U4, U5, ...).+The outline and layers are left alone (`wMm`/`hMm` are ignored), so appended parts can land+outside the outline: resize with `altium_board_shape`. The reply carries `appended` and+`existingParts`. Without `pcbPath` the board stays unsaved. From 0.2.45 the bridge creates the+target folder and checks the file on disk: `saved:true`, or `errorCode: not_saved` (before+0.2.45 a save into a missing folder failed silently, so the next append started a new board).  ## Schematic sheets: `altium_place_on_sch` @@ -48,16 +57,28 @@ number as Comment. From 0.2.16 / 0.2.17 the sheet is sized FROM the parts:   text frame inside the drawing frame along the top, and `_hints` names any of them left   empty. The sheet size is not read back from `SheetSizeX/Y`: on ADDevelop those report the 9500 x-7500 default after a custom size is set. Every call creates a NEW SchDoc (no append yet);-after a re-run `altium_close_document {path}` the stale sheet before capturing with-`altium_show_schematic {filePath}`.+7500 default after a custom size is set.++**Append to an existing sheet (from 0.2.40, verified live 0.2.45).** When `schPath` already+exists or is open, the symbols are ADDED: 4000 mil right of the rightmost symbol, in line with+the existing row, designators continuing. The title block is left alone. From 0.2.45 the sheet+GROWS to keep the new parts inside the drawing frame (`sheetGrown:true`; it never shrinks).+`saved` / `not_saved` as for boards.++## Board shape++`altium_board_shape {x0Mm,y0Mm,wMm,hMm}` sets the outline's four vertices (PointCount ++Segments[] + Rebuild, the pattern that renders on every build; `.Clear` HALTS the engine). -## Board shape: only the editor process works+Read the outline from its VERTICES, never `BoardOutline.BoundingRectangle`: that rectangle is+cached and does not follow a reshape in the same session (it kept the 6000 x 4000 mil default+while the view showed the new shape, measured on AD 26.9.1 and Altium Develop). From 0.2.45+`board_shape`, `pcb_report {want:'board'}` and `read_board`'s outline all read the vertices+and agree with the 2D view. -`IPCB_BoardOutline.PointCount/Segments/Rebuild` is a silent no-op and `.Clear` HALTS the-engine (measured). `altium_board_shape {x0Mm,y0Mm,wMm,hMm}` does it the working way: four-temporary selected tracks + process `PCB:PlaceBoardOutline Mode=BOARDOUTLINE_FROM_SEL_PRIMS`,-then deletes the tracks.+The board shape is NOT plotted into any Gerber (.GM1 / .GKO stay empty). Pass+`mechOutline:true` to also draw the rectangle as 0.1 mm tracks on Mechanical 1. Each call adds+a new set, so pass it once, at the final size.  ## Placement: the four ordering laws (all measured) 

@@ -1 +1 @@-0.2.44+0.2.45

@@ -2,7 +2,7 @@   "manifest_version": 1,   "name": "altium",   "displayName": "Altium Designer",-  "version": "0.2.44",+  "version": "0.2.45",   "description": "Drive Altium Designer from Adom: a resident DelphiScript agent (eval + the 1,100-command process launcher), the X2 -R command line, UIA over the VCL shell, dialogs by PID, screenshots of every Altium window, and Altium 365.",   "homepage": "https://wiki.adom.inc/adom/altium-bridge",   "docs": "https://wiki.adom.inc/adom/altium-bridge",@@ -80,6 +80,8 @@     "altium_install",     "altium_install_extension",     "altium_install_library",+    "altium_list_installed_libraries",+    "altium_uninstall_library",     "altium_install_library_bundle",     "altium_install_receipt",     "altium_instances",