@huaqiu/dsh-eda-host 0.3.21 → 0.3.22

package/cordis.patch.yml

@@ -1,8 +1,11 @@
 # DSH bundle patch: inserts the Huaqiu EDA host netlist tool plugin.
-# The entry inject must match the node-half module contract (`src/index.ts` —
-# export const inject). The tool's apply() reads the `tools` service; the
-# hq-edge supervisor delivers the base URL as overlay config.
+# The entry `inject` MUST match the node-half module contract (`src/index.ts`
+# `export const inject`): `hqEdge` + `tools`. `hqEdge` is REQUIRED — the
+# edge-bridge (HOST) provides it and its `baseUrl` is the loopback HQ Edge
+# endpoint the netlist tools fetch from (`createNodeHqEdge(upstreamRoot,…)` →
+# `get baseUrl()`). Omitting `hqEdge` from inject makes `apply()`'s
+# `ctx.hqEdge` access throw `cannot get property "hqEdge" without inject`.
 - insert:
     - id: huaqiu-dsh-eda-host
       name: '@huaqiu/dsh-eda-host'
-      inject: ['tools']
+      inject: ['hqEdge', 'tools']

package/lib/index.d.mts

@@ -89,8 +89,23 @@ interface EdaHostClient {
 //#region src/index.d.ts
 /** Plugin id — matches package.json. */
 declare const name = "@huaqiu/dsh-eda-host";
-/** Cordis services this half depends on. */
-declare const inject: readonly ["tools"];
+/**
+ * Cordis services this half depends on.
+ *
+ * `hqEdge` is REQUIRED: the edge-bridge (the HOST) provides the node-side
+ * `hqEdge` service whose `baseUrl` is the loopback HQ Edge endpoint
+ * (`createNodeHqEdge(upstreamRoot, …)` → `get baseUrl()`). Without it the
+ * plugin cannot reach hq-edge at all — by design it cannot work standalone
+ * (the user-confirmed contract is "eda-host cannot work without hqEdge").
+ * Declaring it here is what lets `apply()` read `ctx.hqEdge` without Cordis
+ * throwing `cannot get property "hqEdge" without inject` (its context proxy
+ * walks the fiber tree and throws at the root fiber when the service was
+ * never injected into this plugin's fiber).
+ *
+ * `tools` is the DSH node runtime tool registry used to register the netlist
+ * tools.
+ */
+declare const inject: readonly ["hqEdge", "tools"];
 declare module '@deepseek-ai/cordis' {
   interface Context {
     edaHost: EdaHostClient;
@@ -100,7 +115,16 @@ declare module '@deepseek-ai/cordis' {
      * lazily so this plugin does not hard-depend on the bridge and still works
      * in standalone DSH installs (where the service is absent).
      */
-    hqEdge?: {
+    /**
+     * Provided by the hq-edge `edge-bridge` plugin (the HOST). `baseUrl` is the
+     * loopback HQ Edge endpoint, e.g. "http://localhost:18080". This is a
+     * REQUIRED inject (see `export const inject` above): `apply()` reads
+     * `ctx.hqEdge` to resolve the endpoint, so the service must be present or
+     * Cordis throws `cannot get property "hqEdge" without inject`. When present
+     * but its `baseUrl` is empty, the netlist tools degrade to a clear
+     * FAILED_PRECONDITION rather than throwing at load time.
+     */
+    hqEdge: {
       baseUrl?: string;
     };
   }

package/lib/index.mjs

@@ -164,8 +164,23 @@ function createNetListTools(env) {
 //#region src/index.ts
 /** Plugin id — matches package.json. */
 const name = "@huaqiu/dsh-eda-host";
-/** Cordis services this half depends on. */
-const inject = ["tools"];
+/**
+* Cordis services this half depends on.
+*
+* `hqEdge` is REQUIRED: the edge-bridge (the HOST) provides the node-side
+* `hqEdge` service whose `baseUrl` is the loopback HQ Edge endpoint
+* (`createNodeHqEdge(upstreamRoot, …)` → `get baseUrl()`). Without it the
+* plugin cannot reach hq-edge at all — by design it cannot work standalone
+* (the user-confirmed contract is "eda-host cannot work without hqEdge").
+* Declaring it here is what lets `apply()` read `ctx.hqEdge` without Cordis
+* throwing `cannot get property "hqEdge" without inject` (its context proxy
+* walks the fiber tree and throws at the root fiber when the service was
+* never injected into this plugin's fiber).
+*
+* `tools` is the DSH node runtime tool registry used to register the netlist
+* tools.
+*/
+const inject = ["hqEdge", "tools"];
 const log = getLogger("dsh-eda-host");
 /**
 * Host plugin body — provide `edaHost` and register the three netlist tools.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@huaqiu/dsh-eda-host",
-  "version": "0.3.21",
+  "version": "0.3.22",
   "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.3.21"
+    "@huaqiu/dsh-plugin-log": "0.3.22"
   },
   "files": [
     "lib",

package/src/index.ts

@@ -13,9 +13,12 @@
  * This plugin owns DSH integration only: it translates tool calls into hq-edge
  * requests and returns the semantic `SchematicNetlist`. It contains no
  * KiCad-specific logic, no schematic parsing, and no host IPC. The plugin is
- * self-contained — no `@hqedge/*` dependency; the base URL is delivered by the
- * hq-edge supervisor as overlay config (`hqEdgeBaseUrl`), with
- * `HQ_EDGE_BASE_URL` as env fallback (same convention as `@huaqiu/dsh-auth`).
+ * self-contained — no `@hqedge/*` dependency. The base URL is resolved at
+ * request time in this order: (1) the `ctx.hqEdge.baseUrl` service provided by
+ * the edge-bridge HOST (the loopback HQ Edge endpoint), then (2) the
+ * supervisor's overlay config (`hqEdgeBaseUrl`), then (3) `HQ_EDGE_BASE_URL`
+ * env fallback (same convention as `@huaqiu/dsh-auth`). `hqEdge` is a REQUIRED
+ * inject — the plugin cannot reach hq-edge without the bridge.
  *
  * @module @huaqiu/dsh-eda-host
  */
@@ -28,8 +31,23 @@ import { createNetListTools } from './tools.js'
 /** Plugin id — matches package.json. */
 export const name = '@huaqiu/dsh-eda-host'
 
-/** Cordis services this half depends on. */
-export const inject = ['tools'] as const
+/**
+ * Cordis services this half depends on.
+ *
+ * `hqEdge` is REQUIRED: the edge-bridge (the HOST) provides the node-side
+ * `hqEdge` service whose `baseUrl` is the loopback HQ Edge endpoint
+ * (`createNodeHqEdge(upstreamRoot, …)` → `get baseUrl()`). Without it the
+ * plugin cannot reach hq-edge at all — by design it cannot work standalone
+ * (the user-confirmed contract is "eda-host cannot work without hqEdge").
+ * Declaring it here is what lets `apply()` read `ctx.hqEdge` without Cordis
+ * throwing `cannot get property "hqEdge" without inject` (its context proxy
+ * walks the fiber tree and throws at the root fiber when the service was
+ * never injected into this plugin's fiber).
+ *
+ * `tools` is the DSH node runtime tool registry used to register the netlist
+ * tools.
+ */
+export const inject = ['hqEdge', 'tools'] as const
 
 export type { EdaHostConfig } from './config.js'
 export type { EdaHostClient } from './client.js'
@@ -53,7 +71,16 @@ declare module '@deepseek-ai/cordis' {
      * lazily so this plugin does not hard-depend on the bridge and still works
      * in standalone DSH installs (where the service is absent).
      */
-    hqEdge?: { baseUrl?: string }
+    /**
+     * Provided by the hq-edge `edge-bridge` plugin (the HOST). `baseUrl` is the
+     * loopback HQ Edge endpoint, e.g. "http://localhost:18080". This is a
+     * REQUIRED inject (see `export const inject` above): `apply()` reads
+     * `ctx.hqEdge` to resolve the endpoint, so the service must be present or
+     * Cordis throws `cannot get property "hqEdge" without inject`. When present
+     * but its `baseUrl` is empty, the netlist tools degrade to a clear
+     * FAILED_PRECONDITION rather than throwing at load time.
+     */
+    hqEdge: { baseUrl?: string }
   }
 }