dsh-eda-mcp 0.7.1 → 0.7.2

package/lib/bridge.mjs

@@ -293,11 +293,50 @@ var BOARD_OUTLINE_WIDTH_MIL = 10;
 var SILKSCREEN_HEIGHT_MIN_MM = 1;
 var SILKSCREEN_WIDTH_MIN_MM = 0.15;
 
+// src/bridge/workflow-guide.ts
+var WORKFLOW_SUMMARY = [
+  "\u539F\u7406\u56FE\u5DE5\u4F5C\u89C4\u8303\uFF08\u9ED8\u8BA4\u5168\u90E8\u624B\u5DE5\uFF0C\u7981\u6B62\u56FE\u7701\u4E8B\u7528\u81EA\u52A8\u5E03\u5C40/\u81EA\u52A8\u5E03\u7EBF\uFF09\uFF1A",
+  "1) \u5E03\u5C40\uFF1A\u6309 10 \u5355\u4F4D\u6805\u683C\u5BF9\u9F50\uFF1B\u4FE1\u53F7\u4ECE\u5DE6\u5230\u53F3\u3001\u7535\u6E90\u5728\u4E0A\u3001\u5730\u5728\u4E0B\uFF1B\u540C\u7EA7\u5668\u4EF6\u7B49\u95F4\u8DDD\uFF1B\u4E0D\u538B\u5B57\u3001\u4E0D\u538B\u6807\u9898\u680F\uFF1B\u5148\u770B eda_get_page_info \u7684\u5B89\u5168\u533A\u518D\u6446\u4F4D\u3002",
+  "2) \u8FDE\u7EBF\uFF1A\u53EA\u7528 eda_draw_wire \u8D70\u76F4\u7EBF/45 \u5EA6\uFF1B**\u8DE8\u533A\u57DF\u540C\u540D\u7F51\u7EDC\u5FC5\u987B\u7528\u7F51\u7EDC\u7AEF\u53E3\uFF08eda_place_net_port\uFF09\u6216\u7F51\u7EDC\u6807\u7B7E**\uFF0C\u4E0D\u80FD\u9760\u5728\u4E24\u5904\u753B\u4E00\u6761\u53EB\u540C\u540D\u7684\u5BFC\u7EBF\u2014\u2014\u5BFC\u7EBF\u4E00\u65E6\u63A5\u89E6\u5F15\u811A\uFF0Cnet \u4F1A\u88AB\u8FDE\u901A\u6027\u91CD\u7B97\uFF0C\u6307\u5B9A\u540D\u4F1A\u88AB\u8986\u76D6\u3002",
+  "3) \u7F51\u7EDC\u6807\u7B7E\uFF1A\u5148\u8BD5 eda_place_net_label\uFF1B\u82E5\u8BE5\u6784\u5EFA\u7684 createNetLabel \u4E0D\u54CD\u5E94\uFF0C\u4F1A\u81EA\u52A8\u964D\u7EA7\u4E3A\u7EAF\u6587\u672C\u6807\u7B7E\uFF08\u65E0\u7535\u6C14\u8BED\u4E49\uFF09\uFF0C\u6B64\u65F6\u9760 stub \u5BFC\u7EBF\u627F\u8F7D\u7F51\u7EDC\uFF1B\u6279\u91CF\u7528 eda_place_net_labels \u4E00\u6B21\u8C03\u7528\uFF0C\u4E0D\u8981\u4E32\u884C\u4E0A\u767E\u6B21\u3002",
+  "4) \u6821\u9A8C\uFF1Aeda_export_netlist \u770B\u6BCF\u4E2A\u7F51\u7EDC\u7684\u7AEF\u70B9\u662F\u5426 \u22652\uFF1Beda_run_drc \u770B\u9010\u6761 DRC \u660E\u7EC6\uFF1B\u89C6\u89C9\u68C0\u67E5\u4F18\u5148\u5BFC\u51FA PNG \u81EA\u884C\u8BC6\u522B\uFF0C\u800C\u4E0D\u662F\u8BA9 EDA \u91CD\u6392\u3002",
+  "5) \u53EA\u6709\u7528\u6237\u660E\u786E\u8981\u6C42\u65F6\u624D eda_auto_layout / eda_auto_route\uFF08\u9700 force:true \u4E14\u8BBE\u7F6E\u91CC\u653E\u884C\uFF09\u3002",
+  "6) \u5F15\u811A\u4FE1\u606F\u7528 eda_get_pins \u4E00\u6B21\u62FF\u5168\uFF08\u542B pinName/pinNumber\uFF09\uFF0C\u4E0D\u8981\u9010\u811A\u8C03 raw API\u3002"
+].join("\n");
+var WORKFLOW_GUIDE = WORKFLOW_SUMMARY + "\n\n" + [
+  "## \u5E03\u5C40\u7EC6\u5219\u662F\u600E\u4E48\u843D\u5730\u7684",
+  "",
+  "- \u5750\u6807\u5355\u4F4D\u662F 0.01 \u82F1\u5BF8\uFF08MCP \u5355\u4F4D\uFF09\uFF1BA4 \u56FE\u6846 0..1170 / 0..825\uFF0C\u6807\u9898\u680F\u5360 right 460..1160 / bottom 10..190\uFF0C\u5B89\u5168\u533A\u89C1 eda_get_page_info\u3002",
+  "- \u4E00\u9875\u53EA\u653E\u4E00\u4E2A\u529F\u80FD\u5757\uFF1B\u5668\u4EF6\u6309\u4FE1\u53F7\u6D41\u4ECE\u5DE6\u5230\u53F3\u6392\uFF0C\u53CD\u9988\u5143\u4EF6\u653E\u5728\u653E\u5927\u5668\u4E0B\u65B9\uFF0C\u53BB\u8026\u7535\u5BB9\u8D34\u8FD1\u7535\u6E90\u811A\u3002",
+  "- \u5668\u4EF6\u4E4B\u95F4\u7559\u51FA\u81F3\u5C11 20 \u5355\u4F4D\u7528\u4E8E\u8D70\u7EBF\u548C\u6807\u7B7E\uFF1B\u7F51\u7EDC\u7AEF\u53E3\u653E\u5728\u6A21\u5757\u8FB9\u7F18\uFF0C\u5DE6\u53F3\u5404\u4E00\u5217\u3002",
+  "- \u6446\u597D\u4E00\u4E2A\u6A21\u5757\u518D\u6446\u4E0B\u4E00\u4E2A\uFF1B\u6BCF\u6B21\u6446\u5B8C\u7528 eda_get_components \u68C0\u67E5\u6CA1\u6709\u91CD\u53E0\uFF08\u5305\u56F4\u76D2\u76F8\u4EA4\uFF09\u3002",
+  "",
+  "## \u7F51\u7EDC\u4E0E\u6807\u7B7E",
+  "",
+  "- eda_place_net_port \u4EA7\u751F\u771F\u6B63\u7684\u7F51\u7EDC\u7AEF\u53E3\u56FE\u5143\uFF0C\u662F\u8DE8\u533A\u57DF\u8FDE\u63A5\u7684\u9996\u9009\u3002",
+  "- eda_place_net_label \u4F18\u5148\u8C03 sch_PrimitiveAttribute.createNetLabel\uFF1B\u8BE5 API \u5728 3.2.186 \u4E0A\u4E0D\u54CD\u5E94\uFF0C\u63A2\u6D4B\u7ED3\u8BBA\u6309\u4F1A\u8BDD\u7F13\u5B58\uFF0C\u4E4B\u540E\u76F4\u63A5\u964D\u7EA7\u4E3A\u6587\u672C\u6807\u7B7E\uFF08\u4E0D\u518D\u6BCF\u6B21\u4ED8 4 \u79D2\u8D85\u65F6\uFF09\u3002",
+  "- \u964D\u7EA7\u540E\u7684\u6587\u672C\u6807\u7B7E\u6CA1\u6709\u7535\u6C14\u8BED\u4E49\uFF1A\u8FDE\u901A\u6027\u7531 eda_place_net_label_at_pin \u540C\u65F6\u753B\u7684 stub \u5BFC\u7EBF\u627F\u62C5\u3002",
+  "- eda_get_net_labels \u4F1A\u540C\u65F6\u5217\u51FA\u5C5E\u6027\u56FE\u5143\uFF08netlabel/netport/netflag\uFF09\u548C\u6587\u672C\u6807\u7B7E\uFF0C\u5220\u9664\u7528 eda_delete_primitive \u7684\u5BF9\u5E94 kind\u3002",
+  "- \u6279\u91CF\u653E\u7F6E\u7528 eda_place_net_labels([{pinPrimitiveId, net}, ...])\uFF0C\u4E00\u6B21\u8C03\u7528\u5B8C\u6210\u5E76\u9010\u6761\u56DE\u62A5\u6210\u8D25\u3002",
+  "",
+  "## \u5BFC\u7EBF net \u88AB\u8986\u76D6\uFF08\u52A1\u5FC5\u77E5\u9053\uFF09",
+  "",
+  "eda_draw_wire \u4F20\u7684 net \u53EA\u5BF9**\u60AC\u7A7A\u5BFC\u7EBF**\u6709\u6548\uFF1B\u5BFC\u7EBF\u7AEF\u70B9\u4E00\u65E6\u843D\u5728\u5F15\u811A/\u7F51\u7EDC\u4E0A\uFF0CEDA \u4F1A\u6309\u8FDE\u901A\u6027\u91CD\u7B97\u7F51\u7EDC\u540D\uFF08\u5B9E\u6D4B TESTNET \u5E76\u5165\u4E86 LED_A\uFF09\u3002\u6240\u4EE5\u201C\u540C\u540D\u5BFC\u7EBF = \u540C\u540D\u7F51\u7EDC\u201D\u4E0D\u6210\u7ACB\uFF0C\u8DE8\u533A\u57DF\u540C\u540D\u5FC5\u987B\u7528\u7F51\u7EDC\u6807\u7B7E\u6216\u7F51\u7EDC\u7AEF\u53E3\u3002",
+  "",
+  "## \u6821\u9A8C\u987A\u5E8F",
+  "",
+  "1. eda_get_active_document \u786E\u8BA4\u5728\u539F\u7406\u56FE\u9875\uFF08\u4E0D\u662F HOME/PCB\uFF09\u3002",
+  "2. eda_export_netlist\uFF08\u5DF2\u89E3\u6790\u6210\u5BF9\u8C61\uFF09\u68C0\u67E5\u6BCF\u4E2A\u7F51\u7EDC \u22652 \u7AEF\u70B9\u3001\u65E0\u60AC\u7A7A\u3002",
+  "3. eda_run_drc \u770B\u9010\u6761\u660E\u7EC6\uFF08\u542B primitiveId \u4E0E\u5750\u6807\uFF09\u3002",
+  "4. \u9700\u8981\u4EBA\u770B\u6548\u679C\u5C31\u5BFC\u51FA\u56FE\u7247\u81EA\u884C\u8BC6\u522B\uFF0C\u4E0D\u8981\u7528\u81EA\u52A8\u5E03\u5C40\u201C\u4FEE\u201D\u7248\u9762\u3002"
+].join("\n");
+
 // src/bridge/index.ts
 var VERSION = "0.4.0";
 var WS_PORT = Number(process.env.DSH_EDA_MCP_WS_PORT ?? 39009);
 var WS_HOST = "127.0.0.1";
 var ALLOW_RAW_API = (process.env.DSH_EDA_MCP_ALLOW_RAW_API ?? "1") !== "0";
