@huaqiu/dsh-tool-quote 0.5.4 → 0.5.5

package/lib/index.mjs

@@ -20,6 +20,10 @@ function hasHost(config) {
 function quoteUrlOf(config, kind) {
 	return `${(config.hqEdgeBaseUrl ?? "").replace(/\/+$/, "")}/${(config.quotePathPrefix ?? "/api/v1/quote").replace(/^\/+|\/+$/g, "")}/${kind}`;
 }
+/** Build the absolute URL for a place-order trigger route ("pcb" | "smt"). */
+function placeOrderUrlOf(config, kind) {
+	return `${(config.hqEdgeBaseUrl ?? "").replace(/\/+$/, "")}/${(config.quotePathPrefix ?? "/api/v1/quote").replace(/^\/+|\/+$/g, "")}/place/${kind}`;
+}
 //#endregion
 //#region src/client.ts
 /** Semantic failure of a quote request, mirroring hq-edge's envelope kinds. */
@@ -96,9 +100,43 @@ function createQuoteToolClient(config, deps = {}) {
 			throw new QuoteToolError("INTERNAL", `quote request failed: ${String(err)}`, 500);
 		}
 	};
+	const place = async (kind, payload, options = {}) => {
+		const base = resolveBaseUrl();
+		const url = placeOrderUrlOf({
+			...config,
+			hqEdgeBaseUrl: base
+		}, kind);
+		const signal = resolveSignal(config.requestTimeoutMs ?? 0, options.signal);
+		try {
+			const response = await fetchImpl(url, {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify(payload),
+				signal
+			});
+			const text = await response.text();
+			let body;
+			try {
+				body = text.length > 0 ? JSON.parse(text) : null;
+			} catch {
+				body = null;
+			}
+			if (!response.ok) {
+				const envelope = body && typeof body === "object" && !Array.isArray(body) ? body : {};
+				const rawKind = typeof envelope.error === "string" ? envelope.error : statusToKind(response.status);
+				throw new QuoteToolError(rawKind === "EDA_HOST_NOT_READY" ? "FAILED_PRECONDITION" : rawKind, typeof envelope.detail === "string" ? envelope.detail : "place order request failed", response.status, typeof envelope.detail === "string" ? envelope.detail : void 0, typeof envelope.code === "string" || typeof envelope.code === "number" ? envelope.code : void 0);
+			}
+			return body;
+		} catch (err) {
+			if (err instanceof QuoteToolError) throw err;
+			if (isAbortError(err)) throw new QuoteToolError("DEADLINE_EXCEEDED", "place order request timed out", 504);
+			throw new QuoteToolError("INTERNAL", `place order request failed: ${String(err)}`, 500);
+		}
+	};
 	return {
 		quotePcb: (payload, options) => request("pcb", payload, options),
-		quoteSmt: (payload, options) => request("smt", payload, options)
+		quoteSmt: (payload, options) => request("smt", payload, options),
+		placeOrder: (kind, payload, options) => place(kind, payload, options)
 	};
 }
 //#endregion
@@ -169,167 +207,212 @@ function createQuoteTools(env) {
 			description: "Include the bounded raw upstream payload for diagnostics (default false)."
 		}
 	};
-	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, 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"
-				],
-				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",
-				description: "Panel quantity (boards per panel), >= 1. Default 5."
-			},
-			blayer: {
-				type: "integer",
-				description: "PCB layer count, 1-64. Default 4."
+	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, 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"
+					],
+					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",
+					description: "Panel quantity (boards per panel), >= 1. Default 5."
+				},
+				blayer: {
+					type: "integer",
+					description: "PCB layer count, 1-64. Default 4."
+				},
+				blength: {
+					type: "number",
+					description: "Board length in mm, > 0 (canonical mm; converted to cm on the wire)."
+				},
+				bwidth: {
+					type: "number",
+					description: "Board width in mm, > 0."
+				},
+				board_tg: {
+					type: "string",
+					enum: [
+						"tg130",
+						"tg150",
+						"tg170"
+					],
+					description: "Glass transition temperature grade (4+ layers only)."
+				},
+				color: {
+					type: "string",
+					enum: [
+						"green",
+						"red",
+						"yellow",
+						"blue",
+						"white",
+						"black",
+						"matte_black"
+					],
+					description: "Solder mask color. Default green."
+				},
+				cover: {
+					type: "string",
+					enum: [
+						"covered",
+						"exposed",
+						"solder_mask_plug",
+						"non_conductive_fill"
+					],
+					description: "Via process (tenting / open / solder-mask-plug / non-conductive fill). Default covered."
+				},
+				spray: {
+					type: "string",
+					enum: [
+						"hasl_lead",
+						"hasl_lf",
+						"enig",
+						"osp"
+					],
+					description: "Surface finish. Default HASL (lead)."
+				},
+				...edaFlagProps
 			},
