@huaqiu/dsh-eda-host 0.4.5 → 0.4.6

package/lib/index.mjs

@@ -327,7 +327,7 @@ function createEdaHostTools(env) {
 	return [
 		defineTool({
 			name: "get_eda_host_info",
-			description: "Describe the EDA host currently connected through hq-edge (DSH → dsh-eda-host → hq-edge → EDA host). Returns { ok, info: { identity: { hostType, hostName, version }, installation: { applicationPath, executables[]: { name, path } } } }. Use it when you need factual information about the current EDA environment, such as \"what EDA host am I connected to\", \"what version is it\", \"where is it installed\", or \"where is kicad-cli\". The returned information is authoritative host-provided ground truth. " + ERROR_SEMANTICS,
+			description: "Describe the EDA host currently connected through hq-edge (DSH → dsh-eda-host → hq-edge → EDA host). Returns { ok, info: { identity: { hostType, hostName, version }, installation: { applicationPath, executables[]: { name, path } } } }. Use it when you need factual information about the current EDA environment, such as \"what EDA host am I connected to\", \"what version is it\", \"where is it installed\", or \"where is kicad-cli\". When the host is KiCad, the executable list also carries \"kicad-python\" — the interpreter bundled with KiCad that owns the official kicad-python package (kipy); the dsh-kicad skills already run with it automatically. The returned information is authoritative host-provided ground truth. " + ERROR_SEMANTICS,
 			parameters: {},
 			output: {
 				schema: { type: "json" },
@@ -418,6 +418,30 @@ const name = "@huaqiu/dsh-eda-host";
 */
 const inject = ["hqEdge", "tools"];
 const log = getLogger("dsh-eda-host");
+/**
+* Env vars relevant to the hq-edge / DSH / KiCad integration, captured at
+* plugin apply() time so startup issues are diagnosable from the log.
+*
+* Values are logged verbatim EXCEPT `KICAD_API_TOKEN`, which is a live
+* credential KiCad injects for the IPC socket — only its presence is logged
+* (never the token itself).
+*/
+const DSH_ENV_LOG_KEYS = [
+	"DSH_KICAD_PYTHON",
+	"DSH_KICAD_SKILLS_DIR",
+	"DSH_HOME",
+	"HQ_EDGE_BASE_URL",
+	"KICAD_API_SOCKET",
+	"KICAD_API_TOKEN"
+];
+function envSnapshot() {
+	const snapshot = {};
+	for (const key of DSH_ENV_LOG_KEYS) {
+		const value = process.env[key];
+		snapshot[key] = key === "KICAD_API_TOKEN" ? value ? "<set>" : null : value ?? null;
+	}
+	return snapshot;
+}
 log.info("dsh-eda-host: module loaded (waiting for the hqEdge + tools services)");
 /**
 * Host plugin body — provide `edaHost` and register the three netlist tools.
@@ -449,7 +473,8 @@ function apply(ctx, config = {}) {
 		hqEdgeBaseUrlFromConfig: resolved.hqEdgeBaseUrl ?? null,
 		netlistPathPrefix: resolved.netlistPathPrefix,
 		hostPathPrefix: resolved.hostPathPrefix,
-		requestTimeoutMs: resolved.requestTimeoutMs
+		requestTimeoutMs: resolved.requestTimeoutMs,
+		env: envSnapshot()
 	});
 	const client = createEdaHostClient(resolved, { baseUrlResolver: getHqEdgeBaseUrl });
 	ctx.effect(() => ctx.provide("edaHost", client));

package/package.json

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

package/src/index.ts

@@ -112,6 +112,32 @@ declare module '@deepseek-ai/cordis' {
 const COMPONENT = 'dsh-eda-host'
 const log = getLogger(COMPONENT)
 
+/**
+ * Env vars relevant to the hq-edge / DSH / KiCad integration, captured at
+ * plugin apply() time so startup issues are diagnosable from the log.
+ *
+ * Values are logged verbatim EXCEPT `KICAD_API_TOKEN`, which is a live
+ * credential KiCad injects for the IPC socket — only its presence is logged
+ * (never the token itself).
+ */
+const DSH_ENV_LOG_KEYS = [
+  'DSH_KICAD_PYTHON',
+  'DSH_KICAD_SKILLS_DIR',
+  'DSH_HOME',
+  'HQ_EDGE_BASE_URL',
+  'KICAD_API_SOCKET',
+  'KICAD_API_TOKEN',
+] as const
+
+function envSnapshot(): Record<string, string | null> {
+  const snapshot: Record<string, string | null> = {}
+  for (const key of DSH_ENV_LOG_KEYS) {
+    const value = process.env[key]
+    snapshot[key] = key === 'KICAD_API_TOKEN' ? (value ? '<set>' : null) : (value ?? null)
+  }
+  return snapshot
+}
+
 // Emitted on import, before any Cordis dependency is resolved. Pairs with the
 // "node half ready" marker in apply(): if this line is logged but that one is
 // not, the edge-bridge never provided `hqEdge` and this plugin is still
@@ -182,6 +208,7 @@ export function apply(ctx: Context, config: Partial<EdaHostConfig> = {}): () =>
     netlistPathPrefix: resolved.netlistPathPrefix,
     hostPathPrefix: resolved.hostPathPrefix,
     requestTimeoutMs: resolved.requestTimeoutMs,
+    env: envSnapshot(),
   })
 
   const client = createEdaHostClient(resolved, { baseUrlResolver: getHqEdgeBaseUrl })

package/src/tools.ts

@@ -179,6 +179,9 @@ export function createNetListTools(env: NetlistToolEnv) {
          `Use it when you need factual information about the current EDA environment, such as ` +
          `"what EDA host am I connected to", "what version is it", "where is it installed", ` +
          `or "where is kicad-cli". ` +
+         `When the host is KiCad, the executable list also carries "kicad-python" — the ` +
+         `interpreter bundled with KiCad that owns the official kicad-python package ` +
+         `(kipy); the dsh-kicad skills already run with it automatically. ` +
          `The returned information is authoritative host-provided ground truth. ` +
          ERROR_SEMANTICS,
        parameters: {},