@huaqiu/dsh-tool-quote 0.5.3 → 0.5.4

package/lib/index.mjs

@@ -171,7 +171,7 @@ function createQuoteTools(env) {
 	};
 	return [defineTool({
 		name: "quote_pcb",
-		description: "Get a real-time PCB fabrication price quote (multi-layer, panel pricing, delivery options) for the requested region through Huaqiu/NextPCB. Use when the user asks how much a PCB would cost, \"报价\", \"价格\", delivery time estimates, or comparing fab options. Returns the itemized price breakdown, total price, and delivery alternatives (name + build time in days + total price) with currency symbol (¥ CN / ￥ intl). When derive_board_size / derive_board_stackup is set, the response also carries the effective quote form: EDA-extracted board facts (length/width from the board outline, layer count + thickness from the stack-up in KiCad) merged with the caller overrides — plus server defaults applied on the wire (e.g. bcount default 5). Inspect \"form\" in the result, adjust any parameter the user wants to change (e.g. color, blayer, board_tg), and re-query with the corrected form rather than guessing values. Progressive usage: quote_pcb for PCB fabrication, quote_smt for assembly, then the user places the order in the EDA host. This is a quote-only query — no order is created.",
+		description: "Get a real-time PCB fabrication price quote (multi-layer, panel pricing, delivery options) for the requested region through Huaqiu/NextPCB. Use when the user asks how much a PCB would cost, \"报价\", \"价格\", delivery time estimates, or comparing fab options. Returns the itemized price breakdown, total price, and delivery alternatives (name + build time in days + total price) with currency symbol (¥ CN / ￥ intl). When derive_board_size / derive_board_stackup is set, the response also carries the effective quote form: EDA-extracted board facts (length/width from the board outline, layer count + thickness from the stack-up in KiCad) merged with the caller overrides — plus server defaults applied on the wire (e.g. bcount default 5, endpoint-required pbnum=1 / insidecopper). Inspect \"form\" in the result, adjust any parameter the user wants to change (e.g. color, blayer, board_tg), and re-query with the corrected form rather than guessing values. Progressive usage: quote_pcb for PCB fabrication, quote_smt for assembly, then the user places the order in the EDA host. This is a quote-only query — no order is created. All regions are anonymous-queryable (no login required). The pricing region is auto-detected by hq-edge from the trusted request context (CN / JP / INTERNATIONAL) — do NOT force a region unless the user explicitly asks for one.",
 		parameters: {
 			region: {
 				type: "string",
@@ -180,8 +180,7 @@ function createQuoteTools(env) {
 					"eu_us",
 					"jp"
 				],
-				required: true,
-				description: "Pricing region. \"cn\" = Huaqiu China (eda.cn, ¥), \"eu_us\" = NextPCB EU/US, \"jp\" = NextPCB Japan (both ￥)."
+				description: "Optional explicit override. When omitted, hq-edge auto-detects the pricing region from the trusted request context (CN / JP / INTERNATIONAL). \"cn\" = Huaqiu China (eda.cn, ¥), \"eu_us\" = NextPCB EU/US, \"jp\" = NextPCB Japan (both ￥)."
 			},
 			bcount: {
 				type: "integer",
@@ -259,7 +258,7 @@ function createQuoteTools(env) {
 		}
 	}), defineTool({
 		name: "quote_smt",
-		description: "Get a real-time SMT assembly price quote (single/double side, stencil, X-ray, conformal coating, Huaqiu agent part purchasing) for the requested region through Huaqiu/NextPCB. Use when the user asks about assembly costs, \"贴片价格\", \"SMT 报价\", \"焊接费用\", or delivery time for assembly. Embeds the PCB order (layers/size/quantity) used for the assembly quote. Returns the normalized price with SMT fee detail (no-tax, total, tax) and currency symbol. When derive_board_size / derive_board_stackup is set, the response carries the effective form: EDA-extracted board facts (panel size, embedded PCB length/width/layers/thickness) merged with the caller overrides — inspect \"form\" and re-query with corrected parameters instead of guessing. Quote-only — no order is created.",
+		description: "Get a real-time SMT assembly price quote (single/double side, stencil, X-ray, conformal coating, Huaqiu agent part purchasing) for the requested region through Huaqiu/NextPCB. Use when the user asks about assembly costs, \"贴片价格\", \"SMT 报价\", \"焊接费用\", or delivery time for assembly. Embeds the PCB order (layers/size/quantity) used for the assembly quote. Returns the normalized price with SMT fee detail (no-tax, total, tax) and currency symbol. When derive_board_size / derive_board_stackup is set, the response carries the effective form: EDA-extracted board facts (panel size, embedded PCB length/width/layers/thickness) merged with the caller overrides — inspect \"form\" and re-query with corrected parameters instead of guessing. Quote-only — no order is created. The pricing region is auto-detected by hq-edge from the trusted request context (CN / JP / INTERNATIONAL) — do NOT force a region unless the user explicitly asks.",
 		parameters: {
 			region: {
 				type: "string",
@@ -268,8 +267,7 @@ function createQuoteTools(env) {
 					"eu_us",
 					"jp"
 				],
-				required: true,
-				description: "Pricing region. \"cn\" = Huaqiu China (eda.cn, ¥), \"eu_us\" = NextPCB EU/US, \"jp\" = NextPCB Japan (both ￥)."
+				description: "Optional explicit override. When omitted, hq-edge auto-detects the pricing region from the trusted request context (CN / JP / INTERNATIONAL). \"cn\" = Huaqiu China (eda.cn, ¥), \"eu_us\" = NextPCB EU/US, \"jp\" = NextPCB Japan (both ￥)."
 			},
 			number: {
 				type: "string",
@@ -303,7 +301,7 @@ function createQuoteTools(env) {
 			},
 			pcb_bcount: {
 				type: "integer",
-				description: "Embedded PCB panel quantity, >= 1. Default 5."
+				description: "Embedded PCB panel quantity, >= 1. Default 5. NOTE: the embedded board size (pcb_blength/pcb_bwidth) is also used as the assembly panel size (panel = single board) when no explicit panel size is given — the Intl SMT endpoint rejects the request otherwise (\"pcb_width can not empty\", response_code 1003)."
 			},
 			...edaFlagProps
 		},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@huaqiu/dsh-tool-quote",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "type": "module",
   "main": "./lib/index.mjs",
   "types": "./lib/index.d.mts",
@@ -22,7 +22,7 @@
     "@deepseek-ai/dsh-tools": "^0.1.0-rc.0"
   },
   "dependencies": {
-    "@huaqiu/dsh-plugin-log": "0.5.3"
+    "@huaqiu/dsh-plugin-log": "0.5.4"
   },
   "files": [
     "lib",

package/src/tools.ts

@@ -100,19 +100,22 @@ export function createQuoteTools(env: QuoteToolEnv) {
         'When derive_board_size / derive_board_stackup is set, the response also carries the ' +
         'effective quote form: EDA-extracted board facts (length/width from the board outline, ' +
         'layer count + thickness from the stack-up in KiCad) merged with the caller overrides — ' +
-        'plus server defaults applied on the wire (e.g. bcount default 5). Inspect "form" in the ' +
-        'result, adjust any parameter the user wants to change (e.g. color, blayer, board_tg), and ' +
-        're-query with the corrected form rather than guessing values. Progressive usage: quote_pcb ' +
-        'for PCB fabrication, quote_smt for assembly, then the user places the order in the EDA ' +
-        'host. This is a quote-only query — no order is created.',
+        'plus server defaults applied on the wire (e.g. bcount default 5, endpoint-required ' +
+        'pbnum=1 / insidecopper). Inspect "form" in the result, adjust any parameter the user ' +
+        'wants to change (e.g. color, blayer, board_tg), and re-query with the corrected form ' +
+        'rather than guessing values. Progressive usage: quote_pcb for PCB fabrication, quote_smt ' +
+        'for assembly, then the user places the order in the EDA host. This is a quote-only ' +
+        'query — no order is created. All regions are anonymous-queryable (no login required). ' +
+        'The pricing region is auto-detected by hq-edge from the trusted request context (CN / JP / ' +
+        'INTERNATIONAL) — do NOT force a region unless the user explicitly asks for one.',
       parameters: {
         region: {
           type: 'string',
           enum: ['cn', 'eu_us', 'jp'],
-          required: true,
           description:
-            'Pricing region. "cn" = Huaqiu China (eda.cn, ¥), "eu_us" = NextPCB EU/US, ' +
-            '"jp" = NextPCB Japan (both ￥).',
+            'Optional explicit override. When omitted, hq-edge auto-detects the pricing region from ' +
+            'the trusted request context (CN / JP / INTERNATIONAL). "cn" = Huaqiu China (eda.cn, ¥), ' +
+            '"eu_us" = NextPCB EU/US, "jp" = NextPCB Japan (both ￥).',
         },
         bcount: {
           type: 'integer',
@@ -177,15 +180,16 @@ export function createQuoteTools(env: QuoteToolEnv) {
         'derive_board_stackup is set, the response carries the effective form: EDA-extracted board facts ' +
         '(panel size, embedded PCB length/width/layers/thickness) merged with the caller overrides — ' +
         'inspect "form" and re-query with corrected parameters instead of guessing. Quote-only — no ' +
-        'order is created.',
+        'order is created. The pricing region is auto-detected by hq-edge from the trusted request ' +
+        'context (CN / JP / INTERNATIONAL) — do NOT force a region unless the user explicitly asks.',
       parameters: {
         region: {
           type: 'string',
           enum: ['cn', 'eu_us', 'jp'],
-          required: true,
           description:
-            'Pricing region. "cn" = Huaqiu China (eda.cn, ¥), "eu_us" = NextPCB EU/US, ' +
-            '"jp" = NextPCB Japan (both ￥).',
+            'Optional explicit override. When omitted, hq-edge auto-detects the pricing region from ' +
+            'the trusted request context (CN / JP / INTERNATIONAL). "cn" = Huaqiu China (eda.cn, ¥), ' +
+            '"eu_us" = NextPCB EU/US, "jp" = NextPCB Japan (both ￥).',
         },
         number: {
           type: 'string',
@@ -218,12 +222,15 @@ export function createQuoteTools(env: QuoteToolEnv) {
         },
         pcb_bcount: {
           type: 'integer',
-          description: 'Embedded PCB panel quantity, >= 1. Default 5.',
+          description:
+            'Embedded PCB panel quantity, >= 1. Default 5. NOTE: the embedded board size ' +
+            '(pcb_blength/pcb_bwidth) is also used as the assembly panel size (panel = single ' +
+            'board) when no explicit panel size is given — the Intl SMT endpoint rejects the ' +
+            'request otherwise ("pcb_width can not empty", response_code 1003).',
         },
         ...edaFlagProps,
       },
-      output: { schema: { type: 'json' }, render: renderJson },
-      async execute(args: unknown, exec: ToolExecLike): Promise<Json> {
+      output: { schema: { type: 'json' }, render: renderJson },      async execute(args: unknown, exec: ToolExecLike): Promise<Json> {
         const a = args as Record<string, unknown>
         const form: Record<string, unknown> = {}
         if (a.number !== undefined) form.number = a.number