-			blength: {
-				type: "number",
-				description: "Board length in mm, > 0 (canonical mm; converted to cm on the wire)."
+			output: {
+				schema: { type: "json" },
+				render: renderJson
 			},
-			bwidth: {
-				type: "number",
-				description: "Board width in mm, > 0."
-			},
-			board_tg: {
-				type: "string",
-				enum: [
-					"tg130",
-					"tg150",
-					"tg170"
-				],
-				description: "Glass transition temperature grade (4+ layers only)."
-			},
-			color: {
-				type: "string",
-				enum: [
-					"green",
-					"red",
-					"yellow",
-					"blue",
-					"white",
-					"black",
-					"matte_black"
-				],
-				description: "Solder mask color. Default green."
-			},
-			cover: {
-				type: "string",
-				enum: [
-					"covered",
-					"exposed",
-					"solder_mask_plug",
-					"non_conductive_fill"
-				],
-				description: "Via process (tenting / open / solder-mask-plug / non-conductive fill). Default covered."
+			async execute(args, exec) {
+				const a = args;
+				const payload = {
+					region: a.region,
+					form: pcbFormOf(a),
+					eda: edaOf(a),
+					includeRawResponse: a.include_raw_response === true
+				};
+				return asJson(await client.quotePcb(payload, { signal: exec.signal }));
+			}
+		}),
+		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. 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"
+					],
+					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",
+					description: "Assembly quantity as string (e.g. \"5\"). Default \"5\"."
+				},
+				buy_bom: {
+					type: "string",
+					enum: [
+						"hq_select",
+						"user_upload",
+						"online_match"
+					],
+					description: "BOM parts source: hq_select = Huaqiu agent purchasing (default), user_upload = customer parts, online_match = online parts matching."
+				},
+				single_or_double_technique: {
+					type: "string",
+					enum: ["single", "double"],
+					description: "Single-side or double-side assembly. Default double."
+				},
+				pcb_blayer: {
+					type: "integer",
+					description: "Embedded PCB layer count, 1-64 (assembly quote depends on the PCB order). Default 4."
+				},
+				pcb_blength: {
+					type: "number",
+					description: "Embedded PCB board length in mm, > 0."
+				},
+				pcb_bwidth: {
+					type: "number",
+					description: "Embedded PCB board width in mm, > 0."
+				},
+				pcb_bcount: {
+					type: "integer",
+					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
 			},
