@vcad/mcp 0.10.0-main.98 → 0.10.0-main.99

package/index.mjs

@@ -41844,6 +41844,82 @@ var init_CHANGELOG = __esm({
     CHANGELOG_default = {
       $schema: "./changelog.schema.json",
       entries: [
+        {
+          id: "2026-10-20-vendor-verified-power-imu-footprints",
+          version: "0.10.0",
+          date: "2026-10-20",
+          category: "feat",
+          title: "Vendor-verified power, IMU and XT/LCB footprints",
+          summary: "BMI088, ICM-42688-P, TO-277A, XT90PW, XT60PB and AMASS LCB footprints added; TOLL, TDSON/TSDSON, XT30/XT60 and Micro-Fit lands corrected to vendor drawings.",
+          features: [
+            "pcb",
+            "footprints"
+          ],
+          mcpTools: [
+            "search_footprints",
+            "get_footprint"
+          ]
+        },
+        {
+          id: "2026-10-20-schematic-power-flags",
+          version: "0.10.0",
+          date: "2026-10-20",
+          category: "feat",
+          title: "Schematic power flags (PWR_FLAG)",
+          summary: "Mark a net as driven when it is fed through a ferrite, FET or connector. ERC treats it as powered, flags never reach the BOM, and KiCad PWR_FLAG symbols import as flags.",
+          features: [
+            "schematic",
+            "ecad",
+            "erc"
+          ],
+          mcpTools: [
+            "create_schematic",
+            "update_schematic",
+            "run_erc"
+          ]
+        },
+        {
+          id: "2026-10-20-live-part-stock-check",
+          version: "0.10.0",
+          date: "2026-10-20",
+          category: "feat",
+          title: "Orderable parts DB + live LCSC/JLCPCB stock check",
+          summary: "Curated MPN DB with verified LCSC numbers and footprint mapping; check_part_stock and bom_check_stock fetch live stock, price breaks and basic/extended status, and flag missing parts.",
+          features: [
+            "parts",
+            "bom",
+            "ecad",
+            "sourcing"
+          ],
+          mcpTools: [
+            "check_part_stock",
+            "bom_check_stock",
+            "search_electronic_parts",
+            "resolve_part",
+            "find_alternatives"
+          ]
+        },
+        {
+          id: "2026-10-20-hierarchical-schematic-sheets",
+          version: "0.10.0",
+          date: "2026-10-20",
+          category: "feat",
+          title: "Hierarchical schematic sheets",
+          summary: "Schematics can hold reusable child sheets placed many times (CAN x6), with ports, per-instance refs and local nets, global nets, and flattening for ERC, BOM, board and KiCad.",
+          features: [
+            "schematic",
+            "ecad",
+            "erc"
+          ],
+          mcpTools: [
+            "create_schematic",
+            "update_schematic",
+            "inspect_schematic",
+            "run_erc",
+            "place_components",
+            "export_kicad"
+          ]
+        },
         {
           id: "2026-10-19-plane-stub-drc-exemption",
           version: "0.10.0",
@@ -57185,6 +57261,8 @@ var init_tool_metadata = __esm({
       bom_add_line: { title: "Add BOM Line", annotations: RW },
       bom_export: { title: "Export BOM", annotations: RW },
       search_mechanical_parts: { title: "Search Mechanical Parts", annotations: RO_NET },
+      check_part_stock: { title: "Check Part Stock", annotations: RO_NET },
+      bom_check_stock: { title: "Check BOM Stock", annotations: RO_NET },
       // ── Live review window ─────────────────────────────────────────────────
       share_session: { title: "Share Session", annotations: RW },
       unshare_session: { title: "Unshare Session", annotations: RW },
@@ -57315,6 +57393,8 @@ var init_tool_metadata = __esm({
       export_video: { title: "Export Video", annotations: RO },
       // ── ECAD (PCB) ─────────────────────────────────────────────────────────
       create_schematic: { title: "Create Schematic", annotations: RW },
+      update_schematic: { title: "Update Schematic", annotations: RW },
+      inspect_schematic: { title: "Inspect Schematic", annotations: RO },
       place_components: { title: "Place Components", annotations: RW },
       route_nets: { title: "Route Nets", annotations: RW },
       add_coil: { title: "Add Coil", annotations: RW },
@@ -60844,6 +60924,528 @@ var init_mech_parts = __esm({
   }
 });
 
+// src/tools/orderable-catalog.generated.ts
+var ORDERABLE_CATALOG_JSON;
+var init_orderable_catalog_generated = __esm({
+  "src/tools/orderable-catalog.generated.ts"() {
+    "use strict";
+    ORDERABLE_CATALOG_JSON = `{"schema":"vcad-orderable-parts/1","version":"1","checked":"2026-10-20","notes":["Curated ORDERABLE electronic parts: real manufacturer part numbers with","package -> vcad footprint mapping, key parameters, datasheet, and the LCSC","part number as verified against LCSC / JLCPCB public listings on \`checked\`.","This is the sourcing sibling of the generative passive catalog and the","jellybean pinout database: it answers 'what exactly do I order, and from","where', not 'what are the pins'. Stock and price are NEVER stored here \u2014","they go stale in days; \`check_part_stock\` fetches them live (with this","file as the offline fallback for identity and LCSC mapping).","verification.status: verified = MPN and LCSC# confirmed on a vendor page;","corrected = the source BOM's MPN or LCSC# was wrong, \`bom_mpn\` / \`bom_lcsc\`","keep the original; flagged = could not be confirmed orderable \u2014 see note.","Seeded from the rose limbic board BOM (mini/limbic). Bundled into","@vcad/mcp at build time by scripts/gen-orderable-catalog.mjs."],"parts":[{"id":"infineon.ipt012n08n5","mpn":"IPT012N08N5","manufacturer":"Infineon","category":"mosfet","description":"80 V 1.2 mOhm N-channel OptiMOS 5 power MOSFET, TOLL","footprint":"Infineon_PG-HSOF-8-1_TOLL","pins":9,"pads":3,"footprint_status":"generated","params":{"vds_v":80,"id_a":300,"rds_on_mohm":1.2,"vgs_th_v":3,"pd_w":375,"channel":"N"},"datasheet_url":"https://www.lcsc.com/datasheet/lcsc_datasheet_2005292218_Infineon-Technologies-IPT012N08N5_C531199.pdf","lcsc":"C531199","jlc_library":"extended","aliases":["IPT012N08N5ATMA1"],"bom_mpn":"IPT012N08N5ATMA1","verification":{"status":"corrected","source":"JLCPCB/LCSC listing C531199 (IPT012N08N5) and C122550 (IPT012N08N5ATMA1)","note":"Real part. The ATMA1 reel code is listed as C122550 but carries zero stock; the same die under the base code IPT012N08N5 is C531199 and stocked. Order C531199."},"alternatives":[{"mpn":"IAUT300N08S5N012ATMA2","lcsc":"C3278548","note":"80 V 1.2 mOhm automotive TOLL (HSOF-8), same footprint"},{"mpn":"IPT015N10N5","lcsc":"C108964","note":"100 V 1.5 mOhm TOLL, same footprint, more Vds headroom"}]},{"id":"infineon.bsc026n08ns5","mpn":"BSC026N08NS5ATMA1","manufacturer":"Infineon","category":"mosfet","description":"80 V 2.6 mOhm N-channel OptiMOS 5, SuperSO8 (TDSON-8 5x6)","footprint":"Infineon_PG-TDSON-8","pins":9,"pads":3,"footprint_status":"generated","params":{"vds_v":80,"id_a":184,"rds_on_mohm":2.6,"vgs_th_v":3.8,"qg_nc":74,"pd_w":156,"channel":"N"},"datasheet_url":"https://wmsc.lcsc.com/wmsc/upload/file/pdf/v2/lcsc/2404171116_Infineon-Technologies-BSC026N08NS5ATMA1_C5955453.pdf","lcsc":"C5955453","jlc_library":"extended","aliases":["BSC026N08NS5"],"verification":{"status":"verified","source":"JLCPCB/LCSC listing C5955453"},"alternatives":[{"mpn":"BSC026N08NS5","lcsc":"C534311","note":"same part, non-reel code"}]},{"id":"ti.tps48110aq","mpn":"TPS48110AQDGXRQ1","manufacturer":"Texas Instruments","category":"hot_swap_controller","description":"3.5-80 V automotive smart high-side driver with protection + diagnostics (auto-retry), back-to-back FET gate drive","footprint":"VSSOP-19_3x4.9mm_P0.5mm_TI_DGX","pins":19,"footprint_status":"placeholder","params":{"vin_min_v":3.5,"vin_max_v":80,"iq_ua":700,"fault_mode":"auto-retry","aec_q100":true},"datasheet_url":"https://www.ti.com/lit/ds/symlink/tps4811-q1.pdf","lcsc":"C17556513","jlc_library":"extended","aliases":["TPS48110-Q1","TPS48110"],"verification":{"status":"verified","source":"ti.com part-details page + JLCPCB/LCSC C17556513"}},{"id":"ti.tps48111lq","mpn":"TPS48111LQDGXRQ1","manufacturer":"Texas Instruments","category":"hot_swap_controller","description":"3.5-80 V automotive smart high-side driver, latch-off variant of TPS4811-Q1","footprint":"VSSOP-19_3x4.9mm_P0.5mm_TI_DGX","pins":19,"footprint_status":"placeholder","params":{"vin_min_v":3.5,"vin_max_v":80,"fault_mode":"latch-off","aec_q100":true},"datasheet_url":"https://www.ti.com/lit/ds/symlink/tps4811-q1.pdf","lcsc":"C17558994","jlc_library":"extended","aliases":["TPS48111-Q1","TPS48111","TPS48111AQDGXRQ1"],"bom_mpn":"TPS48111AQDGXRQ1","verification":{"status":"corrected","source":"ti.com/product/TPS4811-Q1 orderable list; part-details/TPS48111AQDGXRQ1 returns 404","note":"TPS48111AQDGXRQ1 does not exist. TI's only TPS48111 orderable is TPS48111LQDGXRQ1 (same DGX package). Confirm the latch-off fault behaviour is what the design wants."}},{"id":"st.stm32h723vgt6","mpn":"STM32H723VGT6","manufacturer":"STMicroelectronics","category":"mcu","description":"Arm Cortex-M7 550 MHz, 1 MB flash, 564 KB RAM, LQFP-100","footprint":"LQFP-100_14x14mm_P0.5mm","pins":100,"footprint_status":"generated","params":{"core":"Cortex-M7","fmax_mhz":550,"flash_kb":1024,"ram_kb":564,"vdd_v":[1.71,3.6],"interfaces":["FDCAN x3","Ethernet MAC","USB OTG HS/FS","OCTOSPI","SPI","I2C","UART"]},"datasheet_url":"https://www.st.com/resource/en/datasheet/stm32h723vg.pdf","lcsc":"C730142","jlc_library":"extended","bom_lcsc":"C730194","verification":{"status":"corrected","source":"LCSC product detail C730194 + JLCPCB listing C730142","note":"BOM's C730194 is an STM32H747AGI6 (UFBGA-169) \u2014 wrong part. STM32H723VGT6 is C730142."}},{"id":"ti.tcan1462vq1","mpn":"TCAN1462VDRQ1","manufacturer":"Texas Instruments","category":"can_transceiver","description":"Automotive CAN FD SIC transceiver, 8 Mbps, VIO pin, SOIC-8","footprint":"SOIC-8_3.9x4.9mm_P1.27mm","pins":8,"footprint_status":"generated","params":{"data_rate_mbps":8,"vcc_v":[4.5,5.5],"vio":true,"bus_fault_v":58,"aec_q100":true,"interfaces":["CAN FD (SIC)"]},"datasheet_url":"https://www.ti.com/lit/ds/symlink/tcan1462-q1.pdf","lcsc":"C7399456","jlc_library":"extended","verification":{"status":"verified","source":"JLCPCB/LCSC listing C7399456"},"alternatives":[{"mpn":"TCAN1044AVDRQ1","lcsc":"C3234993","note":"CAN FD (non-SIC) with VIO, SOIC-8, deep LCSC stock; confirm pin 5/8 functions match"}]},{"id":"st.stm32g474ret6","mpn":"STM32G474RET6","manufacturer":"STMicroelectronics","category":"mcu","description":"Arm Cortex-M4F 170 MHz, 512 KB flash, HRTIM, LQFP-64","footprint":"LQFP-64_10x10mm_P0.5mm","pins":64,"footprint_status":"generated","params":{"core":"Cortex-M4F","fmax_mhz":170,"flash_kb":512,"ram_kb":128,"vdd_v":[1.71,3.6],"interfaces":["FDCAN x3","USB FS","SPI","I2C","UART","HRTIM"]},"datasheet_url":"https://www.st.com/resource/en/datasheet/stm32g474re.pdf","lcsc":"C521608","jlc_library":"extended","verification":{"status":"verified","source":"LCSC product detail C521608"}},{"id":"bosch.bmi088","mpn":"BMI088","manufacturer":"Bosch Sensortec","category":"imu","description":"6-axis IMU (separate accel/gyro dies), high vibration robustness","footprint":"BMI088_LGA-16","pins":16,"footprint_status":"generated","params":{"accel_range_g":24,"gyro_range_dps":2000,"vdd_v":[2.4,3.6],"interfaces":["SPI","I2C"]},"datasheet_url":"https://www.lcsc.com/datasheet/lcsc_datasheet_1811031202_Bosch-Sensortec-BMI088_C194919.pdf","lcsc":"C194919","jlc_library":"extended","verification":{"status":"verified","source":"LCSC product detail C194919"}},{"id":"tdk.icm42688p","mpn":"ICM-42688-P","manufacturer":"TDK InvenSense","category":"imu","description":"6-axis low-noise IMU, LGA-14 2.5x3","footprint":"ICM-42688-P_LGA-14","pins":14,"footprint_status":"generated","params":{"accel_range_g":16,"gyro_range_dps":2000,"vdd_v":[1.71,3.6],"interfaces":["SPI","I2C","I3C"]},"datasheet_url":"https://invensense.tdk.com/wp-content/uploads/2020/04/ds-000347_icm-42688-p-datasheet.pdf","lcsc":"C1850418","jlc_library":"extended","verification":{"status":"verified","source":"LCSC product detail C1850418"}},{"id":"panasonic.eehza1j101p","mpn":"EEH-ZA1J101P","manufacturer":"Panasonic","category":"capacitor_polymer_hybrid","description":"100 uF 63 V conductive-polymer hybrid aluminium SMD, 10x10.2 (as specified by BOM)","footprint":"CP_Elec_10x10.5","pins":2,"footprint_status":"placeholder","params":{"capacitance_uf":100,"voltage_v":63},"datasheet_url":"https://industrial.panasonic.com/cdbs/www-data/pdf/RDF0000/ABA0000C1259.pdf","lcsc":null,"jlc_library":null,"aliases":["EEHZA1J101P"],"verification":{"status":"flagged","source":"JLCPCB/LCSC search (no hit for EEHZA1J101P); distributor web search","note":"No orderable listing found. The ZA series appears to top out at 56 uF in 10x10.2 at 63 V (EEHZA1J560P, C178638, out of stock), and EEHZA1H101P is 50 V, which is too low for a 48 V bus. Re-pick: 2x EEHZA1J560P per site, or a larger-can 63 V hybrid."},"alternatives":[{"mpn":"EEHZA1J560P","lcsc":"C178638","note":"56 uF 63 V ZA, same 10x10.2 can; use two per 100 uF site"},{"mpn":"RYHV63V100UF10*10","lcsc":"C48970691","note":"Honor 63 V 100 uF 10x10; check whether it is polymer or plain electrolytic (ESR/ripple) before substituting"}]},{"id":"bourns.pwr263s3533r0f","mpn":"PWR263S-35-33R0F","manufacturer":"Bourns","category":"resistor_power","description":"33 Ohm 35 W 1% thick-film power resistor, TO-263 (D2PAK)","footprint":"TO-263-2","pins":2,"footprint_status":"generated","params":{"resistance_ohm":33,"power_w":35,"tolerance_pct":1,"tcr_ppm":100},"datasheet_url":"https://wmsc.lcsc.com/wmsc/upload/file/pdf/v2/lcsc/2304140030_BOURNS-PWR263S-35-33R0F_C1356479.pdf","lcsc":"C1356479","jlc_library":"extended","verification":{"status":"verified","source":"JLCPCB/LCSC listing C1356479","note":"MPN is real and listed, but LCSC stock was 0 on the check date \u2014 source from Digi-Key/Mouser or pre-order. Pulse energy rating still needs checking against the bus-precharge energy."}},{"id":"ti.tps26631","mpn":"TPS26631PWPR","manufacturer":"Texas Instruments","category":"efuse","description":"4.5-60 V 6 A industrial eFuse with integrated 31 mOhm FET, HTSSOP-20","footprint":"HTSSOP-20-1EP_4.4x6.5mm_P0.65mm","pins":21,"footprint_status":"generated","params":{"vin_min_v":4.5,"vin_max_v":60,"rds_on_mohm":31,"ilim_max_a":6},"datasheet_url":"https://www.ti.com/lit/ds/symlink/tps2663.pdf","lcsc":"C2866319","jlc_library":"extended","verification":{"status":"verified","source":"JLCPCB/LCSC listing C2866319"}},{"id":"ti.lm5145","mpn":"LM5145RGYR","manufacturer":"Texas Instruments","category":"buck_controller","description":"6-75 V synchronous buck controller, VQFN-20","footprint":"VQFN-20-1EP_3.5x4.5mm_P0.5mm","pins":21,"footprint_status":"generated","params":{"vin_min_v":6,"vin_max_v":75,"fsw_max_khz":1000},"datasheet_url":"https://www.ti.com/lit/ds/symlink/lm5145.pdf","lcsc":"C485912","jlc_library":"extended","verification":{"status":"verified","source":"JLCPCB/LCSC listing C485912"}},{"id":"bourns.css2h2512rl500f","mpn":"CSS2H-2512R-L500F","manufacturer":"Bourns","category":"resistor_shunt","description":"0.5 mOhm 6 W 1% metal-strip current-sense resistor, 2512","footprint":"R_2512_6332Metric","pins":2,"footprint_status":"generated","params":{"resistance_mohm":0.5,"power_w":6,"tolerance_pct":1},"datasheet_url":"https://wmsc.lcsc.com/wmsc/upload/file/pdf/v2/lcsc/2304140030_BOURNS-CSS2H-2512R-L500F_C2073667.pdf","lcsc":"C2073667","jlc_library":"extended","verification":{"status":"verified","source":"JLCPCB/LCSC listing C2073667"},"alternatives":[{"mpn":"CSS2H-2512R-L500FE","lcsc":"C1848841","note":"same part, alternate packaging suffix"}]},{"id":"bourns.css2h2512r1l00f","mpn":"CSS2H-2512R-1L00F","manufacturer":"Bourns","category":"resistor_shunt","description":"1 mOhm 5 W 1% metal-strip current-sense resistor, 2512","footprint":"R_2512_6332Metric","pins":2,"footprint_status":"generated","params":{"resistance_mohm":1,"power_w":5,"tolerance_pct":1},"datasheet_url":"https://wmsc.lcsc.com/wmsc/upload/file/pdf/v2/lcsc/2401221722_BOURNS-CSS2H-2512R-1L00F_C4175647.pdf","lcsc":"C4175647","jlc_library":"extended","verification":{"status":"verified","source":"JLCPCB/LCSC listing C4175647"}},{"id":"ti.lm5050-1","mpn":"LM5050MK-1/NOPB","manufacturer":"Texas Instruments","category":"ideal_diode_controller","description":"5-75 V high-side OR-ing FET controller, TSOT-23-6","footprint":"TSOT-23-6","pins":6,"footprint_status":"generated","params":{"vin_min_v":5,"vin_max_v":75},"datasheet_url":"https://www.ti.com/lit/ds/symlink/lm5050-1.pdf","lcsc":"C129323","jlc_library":"extended","verification":{"status":"verified","source":"JLCPCB/LCSC listing C129323"}},{"id":"ti.tps7a16","mpn":"TPS7A1601DGNR","manufacturer":"Texas Instruments","category":"ldo","description":"60 V 100 mA 5 uA-Iq adjustable LDO, MSOP-8 EP","footprint":"MSOP-8-1EP_3x3mm_P0.65mm_EP1.68x1.88mm","pins":8,"footprint_status":"generated","params":{"vin_max_v":60,"iout_ma":100,"iq_ua":5,"vout_v":[1.193,18.5]},"datasheet_url":"https://www.ti.com/lit/ds/symlink/tps7a16.pdf","lcsc":"C55770","jlc_library":"extended","verification":{"status":"verified","source":"JLCPCB/LCSC listing C55770","note":"Listed, but LCSC stock was 0 on the check date."}},{"id":"molex.43045-0412","mpn":"43045-0412","manufacturer":"Molex","category":"connector","description":"Micro-Fit 3.0 header, 2x2, right angle, through hole","footprint":"Molex_Micro-Fit_3.0_43045-0412_2x02_P3.00mm_Horizontal","pins":4,"footprint_status":"generated","params":{"pitch_mm":3,"positions":4,"current_a":8.5,"voltage_v":600},"datasheet_url":"https://www.molex.com/en-us/products/part-detail/430450412","lcsc":"C277721","jlc_library":"extended","aliases":["430450412","0430450412","Molex 43045-0412"],"verification":{"status":"verified","source":"JLCPCB/LCSC listing C277721 (430450412)"},"alternatives":[{"mpn":"C3030WV-2x2P","lcsc":"C239454","note":"CJT Micro-Fit-compatible 2x2 RA clone"}]},{"id":"ti.lmr38020","mpn":"LMR38020SDDAR","manufacturer":"Texas Instruments","category":"buck_converter","description":"4.2-80 V 2 A synchronous buck converter, SO-8 PowerPAD","footprint":"TI_SO-8-1EP_3.9x4.9mm_P1.27mm_EP2.41x3.1mm","pins":8,"footprint_status":"generated","params":{"vin_min_v":4.2,"vin_max_v":80,"iout_a":2,"fsw_max_khz":2200},"datasheet_url":"https://www.ti.com/lit/ds/symlink/lmr38020.pdf","lcsc":"C3192337","jlc_library":"extended","verification":{"status":"verified","source":"JLCPCB/LCSC listing C3192337"}},{"id":"bourns.srp1265a-100m","mpn":"SRP1265A-100M","manufacturer":"Bourns","category":"inductor_power","description":"10 uH 10 A shielded molded power inductor, 13.5x12.5","footprint":"L_Bourns_SRP1265A","pins":2,"footprint_status":"placeholder","params":{"inductance_uh":10,"isat_a":15.5,"irms_a":10,"dcr_mohm":16.5},"datasheet_url":"https://wmsc.lcsc.com/wmsc/upload/file/pdf/v2/lcsc/2202281730_BOURNS-SRP1265A-100M_C840531.pdf","lcsc":"C840531","jlc_library":"extended","verification":{"status":"verified","source":"JLCPCB/LCSC listing C840531","note":"Listed, but LCSC stock was 0 on the check date."},"alternatives":[{"mpn":"MDA1365-100M","lcsc":"C2847583","note":"KOHERelec 10 uH 13 A, 13.5x12.6 \u2014 check pad fit"},{"mpn":"FAUL1365-100MT","lcsc":"C5298351","note":"Changjiang 10 uH 15 A, 13.5x12.6"}]},{"id":"amass.xt30pb22m","mpn":"XT30PB(2+2)-M","manufacturer":"Changzhou Amass","category":"connector","description":"XT30 2+2 (power + signal pair) male, right angle PCB","footprint":"AMASS_XT30PB_2+2_-M_Horizontal","pins":4,"footprint_status":"generated","params":{"power_current_a":15,"positions":4},"datasheet_url":"https://wmsc.lcsc.com/wmsc/upload/file/pdf/v2/lcsc/2304140030_Changzhou-Amass-Elec-XT30PB-2-2-M_C3040128.pdf","lcsc":"C3040128","jlc_library":"extended","verification":{"status":"verified","source":"JLCPCB/LCSC listing C3040128","note":"Signal-pair pin order vs the RobStride harness is still unverified (mechanical, not sourcing)."}},{"id":"amass.xt60pt-m","mpn":"XT60PT-M","manufacturer":"Changzhou Amass","category":"connector","description":"XT60 male, vertical PCB mount","footprint":"AMASS_XT60PT-M_Vertical","pins":2,"footprint_status":"placeholder","params":{"current_a":30,"positions":2},"datasheet_url":"https://www.lcsc.com/product-detail/C54431743.html","lcsc":"C54431743","jlc_library":"extended","verification":{"status":"verified","source":"JLCPCB/LCSC listing C54431743 (stocked); older listing C5155958 has no stock"}},{"id":"amass.xt30pw-m","mpn":"XT30PW-M","manufacturer":"Changzhou Amass","category":"connector","description":"XT30 male, right angle PCB","footprint":"AMASS_XT30PW-M_Horizontal","pins":2,"footprint_status":"generated","params":{"current_a":15,"positions":2},"datasheet_url":"https://www.lcsc.com/product-detail/C53373776.html","lcsc":"C53373776","jlc_library":"extended","verification":{"status":"verified","source":"JLCPCB/LCSC listing C53373776","note":"Real listing but zero LCSC stock on the check date; widely stocked elsewhere (AliExpress/Amass direct). JLC consigned entries C9900183122 exist."}},{"id":"microchip.lan8742a","mpn":"LAN8742A-CZ-TR","manufacturer":"Microchip","category":"ethernet_phy","description":"10/100 Ethernet PHY, RMII, QFN-24 4x4","footprint":"QFN-24-1EP_4x4mm_P0.5mm_EP2.6x2.6mm","pins":25,"footprint_status":"generated","params":{"vdd_v":[1.8,3.3],"interfaces":["RMII","10BASE-T","100BASE-TX"],"temp_c":[0,70]},"datasheet_url":"https://www.lcsc.com/datasheet/lcsc_datasheet_2011201138_Microchip-Tech-LAN8742A-CZ-TR_C621424.pdf","lcsc":"C621424","jlc_library":"extended","bom_lcsc":"C621066","verification":{"status":"corrected","source":"LCSC product detail C621066 + JLCPCB listing C621424","note":"BOM's C621066 is a UNI-ROYAL 1210 8.2 Ohm resistor. LAN8742A-CZ-TR is C621424. Commercial temp (0-70 C) \u2014 LAN8742AI-CZ-TR (C621425) is the industrial-range drop-in."},"alternatives":[{"mpn":"LAN8742AI-CZ-TR","lcsc":"C621425","note":"-40..85 C drop-in"}]},{"id":"winbond.w25q128jvsiq","mpn":"W25Q128JVSIQ","manufacturer":"Winbond","category":"flash","description":"128 Mbit SPI/QSPI NOR flash, SOIC-8 208 mil","footprint":"SOIC-8_5.23x5.23mm_P1.27mm","pins":8,"footprint_status":"generated","params":{"density_mbit":128,"fmax_mhz":133,"vcc_v":[2.7,3.6],"interfaces":["SPI","QSPI"]},"datasheet_url":"https://www.lcsc.com/datasheet/lcsc_datasheet_1811142111_Winbond-Elec-W25Q128JVSIQ_C97521.pdf","lcsc":"C97521","jlc_library":"basic","verification":{"status":"verified","source":"LCSC product detail C97521; JLCPCB basic library"}},{"id":"generic.smcj58a","mpn":"SMCJ58A","manufacturer":"multi-source","category":"tvs","description":"58 V standoff 1.5 kW unidirectional TVS, SMC (DO-214AB)","footprint":"D_SMC","pins":2,"footprint_status":"generated","params":{"vrwm_v":58,"vbr_min_v":64.4,"vc_v":93.6,"ppk_w":1500},"datasheet_url":"https://www.lcsc.com/datasheet/lcsc_datasheet_2304140030_Diodes-Incorporated-SMCJ58A-13-F_C135180.pdf","lcsc":"C135180","jlc_library":"extended","aliases":["SMCJ58A-13-F"],"verification":{"status":"verified","source":"JLCPCB/LCSC listing C135180 (Diodes Inc SMCJ58A-13-F); budget sources C151899 / C10474"},"alternatives":[{"mpn":"SMCJ58A (BORN)","lcsc":"C151899","note":"cheaper second source"},{"mpn":"SMCJ58A (RUILON)","lcsc":"C10474","note":"cheaper second source"}]},{"id":"infineon.bsz440n10ns3g","mpn":"BSZ440N10NS3G","manufacturer":"Infineon","category":"mosfet","description":"100 V 44 mOhm N-channel OptiMOS 3, TSDSON-8 (S3O8 3.3x3.3)","footprint":"Infineon_PG-TSDSON-8","pins":9,"pads":3,"footprint_status":"generated","params":{"vds_v":100,"id_a":18,"rds_on_mohm":44,"vgs_th_v":3.5,"pd_w":29,"channel":"N"},"datasheet_url":"https://www.lcsc.com/datasheet/lcsc_datasheet_2304140030_Infineon-Technologies-BSZ440N10NS3G_C476115.pdf","lcsc":"C476115","jlc_library":"extended","aliases":["BSZ440N10NS3GATMA1"],"verification":{"status":"verified","source":"JLCPCB/LCSC listing C476115"}},{"id":"ti.ucc27511a","mpn":"UCC27511ADBVR","manufacturer":"Texas Instruments","category":"gate_driver","description":"4 A/8 A single-channel low-side gate driver, SOT-23-6","footprint":"SOT-23-6","pins":6,"footprint_status":"generated","params":{"vdd_v":[4.5,18],"source_a":4,"sink_a":8},"datasheet_url":"https://www.ti.com/lit/ds/symlink/ucc27511a.pdf","lcsc":"C2676982","jlc_library":"extended","verification":{"status":"verified","source":"JLCPCB/LCSC listing C2676982"}},{"id":"vishay.ss10ph10","mpn":"SS10PH10-M3/86A","manufacturer":"Vishay","category":"diode_schottky","description":"100 V 10 A high-voltage Schottky rectifier, TO-277A (SMPC)","footprint":"TO-277A","pins":3,"pads":2,"footprint_status":"generated","params":{"vrrm_v":100,"if_a":10,"vf_v":0.8,"ifsm_a":200},"datasheet_url":"https://www.lcsc.com/datasheet/lcsc_datasheet_2007091711_Vishay-Intertech-SS10PH10-M3-86A_C554009.pdf","lcsc":"C554009","jlc_library":"extended","aliases":["SS10P10-M3/86A","SS10PH10"],"bom_mpn":"SS10P10-M3/86A","verification":{"status":"corrected","source":"JLCPCB/LCSC search + distributor search","note":"SS10P10-M3/86A has no vendor listing; the Vishay 100 V 10 A TO-277A Schottky is SS10PH10-M3/86A (C554009). V10P10-M3/86A (TMBS, lower Vf, higher leakage) is the other option."},"alternatives":[{"mpn":"V10P10-M3/86A","lcsc":"C50188","note":"Vishay TMBS 100 V 10 A TO-277A, Vf 0.68 V, same footprint"}]},{"id":"panasonic.25svpf100m","mpn":"25SVPF100M","manufacturer":"Panasonic","category":"capacitor_polymer","description":"100 uF 25 V OS-CON polymer, 8 mm can (SMD D8xL6.9)","footprint":"CP_Elec_6.3x7.7","pins":2,"footprint_status":"placeholder","params":{"capacitance_uf":100,"voltage_v":25,"esr_mohm":24,"ripple_a":3.2,"can_mm":[8,6.9]},"datasheet_url":"https://www.lcsc.com/datasheet/lcsc_datasheet_2304140030_PANASONIC-25SVPF100M_C136279.pdf","lcsc":"C136279","jlc_library":"extended","verification":{"status":"verified","source":"JLCPCB/LCSC listing C136279","note":"Footprint mismatch: 25SVPF100M is an 8 mm can (D8xL6.9) but the BOM maps it to CP_Elec_6.3x7.7. Use CP_Elec_8x6.7 or pick a 6.3 mm part."}},{"id":"bourns.srp6540-150m","mpn":"SRP6540-150M","manufacturer":"Bourns","category":"inductor_power","description":"15 uH 2.9 A shielded power inductor, 7.2x6.5","footprint":"L_Bourns_SRP6540","pins":2,"footprint_status":"placeholder","params":{"inductance_uh":15,"isat_a":2.9,"irms_a":2.9,"dcr_mohm":121},"datasheet_url":"https://wmsc.lcsc.com/wmsc/upload/file/pdf/v2/lcsc/2309040926_BOURNS-SRP6540-150M_C5369215.pdf","lcsc":"C5369215","jlc_library":"extended","verification":{"status":"verified","source":"JLCPCB/LCSC listing C5369215","note":"Listed, but LCSC stock was 0 on the check date. Rated 2.9 A against the BOM's 3 A label."}},{"id":"ti.tps62a02","mpn":"TPS62A02DRLR","manufacturer":"Texas Instruments","category":"buck_converter","description":"2.5-5.5 V 2 A synchronous buck, SOT-563","footprint":"SOT-563","pins":6,"footprint_status":"placeholder","params":{"vin_min_v":2.5,"vin_max_v":5.5,"iout_a":2,"fsw_khz":2400},"datasheet_url":"https://www.ti.com/lit/ds/symlink/tps62a02.pdf","lcsc":"C5350187","jlc_library":"extended","verification":{"status":"verified","source":"JLCPCB/LCSC listing C5350187"}},{"id":"ti.lm4040-2v5","mpn":"LM4040DIM3-2.5/NOPB","manufacturer":"Texas Instruments","category":"voltage_reference","description":"2.5 V 1% shunt voltage reference, SOT-23","footprint":"SOT-23","pins":3,"footprint_status":"generated","params":{"vref_v":2.5,"tolerance_pct":1,"iz_max_ma":15},"datasheet_url":"https://www.ti.com/lit/ds/symlink/lm4040-n.pdf","lcsc":"C205892","jlc_library":"extended","verification":{"status":"verified","source":"JLCPCB/LCSC listing C205892","note":"Listed, but LCSC stock was 0 on the check date."},"alternatives":[{"mpn":"LM4040AIM3-2.5/NOPB","lcsc":"C139302","note":"0.1% grade, same SOT-23 pinout (also out of LCSC stock on the check date)"}]},{"id":"yxc.x322525mob4si","mpn":"X322525MOB4SI","manufacturer":"YXC","category":"crystal","description":"25 MHz crystal, 3225 4-pad, 12 pF (vendor listing), 10 ppm","footprint":"Crystal_SMD_3225-4Pin_3.2x2.5mm","pins":4,"footprint_status":"generated","params":{"frequency_mhz":25,"load_pf":12,"tolerance_ppm":10},"datasheet_url":"https://www.lcsc.com/datasheet/lcsc_datasheet_2403291504_YXC-Crystal-Oscillators-X322525MOB4SI_C9006.pdf","lcsc":"C9006","jlc_library":"basic","verification":{"status":"verified","source":"JLCPCB basic library C9006","note":"LCSC lists a 12 pF load, but the BOM says 20 pF. Re-check the load caps (C713/C714/C725/C726 = 12 pF)."}},{"id":"yxc.x322516mlb4si","mpn":"X322516MLB4SI","manufacturer":"YXC","category":"crystal","description":"16 MHz crystal, 3225 4-pad, 9 pF, 10 ppm","footprint":"Crystal_SMD_3225-4Pin_3.2x2.5mm","pins":4,"footprint_status":"generated","params":{"frequency_mhz":16,"load_pf":9,"tolerance_ppm":10},"datasheet_url":"https://www.lcsc.com/datasheet/lcsc_datasheet_2403291504_YXC-Crystal-Oscillators-X322516MLB4SI_C13738.pdf","lcsc":"C13738","jlc_library":"basic","verification":{"status":"verified","source":"JLCPCB basic library C13738"}},{"id":"jst.sm04b-ghs-tb","mpn":"SM04B-GHS-TB(LF)(SN)","manufacturer":"JST","category":"connector","description":"GH 1.25 mm 4-pos right-angle SMD header","footprint":"JST_GH_SM04B-GHS-TB_1x04-1MP_P1.25mm_Horizontal","pins":4,"footprint_status":"generated","params":{"pitch_mm":1.25,"positions":4,"current_a":1},"datasheet_url":"https://www.lcsc.com/datasheet/lcsc_datasheet_2304140030_JST-SM04B-GHS-TB-LF-SN_C189895.pdf","lcsc":"C189895","jlc_library":"extended","aliases":["SM04B-GHS-TB","JST SM04B-GHS-TB"],"verification":{"status":"verified","source":"JLCPCB/LCSC listing C189895 (the bare SM04B-GHS-TB listing C20584968 has no stock)"},"alternatives":[{"mpn":"XY-SM04B-GHS-TB","lcsc":"C51940118","note":"XYECONN GH-compatible clone, deep stock"}]},{"id":"jst.sm05b-ghs-tb","mpn":"SM05B-GHS-TB(LF)(SN)","manufacturer":"JST","category":"connector","description":"GH 1.25 mm 5-pos right-angle SMD header","footprint":"JST_GH_SM05B-GHS-TB_1x05-1MP_P1.25mm_Horizontal","pins":5,"footprint_status":"generated","params":{"pitch_mm":1.25,"positions":5,"current_a":1},"datasheet_url":"https://www.lcsc.com/datasheet/lcsc_datasheet_2304140030_JST-SM05B-GHS-TB-LF-SN_C189896.pdf","lcsc":"C189896","jlc_library":"extended","aliases":["SM05B-GHS-TB","JST SM05B-GHS-TB"],"verification":{"status":"verified","source":"JLCPCB/LCSC listing C189896"}},{"id":"st.usblc6-2sc6","mpn":"USBLC6-2SC6","manufacturer":"STMicroelectronics","category":"esd","description":"2-line USB ESD protection + VBUS clamp, SOT-23-6","footprint":"SOT-23-6","pins":6,"footprint_status":"generated","params":{"vrwm_v":5.25,"vc_v":17,"c_pf":3.5},"datasheet_url":"https://www.st.com/resource/en/datasheet/usblc6-2.pdf","lcsc":"C7519","jlc_library":"extended","verification":{"status":"verified","source":"LCSC product detail C7519"},"alternatives":[{"mpn":"USBLC6-2SC6 (UMW)","lcsc":"C2687116","note":"pin-compatible second source"}]},{"id":"ti.lmv331","mpn":"LMV331IDBVR","manufacturer":"Texas Instruments","category":"comparator","description":"Single low-voltage open-drain comparator, SOT-23-5","footprint":"SOT-23-5","pins":5,"footprint_status":"generated","params":{"vcc_v":[2.7,5.5],"output":"open-drain"},"datasheet_url":"https://www.ti.com/lit/ds/symlink/lmv331.pdf","lcsc":"C34731","jlc_library":"extended","verification":{"status":"verified","source":"JLCPCB/LCSC listing C34731"}},{"id":"generic.mmbt3904","mpn":"MMBT3904","manufacturer":"multi-source","category":"bjt","description":"40 V 200 mA NPN, SOT-23 (used as remote temperature-sense diode)","footprint":"SOT-23","pins":3,"footprint_status":"generated","params":{"vceo_v":40,"ic_ma":200,"type":"NPN"},"datasheet_url":"https://www.lcsc.com/datasheet/lcsc_datasheet_2207041900_Jiangsu-Changjing-Electronics-Technology-Co---Ltd--MMBT3904-RANGE-100-300_C20526.pdf","lcsc":"C20526","jlc_library":"basic","verification":{"status":"verified","source":"JLCPCB basic library C20526 (CJ MMBT3904)"}},{"id":"murata.dfe252012f-1r0m","mpn":"DFE252012F-1R0M=P2","manufacturer":"Murata","category":"inductor_power","description":"1 uH 3.3 A metal-alloy power inductor, 1008 (2520)","footprint":"L_1008_2520Metric","pins":2,"footprint_status":"placeholder","params":{"inductance_uh":1,"isat_a":4.7,"irms_a":3.3,"dcr_mohm":40},"datasheet_url":"https://wmsc.lcsc.com/wmsc/upload/file/pdf/v2/lcsc/1912111437_Murata-Electronics-DFE252012F-1R0M-P2_C435392.pdf","lcsc":"C435392","jlc_library":"extended","aliases":["DFE252012F-1R0M"],"bom_mpn":"DFE252012F-1R0M","verification":{"status":"verified","source":"JLCPCB/LCSC listing C435392","note":"The orderable code carries the =P2 packaging suffix."}},{"id":"murata.ncp18xh103f03rb","mpn":"NCP18XH103F03RB","manufacturer":"Murata","category":"thermistor_ntc","description":"10 kOhm 1% NTC, B25/50 3380 K, 0603","footprint":"R_0603_1608Metric","pins":2,"footprint_status":"generated","params":{"r25_ohm":10000,"tolerance_pct":1,"beta_k":3380},"datasheet_url":"https://www.lcsc.com/datasheet/lcsc_datasheet_1810311113_Murata-Electronics-NCP18XH103F03RB_C13564.pdf","lcsc":"C13564","jlc_library":"extended","verification":{"status":"verified","source":"JLCPCB/LCSC listing C13564"}},{"id":"ti.sn74lvc1g08","mpn":"SN74LVC1G08DBVR","manufacturer":"Texas Instruments","category":"logic","description":"Single 2-input AND gate, SOT-23-5","footprint":"SOT-23-5","pins":5,"footprint_status":"generated","params":{"vcc_v":[1.65,5.5],"function":"AND2"},"datasheet_url":"https://www.ti.com/lit/ds/symlink/sn74lvc1g08.pdf","lcsc":"C7666","jlc_library":"extended","verification":{"status":"verified","source":"JLCPCB/LCSC listing C7666"}},{"id":"ti.sn74lvc1g32","mpn":"SN74LVC1G32DBVR","manufacturer":"Texas Instruments","category":"logic","description":"Single 2-input OR gate, SOT-23-5","footprint":"SOT-23-5","pins":5,"footprint_status":"generated","params":{"vcc_v":[1.65,5.5],"function":"OR2"},"datasheet_url":"https://www.ti.com/lit/ds/symlink/sn74lvc1g32.pdf","lcsc":"C10096","jlc_library":"extended","verification":{"status":"verified","source":"JLCPCB/LCSC listing C10096"}},{"id":"murata.blm18pg601sn1d","mpn":"BLM18PG601SN1D","manufacturer":"Murata","category":"ferrite_bead","description":"600 Ohm @ 100 MHz ferrite bead, 0603","footprint":"L_0603_1608Metric","pins":2,"footprint_status":"generated","params":{"impedance_ohm_100mhz":600,"irated_ma":500},"datasheet_url":"https://www.murata.com/en-us/products/productdetail?partno=BLM18PG601SN1%23","lcsc":null,"jlc_library":null,"verification":{"status":"flagged","source":"JLCPCB/LCSC search","note":"Real Murata part, but LCSC carries it only as a JLC consigned placeholder (C9900168231) with no stock. Substitute a stocked 600 Ohm 0603 bead."},"alternatives":[{"mpn":"BLM18AG601SN1D","lcsc":"C19330","note":"Murata 600 Ohm 0603, lower current rating than the PG series \u2014 check load current"},{"mpn":"GZ1608D601TF","lcsc":"C1002","note":"Sunlord 600 Ohm 0603, JLC basic"}]},{"id":"infineon.ipt015n10n5","mpn":"IPT015N10N5","manufacturer":"Infineon","category":"mosfet","description":"100 V 1.5 mOhm N-channel OptiMOS 5 power MOSFET, TOLL","footprint":"Infineon_PG-HSOF-8-1_TOLL","pins":9,"pads":3,"footprint_status":"generated","params":{"vds_v":100,"id_a":300,"rds_on_mohm":1.5,"vgs_th_v":3.8,"qg_nc":211,"pd_w":375,"channel":"N"},"datasheet_url":"https://www.lcsc.com/datasheet/lcsc_datasheet_1810010717_Infineon-Technologies-IPT015N10N5_C108964.pdf","lcsc":"C108964","jlc_library":"extended","aliases":["IPT015N10N5ATMA1"],"bom_mpn":"IPT015N10N5ATMA1","verification":{"status":"corrected","source":"LCSC product detail C108964; JLCPCB listing C6419630 (IPT015N10N5ATMA1)","note":"Real part. The ATMA1 reel code (C6419630) has no stock; the base code IPT015N10N5 (C108964, the LCSC# the BOM noted) is stocked. Order C108964."},"alternatives":[{"mpn":"IPT012N08N5","lcsc":"C531199","note":"80 V 1.2 mOhm TOLL \u2014 less Vds headroom"}]},{"id":"infineon.bsc027n10ns5","mpn":"BSC027N10NS5","manufacturer":"Infineon","category":"mosfet","description":"100 V 2.7 mOhm N-channel OptiMOS 5, SuperSO8 (TDSON-8 5x6)","footprint":"Infineon_PG-TDSON-8","pins":9,"pads":3,"footprint_status":"generated","params":{"vds_v":100,"rds_on_mohm":2.7,"channel":"N"},"datasheet_url":"https://www.lcsc.com/product-detail/C534315.html","lcsc":"C534315","jlc_library":"extended","aliases":["BSC027N10NS5ATMA1"],"bom_mpn":"BSC027N10NS5ATMA1","verification":{"status":"corrected","source":"LCSC product detail C534315; JLCPCB listing C7086601 (ATMA1)","note":"The ATMA1 reel code (C7086601) has no stock; BSC027N10NS5 (C534315, the BOM's noted LCSC#) is stocked, but only ~785 pcs (7 per board)."},"alternatives":[{"mpn":"BSC026N08NS5ATMA1","lcsc":"C5955453","note":"80 V 2.6 mOhm, same footprint, deep stock \u2014 only if 80 V is enough"}]},{"id":"ti.tps7a40","mpn":"TPS7A4001DGNR","manufacturer":"Texas Instruments","category":"ldo","description":"100 V 50 mA adjustable LDO, MSOP-8 PowerPAD","footprint":"MSOP-8-1EP_3x3mm_P0.65mm_EP1.68x1.88mm","pins":8,"footprint_status":"generated","params":{"vin_max_v":100,"iout_ma":50,"vout_v":[1.175,90]},"datasheet_url":"https://www.ti.com/lit/ds/symlink/tps7a40.pdf","lcsc":"C55006","jlc_library":"extended","verification":{"status":"verified","source":"LCSC product detail C55006"}},{"id":"bourns.css2h2512r2l00f","mpn":"CSS2H-2512R-2L00F","manufacturer":"Bourns","category":"resistor_shunt","description":"2 mOhm 2512 metal-strip current-sense resistor (as specified by BOM)","footprint":"R_2512_6332Metric","pins":2,"footprint_status":"generated","params":{"resistance_mohm":2,"tolerance_pct":1},"datasheet_url":"https://www.bourns.com/docs/product-datasheets/css2h-2512.pdf","lcsc":null,"jlc_library":null,"verification":{"status":"flagged","source":"JLCPCB/LCSC search (no hit); distributor search","note":"No listing found for the R-suffix 2 mOhm part. A distributor lists CSS2H-2512K-2L00F (2 mOhm 5 W 1%); confirm the suffix against the Bourns datasheet. Not on LCSC either way."},"alternatives":[{"mpn":"CSS2H-2512K-2L00F","note":"Bourns 2 mOhm 5 W (distributor-listed, not on LCSC)"},{"mpn":"LR2512-22R002F4","lcsc":"C108929","note":"RALEC 2 mOhm 2512 on LCSC \u2014 check its power rating against 20 A"}]},{"id":"amass.xt90pb-m","mpn":"XT90PB-M.G.Y","manufacturer":"Changzhou Amass","category":"connector","description":"XT90 male PCB connector (PB board-mount variant)","footprint":"AMASS_XT90PB-M_Vertical","pins":2,"footprint_status":"placeholder","params":{"current_a":45,"positions":2},"datasheet_url":"https://www.lcsc.com/product-detail/C3040688.html","lcsc":"C3040688","jlc_library":"extended","aliases":["XT90PB-M","AMASS XT90PB-M"],"bom_mpn":"AMASS XT90PB-M (vertical PCB; variant name UNVERIFIED)","verification":{"status":"corrected","source":"JLCPCB/LCSC listing C3040688","note":"The orderable code is XT90PB-M.G.Y (C3040688, stocked); bare 'XT90PB-M' is only a JLC consignment placeholder. Confirm PB (vs PW) gives the vertical orientation against the Amass drawing."},"alternatives":[{"mpn":"XT90PW-M.G.Y","lcsc":"C3040689","note":"PW board-mount variant (other orientation)"}]},{"id":"vishay.wslp1206r0100fea","mpn":"WSLP1206R0100FEA","manufacturer":"Vishay Dale","category":"resistor_shunt","description":"10 mOhm 1% power metal-strip current-sense resistor, 1206","footprint":"R_1206_3216Metric","pins":2,"footprint_status":"generated","params":{"resistance_mohm":10,"tolerance_pct":1,"power_w":1},"datasheet_url":"https://www.vishay.com/docs/30175/wslp.pdf","lcsc":"C844910","jlc_library":"extended","verification":{"status":"verified","source":"JLCPCB/LCSC listing C844910"}},{"id":"jst.sm02b-ghs-tb","mpn":"SM02B-GHS-TB(LF)(SN)","manufacturer":"JST","category":"connector","description":"GH 1.25 mm 2-pos right-angle SMD header","footprint":"JST_GH_SM02B-GHS-TB_1x02-1MP_P1.25mm_Horizontal","pins":2,"footprint_status":"generated","params":{"pitch_mm":1.25,"positions":2,"current_a":1},"datasheet_url":"https://www.lcsc.com/product-detail/C189893.html","lcsc":"C189893","jlc_library":"extended","aliases":["SM02B-GHS-TB","JST SM02B-GHS-TB"],"verification":{"status":"verified","source":"JLCPCB/LCSC listing C189893"}},{"id":"ti.sn74aup1g74","mpn":"SN74AUP1G74DCUR","manufacturer":"Texas Instruments","category":"logic","description":"Single D flip-flop with preset/clear, low power, VSSOP-8 (DCU)","footprint":"VSSOP-8_2.3x2mm_P0.5mm","pins":8,"footprint_status":"generated","params":{"vcc_v":[0.8,3.6],"function":"DFF with PRE/CLR"},"datasheet_url":"https://www.ti.com/lit/ds/symlink/sn74aup1g74.pdf","lcsc":"C140267","jlc_library":"extended","verification":{"status":"verified","source":"JLCPCB/LCSC listing C140267"}},{"id":"class.resistor-chip","mpn":null,"manufacturer":"multi-source","category":"passive_class","description":"Thick-film chip resistor class (0603/0805/1206, 1%). Resolve each value via live search; JLC basic UNI-ROYAL 0603WAF series is the default.","footprint":"R_0603_1608Metric","pins":2,"footprint_status":"generated","params":{"series":"E96","tolerance_pct":1,"example":"0603WAF1002T5E (10k, C25804, basic)"},"datasheet_url":null,"lcsc":null,"jlc_library":"basic","verification":{"status":"verified","source":"JLCPCB basic library (UNI-ROYAL 0603WAF)"}},{"id":"class.capacitor-mlcc","mpn":null,"manufacturer":"multi-source","category":"passive_class","description":"MLCC class (X7R/X5R/C0G). Resolve value + voltage + package via live search. Check the voltage rating; 100 V 1210 parts are extended-library.","footprint":"C_0603_1608Metric","pins":2,"footprint_status":"generated","params":{"example":"CC0603KRX7R9BB104 (100nF 50V, C14663, basic)"},"datasheet_url":null,"lcsc":null,"jlc_library":"basic","verification":{"status":"verified","source":"JLCPCB basic library (YAGEO CC0603)"}},{"id":"class.led-0603","mpn":null,"manufacturer":"multi-source","category":"passive_class","description":"0603 indicator LEDs (green/red). JLC basic red KT-0603R (C2286); pick a stocked green 0603 by live search.","footprint":"LED_0603_1608Metric","pins":2,"footprint_status":"generated","params":{},"datasheet_url":null,"lcsc":null,"jlc_library":"basic","verification":{"status":"verified","source":"JLCPCB basic library"}}]}`;
+  }
+});
+
+// src/tools/part-stock.ts
+function db() {
+  if (!dbCache) dbCache = JSON.parse(ORDERABLE_CATALOG_JSON);
+  return dbCache;
+}
+function orderableParts() {
+  return db().parts;
+}
+function orderableCheckedDate() {
+  return db().checked;
+}
+function normMpn(s) {
+  return s.toUpperCase().replace(/[\s\-_/().,+=]/g, "");
+}
+function lookupOrderable(query) {
+  const q2 = query.trim();
+  if (!q2) return null;
+  const parts = orderableParts();
+  if (LCSC_RE.test(q2)) {
+    const c = q2.toUpperCase();
+    return parts.find((p) => p.lcsc === c || p.bom_lcsc === c) ?? null;
+  }
+  const keys = [normMpn(q2)];
+  const lastTok = q2.split(/\s+/).pop();
+  if (lastTok && lastTok !== q2) keys.push(normMpn(lastTok));
+  const noNote = q2.replace(/\s+\([^)]*\)\s*$/, "");
+  if (noNote !== q2) keys.push(normMpn(noNote));
+  for (const key3 of keys) {
+    const hit = parts.find((p) => {
+      const names = [p.mpn, ...p.aliases ?? [], p.bom_mpn].filter(Boolean);
+      return names.some((n) => normMpn(n) === key3);
+    });
+    if (hit) return hit;
+  }
+  return null;
+}
+function searchOrderable(query, limit = 5) {
+  const exact = lookupOrderable(query);
+  const toks = query.toLowerCase().split(/[\s,]+/).filter((t2) => t2.length > 1);
+  if (toks.length === 0) return exact ? [exact] : [];
+  const scored = orderableParts().map((p) => {
+    const hay = [p.mpn ?? "", ...p.aliases ?? [], p.manufacturer, p.category, p.description, p.footprint].join(" ").toLowerCase();
+    const score = toks.reduce((s, t2) => s + (hay.includes(t2) ? 1 : 0), 0);
+    return { p, score: p === exact ? 1e6 : score };
+  }).filter((x) => x.score > 0).sort((a, b) => b.score - a.score);
+  return scored.slice(0, limit).map((x) => x.p);
+}
+function isPlaceholderRow(c) {
+  return /^C99\d{8,}$/.test(c.componentCode) || c.componentBrandEn === "JLCPCB Assembly";
+}
+function unitPriceAt(breaks, qty) {
+  if (breaks.length === 0) return null;
+  const sorted = [...breaks].sort((a, b) => a.qty - b.qty);
+  let price = sorted[0].unit_usd;
+  for (const b of sorted) if (b.qty <= qty) price = b.unit_usd;
+  return price;
+}
+function passiveKeyword(spec) {
+  const m = spec.trim().match(/^(RES|CAP|IND|LED)\s+(.+)$/i);
+  if (!m) return null;
+  const kind = m[1].toUpperCase();
+  const rest = m[2].trim();
+  const toks = rest.split(/\s+/);
+  const pkg = toks.find((t2) => /^(0201|0402|0603|0805|1206|1210|1812|2010|2512)$/.test(t2)) ?? "";
+  if (kind === "RES") {
+    let v = toks[0];
+    if (/^\d+(\.\d+)?$/.test(v)) v = `${v}\u03A9`;
+    else if (/^\d+(\.\d+)?[kKmM]$/.test(v)) v = `${v.slice(0, -1)}${v.slice(-1) === "k" || v.slice(-1) === "K" ? "k" : "M"}\u03A9`;
+    return { keyword: `${v} ${pkg}`.trim(), mustContain: [v] };
+  }
+  if (kind === "CAP") {
+    const v = toks[0];
+    const volt = toks.find((t2) => /^\d+(\.\d+)?V$/i.test(t2));
+    const kw = [v, volt, pkg].filter(Boolean).join(" ");
+    return { keyword: kw, mustContain: [v, ...volt ? [volt.toUpperCase()] : []] };
+  }
+  if (kind === "LED") {
+    const color = (toks.find((t2) => /green|red|blue|yellow|white|orange/i.test(t2)) ?? "").toLowerCase();
+    const KNOWN = { green: "KT-0603G", red: "KT-0603R" };
+    if (pkg === "0603" && KNOWN[color]) return { keyword: KNOWN[color], mustContain: [] };
+    return { keyword: `${color} LED ${pkg}`.trim(), mustContain: [] };
+  }
+  return { keyword: rest, mustContain: [] };
+}
+function describeHas(c, tok) {
+  const hay = `${c.describe ?? ""} ${c.componentSpecificationEn ?? ""}`.toLowerCase().replace(/µ/g, "u");
+  const t2 = tok.toLowerCase().replace(/µ/g, "u");
+  const i = hay.indexOf(t2);
+  if (i < 0) return false;
+  const before = i === 0 ? " " : hay[i - 1];
+  return !/[\d.]/.test(before);
+}
+function extCost(q2, qtyTotal, basis) {
+  const own = basis === "lcsc" ? q2.price_breaks : q2.jlc_price_breaks;
+  const ladder = own.length ? own : basis === "lcsc" ? q2.jlc_price_breaks : q2.price_breaks;
+  const buy = basis === "lcsc" && own.length ? Math.max(qtyTotal, q2.min_order_qty ?? 1) : qtyTotal;
+  const unit = unitPriceAt(ladder, buy);
+  return unit === null ? null : Math.round(unit * buy * 1e4) / 1e4;
+}
+async function annotateBomStock(client, lines, builds = [5, 100]) {
+  const out = [];
+  for (const line of lines) {
+    const need = line.qty * Math.max(...builds);
+    const quote = await client.check(line.part, need);
+    const flags = [];
+    if (!quote.found) flags.push("missing");
+    const stock = Math.max(quote.stock_lcsc ?? -1, quote.stock_jlc ?? -1);
+    if (quote.found && quote.source !== "offline") {
+      if (stock <= 0) flags.push("out_of_stock");
+      else if (stock < need) flags.push("low_stock");
+    }
+    if (quote.eol) flags.push("eol");
+    if (quote.db?.verification.status === "flagged") flags.push("db_flagged");
+    if (quote.db?.verification.status === "corrected") flags.push("db_corrected");
+    if (quote.db?.footprint_status === "placeholder") flags.push("footprint_placeholder");
+    if (line.noted_lcsc && quote.lcsc && line.noted_lcsc.toUpperCase() !== quote.lcsc) {
+      flags.push("lcsc_mismatch");
+      quote.warnings.push(`line notes LCSC ${line.noted_lcsc}, actual part is ${quote.lcsc}`);
+    }
+    const cost = { lcsc: {}, jlc_assembly: {} };
+    for (const basis of BASES) {
+      for (const b of builds) cost[basis][String(b)] = extCost(quote, line.qty * b, basis);
+    }
+    if (quote.price_breaks.length === 0 && quote.jlc_price_breaks.length === 0) flags.push("unpriced");
+    out.push({ ...line, quote, cost, flags, alternatives: quote.db?.alternatives ?? [] });
+  }
+  const totals = { lcsc: {}, jlc_assembly: {} };
+  for (const basis of BASES) {
+    for (const b of builds) {
+      let usd2 = 0;
+      let unpriced = 0;
+      for (const l of out) {
+        const c = l.cost[basis][String(b)];
+        if (c === null) unpriced++;
+        else usd2 += c;
+      }
+      totals[basis][String(b)] = { usd: Math.round(usd2 * 100) / 100, unpriced_lines: unpriced };
+    }
+  }
+  const SERIOUS = /* @__PURE__ */ new Set(["missing", "out_of_stock", "low_stock", "eol", "db_flagged", "db_corrected", "lcsc_mismatch"]);
+  const flagged = out.filter((l) => l.flags.some((f) => SERIOUS.has(f))).map((l) => ({
+    name: l.name,
+    part: l.part,
+    flags: l.flags,
+    note: [l.quote.db?.verification.note, ...l.quote.warnings].filter(Boolean).join(" | ")
+  }));
+  return { builds, lines: out, totals, flagged, checked_at: (/* @__PURE__ */ new Date()).toISOString() };
+}
+function parseCsv(text) {
+  const rows = [];
+  let row = [];
+  let field = "";
+  let inQ = false;
+  for (let i = 0; i < text.length; i++) {
+    const ch = text[i];
+    if (inQ) {
+      if (ch === '"' && text[i + 1] === '"') {
+        field += '"';
+        i++;
+      } else if (ch === '"') inQ = false;
+      else field += ch;
+    } else if (ch === '"') inQ = true;
+    else if (ch === ",") {
+      row.push(field);
+      field = "";
+    } else if (ch === "\n" || ch === "\r") {
+      if (ch === "\r" && text[i + 1] === "\n") i++;
+      row.push(field);
+      rows.push(row);
+      row = [];
+      field = "";
+    } else field += ch;
+  }
+  if (field !== "" || row.length) {
+    row.push(field);
+    rows.push(row);
+  }
+  return rows.filter((r) => r.some((c) => c.trim() !== ""));
+}
+function bomCsvToStockLines(csv2) {
+  const rows = parseCsv(csv2);
+  if (rows.length < 2) return [];
+  const hdr = rows[0].map((h) => h.trim().toLowerCase());
+  const col = (n) => hdr.indexOf(n);
+  const iKind = col("kind");
+  const iName = col("name");
+  const iPn = col("example_pn") >= 0 ? col("example_pn") : col("mpn");
+  const iQty = col("qty");
+  const iNotes = col("notes");
+  const lines = [];
+  for (const r of rows.slice(1)) {
+    if (iKind >= 0 && r[iKind]?.trim() === "manufactured") continue;
+    const pn = (r[iPn] ?? "").trim();
+    if (!pn || /footprint only/i.test(pn)) continue;
+    const noted = (r[iNotes] ?? "").match(/\bLCSC\s+(C\d+)/i)?.[1] ?? null;
+    lines.push({
+      name: (r[iName] ?? pn).trim(),
+      part: pn,
+      qty: Number(r[iQty]) || 1,
+      noted_lcsc: noted
+    });
+  }
+  return lines;
+}
+function stockClient() {
+  if (!sharedClient) sharedClient = new PartStockClient({ offline: process.env.VCAD_PARTS_OFFLINE === "1" });
+  return sharedClient;
+}
+async function checkPartStock(args) {
+  const qs = Array.isArray(args.queries) ? args.queries.map(String) : typeof args.query === "string" ? [args.query] : [];
+  if (qs.length === 0) {
+    return { content: [{ type: "text", text: JSON.stringify({ error: "pass `query` or `queries`" }) }], isError: true };
+  }
+  const need = typeof args.qty === "number" ? Math.max(1, Math.round(args.qty)) : 1;
+  const client = stockClient();
+  const results = [];
+  for (const q2 of qs) results.push(await client.check(q2, need));
+  const payload = { count: results.length, results, note: STOCK_NOTE };
+  return { content: [{ type: "text", text: JSON.stringify(payload) }], structuredContent: payload };
+}
+function setBomLinesResolver(r) {
+  bomResolver = r;
+}
+async function bomCheckStock(args, ctx) {
+  let lines = null;
+  if (typeof args.csv === "string") lines = bomCsvToStockLines(args.csv);
+  else if (Array.isArray(args.lines)) {
+    lines = args.lines.map((l) => ({
+      name: String(l.name ?? l.part),
+      part: String(l.part),
+      qty: Number(l.qty) || 1,
+      noted_lcsc: typeof l.noted_lcsc === "string" ? l.noted_lcsc : null
+    }));
+  } else if (typeof args.bom_id === "string") {
+    lines = bomResolver ? bomResolver(args.bom_id, ctx) : null;
+    if (!lines) {
+      return { content: [{ type: "text", text: JSON.stringify({ error: `Unknown bom_id "${args.bom_id}"` }) }], isError: true };
+    }
+  }
+  if (!lines || lines.length === 0) {
+    return { content: [{ type: "text", text: JSON.stringify({ error: "pass bom_id, csv, or lines (no checkable lines found)" }) }], isError: true };
+  }
+  const builds = Array.isArray(args.builds) && args.builds.length ? args.builds.map((n) => Math.max(1, Math.round(Number(n)))).filter(Boolean) : [5, 100];
+  const report = await annotateBomStock(stockClient(), lines, builds);
+  const payload = { ...report, note: STOCK_NOTE };
+  return { content: [{ type: "text", text: JSON.stringify(payload) }], structuredContent: payload };
+}
+var dbCache, LCSC_RE, JLC_SEARCH_URL, LCSC_DETAIL_URL, UA, PartStockClient, BASES, sharedClient, STOCK_NOTE, checkPartStockSchema, bomCheckStockSchema, bomResolver, toolDefs15;
+var init_part_stock = __esm({
+  "src/tools/part-stock.ts"() {
+    "use strict";
+    init_orderable_catalog_generated();
+    init_tool_def();
+    dbCache = null;
+    LCSC_RE = /^C\d{2,}$/i;
+    JLC_SEARCH_URL = "https://jlcpcb.com/api/overseas-pcb-order/v1/shoppingCart/smtGood/selectSmtComponentList";
+    LCSC_DETAIL_URL = "https://wmsc.lcsc.com/ftps/wm/product/detail?productCode=";
+    UA = "vcad-mcp parts-stock (+https://vcad.io)";
+    PartStockClient = class {
+      fetchImpl;
+      now;
+      minIntervalMs;
+      timeoutMs;
+      ttlMs;
+      offline;
+      sleep;
+      cache = /* @__PURE__ */ new Map();
+      queue = Promise.resolve();
+      lastRequestAt = -Infinity;
+      /** Outbound request count (observability + tests). */
+      requests = 0;
+      constructor(opts = {}) {
+        const g = globalThis.fetch;
+        this.fetchImpl = opts.fetch ?? (g ? g.bind(globalThis) : null);
+        this.now = opts.now ?? Date.now;
+        this.minIntervalMs = opts.minIntervalMs ?? 400;
+        this.timeoutMs = opts.timeoutMs ?? 1e4;
+        this.ttlMs = opts.ttlMs ?? 15 * 6e4;
+        this.offline = opts.offline ?? false;
+        this.sleep = opts.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+      }
+      /** Serialize + space requests; returns parsed JSON or throws. */
+      async request(url, init2) {
+        if (!this.fetchImpl || this.offline) throw new Error("offline");
+        const run = async () => {
+          const wait = this.lastRequestAt + this.minIntervalMs - this.now();
+          if (wait > 0) await this.sleep(wait);
+          this.lastRequestAt = this.now();
+          this.requests++;
+          const ctl = typeof AbortController !== "undefined" ? new AbortController() : null;
+          const timer2 = setTimeout(() => ctl?.abort(), this.timeoutMs);
+          try {
+            const timeout = new Promise(
+              (_, rej) => setTimeout(() => rej(new Error(`timeout after ${this.timeoutMs} ms`)), this.timeoutMs)
+            );
+            const res = await Promise.race([
+              this.fetchImpl(url, { ...init2, signal: ctl?.signal }),
+              timeout
+            ]);
+            if (!res.ok) throw new Error(`HTTP ${res.status}`);
+            return await res.json();
+          } finally {
+            clearTimeout(timer2);
+          }
+        };
+        const p = this.queue.then(run, run);
+        this.queue = p.then(
+          () => void 0,
+          () => void 0
+        );
+        return p;
+      }
+      async cached(key3, fn) {
+        const c = this.cache.get(key3);
+        if (c && this.now() - c.at < this.ttlMs) return { value: c.value, hit: true };
+        const value = await fn();
+        this.cache.set(key3, { at: this.now(), value });
+        return { value, hit: false };
+      }
+      /** JLCPCB parts-library keyword search. */
+      async jlcSearch(keyword) {
+        const { value, hit } = await this.cached(`jlc:${keyword}`, async () => {
+          const r = await this.request(JLC_SEARCH_URL, {
+            method: "POST",
+            headers: { "Content-Type": "application/json", "User-Agent": UA },
+            body: JSON.stringify({ keyword, currentPage: 1, pageSize: 10 })
+          });
+          if (r.code !== 200) throw new Error(`JLC search code ${r.code}`);
+          return r.data?.componentPageInfo?.list ?? [];
+        });
+        return { rows: value, hit };
+      }
+      /** LCSC product detail by LCSC#. Null when LCSC has no such product. */
+      async lcscDetail(code) {
+        const { value, hit } = await this.cached(`lcsc:${code}`, async () => {
+          const r = await this.request(LCSC_DETAIL_URL + encodeURIComponent(code), {
+            headers: { "User-Agent": UA }
+          });
+          if (r.code !== 200) throw new Error(`LCSC detail code ${r.code}`);
+          return r.result && r.result.productCode ? r.result : null;
+        });
+        return { detail: value, hit };
+      }
+      /**
+       * Check one part. `query` is an LCSC#, an MPN (DB-known or not), or a
+       * passive spec line ("RES 10k 0603"). `need` (default 1) picks the best
+       * stocked candidate for spec queries.
+       */
+      async check(query, need = 1) {
+        const q2 = query.trim();
+        const dbPart = lookupOrderable(q2);
+        const base = {
+          query: q2,
+          found: false,
+          lcsc: dbPart?.lcsc ?? (LCSC_RE.test(q2) ? q2.toUpperCase() : null),
+          mpn: dbPart?.mpn ?? null,
+          manufacturer: dbPart?.manufacturer ?? null,
+          package: dbPart?.footprint ?? null,
+          description: dbPart?.description ?? null,
+          stock_lcsc: null,
+          stock_jlc: null,
+          jlc_library: dbPart?.jlc_library ?? null,
+          min_order_qty: null,
+          price_breaks: [],
+          jlc_price_breaks: [],
+          lifecycle: null,
+          eol: false,
+          source: "live",
+          fetched_at: null,
+          db: dbPart ? {
+            id: dbPart.id,
+            mpn: dbPart.mpn,
+            footprint: dbPart.footprint,
+            footprint_status: dbPart.footprint_status,
+            verification: dbPart.verification,
+            alternatives: dbPart.alternatives
+          } : null,
+          warnings: []
+        };
+        if (dbPart?.verification.status === "flagged") {
+          base.warnings.push(`DB flags this part: ${dbPart.verification.note ?? "unverified"}`);
+        }
+        if (dbPart?.verification.status === "corrected" && dbPart.bom_mpn && normMpn(dbPart.bom_mpn) === normMpn(q2)) {
+          base.warnings.push(`'${q2}' was corrected to '${dbPart.mpn}': ${dbPart.verification.note ?? ""}`.trim());
+        }
+        if (dbPart?.bom_lcsc && dbPart.bom_lcsc === q2.toUpperCase()) {
+          base.warnings.push(`LCSC ${q2} is NOT this part's number; the correct LCSC# is ${dbPart.lcsc}. ${dbPart.verification.note ?? ""}`.trim());
+        }
+        let anyHit = false;
+        let anyMiss = false;
+        try {
+          let row;
+          const spec = !dbPart && !LCSC_RE.test(q2) ? passiveKeyword(q2) : null;
+          const keyword = base.lcsc ?? spec?.keyword ?? dbPart?.mpn ?? q2;
+          if (dbPart && !dbPart.mpn && !base.lcsc) {
+            base.warnings.push("DB entry is a part class, not an orderable MPN \u2014 query a concrete value");
+            return this.offlineFallback(base, "class entry");
+          }
+          const s = await this.jlcSearch(keyword);
+          s.hit ? anyHit = true : anyMiss = true;
+          const rows = s.rows.filter((r) => !isPlaceholderRow(r));
+          if (base.lcsc) {
+            row = rows.find((r) => r.componentCode === base.lcsc) ?? s.rows.find((r) => r.componentCode === base.lcsc);
+          } else if (spec) {
+            const ok4 = rows.filter((r) => spec.mustContain.every((t2) => describeHas(r, t2)));
+            const pkgTok = q2.match(/\b(0201|0402|0603|0805|1206|1210|1812|2010|2512)\b/)?.[1];
+            const pkgOk = pkgTok ? ok4.filter((r) => (r.componentSpecificationEn ?? "").includes(pkgTok)) : ok4;
+            const rank = (r) => (r.stockCount >= need ? 0 : 2) + (r.componentLibraryType === "base" ? 0 : 1);
+            row = [...pkgOk].sort((a, b) => rank(a) - rank(b) || b.stockCount - a.stockCount)[0];
+            if (row) base.warnings.push(`spec match: picked ${row.componentCode} ${row.componentModelEn} for '${q2}'`);
+          } else {
+            const key3 = normMpn(dbPart?.mpn ?? q2);
+            const exact = rows.filter((r) => normMpn(r.componentModelEn) === key3);
+            row = exact.find((r) => r.stockCount > 0) ?? exact[0] ?? rows.find((r) => normMpn(r.componentModelEn).startsWith(key3));
+          }
+          if (row) {
+            base.found = true;
+            base.lcsc = row.componentCode;
+            base.mpn = base.mpn ?? row.componentModelEn;
+            base.manufacturer = base.manufacturer ?? row.componentBrandEn;
+            base.package = base.package ?? row.componentSpecificationEn ?? null;
+            base.description = base.description ?? row.describe ?? null;
+            base.stock_jlc = row.stockCount;
+            base.jlc_library = row.componentLibraryType === "base" ? "basic" : "extended";
+            base.jlc_price_breaks = (row.componentPrices ?? []).map((p) => ({ qty: p.startNumber, unit_usd: p.productPrice }));
+            if (isPlaceholderRow(row)) base.warnings.push(`${row.componentCode} is a JLC consignment placeholder, not stocked`);
+          }
+          if (base.lcsc) {
+            const d = await this.lcscDetail(base.lcsc);
+            d.hit ? anyHit = true : anyMiss = true;
+            if (d.detail) {
+              const det = d.detail;
+              base.found = true;
+              if (base.mpn && normMpn(det.productModel) !== normMpn(base.mpn) && !dbPart?.aliases?.some((a) => normMpn(a) === normMpn(det.productModel))) {
+                base.warnings.push(`LCSC ${base.lcsc} is '${det.productModel}' (${det.brandNameEn}), not '${base.mpn}'`);
+              }
+              base.mpn = base.mpn ?? det.productModel;
+              base.manufacturer = base.manufacturer ?? det.brandNameEn;
+              base.stock_lcsc = det.stockNumber;
+              base.min_order_qty = det.minBuyNumber ?? null;
+              base.lifecycle = det.productCycle ?? null;
+              base.eol = /discontinu|obsolete|eol|nrnd|not.?recommend|end.?of.?life/i.test(det.productCycle ?? "");
+              const ladder = (det.productPriceList ?? []).map((p) => ({ qty: p.ladder, unit_usd: p.usdPrice }));
+              base.price_breaks = ladder;
+            }
+          }
+          if (!base.found) base.warnings.push(`no LCSC/JLCPCB listing found for '${q2}'`);
+          base.source = anyHit && !anyMiss ? "cache" : "live";
+          base.fetched_at = new Date(this.now()).toISOString();
+          return base;
+        } catch (e) {
+          return this.offlineFallback(base, e.message);
+        }
+      }
+      offlineFallback(base, why) {
+        base.source = "offline";
+        base.found = base.db !== null && base.lcsc !== null;
+        base.warnings.push(
+          `live check unavailable (${why}); identity from the offline DB (verified ${orderableCheckedDate()}), no stock/price`
+        );
+        return base;
+      }
+    };
+    BASES = ["lcsc", "jlc_assembly"];
+    sharedClient = null;
+    STOCK_NOTE = "Stock and prices are a live snapshot from public LCSC/JLCPCB listings (USD, excl. shipping/tax/JLC setup fees) \u2014 re-check before ordering.";
+    checkPartStockSchema = {
+      type: "object",
+      properties: {
+        query: { type: "string", description: "MPN (e.g. 'TPS48110AQDGXRQ1'), LCSC# (e.g. 'C7519'), or a passive spec line ('RES 10k 0603', 'CAP 100nF 50V 0603')." },
+        queries: { type: "array", items: { type: "string" }, description: "Several queries at once (rate-limited, cached)." },
+        qty: { type: "integer", description: "Quantity needed \u2014 spec queries prefer a candidate with at least this much stock. Default 1." }
+      }
+    };
+    bomCheckStockSchema = {
+      type: "object",
+      properties: {
+        bom_id: { type: "string", description: "A BOM from bom_create (its COTS lines are checked)." },
+        csv: { type: "string", description: "BOM CSV text in the bom_export csv shape (kind,name,\u2026,example_pn,\u2026,qty,\u2026,notes)." },
+        lines: {
+          type: "array",
+          items: {
+            type: "object",
+            properties: { name: { type: "string" }, part: { type: "string" }, qty: { type: "number" }, noted_lcsc: { type: "string" } },
+            required: ["part", "qty"]
+          },
+          description: "Inline lines: part = MPN / LCSC# / passive spec, qty per board."
+        },
+        builds: { type: "array", items: { type: "integer" }, description: "Board build quantities to cost (default [5, 100])." }
+      }
+    };
+    bomResolver = null;
+    toolDefs15 = [
+      {
+        name: "check_part_stock",
+        pack: "bom",
+        description: "Live stock + price check for electronic parts against public LCSC and JLCPCB listings (no credentials). Accepts an MPN, an LCSC#, or a passive spec line ('RES 10k 0603'). Returns LCSC and JLC-assembly stock, the USD price ladder, the JLC basic/extended library tier, lifecycle/EOL, and, when the part is in vcad's curated orderable DB, its verified LCSC#, footprint, verification record, and alternatives. Cached (15 min), rate-limited, and with timeouts. When offline it falls back to the DB's identity data and reports no stock.",
+        inputSchema: checkPartStockSchema,
+        handler: (a) => checkPartStock(a),
+        behavior: behavior({})
+      },
+      {
+        name: "bom_check_stock",
+        pack: "bom",
+        description: "Annotate a BOM with live LCSC/JLCPCB stock and price. Takes a bom_id, BOM CSV text, or inline lines (MPN / LCSC# / passive spec + qty per board). Returns per-line stock, price ladder, and extended cost at each build quantity (default 5 and 100 boards, honouring LCSC minimum order), totals, and flags: missing, out_of_stock, low_stock, eol, db_flagged/db_corrected (the curated DB found the MPN wrong or unorderable), lcsc_mismatch (the line's noted LCSC# is a different part), footprint_placeholder. Flagged lines include alternatives.",
+        inputSchema: bomCheckStockSchema,
+        handler: (a, c) => bomCheckStock(a, c),
+        behavior: behavior({})
+      }
+    ];
+  }
+});
+
 // src/tools/bom.ts
 import { randomUUID as randomUUID6 } from "node:crypto";
 function ok3(payload) {
@@ -61270,7 +61872,7 @@ function renderCsv(bom) {
   }
   return rows.join("\r\n") + "\r\n";
 }
-var PRICING_NOTE, memBoms, bomKey, toUsd3, usdToMinor, fmtUsd, BOM_ORACLE, str, lineProperties, bomCreateSchema, bomAddLineSchema, bomExportSchema, md, csv, toolDefs15;
+var PRICING_NOTE, memBoms, bomKey, toUsd3, usdToMinor, fmtUsd, BOM_ORACLE, str, lineProperties, bomCreateSchema, bomAddLineSchema, bomExportSchema, md, csv, toolDefs16;
 var init_bom = __esm({
   "src/tools/bom.ts"() {
     "use strict";
@@ -61278,11 +61880,23 @@ var init_bom = __esm({
     init_pricing();
     init_types4();
     init_mech_parts();
+    init_part_stock();
     init_session_core();
     init_tool_def();
     PRICING_NOTE = "All prices are ESTIMATES (Phase-0 quote estimates, catalog price bands, or caller-supplied numbers) \u2014 not binding quotes.";
     memBoms = /* @__PURE__ */ new Map();
     bomKey = (owner, id) => `${owner}::${id}`;
+    setBomLinesResolver((bomId, ctx) => {
+      const user = ctx?.user ?? null;
+      const bom = getBom(ownerId(user), bomId);
+      if (!bom) return null;
+      return bom.lines.filter((l) => l.kind === "cots").filter((l) => (l.example_pn ?? l.spec ?? "").trim() !== "").map((l) => ({
+        name: l.name,
+        part: l.example_pn ?? l.spec,
+        qty: l.qty,
+        noted_lcsc: l.notes?.match(/\bLCSC\s+(C\d+)/i)?.[1] ?? null
+      }));
+    });
     toUsd3 = (minor) => Math.round(minor) / 100;
     usdToMinor = (usd2) => Math.round(usd2 * 100);
     fmtUsd = (minor) => minor === null ? "\u2014" : `$${(Math.round(minor) / 100).toFixed(2)}`;
@@ -61378,7 +61992,7 @@ var init_bom = __esm({
       const s = String(v);
       return /[",\r\n]/.test(s) ? `"${s.replace(/"/g, '""')}"` : s;
     };
-    toolDefs15 = [
+    toolDefs16 = [
       {
         name: "bom_create",
         pack: "bom",
@@ -61441,7 +62055,7 @@ async function unshareSession(input, store) {
     note: "Live link revoked \u2014 the link now 404s and no further live updates are broadcast for this session. (A viewer already connected keeps only the events they had already received; their socket isn't force-closed.)"
   });
 }
-var DISABLED, shareSessionSchema, unshareSessionSchema, toolDefs16;
+var DISABLED, shareSessionSchema, unshareSessionSchema, toolDefs17;
 var init_live_share = __esm({
   "src/tools/live-share.ts"() {
     "use strict";
@@ -61469,7 +62083,7 @@ var init_live_share = __esm({
       },
       required: ["document_id"]
     };
-    toolDefs16 = [
+    toolDefs17 = [
       {
         name: "share_session",
         pack: null,
@@ -61597,7 +62211,7 @@ function placePartTool(args, engine) {
     ]
   };
 }
-var searchPartsSchema, placePartSchema, toolDefs17;
+var searchPartsSchema, placePartSchema, toolDefs18;
 var init_parts2 = __esm({
   "src/tools/parts.ts"() {
     "use strict";
@@ -61653,7 +62267,7 @@ var init_parts2 = __esm({
       },
       required: ["document_id", "path"]
     };
-    toolDefs17 = [
+    toolDefs18 = [
       {
         name: "search_parts",
         pack: null,
@@ -61811,7 +62425,7 @@ function exportCad(input, engine) {
     ...scene.instances && scene.instances.length > 0 ? { instances: scene.instances.length } : {}
   });
 }
-var exportCadSchema, toolDefs18;
+var exportCadSchema, toolDefs19;
 var init_export = __esm({
   "src/tools/export.ts"() {
     "use strict";
@@ -61847,7 +62461,7 @@ var init_export = __esm({
       },
       required: ["filename"]
     };
-    toolDefs18 = [
+    toolDefs19 = [
       {
         name: "export_cad",
         pack: null,
@@ -62088,7 +62702,7 @@ function err5(text) {
     isError: true
   };
 }
-var MAX_STEPS_PER_SIDE, JointRangeError, key2, Lattice, checkJointRangeSchema, toolDefs19;
+var MAX_STEPS_PER_SIDE, JointRangeError, key2, Lattice, checkJointRangeSchema, toolDefs20;
 var init_joint_range = __esm({
   "src/tools/joint-range.ts"() {
     "use strict";
@@ -62186,7 +62800,7 @@ var init_joint_range = __esm({
       },
       required: ["document_id"]
     };
-    toolDefs19 = [
+    toolDefs20 = [
       {
         name: "check_joint_range",
         pack: null,
@@ -62466,7 +63080,7 @@ function measureOuterDiameter(args, engine) {
     structuredContent: { outer_diameter: body, document_id: documentId }
   };
 }
-var DEFAULT_LIMIT, r62, vec, ACCURACY_NOTE, inspectFacesSchema, outerDiameterSchema, toolDefs20;
+var DEFAULT_LIMIT, r62, vec, ACCURACY_NOTE, inspectFacesSchema, outerDiameterSchema, toolDefs21;
 var init_faces = __esm({
   "src/tools/faces.ts"() {
     "use strict";
@@ -62547,7 +63161,7 @@ var init_faces = __esm({
       },
       required: ["document_id"]
     };
-    toolDefs20 = [
+    toolDefs21 = [
       {
         name: "inspect_faces",
         pack: null,
@@ -62728,7 +63342,7 @@ function sensitivity(input, engine) {
     claims: report.claims
   });
 }
-var listParametersSchema, setParametersSchema, parameterGradientSchema, sensitivitySchema, toolDefs21;
+var listParametersSchema, setParametersSchema, parameterGradientSchema, sensitivitySchema, toolDefs22;
 var init_parameters = __esm({
   "src/tools/parameters.ts"() {
     "use strict";
@@ -62826,7 +63440,7 @@ var init_parameters = __esm({
       },
       required: []
     };
-    toolDefs21 = [
+    toolDefs22 = [
       {
         name: "list_parameters",
         pack: null,
@@ -62865,6 +63479,181 @@ var init_parameters = __esm({
   }
 });
 
+// src/tools/schematic-hierarchy.ts
+function offsetRef(ref, offset) {
+  const m = /^(.*?)(\d+)$/.exec(ref);
+  if (!m) return `${ref}${offset}`;
+  return `${m[1]}${Number(m[2]) + offset}`;
+}
+function portsOf(def) {
+  const ports = new Set((def.ports ?? []).map((p) => p.name));
+  for (const l of def.body.labels ?? []) if (l.scope === "Hierarchical") ports.add(l.name);
+  return ports;
+}
+async function flattenSchematic(sheet, netlister) {
+  const h = sheet.hierarchy;
+  if (!h) return { sheet, diagnostics: [], instances: [] };
+  const diagnostics = [];
+  const err9 = (message) => diagnostics.push({ severity: "Error", message });
+  const warn = (message) => diagnostics.push({ severity: "Warning", message });
+  const defs = /* @__PURE__ */ new Map();
+  for (const def of h.sheets ?? []) {
+    if (defs.has(def.name)) err9(`Duplicate sheet definition '${def.name}'`);
+    else defs.set(def.name, def);
+  }
+  const globals = new Set(h.global_nets ?? []);
+  for (const l of [...sheet.labels ?? [], ...(h.sheets ?? []).flatMap((d) => d.body.labels ?? [])]) {
+    if (l.scope === "Global") globals.add(l.name);
+  }
+  const rootNames = /* @__PURE__ */ new Set([
+    ...(sheet.labels ?? []).map((l) => l.name),
+    ...Object.keys(sheet.nets ?? {})
+  ]);
+  const useCount = /* @__PURE__ */ new Map();
+  const countUses = (instances2, stack) => {
+    for (const inst of instances2) {
+      useCount.set(inst.sheet, (useCount.get(inst.sheet) ?? 0) + 1);
+      if (stack.includes(inst.sheet)) continue;
+      const def = defs.get(inst.sheet);
+      if (def) countUses(def.instances ?? [], [...stack, def.name]);
+    }
+  };
+  countUses(h.instances ?? [], []);
+  const outComponents = [];
+  const outNets = new Map(Object.entries(sheet.nets ?? {}).map(([k, v]) => [k, [...v]]));
+  const outFlags = [];
+  const instances = [];
+  const unusedPortReported = /* @__PURE__ */ new Set();
+  let autoSlot = 0;
+  const elaborateAll = async (insts, parentPath, parentOffset, resolveParent, stack) => {
+    const seen = /* @__PURE__ */ new Set();
+    const where = parentPath === "" ? "the root sheet" : `sheet instance '${parentPath}'`;
+    for (const inst of insts) {
+      if (!inst.name || inst.name.includes("/")) {
+        err9(`Sheet instance name '${inst.name}' in ${where} must be non-empty and contain no '/'`);
+        continue;
+      }
+      if (seen.has(inst.name)) {
+        err9(`Duplicate sheet instance name '${inst.name}' in ${where}`);
+        continue;
+      }
+      seen.add(inst.name);
+      const def = defs.get(inst.sheet);
+      if (!def) {
+        err9(`Sheet instance '${inst.name}' references unknown sheet '${inst.sheet}'`);
+        continue;
+      }
+      if (stack.includes(def.name)) {
+        err9(`Sheet recursion: instance '${inst.name}' places sheet '${def.name}' inside itself`);
+        continue;
+      }
+      const path = parentPath === "" ? inst.name : `${parentPath}/${inst.name}`;
+      const binding = /* @__PURE__ */ new Map();
+      for (const [port, net] of Object.entries(inst.connections ?? {})) binding.set(port, resolveParent(net));
+      autoSlot += 1;
+      const offset = inst.position ? { x: parentOffset.x + inst.position.x, y: parentOffset.y + inst.position.y } : { x: 0, y: AUTO_INSTANCE_STRIDE * autoSlot };
+      await elaborate(def, inst, path, binding, offset, [...stack, def.name]);
+    }
+  };
+  const elaborate = async (def, inst, path, binding, offset, stack) => {
+    const ports = portsOf(def);
+    for (const port of [...ports].sort()) {
+      if (globals.has(port)) {
+        err9(`Net scope collision: port '${port}' of sheet '${def.name}' is also a global net`);
+      }
+    }
+    for (const port of Object.keys(inst.connections ?? {}).sort()) {
+      if (!ports.has(port)) {
+        err9(`Sheet instance '${path}' connects '${port}', which is not a port of sheet '${def.name}'`);
+      }
+    }
+    for (const port of [...ports].sort()) {
+      if (!binding.has(port)) warn(`Hierarchical port '${port}' of sheet instance '${path}' is not connected`);
+    }
+    if (def.body.hierarchy) {
+      err9(`Sheet '${def.name}' body has its own hierarchy \u2014 nest sheets with \`instances\` instead (ignored)`);
+    }
+    const resolve7 = (name) => {
+      if (ports.has(name)) {
+        const bound = binding.get(name);
+        if (bound !== void 0) return bound;
+      } else if (globals.has(name)) {
+        return name;
+      }
+      return `${path}/${name}`;
+    };
+    const repeated = (useCount.get(def.name) ?? 0) > 1;
+    const refs = {};
+    for (const comp of def.body.components ?? []) {
+      const mapped = inst.ref_map?.[comp.ref];
+      const flatRef = mapped !== void 0 ? mapped : inst.ref_offset != null ? offsetRef(comp.ref, inst.ref_offset) : repeated ? `${comp.ref}_${inst.name}` : comp.ref;
+      refs[comp.ref] = flatRef;
+      outComponents.push({
+        ...comp,
+        ref: flatRef,
+        position: { x: comp.position.x + offset.x, y: comp.position.y + offset.y }
+      });
+    }
+    const body = { ...def.body, hierarchy: void 0 };
+    const nets2 = await netlister(body);
+    const usedNames = /* @__PURE__ */ new Set();
+    for (const [name, pins] of [...nets2.entries()].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) {
+      if (pins.length === 0) continue;
+      if (isAutoName(name) && pins.length < 2) continue;
+      usedNames.add(name);
+      const flat = resolve7(name);
+      if (!ports.has(name) && !globals.has(name) && rootNames.has(flat)) {
+        err9(
+          `Net scope collision: local net '${name}' of sheet instance '${path}' flattens to '${flat}', which the root sheet also uses`
+        );
+      }
+      const entry = outNets.get(flat) ?? [];
+      for (const p of pins) {
+        const dot = p.indexOf(".");
+        const ref = p.slice(0, dot);
+        entry.push(`${refs[ref] ?? ref}${p.slice(dot)}`);
+      }
+      outNets.set(flat, entry);
+    }
+    for (const child of def.instances ?? []) {
+      for (const n of Object.values(child.connections ?? {})) usedNames.add(n);
+    }
+    for (const port of [...ports].sort()) {
+      const key3 = `${def.name}\0${port}`;
+      if (!usedNames.has(port) && !unusedPortReported.has(key3)) {
+        unusedPortReported.add(key3);
+        warn(`Hierarchical port '${port}' of sheet '${def.name}' connects to nothing inside the sheet`);
+      }
+    }
+    for (const flag of def.body.power_flags ?? []) outFlags.push({ ...flag, net: resolve7(flag.net) });
+    instances.push({ path, sheet: def.name, refs });
+    await elaborateAll(def.instances ?? [], path, offset, resolve7, stack);
+  };
+  await elaborateAll(h.instances ?? [], "", { x: 0, y: 0 }, (n) => n, []);
+  const nets = {};
+  for (const [name, pins] of [...outNets.entries()].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) {
+    nets[name] = [...new Set(pins)];
+  }
+  const { hierarchy: _h, ...rest } = sheet;
+  const flatSheet = {
+    ...rest,
+    components: [...sheet.components ?? [], ...outComponents],
+    ...Object.keys(nets).length > 0 ? { nets } : { nets: void 0 },
+    power_flags: [...sheet.power_flags ?? [], ...outFlags]
+  };
+  if (flatSheet.nets === void 0) delete flatSheet.nets;
+  if ((flatSheet.power_flags ?? []).length === 0) delete flatSheet.power_flags;
+  return { sheet: flatSheet, diagnostics, instances };
+}
+var AUTO_INSTANCE_STRIDE, isAutoName;
+var init_schematic_hierarchy = __esm({
+  "src/tools/schematic-hierarchy.ts"() {
+    "use strict";
+    AUTO_INSTANCE_STRIDE = 1e5;
+    isAutoName = (n) => /^NET-\d+$/.test(n);
+  }
+});
+
 // src/tools/constraint-claims.ts
 function claimIdFor(c) {
   return `${CONSTRAINT_CLAIM_PREFIX}${c.label ?? c.id}`;
@@ -63188,7 +63977,7 @@ function err7(text) {
     isError: true
   };
 }
-var vec3Schema, checkEnclosureFitSchema, toolDefs22;
+var vec3Schema, checkEnclosureFitSchema, toolDefs23;
 var init_enclosure = __esm({
   "src/tools/enclosure.ts"() {
     "use strict";
@@ -63247,7 +64036,7 @@ var init_enclosure = __esm({
       },
       required: ["document_id", "enclosure_document_id"]
     };
-    toolDefs22 = [
+    toolDefs23 = [
       {
         name: "check_enclosure_fit",
         pack: "ecad",
@@ -63743,23 +64532,23 @@ function synthesizedPassivePins() {
     { number: "2", name: "2", pin_type: "Passive", position: { x: 5.08, y: 0 } }
   ];
 }
-async function createSchematic(args) {
+async function buildSheetBody(args, where = "") {
   const title = args.title || void 0;
   const componentsInput = args.components || [];
   const wiresInput = args.wires || [];
   const labelsInput = args.labels || [];
   const netsInput = args.nets || void 0;
-  const coord = (v, where) => {
+  const coord = (v, where2) => {
     if (typeof v !== "number" || !Number.isFinite(v)) {
       throw new Error(
-        `create_schematic: ${where} must be a finite number, got ${JSON.stringify(v)}`
+        `create_schematic: ${where2} must be a finite number, got ${JSON.stringify(v)}`
       );
     }
     return v;
   };
-  const coordOpt = (v, where) => {
+  const coordOpt = (v, where2) => {
     if (v === void 0 || v === null) return 0;
-    return coord(v, where);
+    return coord(v, where2);
   };
   const warnings = [];
   const resolvedParts = [];
@@ -63864,7 +64653,16 @@ async function createSchematic(args) {
     labels,
     ...netsInput ? { nets: netsInput } : {}
   };
-  if (netsInput) validateExplicitNets(schematic, netsInput);
+  const flagsInput = parsePowerFlags(args.power_flags, `${where}power_flags`);
+  if (flagsInput.length > 0) schematic.power_flags = flagsInput;
+  if (netsInput) {
+    try {
+      validateExplicitNets(schematic, netsInput);
+    } catch (e) {
+      if (!where) throw e;
+      throw new Error(`${where}${e.message}`);
+    }
+  }
   for (const label of labels) {
     const touchesWire = wires.some(
       (w) => Math.abs(w.start.x - label.position.x) < POSITION_TOLERANCE && Math.abs(w.start.y - label.position.y) < POSITION_TOLERANCE || Math.abs(w.end.x - label.position.x) < POSITION_TOLERANCE && Math.abs(w.end.y - label.position.y) < POSITION_TOLERANCE
@@ -63881,10 +64679,218 @@ async function createSchematic(args) {
       );
     }
   }
+  return {
+    sheet: schematic,
+    warnings: where ? warnings.map((w) => `${where}${w}`) : warnings,
+    resolvedParts
+  };
+}
+function parsePowerFlags(raw, where) {
+  if (raw === void 0 || raw === null) return [];
+  if (!Array.isArray(raw)) throw new Error(`${where} must be an array`);
+  return raw.map((f, i) => {
+    if (typeof f === "string" && f) return { net: f };
+    const o = f ?? {};
+    if (typeof o.net !== "string" || !o.net) {
+      throw new Error(`${where}[${i}] must be a net name or {net, note?}`);
+    }
+    return {
+      net: o.net,
+      ...typeof o.note === "string" ? { note: o.note } : {},
+      ...typeof o.x === "number" && typeof o.y === "number" ? { position: { x: o.x, y: o.y } } : {}
+    };
+  });
+}
+function parseSheetInstance(raw, where) {
+  if (typeof raw.name !== "string" || typeof raw.sheet !== "string") {
+    throw new Error(`${where} needs string \`name\` and \`sheet\``);
+  }
+  const conns = raw.connections ?? {};
+  const connections = {};
+  for (const [port, net] of Object.entries(conns)) {
+    if (typeof net !== "string") throw new Error(`${where}.connections.${port} must be a net name`);
+    connections[port] = net;
+  }
+  return {
+    name: raw.name,
+    sheet: raw.sheet,
+    connections,
+    ...raw.ref_map ? { ref_map: raw.ref_map } : {},
+    ...typeof raw.ref_offset === "number" ? { ref_offset: raw.ref_offset } : {},
+    ...typeof raw.x === "number" && typeof raw.y === "number" ? { position: { x: raw.x, y: raw.y } } : {}
+  };
+}
+async function parseSheetDefinition(raw, i) {
+  if (typeof raw.name !== "string" || !raw.name) throw new Error(`sheets[${i}] needs a \`name\``);
+  const where = `sheet '${raw.name}': `;
+  const built = await buildSheetBody(raw, where);
+  const ports = (raw.ports ?? []).map((p, j) => {
+    if (typeof p === "string") return { name: p, direction: "Passive" };
+    const o = p ?? {};
+    if (typeof o.name !== "string") throw new Error(`${where}ports[${j}] needs a name`);
+    return {
+      name: o.name,
+      direction: o.direction === void 0 ? "Passive" : validatePinType(o.direction, `${where}port ${o.name}`)
+    };
+  });
+  const instances = (raw.instances ?? []).map(
+    (inst, j) => parseSheetInstance(inst, `${where}instances[${j}]`)
+  );
+  return { def: { name: raw.name, ports, body: built.sheet, instances }, built };
+}
+async function flattenSheet(sheet) {
+  return flattenSchematic(sheet, async (s) => (await deriveNets(s)).nets);
+}
+async function docFlatSchematic(doc) {
+  const sheet = doc.schematic;
+  if (!sheet) return null;
+  return flattenSheet(sheet);
+}
+function flaggedNets(sheet) {
+  return new Set((sheet.power_flags ?? []).map((f) => f.net));
+}
+async function createSchematic(args) {
+  const root = await buildSheetBody(args);
+  const warnings = [...root.warnings];
+  const resolvedParts = [...root.resolvedParts];
+  const schematic = root.sheet;
+  const sheetsInput = args.sheets ?? [];
+  const instancesInput = args.instances ?? [];
+  if (sheetsInput.length > 0 || instancesInput.length > 0) {
+    const sheets = [];
+    for (let i = 0; i < sheetsInput.length; i++) {
+      const { def, built } = await parseSheetDefinition(sheetsInput[i], i);
+      warnings.push(...built.warnings);
+      resolvedParts.push(...built.resolvedParts.map((r) => ({ ...r, ref: `${def.name}:${r.ref}` })));
+      sheets.push(def);
+    }
+    schematic.hierarchy = {
+      sheets,
+      instances: instancesInput.map((inst, i) => parseSheetInstance(inst, `instances[${i}]`)),
+      global_nets: (args.global_nets ?? []).map(String)
+    };
+  }
   const doc = createDocument();
   doc.schematic = schematic;
   const documentId = registerSession(doc);
-  const derived = await deriveNets(schematic);
+  return schematicSummary(schematic, documentId, warnings, resolvedParts);
+}
+async function updateSchematic(args) {
+  const ctx = resolveDocInput(args);
+  const doc = ctx.doc;
+  if (!doc.schematic) return ecadError("Document has no schematic \u2014 create one with create_schematic.");
+  const warnings = [];
+  const resolvedParts = [];
+  let schematic = doc.schematic;
+  if (args.root && typeof args.root === "object") {
+    const built = await buildSheetBody(args.root);
+    warnings.push(...built.warnings);
+    resolvedParts.push(...built.resolvedParts);
+    schematic = { ...built.sheet, ...schematic.hierarchy ? { hierarchy: schematic.hierarchy } : {} };
+  }
+  if (args.power_flags !== void 0) {
+    const flags = parsePowerFlags(args.power_flags, "power_flags");
+    if (flags.length > 0) schematic.power_flags = flags;
+    else delete schematic.power_flags;
+  }
+  const touchesHierarchy = ["sheets", "remove_sheets", "instances", "remove_instances", "global_nets"].some(
+    (k) => args[k] !== void 0
+  );
+  if (touchesHierarchy) {
+    const h = {
+      sheets: [...schematic.hierarchy?.sheets ?? []],
+      instances: [...schematic.hierarchy?.instances ?? []],
+      global_nets: [...schematic.hierarchy?.global_nets ?? []]
+    };
+    const removeSheets = new Set((args.remove_sheets ?? []).map(String));
+    h.sheets = h.sheets.filter((d) => !removeSheets.has(d.name));
+    const sheetsInput = args.sheets ?? [];
+    for (let i = 0; i < sheetsInput.length; i++) {
+      const { def, built } = await parseSheetDefinition(sheetsInput[i], i);
+      warnings.push(...built.warnings);
+      resolvedParts.push(...built.resolvedParts.map((r) => ({ ...r, ref: `${def.name}:${r.ref}` })));
+      const at = h.sheets.findIndex((d) => d.name === def.name);
+      if (at >= 0) h.sheets[at] = def;
+      else h.sheets.push(def);
+    }
+    const removeInst = new Set((args.remove_instances ?? []).map(String));
+    h.instances = h.instances.filter((x) => !removeInst.has(x.name));
+    (args.instances ?? []).forEach((raw, i) => {
+      const inst = parseSheetInstance(raw, `instances[${i}]`);
+      const at = h.instances.findIndex((x) => x.name === inst.name);
+      if (at >= 0) h.instances[at] = inst;
+      else h.instances.push(inst);
+    });
+    if (args.global_nets !== void 0) h.global_nets = (args.global_nets ?? []).map(String);
+    if (h.sheets.length === 0 && h.instances.length === 0) delete schematic.hierarchy;
+    else schematic.hierarchy = h;
+  }
+  doc.schematic = schematic;
+  return schematicSummary(schematic, String(args.document_id), warnings, resolvedParts);
+}
+async function inspectSchematic(args) {
+  const { doc } = resolveDocInput(args);
+  const flat = await docFlatSchematic(doc);
+  if (!flat) return ecadError("Document has no schematic \u2014 create one with create_schematic.");
+  const sheet = doc.schematic;
+  const only = typeof args.instance === "string" ? args.instance : void 0;
+  if (only && !flat.instances.some((i) => i.path === only)) {
+    return ecadError(
+      `No sheet instance '${only}' (have: ${flat.instances.map((i) => i.path).join(", ") || "none \u2014 the schematic is flat"})`
+    );
+  }
+  const derived = await deriveNets(flat.sheet);
+  const inScope = (net, pins) => {
+    if (!only) return true;
+    if (net.startsWith(`${only}/`)) return true;
+    const refs = new Set(Object.values(flat.instances.find((i) => i.path === only).refs));
+    return pins.some((p) => refs.has(p.slice(0, p.indexOf("."))));
+  };
+  const nets = {};
+  for (const [name, pins] of [...derived.nets.entries()].sort(([a], [b]) => a.localeCompare(b))) {
+    if (inScope(name, pins)) nets[name] = pins;
+  }
+  const groups = /* @__PURE__ */ new Map();
+  for (const c of flat.sheet.components) {
+    if (c.ref.startsWith("#")) continue;
+    const part = c.properties?.part;
+    const key3 = `${c.value}\0${c.footprintId}\0${part ?? ""}`;
+    const g = groups.get(key3) ?? { value: c.value, footprint: c.footprintId, ...part ? { part } : {}, refs: [] };
+    g.refs.push(c.ref);
+    groups.set(key3, g);
+  }
+  const bom = [...groups.values()].map((g) => ({ ...g, qty: g.refs.length, refs: g.refs.sort() })).sort((a, b) => b.qty - a.qty || a.value.localeCompare(b.value));
+  const h = sheet.hierarchy;
+  const payload = {
+    success: true,
+    document_id: args.document_id,
+    hierarchical: !!h,
+    ...h ? {
+      sheets: (h.sheets ?? []).map((d) => ({
+        name: d.name,
+        ports: (d.ports ?? []).map((p) => ({ name: p.name, direction: p.direction ?? "Passive" })),
+        components: d.body.components.length,
+        instances: (d.instances ?? []).map((i) => ({ name: i.name, sheet: i.sheet }))
+      })),
+      global_nets: h.global_nets ?? [],
+      instances: flat.instances.filter((i) => !only || i.path === only)
+    } : {},
+    root_components: sheet.components.length,
+    components: flat.sheet.components.length,
+    nets,
+    power_flags: (flat.sheet.power_flags ?? []).map((f) => ({ net: f.net, ...f.note ? { note: f.note } : {} })),
+    ...flat.diagnostics.length > 0 ? { issues: flat.diagnostics } : {},
+    bom
+  };
+  return { content: [{ type: "text", text: JSON.stringify(payload) }] };
+}
+async function schematicSummary(schematic, documentId, warningsIn, resolvedParts) {
+  const warnings = [...warningsIn];
+  const flat = await flattenSheet(schematic);
+  const components = flat.sheet.components;
+  const wires = schematic.wires;
+  const labels = schematic.labels;
+  const derived = await deriveNets(flat.sheet);
   warnings.push(...derived.warnings);
   const netsPreview = {};
   for (const [name, pins] of derived.nets) netsPreview[name] = pins;
@@ -63927,6 +64933,14 @@ async function createSchematic(args) {
           nets: netsPreview,
           ...resolvedParts.length > 0 ? { resolved_parts: resolvedParts } : {},
           ...unconnected.length > 0 ? { unconnected_pins: unconnected } : {},
+          ...schematic.hierarchy ? {
+            hierarchy: {
+              sheets: (schematic.hierarchy.sheets ?? []).map((d) => d.name),
+              instances: flat.instances.map((i) => ({ path: i.path, sheet: i.sheet })),
+              ...flat.diagnostics.length > 0 ? { issues: flat.diagnostics } : {}
+            }
+          } : {},
+          ...(flat.sheet.power_flags ?? []).length > 0 ? { power_flags: (flat.sheet.power_flags ?? []).map((f) => f.net) } : {},
           ...warnings.length > 0 ? { warnings } : {}
         })
       }
@@ -64080,7 +65094,8 @@ async function placeComponents(args) {
       isError: true
     };
   }
-  const derived = await deriveNets(doc.schematic);
+  const flatSchematic = (await flattenSheet(doc.schematic)).sheet;
+  const derived = await deriveNets(flatSchematic);
   const netByPin = derived.netByPin;
   const useConnectivity = netByPin.size > 0;
   const warnings = [...derived.warnings];
@@ -64164,7 +65179,7 @@ async function placeComponents(args) {
   };
   const rules = defaultDesignRules();
   const defaultRules = rules.defaultRules;
-  const components = doc.schematic.components;
+  const components = flatSchematic.components;
   const strategy = args.strategy || "grid";
   const margin = Math.min(5, extentW / 8, extentH / 8);
   const usableW = extentW - 2 * margin;
@@ -65752,14 +66767,16 @@ async function runErc2(args) {
       isError: true
     };
   }
-  const sheet = doc.schematic;
+  const flat = await flattenSheet(doc.schematic);
+  const sheet = flat.sheet;
+  const flagged = flaggedNets(sheet);
   if (await isEcadAvailable2()) {
     const ercOutcome = await runErc(sheet);
     if (ercOutcome.status === "errored") {
       return ecadUnverifiable("run_erc", ercOutcome);
     }
   }
-  const violations = [];
+  const violations = flat.diagnostics.map((d) => ({ severity: d.severity, message: d.message }));
   const refs = /* @__PURE__ */ new Map();
   for (const comp of sheet.components) {
     refs.set(comp.ref, (refs.get(comp.ref) || 0) + 1);
@@ -65791,6 +66808,8 @@ async function runErc2(args) {
     verified = true;
     for (const v of kernelOutcome.violations) {
       if (!isPinTypeOrPowerViolation(v.message)) continue;
+      const noSource = /^Power input pin on net '(.*)' has no power source$/.exec(v.message);
+      if (noSource && flagged.has(noSource[1])) continue;
       violations.push({
         severity: v.severity,
         message: v.message,
@@ -65802,6 +66821,16 @@ async function runErc2(args) {
   } else {
     unverifiedReason = `kernel ERC could not parse the schematic: ${kernelOutcome.message}`;
   }
+  if (flagged.size > 0) {
+    for (const net of [...flagged].sort()) {
+      if (!derived.nets.has(net)) {
+        violations.push({
+          severity: "Warning",
+          message: `Power flag on net '${net}', which does not exist`
+        });
+      }
+    }
+  }
   violations.sort((a, b) => {
     const sev = (a.severity === "Error" ? 0 : 1) - (b.severity === "Error" ? 0 : 1);
     return sev !== 0 ? sev : a.message.localeCompare(b.message);
@@ -66046,7 +67075,7 @@ async function exportKicad(args) {
     if (!name) {
       return ecadError("Project filename must have a basename, e.g. 'board.kicad_pro'.");
     }
-    const sheet = doc.schematic;
+    const sheet = (await docFlatSchematic(doc))?.sheet;
     if (!sheet) {
       return ecadError(
         "A KiCad project bundle needs a schematic; this document has none. Create one with create_schematic, or export the board alone as .kicad_pcb."
@@ -66069,7 +67098,7 @@ async function exportKicad(args) {
   let format;
   if (ext === "kicad_sch") {
     format = "kicad_sch";
-    const sheet = doc.schematic;
+    const sheet = (await docFlatSchematic(doc))?.sheet;
     if (!sheet) {
       return ecadError(
         "Document has no schematic to export. Create one with create_schematic."
@@ -70920,8 +71949,14 @@ async function searchElectronicParts(args) {
   const query = typeof args.query === "string" ? args.query : "";
   const limit = typeof args.limit === "number" ? Math.max(1, Math.round(args.limit)) : 5;
   const results = await searchEcadParts(query, limit);
+  const orderable = searchOrderable(query, limit);
   return {
-    content: [{ type: "text", text: JSON.stringify({ query, count: results.length, results }) }]
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify({ query, count: results.length, results, orderable_count: orderable.length, orderable })
+      }
+    ]
   };
 }
 async function resolvePart2(args) {
@@ -70936,6 +71971,12 @@ async function resolvePart2(args) {
       content: [{ type: "text", text: JSON.stringify({ kind: "jellybean", ...def }) }]
     };
   }
+  const orderable = lookupOrderable(query);
+  if (orderable) {
+    return {
+      content: [{ type: "text", text: JSON.stringify({ kind: "orderable", ...orderable }) }]
+    };
+  }
   return {
     content: [
       {
@@ -70949,8 +71990,20 @@ async function resolvePart2(args) {
 async function findAlternatives2(args) {
   const query = typeof args.query === "string" ? args.query : "";
   const alts = await findAlternatives(query);
+  const part = lookupOrderable(query);
+  const orderable_alternatives = part?.alternatives ?? [];
   return {
-    content: [{ type: "text", text: JSON.stringify({ query, count: alts.length, alternatives: alts }) }]
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify({
+          query,
+          count: alts.length,
+          alternatives: alts,
+          ...part ? { orderable: { id: part.id, mpn: part.mpn, lcsc: part.lcsc }, orderable_alternatives } : {}
+        })
+      }
+    ]
   };
 }
 async function verifySubstitution2(args) {
@@ -71622,11 +72675,12 @@ async function fixDrc(args, toolCtx) {
   };
   return { content: [{ type: "text", text: JSON.stringify(payload) }] };
 }
-var PCB_LAYER_SET, COPPER_LAYERS, COPPER_LAYER_SET, POSITION_TOLERANCE, PIN_SEP, pinKey, createSchematicSchema, docInputProperties, placeComponentsSchema, routeNetsSchema, runDrcSchema, runErcSchema, critiqueRouteSchema, routeDiffPairSchema, lengthMatchTracesSchema, exportGerberSchema, validateForFabSchema, fabPrepSchema, exportKicadSchema, addCoilSchema, boardFromSolidSchema, addCoilArraySchema, windingLayoutSchema, calcImpedanceSchema, sizeImpedanceSchema, sizePdnSchema, calcCoilSchema, sizeCoilSchema, calcRfSchema, COIL_GEOMETRY, MU0, RAIL_PIN_NAMES, PIN_TYPES, CHIP_SIZE_CODES, CONNECTIVITY_GUARD_MAX_NETS, POWER_NET_RE, DRC_CATEGORY, DRC_DELTA_SAMPLE_CAP, DRC_DELTA_FULL_BOARD_MAX, LINT_CRYSTAL_MAX_MM, LINT_DECAP_MAX_MM, LINT_CONNECTOR_EDGE_MAX_MM, LINT_HIGH_CURRENT_SEP_MIN_MM, LINT_GROUND_NET_RE, LINT_SUPPLY_NET_RE, SENSITIVE_NET_RE, HIGH_CURRENT_CLASS_RE, refPrefix, dist2d, round22, sumSq, round33, vec2Schema, setBoardOutlineSchema, FOOTPRINT_FAMILIES, listFootprintsSchema, searchFootprintsSchema, getPadPositionsSchema, getFootprintSchema, ROTATION_CONVENTION, describePcbSchema, DESCRIBE_NET_NAME_CAP, addTraceSchema, addViaSchema, OZ_TO_MM, setStackupSchema, setPlacementSchema, addZoneSchema, deleteElementProps, deleteZoneSchema, deleteTraceSchema, deleteViaSchema, COPPER_KINDS, GET_COPPER_CAP, getCopperSchema, TIE_POSITION_TOL, addNetTieSchema, deleteNetTieSchema, undoSchema, setDesignRulesSchema, sizeTraceForCurrentSchema, addViaArraySchema, MAX_VIA_ARRAY, addMotorWindingSchema, calcMotorSchema, SILICON_STEEL_KNEE_T, sig6, BEARING_FRICTION_MNM, checkSelfStartSchema, solidFromBoardSchema, FR4_DENSITY_KG_M3, COPPER_DENSITY_KG_M3, DEFAULT_COPPER_THICKNESS_MM, loopArea, MOUNTING_FP_RE, KEEPOUT_ECHO_CAP, INLINE_DOC_ECHO_CAP, searchElectronicPartsSchema, resolvePartSchema, findAlternativesSchema, verifySubstitutionSchema, buildReceiptSchema, verifyReceiptSchema, FIX_EPS, FIX_DRC_NEVER, fixDrcSchema, toolDefs23;
+var PCB_LAYER_SET, COPPER_LAYERS, COPPER_LAYER_SET, POSITION_TOLERANCE, PIN_SEP, pinKey, powerFlagsSchema, sheetInstanceSchema, sheetDefinitionSchema, createSchematicSchema, updateSchematicSchema, inspectSchematicSchema, docInputProperties, placeComponentsSchema, routeNetsSchema, runDrcSchema, runErcSchema, critiqueRouteSchema, routeDiffPairSchema, lengthMatchTracesSchema, exportGerberSchema, validateForFabSchema, fabPrepSchema, exportKicadSchema, addCoilSchema, boardFromSolidSchema, addCoilArraySchema, windingLayoutSchema, calcImpedanceSchema, sizeImpedanceSchema, sizePdnSchema, calcCoilSchema, sizeCoilSchema, calcRfSchema, COIL_GEOMETRY, MU0, RAIL_PIN_NAMES, PIN_TYPES, CHIP_SIZE_CODES, CONNECTIVITY_GUARD_MAX_NETS, POWER_NET_RE, DRC_CATEGORY, DRC_DELTA_SAMPLE_CAP, DRC_DELTA_FULL_BOARD_MAX, LINT_CRYSTAL_MAX_MM, LINT_DECAP_MAX_MM, LINT_CONNECTOR_EDGE_MAX_MM, LINT_HIGH_CURRENT_SEP_MIN_MM, LINT_GROUND_NET_RE, LINT_SUPPLY_NET_RE, SENSITIVE_NET_RE, HIGH_CURRENT_CLASS_RE, refPrefix, dist2d, round22, sumSq, round33, vec2Schema, setBoardOutlineSchema, FOOTPRINT_FAMILIES, listFootprintsSchema, searchFootprintsSchema, getPadPositionsSchema, getFootprintSchema, ROTATION_CONVENTION, describePcbSchema, DESCRIBE_NET_NAME_CAP, addTraceSchema, addViaSchema, OZ_TO_MM, setStackupSchema, setPlacementSchema, addZoneSchema, deleteElementProps, deleteZoneSchema, deleteTraceSchema, deleteViaSchema, COPPER_KINDS, GET_COPPER_CAP, getCopperSchema, TIE_POSITION_TOL, addNetTieSchema, deleteNetTieSchema, undoSchema, setDesignRulesSchema, sizeTraceForCurrentSchema, addViaArraySchema, MAX_VIA_ARRAY, addMotorWindingSchema, calcMotorSchema, SILICON_STEEL_KNEE_T, sig6, BEARING_FRICTION_MNM, checkSelfStartSchema, solidFromBoardSchema, FR4_DENSITY_KG_M3, COPPER_DENSITY_KG_M3, DEFAULT_COPPER_THICKNESS_MM, loopArea, MOUNTING_FP_RE, KEEPOUT_ECHO_CAP, INLINE_DOC_ECHO_CAP, searchElectronicPartsSchema, resolvePartSchema, findAlternativesSchema, verifySubstitutionSchema, buildReceiptSchema, verifyReceiptSchema, FIX_EPS, FIX_DRC_NEVER, fixDrcSchema, toolDefs24;
 var init_ecad2 = __esm({
   "src/tools/ecad.ts"() {
     "use strict";
     init_dist2();
+    init_schematic_hierarchy();
     init_receipt_unified();
     init_clearance();
     init_constraint_claims();
@@ -71635,6 +72689,7 @@ var init_ecad2 = __esm({
     init_session2();
     init_kernel_event();
     init_em_claims();
+    init_part_stock();
     init_enclosure();
     init_pcb_validate();
     init_pcb_layers2();
@@ -71648,6 +72703,80 @@ var init_ecad2 = __esm({
     POSITION_TOLERANCE = 0.01;
     PIN_SEP = String.fromCharCode(0);
     pinKey = (ref, pinNumber) => `${ref}${PIN_SEP}${pinNumber}`;
+    powerFlagsSchema = {
+      type: "array",
+      description: "Power flags (KiCad PWR_FLAG): nets declared as DRIVEN although no PowerOutput pin sits on them \u2014 a rail fed through a ferrite, a load-switch FET or a connector. Each is a net name or {net, note}. ERC counts a flagged net as powered; flags are not parts, so they never reach the BOM or board.",
+      items: {
+        anyOf: [
+          { type: "string" },
+          {
+            type: "object",
+            properties: {
+              net: { type: "string" },
+              note: { type: "string" }
+            },
+            required: ["net"]
+          }
+        ]
+      }
+    };
+    sheetInstanceSchema = {
+      type: "object",
+      properties: {
+        name: { type: "string", description: 'Instance name, e.g. "CAN1" (no "/").' },
+        sheet: { type: "string", description: "Sheet definition name." },
+        connections: {
+          type: "object",
+          description: 'Port \u2192 parent-sheet net, e.g. {"TXD": "FDCAN1_TX"}.',
+          additionalProperties: { type: "string" }
+        },
+        ref_offset: {
+          type: "number",
+          description: "Renumber refs (U1 + 100 \u2192 U101). Default: a sheet placed once keeps its refs; a repeated sheet gets <ref>_<instance> (U1_CAN1)."
+        },
+        ref_map: {
+          type: "object",
+          description: 'Explicit local \u2192 flat refs, e.g. {"U1": "U31"}; wins over ref_offset.',
+          additionalProperties: { type: "string" }
+        }
+      },
+      required: ["name", "sheet"]
+    };
+    sheetDefinitionSchema = {
+      type: "object",
+      properties: {
+        name: { type: "string", description: "Sheet definition name." },
+        title: { type: "string" },
+        ports: {
+          type: "array",
+          description: 'Hierarchical ports: names (or {name, direction}) of nets the parent connects, e.g. ["TXD", "RXD"].',
+          items: {
+            anyOf: [
+              { type: "string" },
+              {
+                type: "object",
+                properties: {
+                  name: { type: "string" },
+                  direction: { type: "string", description: "Input, Output, Bidirectional, Passive, PowerInput, PowerOutput" }
+                },
+                required: ["name"]
+              }
+            ]
+          }
+        },
+        components: { type: "array", description: "As create_schematic.components.", items: { type: "object" } },
+        nets: {
+          type: "object",
+          description: "As create_schematic.nets, in this sheet's scope.",
+          additionalProperties: { type: "array", items: { type: "string" } }
+        },
+        labels: { type: "array", items: { type: "object" } },
+        wires: { type: "array", items: { type: "object" } },
+        power_flags: powerFlagsSchema,
+        instances: { type: "array", description: "Nested child sheet instances.", items: { type: "object" } }
+      },
+      required: ["name", "components"]
+    };
     createSchematicSchema = {
       type: "object",
       properties: {
@@ -71757,10 +72886,74 @@ var init_ecad2 = __esm({
             type: "array",
             items: { type: "string" }
           }
+        },
+        power_flags: powerFlagsSchema,
+        sheets: {
+          type: "array",
+          description: "Hierarchical child sheets (definitions). Each is a create_schematic-shaped body (components, nets, labels, wires, power_flags) plus `name`, `ports` and nested `instances`. Inside a sheet a net name is LOCAL to each instance (flattens to `<instance path>/<net>`, e.g. `CAN1/CANH`) unless it is a port (resolved through the instance's `connections`) or global (`global_nets`, or a Global label). The root sheet is this call's own components/nets.",
+          items: sheetDefinitionSchema
+        },
+        instances: {
+          type: "array",
+          description: "Sheet instances placed on the root sheet. Place a sheet several times (CAN \xD76) \u2014 each instance gets its own local nets and reference designators.",
+          items: sheetInstanceSchema
+        },
+        global_nets: {
+          type: "array",
+          description: 'Net names shared by every sheet, e.g. ["GND", "+3V3", "VBAT"].',
+          items: { type: "string" }
         }
       },
       required: ["components"]
     };
+    updateSchematicSchema = {
+      type: "object",
+      properties: {
+        document_id: { type: "string", description: "Session id from create_schematic." },
+        root: {
+          type: "object",
+          description: "Replace the ROOT sheet body (create_schematic-shaped: components, nets, labels, wires, power_flags). The hierarchy is kept."
+        },
+        sheets: {
+          type: "array",
+          description: "Sheet definitions to add, or replace by `name`.",
+          items: sheetDefinitionSchema
+        },
+        remove_sheets: {
+          type: "array",
+          description: "Sheet definition names to delete.",
+          items: { type: "string" }
+        },
+        instances: {
+          type: "array",
+          description: "Root sheet instances to add, or replace by `name`.",
+          items: sheetInstanceSchema
+        },
+        remove_instances: {
+          type: "array",
+          description: "Root sheet instance names to delete.",
+          items: { type: "string" }
+        },
+        global_nets: {
+          type: "array",
+          description: "Replace the global net list.",
+          items: { type: "string" }
+        },
+        power_flags: { ...powerFlagsSchema, description: "Replace the ROOT sheet's power flags." }
+      },
+      required: ["document_id"]
+    };
+    inspectSchematicSchema = {
+      type: "object",
+      properties: {
+        document_id: { type: "string", description: "Session id from create_schematic." },
+        instance: {
+          type: "string",
+          description: 'Limit nets/refs to one sheet instance path (e.g. "CAN1" or "PWR/BUCK2").'
+        }
+      },
+      required: ["document_id"]
+    };
     docInputProperties = {
       document_id: {
         type: "string",
@@ -73233,7 +74426,7 @@ var init_ecad2 = __esm({
       },
       required: ["document_id"]
     };
-    toolDefs23 = [
+    toolDefs24 = [
       {
         name: "create_schematic",
         pack: "ecad",
@@ -73242,6 +74435,22 @@ var init_ecad2 = __esm({
         handler: (a) => createSchematic(a),
         behavior: behavior({ writesDoc: true })
       },
+      {
+        name: "update_schematic",
+        pack: "ecad",
+        description: "Edit a schematic session in place: replace the root sheet body, add / replace / remove hierarchical sheet definitions and root sheet instances, set the global nets, or set power flags. Returns the re-flattened netlist and any hierarchy issues, like create_schematic.",
+        inputSchema: updateSchematicSchema,
+        handler: (a) => updateSchematic(a),
+        behavior: behavior({ writesDoc: true })
+      },
+      {
+        name: "inspect_schematic",
+        pack: "ecad",
+        description: "Inspect a schematic session: sheet tree, per-instance reference maps, the flattened netlist (optionally one instance's), power flags, hierarchy issues, and a BOM grouping of the flattened parts.",
+        inputSchema: inspectSchematicSchema,
+        handler: (a) => inspectSchematic(a),
+        behavior: behavior({})
+      },
       {
         name: "place_components",
         pack: "ecad",
@@ -73895,7 +75104,7 @@ async function solveConstraints(args) {
   }
   return solveAndReport(ctx.doc, ctx.documentId);
 }
-var anchorDescription, addConstraintSchema, deleteConstraintSchema, listConstraintsSchema, solveConstraintsSchema, toolDefs24;
+var anchorDescription, addConstraintSchema, deleteConstraintSchema, listConstraintsSchema, solveConstraintsSchema, toolDefs25;
 var init_design_constraints = __esm({
   "src/tools/design-constraints.ts"() {
     "use strict";
@@ -73940,7 +75149,7 @@ var init_design_constraints = __esm({
       },
       required: ["document_id"]
     };
-    toolDefs24 = [
+    toolDefs25 = [
       {
         name: "add_constraint",
         pack: null,
@@ -74174,7 +75383,7 @@ function recordMeasurement(input) {
   }
   return jsonResult3(report);
 }
-var MEASURABLE_KINDS, MEASURABLE_AXES, MEASURABLE_FEATURES, predictions, reports, predictPrintSchema, recordMeasurementSchema, jsonResult3, toolDefs25;
+var MEASURABLE_KINDS, MEASURABLE_AXES, MEASURABLE_FEATURES, predictions, reports, predictPrintSchema, recordMeasurementSchema, jsonResult3, toolDefs26;
 var init_print_check = __esm({
   "src/tools/print-check.ts"() {
     "use strict";
@@ -74277,7 +75486,7 @@ var init_print_check = __esm({
     jsonResult3 = (value) => ({
       content: [{ type: "text", text: JSON.stringify(value, null, 2) }]
     });
-    toolDefs25 = [
+    toolDefs26 = [
       {
         name: "predict_print",
         pack: "print",
@@ -75148,7 +76357,7 @@ async function renderStackup(args) {
   });
   return withRenderAssets({ content }, assets);
 }
-var renderViewSchema, SVG_SCALE, DEFAULT_WIDTH_PX, MAX_NODES, MAX_PATTERN_INSTANCES, MAX_RENDER_TRIANGLES, MAX_RASTER_SVG_BYTES, MAX_INLINE_SVG_BYTES, renderPcbSchema, PCB_MARGIN_MM, RATSNEST_COLOR, renderRatsnestSchema, renderStackupSchema, toolDefs26;
+var renderViewSchema, SVG_SCALE, DEFAULT_WIDTH_PX, MAX_NODES, MAX_PATTERN_INSTANCES, MAX_RENDER_TRIANGLES, MAX_RASTER_SVG_BYTES, MAX_INLINE_SVG_BYTES, renderPcbSchema, PCB_MARGIN_MM, RATSNEST_COLOR, renderRatsnestSchema, renderStackupSchema, toolDefs27;
 var init_render2 = __esm({
   "src/tools/render.ts"() {
     "use strict";
@@ -75311,7 +76520,7 @@ var init_render2 = __esm({
       },
       required: ["document_id"]
     };
-    toolDefs26 = [
+    toolDefs27 = [
       {
         name: "render_view",
         pack: null,
@@ -75517,7 +76726,7 @@ async function verifyPart(args) {
     rmSync(scratch, { recursive: true, force: true });
   }
 }
-var execFileAsync, verifyPartSchema, listEvalTasksSchema, toolDefs27;
+var execFileAsync, verifyPartSchema, listEvalTasksSchema, toolDefs28;
 var init_verify = __esm({
   "src/tools/verify.ts"() {
     "use strict";
@@ -75548,7 +76757,7 @@ var init_verify = __esm({
         }
       }
     };
-    toolDefs27 = [
+    toolDefs28 = [
       {
         name: "verify_part",
         pack: "eval",
@@ -75608,7 +76817,7 @@ function verifySpec(input, engine) {
     ]
   };
 }
-var pointSpecSchema, verifySpecSchema, toolDefs28;
+var pointSpecSchema, verifySpecSchema, toolDefs29;
 var init_verify_spec = __esm({
   "src/tools/verify-spec.ts"() {
     "use strict";
@@ -75672,7 +76881,7 @@ var init_verify_spec = __esm({
       },
       required: ["document_id", "spec"]
     };
-    toolDefs28 = [
+    toolDefs29 = [
       {
         name: "verify_spec",
         pack: null,
@@ -75814,7 +77023,7 @@ function topologyOptimizeTool(args, engine) {
     ]
   };
 }
-var regionSchema, topologyOptimizeSchema, round5, toolDefs29;
+var regionSchema, topologyOptimizeSchema, round5, toolDefs30;
 var init_topopt = __esm({
   "src/tools/topopt.ts"() {
     "use strict";
@@ -75926,7 +77135,7 @@ var init_topopt = __esm({
       }
     };
     round5 = (v) => Number(v.toPrecision(5));
-    toolDefs29 = [
+    toolDefs30 = [
       {
         name: "topology_optimize",
         pack: null,
@@ -75950,7 +77159,7 @@ function textResult2(payload) {
     ]
   };
 }
-var paramValue, deviceSpecSchema, parametersSchema, simOptionsSchema, simulateChargedParticlesSchema, optimizeElectrodesSchema, toolDefs30;
+var paramValue, deviceSpecSchema, parametersSchema, simOptionsSchema, simulateChargedParticlesSchema, optimizeElectrodesSchema, toolDefs31;
 var init_particle = __esm({
   "src/tools/particle.ts"() {
     "use strict";
@@ -76084,7 +77293,7 @@ var init_particle = __esm({
         }
       }
     };
-    toolDefs30 = [
+    toolDefs31 = [
       {
         name: "simulate_charged_particles",
         pack: null,
@@ -76135,7 +77344,7 @@ function textResult3(payload) {
     ]
   };
 }
-var paramValue2, distSchema, stackupSpecSchema, toolDefs31;
+var paramValue2, distSchema, stackupSpecSchema, toolDefs32;
 var init_tolerance = __esm({
   "src/tools/tolerance.ts"() {
     "use strict";
@@ -76223,7 +77432,7 @@ var init_tolerance = __esm({
         }
       }
     };
-    toolDefs31 = [
+    toolDefs32 = [
       {
         name: "analyze_tolerance_stackup",
         pack: null,
@@ -76283,7 +77492,7 @@ function textResult4(payload) {
     ]
   };
 }
-var paramValue3, paramVec3, shapeSchema, boundarySchema, thermalSpecSchema, transientSchema, toolDefs32;
+var paramValue3, paramVec3, shapeSchema, boundarySchema, thermalSpecSchema, transientSchema, toolDefs33;
 var init_thermal = __esm({
   "src/tools/thermal.ts"() {
     "use strict";
@@ -76450,7 +77659,7 @@ var init_thermal = __esm({
         }
       }
     };
-    toolDefs32 = [
+    toolDefs33 = [
       {
         name: "solve_thermal",
         pack: null,
@@ -76512,7 +77721,7 @@ function textResult5(payload) {
     ]
   };
 }
-var vec32, shapeSchema2, flowSpecSchema, toolDefs33;
+var vec32, shapeSchema2, flowSpecSchema, toolDefs34;
 var init_flow = __esm({
   "src/tools/flow.ts"() {
     "use strict";
@@ -76646,7 +77855,7 @@ var init_flow = __esm({
         }
       }
     };
-    toolDefs33 = [
+    toolDefs34 = [
       {
         name: "simulate_flow",
         pack: null,
@@ -76728,7 +77937,7 @@ function frequencyGrid(ac) {
   }
   return out;
 }
-var deviceSchema, devicesSchema, toolDefs34;
+var deviceSchema, devicesSchema, toolDefs35;
 var init_circuit = __esm({
   "src/tools/circuit.ts"() {
     "use strict";
@@ -76765,7 +77974,7 @@ var init_circuit = __esm({
       items: deviceSchema,
       description: "Netlist as data. Node ids are dense integers with 0 = ground; the device's index in this array is its device id (used by sourceId / freeDevices / outNode references)."
     };
-    toolDefs34 = [
+    toolDefs35 = [
       {
         name: "simulate_circuit",
         pack: null,
@@ -76956,7 +78165,7 @@ function textResult7(payload) {
     ]
   };
 }
-var regionSchema2, toolDefs35;
+var regionSchema2, toolDefs36;
 var init_structure = __esm({
   "src/tools/structure.ts"() {
     "use strict";
@@ -76983,7 +78192,7 @@ var init_structure = __esm({
         }
       }
     };
-    toolDefs35 = [
+    toolDefs36 = [
       {
         name: "analyze_structure",
         pack: null,
@@ -77202,7 +78411,7 @@ function textResult8(payload) {
     ]
   };
 }
-var paramValue4, rectRegion, bcSchema, electroShape, emSpecSchema, toolDefs36;
+var paramValue4, rectRegion, bcSchema, electroShape, emSpecSchema, toolDefs37;
 var init_em = __esm({
   "src/tools/em.ts"() {
     "use strict";
@@ -77358,7 +78567,7 @@ var init_em = __esm({
         }
       }
     };
-    toolDefs36 = [
+    toolDefs37 = [
       {
         name: "simulate_em",
         pack: null,
@@ -77471,7 +78680,7 @@ function textResult9(payload) {
     ]
   };
 }
-var paramValue5, pointSpec, antennaSpecSchema, toolDefs37;
+var paramValue5, pointSpec, antennaSpecSchema, toolDefs38;
 var init_antenna = __esm({
   "src/tools/antenna.ts"() {
     "use strict";
@@ -77520,7 +78729,7 @@ var init_antenna = __esm({
         feed_mm: pointSpec
       }
     };
-    toolDefs37 = [
+    toolDefs38 = [
       {
         name: "analyze_antenna",
         pack: null,
@@ -77597,7 +78806,7 @@ function textResult10(payload) {
     ]
   };
 }
-var photonicsSpecSchema, toolDefs38;
+var photonicsSpecSchema, toolDefs39;
 var init_photonics = __esm({
   "src/tools/photonics.ts"() {
     "use strict";
@@ -77683,7 +78892,7 @@ var init_photonics = __esm({
         }
       }
     };
-    toolDefs38 = [
+    toolDefs39 = [
       {
         name: "simulate_photonics",
         pack: null,
@@ -77749,7 +78958,7 @@ function textResult11(payload) {
     ]
   };
 }
-var paramValue6, shieldSpecSchema, toolDefs39;
+var paramValue6, shieldSpecSchema, toolDefs40;
 var init_neutronics = __esm({
   "src/tools/neutronics.ts"() {
     "use strict";
@@ -77820,7 +79029,7 @@ var init_neutronics = __esm({
         }
       }
     };
-    toolDefs39 = [
+    toolDefs40 = [
       {
         name: "simulate_neutron_shield",
         pack: null,
@@ -77862,7 +79071,7 @@ function textResult12(payload) {
     ]
   };
 }
-var simSpecSchema, toolDefs40;
+var simSpecSchema, toolDefs41;
 var init_qcd = __esm({
   "src/tools/qcd.ts"() {
     "use strict";
@@ -77952,7 +79161,7 @@ var init_qcd = __esm({
         }
       }
     };
-    toolDefs40 = [
+    toolDefs41 = [
       {
         name: "simulate_lattice_gauge",
         pack: null,
@@ -78094,7 +79303,7 @@ function predictPhysicsTool(args, engine) {
     ]
   };
 }
-var PHYSICS_DOMAIN, ORACLE, TIER_RESOLUTION, regionSchema3, predictPhysicsSchema, round52, toolDefs41;
+var PHYSICS_DOMAIN, ORACLE, TIER_RESOLUTION, regionSchema3, predictPhysicsSchema, round52, toolDefs42;
 var init_physics2 = __esm({
   "src/tools/physics.ts"() {
     "use strict";
@@ -78207,7 +79416,7 @@ var init_physics2 = __esm({
       }
     };
     round52 = (v) => Number(v.toPrecision(5));
-    toolDefs41 = [
+    toolDefs42 = [
       {
         name: "predict_physics",
         pack: null,
@@ -78451,7 +79660,7 @@ function applySetParam(doc, node, path, value) {
   }
   cursor[parts[parts.length - 1]] = value;
 }
-var lastReports, mechanicalProcessEnum, pcbProcessEnum, processEnum, rulesetEnum, dfmCheckSchema, dfmExplainSchema, dfmSuggestFixSchema, dfmApplyFixSchema, toolDefs42;
+var lastReports, mechanicalProcessEnum, pcbProcessEnum, processEnum, rulesetEnum, dfmCheckSchema, dfmExplainSchema, dfmSuggestFixSchema, dfmApplyFixSchema, toolDefs43;
 var init_dfm2 = __esm({
   "src/tools/dfm.ts"() {
     "use strict";
@@ -78554,7 +79763,7 @@ var init_dfm2 = __esm({
       },
       required: ["issue_id"]
     };
-    toolDefs42 = [
+    toolDefs43 = [
       {
         name: "dfm_check",
         pack: "dfm",
@@ -79053,7 +80262,7 @@ function sheetMetalCost(input, engine) {
     summary: `${result.breakdown.currency} ${result.breakdown.total_each.toFixed(2)} each @ qty ${result.breakdown.quantity} (mass ${result.breakdown.mass_kg_each.toFixed(3)} kg, ${result.breakdown.cut_length_m.toFixed(2)} m cut, ${result.breakdown.bends} bend(s)).`
   });
 }
-var sheetMetalCreateSchema, sheetMetalUnfoldSchema, sheetMetalMaterialsSchema, sheetMetalBendTableSchema, sheetMetalCheckSchema, sheetMetalNestSchema, sheetMetalSequenceSchema, sheetMetalSuggestFixSchema, sheetMetalCostSchema, toolDefs43;
+var sheetMetalCreateSchema, sheetMetalUnfoldSchema, sheetMetalMaterialsSchema, sheetMetalBendTableSchema, sheetMetalCheckSchema, sheetMetalNestSchema, sheetMetalSequenceSchema, sheetMetalSuggestFixSchema, sheetMetalCostSchema, toolDefs44;
 var init_sheet_metal2 = __esm({
   "src/tools/sheet-metal.ts"() {
     "use strict";
@@ -79314,7 +80523,7 @@ var init_sheet_metal2 = __esm({
       },
       required: ["document_id"]
     };
-    toolDefs43 = [
+    toolDefs44 = [
       {
         name: "sheet_metal_create",
         pack: "sheet_metal",
@@ -79554,7 +80763,7 @@ function flatPatternFromSolid(input, engine) {
     ]
   };
 }
-var flatPatternFromSolidSchema, toolDefs44;
+var flatPatternFromSolidSchema, toolDefs45;
 var init_flat_pattern = __esm({
   "src/tools/flat-pattern.ts"() {
     "use strict";
@@ -79594,7 +80803,7 @@ var init_flat_pattern = __esm({
       },
       required: ["document_id"]
     };
-    toolDefs44 = [
+    toolDefs45 = [
       {
         name: "flat_pattern_from_solid",
         pack: "sheet_metal",
@@ -79775,7 +80984,7 @@ function simulateStrike(input, engine) {
   }
   return { content: [{ type: "text", text: JSON.stringify(payload, null, 2) }] };
 }
-var cents, MATERIAL_ALIASES, simulateStrikeSchema, round23, round4, toolDefs45;
+var cents, MATERIAL_ALIASES, simulateStrikeSchema, round23, round4, toolDefs46;
 var init_acoustics = __esm({
   "src/tools/acoustics.ts"() {
     "use strict";
@@ -79849,7 +81058,7 @@ var init_acoustics = __esm({
     };
     round23 = (x) => Math.round(x * 100) / 100;
     round4 = (x) => Math.round(x * 1e4) / 1e4;
-    toolDefs45 = [
+    toolDefs46 = [
       {
         name: "simulate_strike",
         pack: "sheet_metal",
@@ -80129,7 +81338,7 @@ function importStep(input, engine) {
     ]
   };
 }
-var MAX_STEP_BYTES, STEP_CACHE_DIR, importStepSchema, toolDefs46;
+var MAX_STEP_BYTES, STEP_CACHE_DIR, importStepSchema, toolDefs47;
 var init_import = __esm({
   "src/tools/import.ts"() {
     "use strict";
@@ -80166,7 +81375,7 @@ var init_import = __esm({
         }
       }
     };
-    toolDefs46 = [
+    toolDefs47 = [
       {
         name: "import_step",
         pack: null,
@@ -80456,7 +81665,7 @@ async function importEagle(input) {
     ]
   };
 }
-var MAX_PCB_BYTES, importKicadSchema, importAltiumSchema, importAltiumLibrarySchema, importEagleSchema, toolDefs47;
+var MAX_PCB_BYTES, importKicadSchema, importAltiumSchema, importAltiumLibrarySchema, importEagleSchema, toolDefs48;
 var init_import_pcb = __esm({
   "src/tools/import-pcb.ts"() {
     "use strict";
@@ -80531,7 +81740,7 @@ var init_import_pcb = __esm({
         }
       }
     };
-    toolDefs47 = [
+    toolDefs48 = [
       {
         name: "import_kicad",
         pack: "ecad",
@@ -80644,7 +81853,7 @@ Compressed URL param: ${encoded.length} bytes`
     ]
   };
 }
-var openInBrowserSchema, toolDefs48;
+var openInBrowserSchema, toolDefs49;
 var init_share = __esm({
   "src/tools/share.ts"() {
     "use strict";
@@ -80668,7 +81877,7 @@ var init_share = __esm({
         }
       }
     };
-    toolDefs48 = [
+    toolDefs49 = [
       {
         name: "open_in_browser",
         pack: null,
@@ -81152,7 +82361,7 @@ function batchReset(input) {
     };
   }
 }
-var simulations, MAX_TRAJECTORY, envRecords, batchGroups, INLINE_DOC_DESC, GROUND_SCHEMA_PROPS, SESSION_DOC_DESC, createRobotEnvSchema, gymStepSchema, gymResetSchema, gymObserveSchema, gymCloseSchema, batchCreateEnvsSchema, batchStepSchema, batchResetSchema, toolDefs49;
+var simulations, MAX_TRAJECTORY, envRecords, batchGroups, INLINE_DOC_DESC, GROUND_SCHEMA_PROPS, SESSION_DOC_DESC, createRobotEnvSchema, gymStepSchema, gymResetSchema, gymObserveSchema, gymCloseSchema, batchCreateEnvsSchema, batchStepSchema, batchResetSchema, toolDefs50;
 var init_gym = __esm({
   "src/tools/gym.ts"() {
     "use strict";
@@ -81354,7 +82563,7 @@ var init_gym = __esm({
       },
       required: ["batch_id"]
     };
-    toolDefs49 = [
+    toolDefs50 = [
       {
         name: "create_robot_env",
         pack: "physics",
@@ -81723,7 +82932,7 @@ async function renderMolecule(input) {
     return fail(err9);
   }
 }
-var loadStructureSchema, inspectMoleculeSchema, configSchema, minimizeEnergySchema, mdRunSchema, designMaterialSchema, homogenizeMaterialSchema, renderMoleculeSchema, CPK, DEFAULT_RADIUS, toolDefs50;
+var loadStructureSchema, inspectMoleculeSchema, configSchema, minimizeEnergySchema, mdRunSchema, designMaterialSchema, homogenizeMaterialSchema, renderMoleculeSchema, CPK, DEFAULT_RADIUS, toolDefs51;
 var init_atoms2 = __esm({
   "src/tools/atoms.ts"() {
     "use strict";
@@ -81858,7 +83067,7 @@ var init_atoms2 = __esm({
       S: 1.05,
       P: 1.07
     };
-    toolDefs50 = [
+    toolDefs51 = [
       {
         name: "load_structure",
         pack: "atoms",
@@ -83066,7 +84275,7 @@ function errorResult(text) {
     isError: true
   };
 }
-var recordSimulationSchema, SVG_SCALE2, MAX_STEPS, MIN_STEPS, DEFAULT_WIDTH_PX2, MIN_WIDTH_PX, MAX_WIDTH_PX, DEFAULT_FPS, MIN_FPS, MAX_FPS, toolDefs51;
+var recordSimulationSchema, SVG_SCALE2, MAX_STEPS, MIN_STEPS, DEFAULT_WIDTH_PX2, MIN_WIDTH_PX, MAX_WIDTH_PX, DEFAULT_FPS, MIN_FPS, MAX_FPS, toolDefs52;
 var init_record2 = __esm({
   "src/tools/record.ts"() {
     "use strict";
@@ -83130,7 +84339,7 @@ var init_record2 = __esm({
     DEFAULT_FPS = 30;
     MIN_FPS = 1;
     MAX_FPS = 60;
-    toolDefs51 = [
+    toolDefs52 = [
       {
         name: "record_simulation",
         pack: "physics",
@@ -83223,7 +84432,7 @@ ${text}`
     ]
   };
 }
-var getChangelogSchema, toolDefs52;
+var getChangelogSchema, toolDefs53;
 var init_changelog2 = __esm({
   "src/tools/changelog.ts"() {
     "use strict";
@@ -83263,7 +84472,7 @@ var init_changelog2 = __esm({
         }
       }
     };
-    toolDefs52 = [
+    toolDefs53 = [
       {
         name: "get_changelog",
         pack: null,
@@ -83412,7 +84621,7 @@ function getSimVersion(input) {
     ]
   };
 }
-var getSimReplaySchema, getSimVersionSchema, toolDefs53;
+var getSimReplaySchema, getSimVersionSchema, toolDefs54;
 var init_sim_replay = __esm({
   "src/tools/sim-replay.ts"() {
     "use strict";
@@ -83440,7 +84649,7 @@ var init_sim_replay = __esm({
       },
       required: ["env_id"]
     };
-    toolDefs53 = [
+    toolDefs54 = [
       {
         name: "get_sim_replay",
         pack: null,
@@ -83559,7 +84768,7 @@ async function getOrderFeed(input, store, user) {
     version: version2
   });
 }
-var toUsd4, getOrderFeedSchema, toolDefs54;
+var toUsd4, getOrderFeedSchema, toolDefs55;
 var init_order_feed = __esm({
   "src/tools/order-feed.ts"() {
     "use strict";
@@ -83578,7 +84787,7 @@ var init_order_feed = __esm({
       },
       required: ["document_id"]
     };
-    toolDefs54 = [
+    toolDefs55 = [
       {
         name: "get_order_feed",
         pack: "fabricate",
@@ -84484,7 +85693,7 @@ ${issues.map((i) => i.problem).join("\n")}`
     note: "Rollout compiled to the document timeline. Preview with render_sequence, ship with export_video."
   });
 }
-var MAX_FRAMES, MAX_GEO_SAMPLES, MAX_VERIFY_FRAMES, INLINE_GLB_MAX_BASE64, DEFAULT_WIDTH_PX3, MIN_WIDTH_PX2, MAX_WIDTH_PX2, SVG_SCALE3, KEYFRAMES_DESCRIPTION, animateSchema, renderSequenceSchema, CAMERA_NODE, exportVideoSchema, ffmpegAvailable, timelineFromSimulationSchema, toolDefs55;
+var MAX_FRAMES, MAX_GEO_SAMPLES, MAX_VERIFY_FRAMES, INLINE_GLB_MAX_BASE64, DEFAULT_WIDTH_PX3, MIN_WIDTH_PX2, MAX_WIDTH_PX2, SVG_SCALE3, KEYFRAMES_DESCRIPTION, animateSchema, renderSequenceSchema, CAMERA_NODE, exportVideoSchema, ffmpegAvailable, timelineFromSimulationSchema, toolDefs56;
 var init_animate = __esm({
   "src/tools/animate.ts"() {
     "use strict";
@@ -84636,7 +85845,7 @@ var init_animate = __esm({
       },
       required: ["env_id", "document_id"]
     };
-    toolDefs55 = [
+    toolDefs56 = [
       {
         name: "animate",
         pack: null,
@@ -84699,7 +85908,7 @@ function buildInstructions(kernelPrompt) {
     "- Ship with `export_cad` (STL/GLB/STEP) or `open_in_browser` (vcad.io deep link).",
     "- Fix in place: when geometry is wrong, prefer `update` on the offending node over deleting parts and starting over.",
     "- Cut sheet parts you already modelled: `flat_pattern_from_solid` turns any constant-thickness solid \u2014 extruded sketch, boolean, imported STEP \u2014 into a fab-ready DXF plus a bend table, no sheet-metal re-authoring. Called without `part_id` it does the whole document and groups identical parts into one pattern \xD7 quantity; hand its `nest_input` to `sheet_metal_nest`, then `sheet_metal_cost`, for a quote. It fails closed: the emitted profile re-extruded by the detected thickness must reproduce the solid's volume.",
-    "- Deliver the project bill of materials with `bom_create` \u2192 `bom_export` (markdown/CSV/JSON with landed-cost totals): link quote_manufacturing quotes on manufactured lines, and source COTS hardware (bearings, shafts, standoffs, screws, ferrite magnets) with `search_mechanical_parts`. All BOM prices are estimates and flagged as such.",
+    "- Deliver the project bill of materials with `bom_create` \u2192 `bom_export` (markdown/CSV/JSON with landed-cost totals): link quote_manufacturing quotes on manufactured lines, and source COTS hardware (bearings, shafts, standoffs, screws, ferrite magnets) with `search_mechanical_parts`. Check electronic lines against live LCSC/JLCPCB stock and price with `bom_check_stock` (or one part with `check_part_stock`). All BOM prices are estimates and flagged as such.",
     "",
     "",
     "Sessions and server restarts: a `document_id` is a handle to server-side state, NOT storage. If ANY preview goes dark, a widget stops updating, or a call fails with an unknown `document_id`, check `server_info` FIRST \u2014 a low `uptime_s` or a changed `instance_id` means the SERVER RESTARTED and the feature is fine. That is the fastest way to tell a restart from a bug, and it should be the first check for any preview-shaped complaint. On a restart every live document_id dies at once, so previously-working widgets all go dark together \u2014 that is not a renderer bug. When `server_info` reports `durable:false`, sessions are in-memory only and cannot be recovered: keep the authoring source (your `create_cad_loon` call or record of edits) so a document can be rebuilt, and snapshot long-lived work with `checkpoint_document` / `save_document`. Every tool result also carries `_meta['io.vcad/build']` with `boot_token` + `instance_id`, so a changed value flags a restart without polling.",
@@ -85547,6 +86756,7 @@ var init_server3 = __esm({
     init_ordering();
     init_bom();
     init_mech_parts();
+    init_part_stock();
     init_live_share();
     init_parts2();
     init_preview();
@@ -85595,8 +86805,8 @@ var init_server3 = __esm({
     init_order_feed();
     init_animate();
     PKG_VERSION = (() => {
-      if ("0.10.0-main.98") {
-        return "0.10.0-main.98";
+      if ("0.10.0-main.99") {
+        return "0.10.0-main.99";
       }
       try {
         const req = createRequire2(import.meta.url);
@@ -85605,8 +86815,8 @@ var init_server3 = __esm({
         return "0.0.0";
       }
     })();
-    BUILD_SHA = "a9b6b278d2e31337b686b38b7d9da0f874635906";
-    BUILD_TIME = "2026-10-20T00:42:15.256Z";
+    BUILD_SHA = "760ec5bebb4b0432d2d732e2f43fd190f8e7c268";
+    BUILD_TIME = "2026-10-20T13:47:22.068Z";
     SHORT_SHA = BUILD_SHA === "unknown" ? "unknown" : BUILD_SHA.slice(0, 7);
     VERSION_WITH_BUILD = SHORT_SHA === "unknown" ? PKG_VERSION : `${PKG_VERSION}+${SHORT_SHA}`;
     INSTANCE_ID = randomUUID7().slice(0, 8);
@@ -85639,25 +86849,25 @@ var init_server3 = __esm({
       ...toolDefs10,
       ...toolDefs11,
       ...toolDefs13,
-      ...toolDefs15,
-      ...toolDefs14,
       ...toolDefs16,
+      ...toolDefs14,
+      ...toolDefs15,
       ...toolDefs17,
+      ...toolDefs18,
       ...toolDefs5,
       ...toolDefs3,
-      ...toolDefs18,
+      ...toolDefs19,
       ...toolDefs6,
       ...toolDefs7,
-      ...toolDefs19,
       ...toolDefs20,
       ...toolDefs21,
-      ...toolDefs24,
+      ...toolDefs22,
       ...toolDefs25,
       ...toolDefs26,
       ...toolDefs27,
       ...toolDefs28,
-      ...toolDefs12,
       ...toolDefs29,
+      ...toolDefs12,
       ...toolDefs30,
       ...toolDefs31,
       ...toolDefs32,
@@ -85670,24 +86880,25 @@ var init_server3 = __esm({
       ...toolDefs39,
       ...toolDefs40,
       ...toolDefs41,
-      ...toolDefs,
       ...toolDefs42,
+      ...toolDefs,
       ...toolDefs43,
       ...toolDefs44,
       ...toolDefs45,
       ...toolDefs46,
-      ...toolDefs2,
       ...toolDefs47,
+      ...toolDefs2,
       ...toolDefs48,
       ...toolDefs49,
       ...toolDefs50,
       ...toolDefs51,
       ...toolDefs52,
-      ...toolDefs23,
-      ...toolDefs22,
       ...toolDefs53,
+      ...toolDefs24,
+      ...toolDefs23,
       ...toolDefs54,
-      ...toolDefs55
+      ...toolDefs55,
+      ...toolDefs56
     ];
     LIST_TOOL_ORDER = [
       // ── Session lifecycle ──────────────────────────────────────
@@ -85714,6 +86925,8 @@ var init_server3 = __esm({
       "bom_add_line",
       "bom_export",
       "search_mechanical_parts",
+      "check_part_stock",
+      "bom_check_stock",
       // ── Live review window ─────────────────────────────────────
       "share_session",
       "unshare_session",
@@ -85829,6 +87042,8 @@ var init_server3 = __esm({
       "get_changelog",
       // ── ECAD (PCB) ─────────────────────────────────────────────
       "create_schematic",
+      "update_schematic",
+      "inspect_schematic",
       "place_components",
       "route_nets",
       "add_coil",