+var ALLOW_AUTO_LAYOUT = (process.env.DSH_EDA_ALLOW_AUTO_LAYOUT ?? "0") === "1";
 var TOOL_TIMEOUT_MS = Number(process.env.DSH_EDA_MCP_TOOL_TIMEOUT_MS ?? 6e4);
 var MCP_UNITS_PER_INCH = 100;
 var PAPER_SIZES = {
@@ -321,6 +360,13 @@ function safeAreas(paperName) {
     lowerLeft: { left: 40, bottom: 40, right: paper.titleBlock.left - 20, top: paper.titleBlock.top - 10 }
   };
 }
+function decodeTextPayload(value) {
+  const text = typeof value === "string" ? value : "";
+  if (text === "") return text;
+  const looksUtf16 = text.charCodeAt(0) === 65279 || text.length > 3 && text.charCodeAt(1) === 0 && text.charCodeAt(3) === 0;
+  if (!looksUtf16) return text;
+  return Buffer.from(text, "latin1").toString("utf16le").replace(String.fromCharCode(65279), "");
+}
 function checkPointInFrame(x, y, paperName, margin = 0) {
   const paper = paperOf(paperName);
   const f = paper.frame;
@@ -539,11 +585,11 @@ var TOOLS = [
   }, ["libraryUuid", "uuid", "x", "y"]) },
   { name: "eda_place_net_flag", description: "Place a power/ground net flag (VCC/GND etc.) on the active schematic page.", inputSchema: objectSchema({ identification: { type: "string", enum: ["Power", "Ground", "AnalogGround", "ProtectGround"] }, net: { type: "string" }, x: { type: "number" }, y: { type: "number" }, rotation: { type: "integer", enum: [0, 90, 180, 270] }, mirror: { type: "boolean" }, paper: { type: "string" }, allowOutsideFrame: { type: "boolean" } }, ["identification", "net", "x", "y"]) },
   { name: "eda_place_net_port", description: "Place a net port on the active schematic page.", inputSchema: objectSchema({ direction: { type: "string", enum: ["IN", "OUT", "BI"] }, net: { type: "string" }, x: { type: "number" }, y: { type: "number" }, rotation: { type: "integer", enum: [0, 90, 180, 270] }, mirror: { type: "boolean" }, paper: { type: "string" }, allowOutsideFrame: { type: "boolean" } }, ["direction", "net", "x", "y"]) },
-  { name: "eda_get_pins", description: "List pins of one schematic component. Use the returned primitiveId with eda_place_net_flag_at_pin, eda_place_net_label_at_pin, or eda_set_no_connect.", inputSchema: objectSchema({ componentPrimitiveId: { type: "string" } }, ["componentPrimitiveId"]) },
+  { name: "eda_get_pins", description: "List pins of one schematic component in a single round trip, including pinName and pinNumber (no per-pin sch_PrimitivePin.get needed). Use the returned primitiveId with eda_place_net_flag_at_pin, eda_place_net_label_at_pin, or eda_set_no_connect.", inputSchema: objectSchema({ componentPrimitiveId: { type: "string" } }, ["componentPrimitiveId"]) },
   { name: "eda_place_net_flag_at_pin", description: "Place a power/ground net flag at a pin WITHOUT covering the symbol: the pin direction is read from the pin rotation, a stub wire of stubLength MCP units (default 20) is drawn outwards from the pin with the net name, and the flag is placed at its end. Pass offsetX/offsetY to place it manually (that disables the stub) or stubLength=0 for the old on-pin behaviour.", inputSchema: objectSchema({ pinPrimitiveId: { type: "string" }, identification: { type: "string", enum: ["Power", "Ground", "AnalogGround", "ProtectGround"] }, net: { type: "string" }, stubLength: { type: "number" }, offsetX: { type: "number" }, offsetY: { type: "number" }, rotation: { type: "integer", enum: [0, 90, 180, 270] }, mirror: { type: "boolean" }, color: { type: "string" }, lineWidth: { type: "integer" }, lineType: { type: "integer" }, paper: { type: "string" }, allowOutsideFrame: { type: "boolean" } }, ["pinPrimitiveId", "identification", "net"]) },
   { name: "eda_place_net_label_at_pin", description: "Place a REAL net label at a pin (sch_PrimitiveAttribute.createNetLabel; falls back to text and reports method) WITHOUT covering the symbol: a stub wire of stubLength MCP units (default 20) is drawn outwards along the pin direction and the label goes at its end. offsetX/offsetY place it manually (disables the stub); stubLength=0 keeps the old on-pin behaviour.", inputSchema: objectSchema({ pinPrimitiveId: { type: "string" }, net: { type: "string" }, stubLength: { type: "number" }, offsetX: { type: "number" }, offsetY: { type: "number" }, rotation: { type: "integer", enum: [0, 90, 180, 270] }, fontSize: { type: "number" }, color: { type: "string" }, lineWidth: { type: "integer" }, lineType: { type: "integer" }, paper: { type: "string" }, allowOutsideFrame: { type: "boolean" } }, ["pinPrimitiveId", "net"]) },
   { name: "eda_set_no_connect", description: "Set or clear the no-connect flag on one or more schematic pins via sch_PrimitivePin.modify.", inputSchema: objectSchema({ primitiveIds: { type: "array", items: { type: "string" } }, noConnected: { type: "boolean" } }, ["primitiveIds"]) },