-			spray: {
-				type: "string",
-				enum: [
-					"hasl_lead",
-					"hasl_lf",
-					"enig",
-					"osp"
-				],
-				description: "Surface finish. Default HASL (lead)."
+			output: {
+				schema: { type: "json" },
+				render: renderJson
 			},
-			...edaFlagProps
-		},
-		output: {
-			schema: { type: "json" },
-			render: renderJson
-		},
-		async execute(args, exec) {
-			const a = args;
-			const payload = {
-				region: a.region,
-				form: pcbFormOf(a),
-				eda: edaOf(a),
-				includeRawResponse: a.include_raw_response === true
-			};
-			return asJson(await client.quotePcb(payload, { signal: exec.signal }));
-		}
-	}), 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. 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: {
+			async execute(args, exec) {
+				const a = args;
+				const form = {};
+				if (a.number !== void 0) form.number = a.number;
+				if (a.buy_bom !== void 0) form.buyBom = a.buy_bom;
+				if (a.single_or_double_technique !== void 0) form.singleOrDoubleTechnique = a.single_or_double_technique;
+				const pcb = {};
+				if (a.pcb_blayer !== void 0) pcb.blayer = a.pcb_blayer;
+				if (a.pcb_blength !== void 0) pcb.blength = a.pcb_blength;
+				if (a.pcb_bwidth !== void 0) pcb.bwidth = a.pcb_bwidth;
+				if (a.pcb_bcount !== void 0) pcb.bcount = a.pcb_bcount;
+				if (Object.keys(pcb).length > 0) form.pcbOrder = pcb;
+				const payload = {
+					region: a.region,
+					form: Object.keys(form).length > 0 ? form : void 0,
+					eda: edaOf(a),
+					includeRawResponse: a.include_raw_response === true
+				};
+				return asJson(await client.quoteSmt(payload, { signal: exec.signal }));
+			}
+		}),
+		defineTool({
+			name: "place_pcb_order",
+			description: "Trigger the EDA host's PCB place-order workflow (KiCad ACTIONS::placeOrderForPCB). The host validates the Huaqiu login (opens its login dialog first if needed), prepares the order artifacts (gerber/drill/bom/zip) from the currently open PCB board, uploads them and opens the place-order page in the editor's own dialog. Use when the user asks to \"下单\", \"place order\", \"提交打样/PCB订单\", or after a quote_pcb has been reviewed and the user wants to actually order. Returns { orderUrl, status, message } — status \"launched\" means the order dialog was opened in the editor; the user completes the order there. NOT a quote — this creates/enters the order flow. Preconditions: a PCB editor with a board open in the EDA host (otherwise FAILED_PRECONDITION), and a logged-in Huaqiu account (the host prompts login itself). The region is auto-detected by hq-edge from the trusted request context — do NOT force a region unless the user explicitly asks.",
+			parameters: { region: {
 				type: "string",
 				enum: [
 					"cn",
 					"eu_us",
 					"jp"
 				],
-				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 ￥)."
+				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."
+			} },
+			output: {
+				schema: { type: "json" },
+				render: renderJson
 			},
-			number: {
-				type: "string",
-				description: "Assembly quantity as string (e.g. \"5\"). Default \"5\"."
-			},
-			buy_bom: {
+			async execute(args, exec) {
+				const payload = { region: args.region };
+				return asJson(await client.placeOrder("pcb", payload, { signal: exec.signal }));
+			}
+		}),
+		defineTool({
+			name: "place_smt_order",
+			description: "Trigger the EDA host's SMT assembly place-order workflow (KiCad ACTIONS::placeOrderForSMT). Same flow as place_pcb_order but for assembly: the host validates login, prepares the assembly order artifacts (board zip + BOM + component positions) from the currently open PCB, uploads them and opens the place-order page in the editor's own dialog. Use when the user wants to \"贴片下单\", \"SMT 下单\", \"place SMT order\", or after quote_smt has been reviewed. Returns { orderUrl, status, message }. Preconditions: a PCB editor with a board open in the EDA host, and a logged-in Huaqiu account (the host prompts login itself). The region is auto-detected by hq-edge — do NOT force a region unless the user explicitly asks.",
+			parameters: { region: {
 				type: "string",
 				enum: [
-					"hq_select",
-					"user_upload",
-					"online_match"
+					"cn",
+					"eu_us",
+					"jp"
 				],
-				description: "BOM parts source: hq_select = Huaqiu agent purchasing (default), user_upload = customer parts, online_match = online parts matching."
-			},
-			single_or_double_technique: {
-				type: "string",
-				enum: ["single", "double"],
-				description: "Single-side or double-side assembly. Default double."
-			},
-			pcb_blayer: {
-				type: "integer",
-				description: "Embedded PCB layer count, 1-64 (assembly quote depends on the PCB order). Default 4."
-			},
-			pcb_blength: {
-				type: "number",
-				description: "Embedded PCB board length in mm, > 0."
-			},
-			pcb_bwidth: {
-				type: "number",
-				description: "Embedded PCB board width in mm, > 0."
-			},
-			pcb_bcount: {
-				type: "integer",
-				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)."
+				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."
+			} },
+			output: {
+				schema: { type: "json" },
+				render: renderJson
 			},
-			...edaFlagProps
-		},
-		output: {
-			schema: { type: "json" },
-			render: renderJson
-		},
-		async execute(args, exec) {
-			const a = args;
-			const form = {};
-			if (a.number !== void 0) form.number = a.number;
-			if (a.buy_bom !== void 0) form.buyBom = a.buy_bom;
-			if (a.single_or_double_technique !== void 0) form.singleOrDoubleTechnique = a.single_or_double_technique;
-			const pcb = {};
-			if (a.pcb_blayer !== void 0) pcb.blayer = a.pcb_blayer;
-			if (a.pcb_blength !== void 0) pcb.blength = a.pcb_blength;
-			if (a.pcb_bwidth !== void 0) pcb.bwidth = a.pcb_bwidth;
-			if (a.pcb_bcount !== void 0) pcb.bcount = a.pcb_bcount;
-			if (Object.keys(pcb).length > 0) form.pcbOrder = pcb;
-			const payload = {
-				region: a.region,
-				form: Object.keys(form).length > 0 ? form : void 0,
-				eda: edaOf(a),
-				includeRawResponse: a.include_raw_response === true
-			};
-			return asJson(await client.quoteSmt(payload, { signal: exec.signal }));
-		}
-	})];
+			async execute(args, exec) {
+				const payload = { region: args.region };
+				return asJson(await client.placeOrder("smt", payload, { signal: exec.signal }));
+			}
+		})
+	];
 }
 //#endregion
 //#region src/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@huaqiu/dsh-tool-quote",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "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.4"
+    "@huaqiu/dsh-plugin-log": "0.5.5"
   },
   "files": [
     "lib",

package/src/client.ts

@@ -19,7 +19,7 @@
  */
 
 import type { QuoteToolConfig } from './config.js'
-import { quoteUrlOf } from './config.js'
+import { quoteUrlOf, placeOrderUrlOf } from './config.js'
 
 export type QuoteKind = 'pcb' | 'smt'
 
@@ -73,6 +73,12 @@ function resolveSignal(deadlineMs: number, caller?: AbortSignal): AbortSignal |
 export interface QuoteToolClient {
   quotePcb(payload: unknown, options?: QuoteToolRequestOptions): Promise<unknown>
   quoteSmt(payload: unknown, options?: QuoteToolRequestOptions): Promise<unknown>
+  /**
+   * Trigger the EDA host's place-order workflow (hq-edge
+   * POST /api/v1/quote/place/:kind → QuoteService.PlacePcbOrder / PlaceSmtOrder
+   * → KiCad ACTIONS::placeOrderForPCB / placeOrderForSMT). `kind` is 'pcb' | 'smt'.
+   */
+  placeOrder(kind: 'pcb' | 'smt', payload: unknown, options?: QuoteToolRequestOptions): Promise<unknown>
 }
 
 export function createQuoteToolClient(
@@ -147,8 +153,67 @@ export function createQuoteToolClient(
     }
   }
 
+  const place = async (
+    kind: 'pcb' | 'smt',
+    payload: unknown,
+    options: QuoteToolRequestOptions = {},
+  ): Promise<unknown> => {
+    const base = resolveBaseUrl()
+    const url = placeOrderUrlOf({ ...config, hqEdgeBaseUrl: base }, kind)
+    const signal = resolveSignal(config.requestTimeoutMs ?? 0, options.signal)
+    try {
+      const response = await fetchImpl(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(payload),
+        signal,
+      })
+      const text = await response.text()
+      let body: unknown
+      try {
+        body = text.length > 0 ? JSON.parse(text) : null
+      } catch {
+        body = null
+      }
+      if (!response.ok) {
+        const envelope =
+          body && typeof body === 'object' && !Array.isArray(body)
+            ? (body as Record<string, unknown>)
+            : {}
+        // Normalize the host envelope into the semantic kinds DSH agents
+        // branch on: EDA_HOST_NOT_READY (no PCB editor / not ready) maps to
+        // FAILED_PRECONDITION, anything else keeps its host kind.
+        const rawKind =
+          typeof envelope.error === 'string' ? envelope.error : statusToKind(response.status)
+        const kindFromEnvelope =
+          rawKind === 'EDA_HOST_NOT_READY' ? 'FAILED_PRECONDITION' : rawKind
+        throw new QuoteToolError(
+          kindFromEnvelope,
+          typeof envelope.detail === 'string' ? envelope.detail : 'place order request failed',
+          response.status,
+          typeof envelope.detail === 'string' ? envelope.detail : undefined,
+          typeof envelope.code === 'string' || typeof envelope.code === 'number'
+            ? envelope.code
+            : undefined,
+        )
+      }
+      return body
+    } catch (err) {
+      if (err instanceof QuoteToolError) throw err
+      if (isAbortError(err)) {
+        throw new QuoteToolError(
+          'DEADLINE_EXCEEDED',
+          'place order request timed out',
+          504,
+        )
+      }
+      throw new QuoteToolError('INTERNAL', `place order request failed: ${String(err)}`, 500)
+    }
+  }
+
   return {
     quotePcb: (payload, options) => request('pcb', payload, options),
     quoteSmt: (payload, options) => request('smt', payload, options),
+    placeOrder: (kind, payload, options) => place(kind, payload, options),
   }
 }