-  { name: "eda_draw_wire", description: "Draw a schematic wire (polyline). Coordinates are MCP units (0.01 inch).", inputSchema: objectSchema({ points: { type: "array", items: { type: "number" } }, net: { type: "string" }, color: { type: "string" }, lineWidth: { type: "integer", minimum: 1, maximum: 10 }, lineType: { type: "integer", enum: [0, 1, 2, 3] } }, ["points"]) },
+  { name: "eda_draw_wire", description: "Draw a schematic wire (polyline). Coordinates are MCP units (0.01 inch). IMPORTANT: the net argument only sticks on a floating wire \u2014 as soon as an endpoint touches a pin, EDA recomputes the net from connectivity and the name you passed is overwritten (measured: TESTNET merged into LED_A). To join same-named nets across regions use eda_place_net_port or a net label; do not rely on two distantly drawn wires sharing a name.", inputSchema: objectSchema({ points: { type: "array", items: { type: "number" } }, net: { type: "string" }, color: { type: "string" }, lineWidth: { type: "integer", minimum: 1, maximum: 10 }, lineType: { type: "integer", enum: [0, 1, 2, 3] } }, ["points"]) },
   { name: "eda_draw_rectangle", description: "Draw a rectangle. topLeftY is the UPPER y coordinate (max y); height extends downward. Coordinates are MCP units.", inputSchema: objectSchema({ topLeftX: { type: "number" }, topLeftY: { type: "number" }, width: { type: "number" }, height: { type: "number" }, cornerRadius: { type: "number" }, rotation: { type: "integer", enum: [0, 90, 180, 270] }, color: { type: "string" }, fillColor: { type: "string" }, lineWidth: { type: "integer", minimum: 1, maximum: 10 }, lineType: { type: "integer", enum: [0, 1, 2, 3] }, fillStyle: { type: "string" } }, ["topLeftX", "topLeftY", "width", "height"]) },
   { name: "eda_draw_functional_box", description: "Draw a dashed functional-group box around one group of components, with an optional label. Margins and coordinates are MCP units; default margin 1 unit (about 0.254 mm).", inputSchema: objectSchema({ componentIds: { type: "array", items: { type: "string" } }, label: { type: "string" }, margin: { type: "number" }, color: { type: "string" }, lineWidth: { type: "integer", minimum: 1, maximum: 10 }, lineType: { type: "integer", enum: [0, 1, 2, 3] } }) },
   { name: "eda_draw_circle", description: "Draw a circle. Coordinates are MCP units.", inputSchema: objectSchema({ centerX: { type: "number" }, centerY: { type: "number" }, radius: { type: "number" }, color: { type: "string" }, fillColor: { type: "string" }, lineWidth: { type: "integer", minimum: 1, maximum: 10 }, lineType: { type: "integer", enum: [0, 1, 2, 3] }, fillStyle: { type: "string" } }, ["centerX", "centerY", "radius"]) },