package/src/config.ts

@@ -55,3 +55,13 @@ export function quoteUrlOf(config: QuoteToolConfig, kind: 'pcb' | 'smt'): string
   )
   return `${base}/${prefix}/${kind}`
 }
+
+/** Build the absolute URL for a place-order trigger route ("pcb" | "smt"). */
+export function placeOrderUrlOf(config: QuoteToolConfig, kind: 'pcb' | 'smt'): string {
+  const base = (config.hqEdgeBaseUrl ?? '').replace(/\/+$/, '')
+  const prefix = (config.quotePathPrefix ?? DEFAULT_QUOTE_PATH_PREFIX).replace(
+    /^\/+|\/+$/g,
+    '',
+  )
+  return `${base}/${prefix}/place/${kind}`
+}

package/src/tools.ts

@@ -253,5 +253,66 @@ export function createQuoteTools(env: QuoteToolEnv) {
         return asJson(result)
       },
     }),
+    defineTool({
+      name: 'place_pcb_order',
+      description:
+        'Trigger the EDA host\'s PCB place-order workflow (KiCad ACTIONS::placeOrderForPCB). ' +
+        'The host validates the Huaqiu login (opens its login dialog first if needed), prepares ' +
+        'the order artifacts (gerber/drill/bom/zip) from the currently open PCB board, uploads ' +
+        'them and opens the place-order page in the editor\'s own dialog. Use when the user asks ' +
+        'to "下单", "place order", "提交打样/PCB订单", or after a quote_pcb has been reviewed and the ' +
+        'user wants to actually order. Returns { orderUrl, status, message } — status "launched" ' +
+        'means the order dialog was opened in the editor; the user completes the order there. ' +
+        'NOT a quote — this creates/enters the order flow. Preconditions: a PCB editor with a ' +
+        'board open in the EDA host (otherwise FAILED_PRECONDITION), and a logged-in Huaqiu ' +
+        'account (the host prompts login itself). The region is auto-detected by hq-edge from the ' +
+        'trusted request context — do NOT force a region unless the user explicitly asks.',
+      parameters: {
+        region: {
+          type: 'string',
+          enum: ['cn', 'eu_us', 'jp'],
+          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.',
+        },
+      },
+      output: { schema: { type: 'json' }, render: renderJson },
+      async execute(args: unknown, exec: ToolExecLike): Promise<Json> {
+        const a = args as Record<string, unknown>
+        const payload = { region: a.region }
+        const result = await client.placeOrder('pcb', payload, { signal: exec.signal })
+        return asJson(result)
+      },
+    }),
+    defineTool({
+      name: 'place_smt_order',
+      description:
+        'Trigger the EDA host\'s SMT assembly place-order workflow (KiCad ACTIONS::placeOrderForSMT). ' +
+        'Same flow as place_pcb_order but for assembly: the host validates login, prepares the ' +
+        'assembly order artifacts (board zip + BOM + component positions) from the currently open ' +
+        'PCB, uploads them and opens the place-order page in the editor\'s own dialog. Use when the ' +
+        'user wants to "贴片下单", "SMT 下单", "place SMT order", or after quote_smt has been reviewed. ' +
+        'Returns { orderUrl, status, message }. Preconditions: a PCB editor with a board open in the ' +
+        'EDA host, and a logged-in Huaqiu account (the host prompts login itself). The region is ' +
+        'auto-detected by hq-edge — do NOT force a region unless the user explicitly asks.',
+      parameters: {
+        region: {
+          type: 'string',
+          enum: ['cn', 'eu_us', 'jp'],
+          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.',
+        },
+      },
+      output: { schema: { type: 'json' }, render: renderJson },
+      async execute(args: unknown, exec: ToolExecLike): Promise<Json> {
+        const a = args as Record<string, unknown>
+        const payload = { region: a.region }
+        const result = await client.placeOrder('smt', payload, { signal: exec.signal })
+        return asJson(result)
+      },
+    }),
   ]
 }