@@ -556,14 +602,18 @@ var TOOLS = [
   { name: "eda_get_nets", description: "List nets of the current schematic project. Uses sch_Net.* first; when the schematic is not the active document those APIs return [] and this tool falls back to parsing sch_Netlist.getNetlist, reporting which source was used.", inputSchema: objectSchema({ name: { type: "string" }, parseNetlist: { type: "boolean" } }) },
   { name: "eda_get_active_document", description: "Return the document/tab that is currently active (documentType, uuid, tabId, parent project). Most tab-dependent APIs (sch_Net.*, netlist export, DRC) only work when the matching document is active - use eda_open_document to switch.", inputSchema: objectSchema({}) },
   { name: "eda_open_document", description: "Open/activate a document tab by uuid (dmt_EditorControl.openDocument). Works for a schematic page or a PCB, so tab-dependent APIs can run.", inputSchema: objectSchema({ documentUuid: { type: "string" }, splitScreenId: { type: "string" } }, ["documentUuid"]) },
-  { name: "eda_get_net_labels", description: "List net-label / attribute primitives on the active schematic page (sch_PrimitiveAttribute.getAll), optionally for one parent primitive.", inputSchema: objectSchema({ parentPrimitiveId: { type: "string" } }) },
-  { name: "eda_place_net_label", description: "Place a real net label at x/y via sch_PrimitiveAttribute.createNetLabel (falls back to a plain text label when that API is missing, and reports which method was used). Coordinates are MCP units.", inputSchema: objectSchema({ x: { type: "number" }, y: { type: "number" }, net: { type: "string" }, fontSize: { type: "number" }, rotation: { type: "integer", enum: [0, 90, 180, 270] } }, ["x", "y", "net"]) },
-  { name: "eda_run_drc", description: "Run schematic DRC and return the verbose result array.", inputSchema: objectSchema({ strict: { type: "boolean" } }) },
-  { name: "eda_auto_layout", description: "Run schematic auto-layout (sch_Document.autoLayout).", inputSchema: objectSchema({ uuids: { type: "array", items: { type: "string" } } }) },
-  { name: "eda_auto_route", description: "Run schematic auto-routing (sch_Document.autoRouting).", inputSchema: objectSchema({ uuids: { type: "array", items: { type: "string" } } }) },
+  { name: "eda_get_net_labels", description: "List every label-like primitive on the active schematic page: attribute primitives (netlabel/netport/netflag) PLUS plain texts left by the createNetLabel fallback, so they can be audited and deleted. Reports kind/primitiveId/net per entry.", inputSchema: objectSchema({ parentPrimitiveId: { type: "string" } }) },
+  { name: "eda_place_net_label", description: "Place a net label at x/y. The real API (sch_PrimitiveAttribute.createNetLabel) is probed once per session; when the build never answers, a plain TEXT label is placed instead, which carries no electrical meaning and must be paired with a stub wire. Pass probe:true to re-check.", inputSchema: objectSchema({ x: { type: "number" }, y: { type: "number" }, net: { type: "string" }, fontSize: { type: "number" }, rotation: { type: "integer", enum: [0, 90, 180, 270] } }, ["x", "y", "net"]) },
+  { name: "eda_place_net_labels", description: "Place many net labels in ONE call (per-pin or by coordinate) and report done/failed per item: a 133-label schematic used to exceed the caller timeout with no progress. items: [{ pinPrimitiveId, net, stubLength?, offsetX?, offsetY? }] or [{ x, y, net, fontSize? }].", inputSchema: objectSchema({ items: { type: "array", items: { type: "object", additionalProperties: true } }, probe: { type: "boolean" } }, ["items"]) },
+  { name: "eda_run_drc", description: "Run schematic DRC with includeVerboseError and return one entry per problem (type, message, primitiveId, x/y plus the raw record) instead of bare counts.", inputSchema: objectSchema({ strict: { type: "boolean" } }) },
+  { name: "eda_auto_layout", description: "Run schematic auto-layout (sch_Document.autoLayout). DISABLED by default: automated layout is not used unless the user asks for it. Pass force:true only then.", inputSchema: objectSchema({ uuids: { type: "array", items: { type: "string" } }, force: { type: "boolean" } }) },
+  { name: "eda_auto_route", description: "Run schematic auto-routing (sch_Document.autoRouting). DISABLED by default: route by hand unless the user explicitly asks. Pass force:true only then.", inputSchema: objectSchema({ uuids: { type: "array", items: { type: "string" } }, force: { type: "boolean" } }) },
   { name: "eda_export_netlist", description: "Export the schematic netlist as text (default JLCEDA format). Returns null when no schematic is active - check eda_get_active_document / open the schematic page first.", inputSchema: objectSchema({ type: { type: "string" } }) },
-  { name: "eda_export_bom", description: "Export the schematic BOM. csv returns text; xlsx returns a base64 data URL.", inputSchema: objectSchema({ format: { type: "string", enum: ["csv", "xlsx"] } }) },
-  { name: "eda_delete_primitive", description: "Delete a schematic primitive by kind and primitive id.", inputSchema: objectSchema({ kind: { type: "string", enum: ["component", "wire", "rectangle", "circle", "arc", "polygon", "text"] }, primitiveId: { type: "string" } }, ["kind", "primitiveId"]) },
+  { name: "eda_export_bom", description: "Export the schematic BOM. csv is decoded from UTF-16 to readable text; xlsx returns a base64 data URL.", inputSchema: objectSchema({ format: { type: "string", enum: ["csv", "xlsx"] } }) },
+  { name: "eda_move_component", description: "Move/rotate/mirror a schematic component (sch_PrimitiveComponent.modify) without deleting and re-placing it, so the designator and value survive.", inputSchema: objectSchema({ primitiveId: { type: "string" }, x: { type: "number" }, y: { type: "number" }, rotation: { type: "number" }, mirror: { type: "boolean" } }, ["primitiveId"]) },
+  { name: "eda_workflow_guide", description: "Return the schematic working standard: grid-aligned manual placement, signal flow, when net labels/ports are required (a wire net name is overridden by connectivity), net-label fallback behaviour, batch placement and the verification order. Read it before laying out a sheet.", inputSchema: objectSchema({}) },
+  { name: "eda_list_api_methods", description: 'List every API method the connected extension accepts (its allow-list). Call it when eda_api_call answers "API method not allowed".', inputSchema: objectSchema({}) },
+  { name: "eda_delete_primitive", description: 'Delete a schematic primitive by kind and primitive id. Net ports, net flags and net labels are attribute primitives and need kind "netport"/"netflag"/"netlabel"; the text fallback labels are kind "text".', inputSchema: objectSchema({ kind: { type: "string", enum: ["component", "wire", "rectangle", "circle", "arc", "polygon", "text", "netport", "netflag", "netlabel"] }, primitiveId: { type: "string" } }, ["kind", "primitiveId"]) },
   { name: "eda_create_board", description: "Create a board linking a schematic and a PCB (dmt_Board.createBoard).", inputSchema: objectSchema({ schematicUuid: { type: "string" }, pcbUuid: { type: "string" } }) },
   { name: "eda_api_call", description: "Call an allow-listed JLCEDA Pro extension API method directly.", inputSchema: objectSchema({ method: { type: "string" }, args: { type: "array" } }, ["method", "args"]) },
   { name: "pcb_get_components", description: "List PCB components (mil). includePins=true also reads pcb_PrimitiveComponent.getAllPinsByPrimitiveId per component, which is the accurate pad/net source; the fast summary pad list can be stale.", inputSchema: objectSchema({ layer: { type: ["string", "integer"] }, locked: { type: "boolean" }, includeBounds: { type: "boolean" }, includePins: { type: "boolean" } }) },
@@ -747,6 +797,8 @@ var WsConnection = class {
 var clients = /* @__PURE__ */ new Set();
 var pendingCalls = /* @__PURE__ */ new Map();
 var pcbComponentBaseline = null;
+var netLabelSupport = null;
+var placedTextLabels = [];
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -1213,30 +1265,88 @@ async function parseNetlist(previous, timeoutMs) {
   const nets = [...byNet.entries()].map(([net, pins]) => ({ net, pins, pinCount: pins.length }));
   return { source: "sch_Netlist.getNetlist", count: nets.length, nets, netlistBytes: text.length };
 }
-async function placeNetLabel(net, x, y, fontSize, timeoutMs) {
+async function placeNetLabel(net, x, y, fontSize, timeoutMs, options = {}) {
   if (net === "" || net === "undefined") throw new Error("a net name is required");
   assertNetName(String(net), "eda_place_net_label");
   const size = fontSize === void 0 ? 12 : Number(fontSize);
-  try {
-    const raw = await callExtension("sch_PrimitiveAttribute.createNetLabel", [x, y, net], Math.min(timeoutMs, 4e3));
-    if (raw === void 0 || raw === null) throw new Error("createNetLabel returned nothing");
-    return { method: "netLabel", net, x, y, label: summarizePrimitive(raw) };
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    if (!/not found|not available|not allowed|timed out|timeout/i.test(message)) throw error;
-    const raw = await callExtension("sch_PrimitiveText.create", [x, y, net, 0, null, null, size, false, false, false, 1], timeoutMs);
-    const label = summarizePrimitive(raw);
-    return {
-      method: "text",
-      net,
+  if (options.probe === true) netLabelSupport = null;
+  let failure = null;
+  if (netLabelSupport !== false) {
+    try {
+      const raw2 = await callExtension("sch_PrimitiveAttribute.createNetLabel", [x, y, net], Math.min(timeoutMs, 4e3));
+      if (raw2 === void 0 || raw2 === null) throw new Error("createNetLabel returned nothing");
+      netLabelSupport = true;
+      return { method: "netLabel", net, x, y, label: summarizePrimitive(raw2) };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      if (!/not found|not available|not allowed|timed out|timeout|nothing|undefined/i.test(message)) throw error;
+      failure = message;
+      netLabelSupport = false;
+    }
+  }
+  const raw = await callExtension("sch_PrimitiveText.create", [x, y, net, 0, null, null, size, false, false, false, 1], timeoutMs);
+  const label = summarizePrimitive(raw);
+  if (label.primitiveId !== void 0) {
+    placedTextLabels.push({ net: String(net), x, y, primitiveId: label.primitiveId });
+    if (placedTextLabels.length > 2e3) placedTextLabels.shift();
+  }
+  return {
+    method: "text",
+    net,
+    x,
+    y,
+    created: label.primitiveId !== void 0,
+    warning: "createNetLabel is unavailable on this EDA build (" + (failure ?? "probe already failed this session") + "), so a plain TEXT label was placed: it carries no electrical meaning. The stub wire drawn by the caller is what joins the net; eda_get_net_labels lists these texts by name and id.",
+    ...label.primitiveId === void 0 ? { hint: "No label primitive was created: the schematic page must be the ACTIVE document (sch_PrimitiveText.create is tab-dependent). Use eda_get_active_document / eda_open_document, then retry." } : {},
+    label
+  };
+}
+async function placeAtPin(toolName, args, timeoutMs) {
+  const pinPrimitiveId = String(args.pinPrimitiveId ?? "");
+  if (pinPrimitiveId === "") throw new Error("pinPrimitiveId is required");
+  const isFlag = toolName === "eda_place_net_flag_at_pin";
+  assertNetName(String(args.net ?? ""), toolName);
+  const pin = await callExtension("sch_PrimitivePin.get", [pinPrimitiveId], timeoutMs);
+  const pinRecord = asRecord(pin);
+  const pinX = Number(pickValue(pinRecord, "X", "x"));
+  const pinY = Number(pickValue(pinRecord, "Y", "y"));
+  if (!Number.isFinite(pinX) || !Number.isFinite(pinY)) throw new Error("could not read pin position for " + pinPrimitiveId);
+  const pinRotation = Number(pickValue(pinRecord, "Rotation", "rotation") ?? 0);
+  const direction = pinDirection(pinRotation);
+  const explicitOffset = args.offsetX !== void 0 || args.offsetY !== void 0;
+  const stubLength = args.stubLength === void 0 ? explicitOffset ? 0 : 20 : Math.max(0, Number(args.stubLength));
+  const x = pinX + direction.dx * stubLength + Number(args.offsetX ?? 0);
+  const y = pinY + direction.dy * stubLength + Number(args.offsetY ?? 0);
+  if (args.allowOutsideFrame !== true) {
+    const problem = checkPointInFrame(x, y, args.paper, 5) ?? checkPointAgainstTitleBlock(x, y, args.paper, 5);
+    if (problem !== void 0) {
+      throw new Error(toolName + " refused: " + problem + " - reduce stubLength or pass offsetX/offsetY to place it elsewhere.");
+    }
+  }
+  let stub;
+  if (stubLength > 0 && typeof args.net === "string" && args.net !== "") {
+    stub = summarizePrimitive(await callExtension("sch_PrimitiveWire.create", [
+      [pinX, pinY, x, y],
+      String(args.net),
+      args.color === void 0 ? void 0 : String(args.color),
+      args.lineWidth === void 0 ? void 0 : Number(args.lineWidth),
+      args.lineType === void 0 ? void 0 : Number(args.lineType)
+    ], timeoutMs));
+  }
+  const placement = { pin: { primitiveId: pinPrimitiveId, x: pinX, y: pinY, rotation: pinRotation }, direction, stubLength, x, y, stub };
+  if (isFlag) {
+    const flag = await callExtension("sch_PrimitiveComponent.createNetFlag", [
+      String(args.identification),
+      String(args.net),
       x,
       y,
-      created: label.primitiveId !== void 0,
-      warning: "createNetLabel could not be called (" + message + "). On JLCEDA Pro 3.2.186 the API exists but never resolves, so it is probed with a 4 s timeout. A plain text label does NOT create an electrical connection - the stub wire drawn by eda_place_net_label_at_pin carries the net, so keep it.",
-      ...label.primitiveId === void 0 ? { hint: "No label primitive was created: the schematic page must be the ACTIVE document (sch_PrimitiveText.create is tab-dependent). Use eda_get_active_document / eda_open_document, then retry." } : {},
-      label
-    };
+      args.rotation === void 0 ? pinRotation : Number(args.rotation),
+      Boolean(args.mirror ?? false)
+    ], timeoutMs);
+    return { ...placement, flag: summarizePrimitive(flag) };
   }
+  const label = await placeNetLabel(String(args.net), x, y, args.fontSize, timeoutMs);
+  return { ...label, ...placement };
 }
 function isInternalHelperMissing(error) {
   const message = error instanceof Error ? error.message : String(error);
@@ -1269,10 +1379,10 @@ async function resolveProjectUuid(args, timeoutMs) {
       const teamUuid = String(pickValue(asRecord(team), "uuid", "Uuid") ?? "");
       if (teamUuid === "") continue;
       const owned = await callExtension("dmt_Project.getAllProjectsUuid", [teamUuid], toolTimeout(args, timeoutMs)).catch(() => []);
-      for (const uuid of Array.isArray(owned) ? owned.map(String) : []) {
-        if (seen.has(uuid)) continue;
-        seen.add(uuid);
-        candidates.push(uuid);
+      for (const uuid2 of Array.isArray(owned) ? owned.map(String) : []) {
+        if (seen.has(uuid2)) continue;
+        seen.add(uuid2);
+        candidates.push(uuid2);
       }
     }
   }
@@ -1291,6 +1401,40 @@ async function resolveProjectUuid(args, timeoutMs) {
   }
   return { uuid: matched.uuid, matched };
 }
+async function waitForActiveProject(uuid2, timeoutMs = 4e3) {
+  const deadline = Date.now() + timeoutMs;
+  let lastActive = null;
+  for (; ; ) {
+    try {
+      const info = asRecord(await callExtension("dmt_Project.getCurrentProjectInfo", [], 3e3));
+      lastActive = String(pickValue(info, "uuid", "Uuid") ?? "") || null;
+      if (lastActive === uuid2) return { active: true, project: info };
+    } catch {
+    }
+    if (Date.now() > deadline) return { active: false, project: null, lastActive };
+    await sleep(400);
+  }
+}
+function internalIdsOf(info) {
+  const ids = /* @__PURE__ */ new Set();
+  const boards = Array.isArray(asRecord(info).data) ? asRecord(info).data : [];
+  for (const board of boards) {
+    const record = asRecord(board);
+    const boardUuid = String(pickValue(record, "uuid", "Uuid") ?? "");
+    if (boardUuid !== "") ids.add(boardUuid);
+    for (const docKey of ["schematic", "pcb"]) {
+      const doc = asRecord(record[docKey]);
+      const docUuid = String(pickValue(doc, "uuid", "Uuid") ?? "");
+      if (docUuid !== "") ids.add(docUuid);
+      const pages = Array.isArray(doc.pages) ? doc.pages : [];
+      for (const page of pages) {
+        const pageUuid = String(pickValue(asRecord(page), "uuid", "Uuid") ?? "");
+        if (pageUuid !== "") ids.add(pageUuid);
+      }
+    }
+  }
+  return ids;
+}
 async function executeTool(name, rawArgs, timeoutMs) {
   const args = asRecord(rawArgs);
   const tool = PCB_TOOL_ALIASES[name] ?? name;
@@ -1361,24 +1505,45 @@ async function executeTool(name, rawArgs, timeoutMs) {
         saveTo
       ], toolTimeout(args, timeoutMs));
       const raw = imported?.result ?? imported;
-      const uuid = typeof raw === "string" ? raw : typeof raw?.uuid === "string" ? raw.uuid : void 0;
+      const uuid2 = typeof raw === "string" ? raw : typeof raw?.uuid === "string" ? raw.uuid : void 0;
       const landed = raw !== null && raw !== void 0;
       let opened = false;
-      if (args.open === true && uuid !== void 0) {
+      if (args.open === true && uuid2 !== void 0) {
         try {
-          opened = await callExtension("dmt_Project.openProject", [uuid], timeoutMs) !== false;
+          await callExtension("dmt_Project.openProject", [uuid2], timeoutMs);
+          opened = (await waitForActiveProject(uuid2, 4e3)).active;
         } catch {
           opened = false;
         }
       }
+      let collisions = null;
+      if (landed && uuid2 !== void 0 && args.checkCollisions !== false) {
+        try {
+          const mine = await callExtension("dmt_Project.getProjectInfo", [uuid2], toolTimeout(args, timeoutMs));
+          const myIds = internalIdsOf(mine);
+          const others = await callExtension("dmt_Project.getAllProjectsUuid", [], toolTimeout(args, timeoutMs));
+          const list = (Array.isArray(others) ? others.map(String) : []).filter((other) => other !== uuid2).slice(0, 20);
+          collisions = [];
+          for (const other of list) {
+            const info = await callExtension("dmt_Project.getProjectInfo", [other], timeoutMs).catch(() => void 0);
+            const shared = [...internalIdsOf(info)].filter((sharedId) => myIds.has(sharedId));
+            if (shared.length > 0) {
+              collisions.push({ projectUuid: other, friendlyName: pickValue(asRecord(info), "friendlyName", "FriendlyName") ?? null, sharedIds: shared });
+            }
+          }
+        } catch {
+          collisions = null;
+        }
+      }
       return {
         ok: landed,
         imported: landed,
         name: basename(path),
         size: bytes.length,
         teamUuid,
-        uuid: uuid ?? null,
+        uuid: uuid2 ?? null,
         opened,
+        collisions,
         result: raw ?? null,
         hint: landed ? null : "The app returned nothing: the import did not create a project. That means this build ignores the saveTo target (same limitation as createProject), so import cannot be used to create projects here."
       };
@@ -1441,10 +1606,10 @@ async function executeTool(name, rawArgs, timeoutMs) {
           const teamUuid = String(pickValue(asRecord(team), "uuid", "Uuid") ?? "");
           if (teamUuid === "") continue;
           const owned = await callExtension("dmt_Project.getAllProjectsUuid", [teamUuid], toolTimeout(args, timeoutMs)).catch(() => []);
-          for (const uuid of Array.isArray(owned) ? owned.map(String) : []) {
-            if (seen.has(uuid)) continue;
-            seen.add(uuid);
-            list.push(uuid);
+          for (const uuid2 of Array.isArray(owned) ? owned.map(String) : []) {
+            if (seen.has(uuid2)) continue;
+            seen.add(uuid2);
+            list.push(uuid2);
           }
         }
         aggregated = true;
@@ -1452,11 +1617,11 @@ async function executeTool(name, rawArgs, timeoutMs) {
       if (args.resolveNames === false) return { count: list.length, uuids: list, aggregated };
       const limit = Number.isFinite(Number(args.limit)) ? Math.max(1, Number(args.limit)) : list.length;
       const projects = [];
-      for (const uuid of list.slice(0, limit)) {
+      for (const uuid2 of list.slice(0, limit)) {
         try {
-          projects.push(await callExtension("dmt_Project.getProjectInfo", [uuid], toolTimeout(args, timeoutMs)));
+          projects.push(await callExtension("dmt_Project.getProjectInfo", [uuid2], toolTimeout(args, timeoutMs)));
         } catch {
-          projects.push({ uuid });
+          projects.push({ uuid: uuid2 });
         }
       }
       return { count: list.length, resolved: projects.length, aggregated, projects };
@@ -1467,10 +1632,17 @@ async function executeTool(name, rawArgs, timeoutMs) {
     }
     case "eda_open_project": {
       const resolvedProject = await resolveProjectUuid(args, timeoutMs);
-      const uuid = resolvedProject.uuid;
-      const opened = await callExtension("dmt_Project.openProject", [uuid], toolTimeout(args, timeoutMs));
-      const current = await callExtension("dmt_Project.getCurrentProjectInfo", [], timeoutMs).catch(() => void 0);
-      return { opened: opened !== false, uuid, matched: resolvedProject.matched, current: current === void 0 ? null : summarizePrimitive(current) };
+      const uuid2 = resolvedProject.uuid;
+      const returned = await callExtension("dmt_Project.openProject", [uuid2], toolTimeout(args, timeoutMs));
+      const activation = await waitForActiveProject(uuid2, args.verifyMs === void 0 ? 4e3 : Number(args.verifyMs));
+      return {
+        opened: activation.active,
+        openReturned: returned !== false,
+        uuid: uuid2,
+        matched: resolvedProject.matched,
+        current: activation.active ? summarizePrimitive(activation.project) : null,
+        ...activation.active ? {} : { hint: "The project did not become active within the verification window (last active: " + (activation.lastActive ?? "unknown") + "); it may still be loading, or the app refused the switch." }
+      };
     }
     case "eda_get_workspace": {
       const workspace = await callExtension("dmt_Workspace.getCurrentWorkspaceInfo", [], timeoutMs).catch(() => void 0);
@@ -1545,13 +1717,26 @@ async function executeTool(name, rawArgs, timeoutMs) {
         uuid: args.sourceUuid,
         name: args.sourceName
       }, timeoutMs);
-      const uuid = await callExtension("dmt_Project.copyProject", [
-        source.uuid,
-        args.targetTeamUuid === void 0 ? void 0 : String(args.targetTeamUuid),
-        args.targetFolderUuid === void 0 ? void 0 : String(args.targetFolderUuid),
-        args.newFriendlyName === void 0 ? void 0 : String(args.newFriendlyName),
-        args.newName === void 0 ? void 0 : String(args.newName)
-      ], toolTimeout(args, timeoutMs));
+      let copyRaw;
+      try {
+        copyRaw = await callExtension("dmt_Project.copyProject", [
+          source.uuid,
+          args.targetTeamUuid === void 0 ? void 0 : String(args.targetTeamUuid),
+          args.targetFolderUuid === void 0 ? void 0 : String(args.targetFolderUuid),
+          args.newFriendlyName === void 0 ? void 0 : String(args.newFriendlyName),
+          args.newName === void 0 ? void 0 : String(args.newName)
+        ], toolTimeout(args, timeoutMs));
+      } catch (failure) {
+        throw new Error("eda_copy_project failed: " + (failure instanceof Error ? failure.message : String(failure)));
+      }
+      const copyUuid = typeof copyRaw === "string" ? copyRaw : String(pickValue(asRecord(copyRaw), "uuid", "Uuid") ?? "");
+      return {
+        copied: copyUuid !== "",
+        sourceUuid: source.uuid,
+        uuid: copyUuid === "" ? null : copyUuid,
+        raw: copyRaw ?? null,
+        hint: copyUuid === "" ? "The app returned no uuid and created nothing: copyProject does not work on this build for local projects (same family as createProject/deleteProject). Duplicate it in the app, or export with eda_export_project and import it back with eda_import_project to get an independent copy." : null
+      };
       return { copied: typeof uuid === "string" && uuid !== "", sourceUuid: source.uuid, uuid: uuid ?? null };
     }
     case "eda_create_project": {
@@ -1568,25 +1753,26 @@ async function executeTool(name, rawArgs, timeoutMs) {
         throw new Error("eda_create_project: no team is available (sign in to a JLC account in JLCEDA Pro, or pass teamUuid from eda_list_teams)");
       }
       const folderUuid = args.folderUuid === void 0 ? "" : String(args.folderUuid).trim();
-      const uuid = await callExtension("dmt_Project.createProject", [
+      const uuid2 = await callExtension("dmt_Project.createProject", [
         friendlyName,
         args.name === void 0 ? void 0 : String(args.name),
         teamUuid,
         folderUuid === "" ? void 0 : folderUuid,
         args.description === void 0 ? void 0 : String(args.description)
       ], toolTimeout(args, timeoutMs));
-      if (typeof uuid !== "string" || uuid === "") {
+      if (typeof uuid2 !== "string" || uuid2 === "") {
         throw new Error("eda_create_project: the app returned no project uuid (team " + teamUuid + " from " + teamSource + "; the app may have shown a dialog or rejected the name)");
       }
       let opened = false;
       if (args.open === true) {
         try {
-          opened = await callExtension("dmt_Project.openProject", [uuid], timeoutMs) !== false;
+          await callExtension("dmt_Project.openProject", [uuid2], timeoutMs);
+          opened = (await waitForActiveProject(uuid2, 4e3)).active;
         } catch {
           opened = false;
         }
       }
-      return { created: true, uuid, friendlyName, teamUuid, teamSource, folderUuid: folderUuid === "" ? null : folderUuid, opened };
+      return { created: true, uuid: uuid2, friendlyName, teamUuid, teamSource, folderUuid: folderUuid === "" ? null : folderUuid, opened };
     }
     case "eda_launch": {
       const probe = launchProbe();
@@ -1768,68 +1954,90 @@ async function executeTool(name, rawArgs, timeoutMs) {
       const componentPrimitiveId = String(args.componentPrimitiveId ?? "");
       if (componentPrimitiveId === "") throw new Error("componentPrimitiveId is required");
       const raw = await callExtension("sch_PrimitiveComponent.getAllPinsByPrimitiveId", [componentPrimitiveId], timeoutMs);
-      if (Array.isArray(raw)) return raw.map(summarizePrimitive);
-      return raw;
+      if (!Array.isArray(raw)) return raw;
+      return raw.map((entry) => {
+        const record = asRecord(entry);
+        return {
+          primitiveId: pickValue(record, "PrimitiveId", "primitiveId"),
+          pinNumber: pickValue(record, "PinNumber", "pinNumber") ?? null,
+          pinName: pickValue(record, "PinName", "pinName") ?? null,
+          x: pickValue(record, "X", "x"),
+          y: pickValue(record, "Y", "y"),
+          rotation: pickValue(record, "Rotation", "rotation") ?? 0,
+          pinLength: pickValue(record, "PinLength", "pinLength") ?? null,
+          noConnected: pickValue(record, "NoConnected", "noConnected") ?? null
+        };
+      });
     }
     case "eda_place_net_flag_at_pin":
-    case "eda_place_net_label_at_pin": {
-      const pinPrimitiveId = String(args.pinPrimitiveId ?? "");
-      if (pinPrimitiveId === "") throw new Error("pinPrimitiveId is required");
-      assertNetName(String(args.net ?? ""), name === "eda_place_net_flag_at_pin" ? "eda_place_net_flag_at_pin" : "eda_place_net_label_at_pin");
-      const pin = await callExtension("sch_PrimitivePin.get", [pinPrimitiveId], timeoutMs);
-      const pinRecord = asRecord(pin);
-      const pinX = Number(pickValue(pinRecord, "X", "x"));
-      const pinY = Number(pickValue(pinRecord, "Y", "y"));
-      if (!Number.isFinite(pinX) || !Number.isFinite(pinY)) throw new Error("could not read pin position for " + pinPrimitiveId);
-      const pinRotation = Number(pickValue(pinRecord, "Rotation", "rotation") ?? 0);
-      const direction = pinDirection(pinRotation);
-      const explicitOffset = args.offsetX !== void 0 || args.offsetY !== void 0;
-      const stubLength = args.stubLength === void 0 ? explicitOffset ? 0 : 20 : Math.max(0, Number(args.stubLength));
-      const x = pinX + direction.dx * stubLength + Number(args.offsetX ?? 0);
-      const y = pinY + direction.dy * stubLength + Number(args.offsetY ?? 0);
-      if (args.allowOutsideFrame !== true) {
-        const problem = checkPointInFrame(x, y, args.paper, 5) ?? checkPointAgainstTitleBlock(x, y, args.paper, 5);
-        if (problem !== void 0) {
-          throw new Error((name === "eda_place_net_flag_at_pin" ? "eda_place_net_flag_at_pin" : "eda_place_net_label_at_pin") + " refused: " + problem + " - reduce stubLength or pass offsetX/offsetY to place it elsewhere.");
-        }
-      }
-      let stub;
-      if (stubLength > 0 && typeof args.net === "string" && args.net !== "") {
-        stub = summarizePrimitive(await callExtension("sch_PrimitiveWire.create", [
-          [pinX, pinY, x, y],
-          String(args.net),
-          args.color === void 0 ? void 0 : String(args.color),
-          args.lineWidth === void 0 ? void 0 : Number(args.lineWidth),
-          args.lineType === void 0 ? void 0 : Number(args.lineType)
-        ], timeoutMs));
-      }
-      const placement = { pin: { primitiveId: pinPrimitiveId, x: pinX, y: pinY, rotation: pinRotation }, direction, stubLength, x, y, stub };
-      if (name === "eda_place_net_flag_at_pin") {
-        const flag = await callExtension("sch_PrimitiveComponent.createNetFlag", [
-          String(args.identification),
-          String(args.net),
-          x,
-          y,
-          args.rotation === void 0 ? pinRotation : Number(args.rotation),
-          Boolean(args.mirror ?? false)
-        ], timeoutMs);
-        return { ...placement, flag: summarizePrimitive(flag) };
-      }
-      const label = await placeNetLabel(String(args.net), x, y, args.fontSize, timeoutMs);
-      return { ...label, ...placement };
-    }
+    case "eda_place_net_label_at_pin":
+      return await placeAtPin(name, args, timeoutMs);
     case "eda_place_net_label": {
       const x = Number(args.x);
       const y = Number(args.y);
       if (!Number.isFinite(x) || !Number.isFinite(y)) throw new Error("eda_place_net_label requires numeric x/y");
-      return await placeNetLabel(String(args.net), x, y, args.fontSize, timeoutMs);
+      return await placeNetLabel(String(args.net), x, y, args.fontSize, timeoutMs, { probe: args.probe === true });
+    }
+    case "eda_place_net_labels": {
+      const items = Array.isArray(args.items) ? args.items.map(asRecord) : [];
+      if (items.length === 0) throw new Error("eda_place_net_labels requires items: [{ pinPrimitiveId, net }] or [{ x, y, net }]");
+      const results = [];
+      for (const item of items) {
+        const net = item.net === void 0 ? "" : String(item.net);
+        try {
+          const placed = item.pinPrimitiveId !== void 0 ? await placeAtPin("eda_place_net_label_at_pin", { ...item, net }, timeoutMs) : await placeNetLabel(net, Number(item.x), Number(item.y), item.fontSize, timeoutMs, { probe: args.probe === true });
+          results.push({ ok: true, net, ...placed });
+        } catch (error) {
+          results.push({ ok: false, net, error: error instanceof Error ? error.message : String(error) });
+        }
+      }
+      const done = results.filter((entry) => entry.ok).length;
+      return {
+        total: items.length,
+        done,
+        failed: items.length - done,
+        method: netLabelSupport === true ? "netLabel" : "text",
+        results
+      };
     }
     case "eda_get_net_labels": {
-      const raw = await callExtension("sch_PrimitiveAttribute.getAll", [
+      const attributes = await callExtension("sch_PrimitiveAttribute.getAll", [
         args.parentPrimitiveId === void 0 ? void 0 : String(args.parentPrimitiveId)
-      ], timeoutMs);
-      if (!Array.isArray(raw)) return raw;
-      return { count: raw.length, labels: raw.map(summarizePrimitive) };
+      ], timeoutMs).catch(() => []);
+      const texts = args.parentPrimitiveId === void 0 ? await callExtension("sch_PrimitiveText.getAll", [], timeoutMs).catch(() => []) : [];
+      const entries = [];
+      for (const entry of Array.isArray(attributes) ? attributes : []) {
+        const record = asRecord(entry);
+        entries.push({
+          primitiveId: pickValue(record, "PrimitiveId", "primitiveId"),
+          kind: String(pickValue(record, "PrimitiveType", "primitiveType", "Type", "type") ?? "attribute"),
+          net: pickValue(record, "Net", "net") ?? null,
+          userValue: pickValue(record, "UserValue", "userValue", "Value", "value") ?? null,
+          x: pickValue(record, "X", "x"),
+          y: pickValue(record, "Y", "y")
+        });
+      }
+      for (const entry of Array.isArray(texts) ? texts : []) {
+        const record = asRecord(entry);
+        const content = String(pickValue(record, "Content", "content", "Text", "text") ?? "");
+        if (content === "") continue;
+        entries.push({
+          primitiveId: pickValue(record, "PrimitiveId", "primitiveId"),
+          kind: "text",
+          net: content,
+          userValue: content,
+          x: pickValue(record, "X", "x"),
+          y: pickValue(record, "Y", "y")
+        });
+      }
+      return {
+        count: entries.length,
+        attributeCount: Array.isArray(attributes) ? attributes.length : 0,
+        textCount: Array.isArray(texts) ? texts.length : 0,
+        sessionTextLabels: placedTextLabels.length,
+        note: 'kind "text" entries are plain texts (no electrical meaning). Delete any entry with eda_delete_primitive(kind: "netlabel"|"netport"|"netflag"|"text", primitiveId).',
+        labels: entries
+      };
     }
     case "eda_get_active_document": {
       const info = await callExtension("dmt_SelectControl.getCurrentDocumentInfo", [], timeoutMs);
@@ -1955,8 +2163,33 @@ async function executeTool(name, rawArgs, timeoutMs) {
       ], timeoutMs);
     case "eda_save_document":
       return await callExtension("sch_Document.save", [], timeoutMs);
-    case "eda_zoom_to_fit":
-      return await callExtension("dmt_EditorControl.zoomToAllPrimitives", [args.tabId], timeoutMs);
+    case "eda_zoom_to_fit": {
+      const raw = await callExtension("dmt_EditorControl.zoomToAllPrimitives", [args.tabId], timeoutMs);
+      const record = asRecord(raw);
+      const left = Number(pickValue(record, "left", "Left"));
+      const right = Number(pickValue(record, "right", "Right"));
+      const bottom = Number(pickValue(record, "bottom", "Bottom"));
+      const top = Number(pickValue(record, "top", "Top"));
+      if (![left, right, bottom, top].every((value) => Number.isFinite(value))) return raw;
+      const frame = paperOf(args.paper).frame;
+      const clamped = {
+        left: Math.max(frame.left, left),
+        right: Math.min(frame.right, right),
+        bottom: Math.max(frame.bottom, bottom),
+        top: Math.min(frame.top, top)
+      };
+      if (clamped.left >= clamped.right || clamped.bottom >= clamped.top) {
+        return { ...record, requested: { left, right, bottom, top }, clamped: null, note: "the primitive bounds do not overlap the page frame" };
+      }
+      await callExtension("dmt_EditorControl.zoomToRegion", [
+        clamped.left,
+        clamped.right,
+        clamped.top,
+        clamped.bottom,
+        args.tabId
+      ], timeoutMs);
+      return { ...record, requested: { left, right, bottom, top }, clamped };
+    }
     case "eda_zoom_to_region":
       return await callExtension("dmt_EditorControl.zoomToRegion", [
         Number(args.left),
@@ -2000,24 +2233,98 @@ async function executeTool(name, rawArgs, timeoutMs) {
       const parsed = await parseNetlist(Array.isArray(all) ? all : project, timeoutMs);
       return parsed;
     }
-    case "eda_run_drc":
-      return await callExtension("sch_Drc.check", [args.strict === void 0 ? true : Boolean(args.strict), false, true], timeoutMs);
+    case "eda_run_drc": {
+      const verbose = await callExtension("sch_Drc.check", [
+        args.strict === void 0 ? true : Boolean(args.strict),
+        false,
+        true
+      ], toolTimeout(args, timeoutMs));
+      if (Array.isArray(verbose)) {
+        return {
+          ok: verbose.length === 0,
+          count: verbose.length,
+          entries: verbose.map((entry) => {
+            const record = asRecord(entry);
+            return {
+              type: pickValue(record, "Type", "type", "Level", "level") ?? null,
+              message: pickValue(record, "Message", "message", "Error", "error", "Description", "description") ?? null,
+              primitiveId: pickValue(record, "PrimitiveId", "primitiveId") ?? null,
+              x: pickValue(record, "X", "x") ?? null,
+              y: pickValue(record, "Y", "y") ?? null,
+              raw: entry
+            };
+          }),
+          hint: 'Field names vary by EDA build; "raw" keeps the untouched record.'
+        };
+      }
+      return { ok: Boolean(verbose), count: null, entries: [], raw: verbose };
+    }
     case "eda_auto_layout":
-      return await callExtension("sch_Document.autoLayout", [Array.isArray(args.uuids) ? { uuids: args.uuids.map(String) } : void 0], timeoutMs);
-    case "eda_auto_route":
-      return await callExtension("sch_Document.autoRouting", [Array.isArray(args.uuids) ? { uuids: args.uuids.map(String) } : void 0], timeoutMs);
-    case "eda_export_netlist":
-      return await callExtension("sch_ManufactureData.getNetlistFile", [void 0, typeof args.type === "string" && args.type !== "" ? args.type : "JLCEDA"], timeoutMs);
-    case "eda_export_bom":
-      return await callExtension("sch_ManufactureData.getBomFile", [void 0, args.format === "xlsx" ? "xlsx" : "csv"], timeoutMs);
-    case "eda_delete_primitive":
-      return await callExtension(primitiveKindToClass(String(args.kind)) + ".delete", [String(args.primitiveId)], timeoutMs);
+    case "eda_auto_route": {
+      if (ALLOW_AUTO_LAYOUT !== true && args.force !== true) {
+        throw new Error(
+          name + " is disabled by policy (settings allowAutoLayoutRouting=false, env DSH_EDA_ALLOW_AUTO_LAYOUT). Do NOT retry with force:true unless the user explicitly asked for automatic layout/routing.",
+          "",
+          "Do this instead, in order:",
+          "1. eda_get_active_document \u2014 make sure a schematic page is active (eda_open_document if not).",
+          "2. eda_get_page_info \u2014 read the A4 frame and the safe areas before placing anything.",
+          "3. eda_get_components \u2014 see what is already placed and where (x/y + bounding boxes) to avoid overlap.",
+          "4. Place or move parts yourself on a 10-unit grid: eda_place_component for new ones, eda_move_component (keeps designator/value) to re-grid existing ones. Signal flow left to right, power rails on top, ground at the bottom, >=20 units between symbols for wires and labels.",
+          "5. Connect with eda_draw_wire for local nets; for anything that spans the sheet use eda_place_net_port or a net label (a wire net name is overridden by connectivity once an endpoint touches a pin).",
+          "6. Verify: eda_export_netlist (every net should have >=2 endpoints) and eda_run_drc (per-problem entries). For a visual check export the canvas to an image and look at it, rather than letting EDA rearrange the sheet.",
+          "7. Call eda_workflow_guide for the full standard."
+        );
+      }
+      const payload = Array.isArray(args.uuids) ? { uuids: args.uuids.map(String) } : void 0;
+      return await callExtension(name === "eda_auto_layout" ? "sch_Document.autoLayout" : "sch_Document.autoRouting", [payload], toolTimeout(args, timeoutMs));
+    }
+    case "eda_export_netlist": {
+      const payload = await callExtension("sch_ManufactureData.getNetlistFile", [
+        void 0,
+        typeof args.type === "string" && args.type !== "" ? args.type : void 0
+      ], toolTimeout(args, timeoutMs));
+      const text = typeof payload === "string" ? payload : payload !== null && typeof payload === "object" && typeof payload.text === "string" ? payload.text : void 0;
+      if (text === void 0) return { parsed: false, netlist: payload ?? null };
+      if (args.format === "text") return { parsed: false, netlistText: text, bytes: text.length };
+      try {
+        return { parsed: true, bytes: text.length, netlist: JSON.parse(text) };
+      } catch {
+        return { parsed: false, bytes: text.length, netlistText: text };
+      }
+    }
+    case "eda_export_bom": {
+      const format = args.format === "xlsx" ? "xlsx" : "csv";
+      const payload = await callExtension("sch_ManufactureData.getBomFile", [void 0, format], toolTimeout(args, timeoutMs));
+      if (format === "xlsx") return payload;
+      const raw = typeof payload === "string" ? payload : payload !== null && typeof payload === "object" && typeof payload.text === "string" ? payload.text : "";
+      return { format, bom: decodeTextPayload(raw) };
+    }
+    case "eda_delete_primitive": {
+      const kind = String(args.kind);
+      const className = kind === "netport" || kind === "netflag" || kind === "netlabel" ? "sch_PrimitiveAttribute" : primitiveKindToClass(kind);
+      return await callExtension(className + ".delete", [String(args.primitiveId)], timeoutMs);
+    }
+    case "eda_move_component":
+      return await callExtension("sch_PrimitiveComponent.modify", [String(args.primitiveId), {
+        x: args.x === void 0 ? void 0 : Number(args.x),
+        y: args.y === void 0 ? void 0 : Number(args.y),
+        rotation: args.rotation === void 0 ? void 0 : Number(args.rotation),
+        mirror: args.mirror === void 0 ? void 0 : Boolean(args.mirror)
+      }], timeoutMs);
+    case "eda_list_api_methods":
+      return { count: ALLOWED_API.size, methods: [...ALLOWED_API].sort() };
+    case "eda_workflow_guide":
+      return { summary: WORKFLOW_SUMMARY, guide: WORKFLOW_GUIDE, autoLayoutAllowed: ALLOW_AUTO_LAYOUT };
+    case "eda_workflow_guide":
+      return { summary: WORKFLOW_SUMMARY, guide: WORKFLOW_GUIDE, autoLayoutAllowed: ALLOW_AUTO_LAYOUT };
     case "eda_create_board":
       return await callExtension("dmt_Board.createBoard", [args.schematicUuid, args.pcbUuid], timeoutMs);
     case "eda_api_call": {
       if (!ALLOW_RAW_API) throw new Error("eda_api_call is disabled by settings (allowRawApi=false)");
       const method = String(args.method ?? "");
-      if (!ALLOWED_API.has(method)) throw new Error("API method not allowed: " + method);
+      if (!ALLOWED_API.has(method)) {
+        throw new Error("API method not allowed: " + method + ". The extension only accepts its allow-list (" + ALLOWED_API.size + " methods): call eda_list_api_methods to get it. Common schematic helpers such as sch_PrimitiveComponent.getAllPinsByPrimitiveId and sch_PrimitivePin.get are already wrapped by eda_get_pins.");
+      }
       return await callExtension(method, Array.isArray(args.args) ? args.args : [], timeoutMs);
     }
     case "pcb_get_components": {
@@ -2196,17 +2503,17 @@ async function executeTool(name, rawArgs, timeoutMs) {
     case "pcb_save_document":
       return await callExtension("pcb_Document.save", [], timeoutMs);
     case "pcb_import_changes": {
-      const uuid = args.schematicUuid === void 0 || args.schematicUuid === null ? null : String(args.schematicUuid);
+      const uuid2 = args.schematicUuid === void 0 || args.schematicUuid === null ? null : String(args.schematicUuid);
       if (args.wait === true) {
-        return await callExtension("pcb_Document.importChanges", [uuid === null ? void 0 : uuid], toolTimeout(args, timeoutMs));
+        return await callExtension("pcb_Document.importChanges", [uuid2 === null ? void 0 : uuid2], toolTimeout(args, timeoutMs));
       }
       pcbComponentBaseline = await pcbComponentIds(timeoutMs);
       let started;
       try {
-        started = asRecord(await callExtension("dsh.internal.jobStart", ["importChanges", uuid], timeoutMs));
+        started = asRecord(await callExtension("dsh.internal.jobStart", ["importChanges", uuid2], timeoutMs));
       } catch (error) {
         if (!isInternalHelperMissing(error)) throw error;
-        const result2 = await callExtension("pcb_Document.importChanges", [uuid === null ? void 0 : uuid], toolTimeout(args, timeoutMs));
+        const result2 = await callExtension("pcb_Document.importChanges", [uuid2 === null ? void 0 : uuid2], toolTimeout(args, timeoutMs));
         const after = await pcbComponentIds(timeoutMs);
         return {
           triggered: true,