@huaqiu/dsh-tool-schematic-gen 0.3.7 → 0.3.9

package/lib/index.mjs

@@ -787,6 +787,33 @@ async function createPreviewArtifact(env, type, filename, content, contentEncodi
 	});
 }
 /**
+* Best-effort cross-process URI for a stored artifact (`file://` to its
+* content on disk). This is what the Place action hands to HQ Edge — an
+* artifact *id* is store-local and meaningless there. Never throws: a
+* generation must not fail because the URI is unavailable; the card simply
+* hides Place when there is no uri.
+*/
+async function artifactUriOf(env, id) {
+	try {
+		if (!env.artifacts || typeof env.artifacts.getDownloadUri !== "function") return null;
+		return await env.artifacts.getDownloadUri(id);
+	} catch (err) {
+		console.warn(LOG_TAG$1, "getDownloadUri failed for", id, String(err?.message || err));
+		return null;
+	}
+}
+async function toArtifactEntry(env, created) {
+	const entry = {
+		id: created.id,
+		type: created.type,
+		filename: created.filename,
+		size: created.size
+	};
+	const uri = await artifactUriOf(env, created.id);
+	if (uri) entry.uri = uri;
+	return entry;
+}
+/**
 * Pull the schematic deliverable out of the final agent state. `schFiles`
 * carry the `.kicad_sch` content inline, so the text is returned verbatim.
 */
@@ -826,12 +853,7 @@ async function materializeSchematicArtifacts(env, schFiles) {
 		const file = schFiles[i];
 		try {
 			const created = await createPreviewArtifact(env, "schematic", file.filename, file.content);
-			artifacts.push({
-				id: created.id,
-				type: created.type,
-				filename: created.filename,
-				size: created.size
-			});
+			artifacts.push(await toArtifactEntry(env, created));
 		} catch (storeErr) {
 			anyFailed = true;
 			outFiles[i].content = file.content;
@@ -979,13 +1001,7 @@ async function runGenerateSystem(args, exec, env) {
 	const notes = [];
 	let zipArtifact = null;
 	try {
-		const created = await createPreviewArtifact(env, "zip", sanitizeZipBaseName(designName) + ".zip", zipBuf.toString("base64"), "base64");
-		zipArtifact = {
-			id: created.id,
-			type: created.type,
-			filename: created.filename,
-			size: created.size
-		};
+		zipArtifact = await toArtifactEntry(env, await createPreviewArtifact(env, "zip", sanitizeZipBaseName(designName) + ".zip", zipBuf.toString("base64"), "base64"));
 	} catch (storeErr) {
 		notes.push("Could not store the project zip as an artifact (" + String(storeErr?.message || storeErr) + "); kept it in the result instead.");
 	}
@@ -1015,7 +1031,7 @@ const AUTH_GATE_NOTE = "AUTH: This tool requires a Huaqiu EDA (eda.cn) account.
 function createSchematicTool(env) {
 	return defineTool({
 		name: "generate_schematic_from_description",
-		description: "Generate a KiCad schematic (.kicad_sch files) from a natural-language description of a circuit or sub-circuit — e.g. \"design a 5V LM7805 linear regulator power supply with input and output filter capacitors\". Calls the online HQ-EDA schematic generation agent and returns schFiles (filename references), schArtifacts (preview artifact references with id/type/filename/size per sheet), kicadPro and project_achieve_url. Use this when the user asks to draw, generate or create a circuit schematic from a description (not from an image — for that use the symbol/footprint tools). IMPORTANT: The generated schematic renders automatically as a result card in the web client — an interactive canvas preview per sheet (multi-sheet results get a sheet tab bar) and a download button for the current sheet. Do NOT paste the schematic source, file URLs, or any fenced code block into your reply; just note in one line that the schematic was generated and how many sheets it has. " + AUTH_GATE_NOTE,
+		description: "Generate a KiCad schematic (.kicad_sch files) from a natural-language description of a circuit or sub-circuit — e.g. \"design a 5V LM7805 linear regulator power supply with input and output filter capacitors\". Calls the online HQ-EDA schematic generation agent and returns schFiles (filename references), schArtifacts (preview artifact references with id/type/filename/size plus a uri when the cross-process placement channel is available), kicadPro and project_achieve_url. Use this when the user asks to draw, generate or create a circuit schematic from a description (not from an image — for that use the symbol/footprint tools). IMPORTANT: The generated schematic renders automatically as a result card in the web client — an interactive canvas preview per sheet (multi-sheet results get a sheet tab bar) and a download button for the current sheet. Do NOT paste the schematic source, file URLs, or any fenced code block into your reply; just note in one line that the schematic was generated and how many sheets it has. " + AUTH_GATE_NOTE,
 		parameters: {
 			description: {
 				type: "string",
@@ -1040,7 +1056,7 @@ function createSchematicTool(env) {
 function createSystemTool(env) {
 	return defineTool({
 		name: "generate_system_module_graph",
-		description: "Generate a hardware system design (module graph) from a natural-language description — e.g. \"design a small smart alarm clock\". Calls the online HQ-EDA system-design agent, which plans the modules, searches/selects parts, wires the connections, and produces a module graph; the graph is then exported to a KiCad project zip. Returns: a zipArtifact reference (preview-artifact id of the full project zip — the zip is never inlined into the conversation) and a summary (design name, module count, connection count, module names). Use this when the user wants a whole system/module-level design, not a single schematic or symbol. IMPORTANT: The generated system design renders automatically as a result card in the web client — a canvas preview of the project root schematic (fetched from the zip artifact) and a Download button for the full project zip. Do NOT paste the schematic source, file URLs, or any fenced code block into your reply; just note in one line that the design was generated, its module count, and that the project zip is downloadable from the card. " + AUTH_GATE_NOTE,
+		description: "Generate a hardware system design (module graph) from a natural-language description — e.g. \"design a small smart alarm clock\". Calls the online HQ-EDA system-design agent, which plans the modules, searches/selects parts, wires the connections, and produces a module graph; the graph is then exported to a KiCad project zip. Returns: a zipArtifact reference (preview-artifact id of the full project zip — the zip is never inlined into the conversation; a uri field is included when the cross-process placement channel is available) and a summary (design name, module count, connection count, module names). Use this when the user wants a whole system/module-level design, not a single schematic or symbol. IMPORTANT: The generated system design renders automatically as a result card in the web client — a canvas preview of the project root schematic (fetched from the zip artifact) and a Download button for the full project zip. Do NOT paste the schematic source, file URLs, or any fenced code block into your reply; just note in one line that the design was generated, its module count, and that the project zip is downloadable from the card. " + AUTH_GATE_NOTE,
 		parameters: {
 			description: {
 				type: "string",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@huaqiu/dsh-tool-schematic-gen",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "type": "module",
   "main": "./lib/index.mjs",
   "types": "./lib/index.d.mts",
@@ -30,8 +30,8 @@
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.0",
     "@deepseek-ai/dsh-tools": "^0.1.0-rc.0",
-    "@huaqiu/dsh-auth": "^0.3.7",
-    "@huaqiu/dsh-artifacts": "^0.3.7",
+    "@huaqiu/dsh-auth": "^0.3.9",
+    "@huaqiu/dsh-artifacts": "^0.3.9",
     "react": "^18"
   },
   "devDependencies": {
@@ -39,9 +39,9 @@
     "@huaqiu/kicad-sexpr-parser": "^0.1.1",
     "@types/react": "^18.3.31",
     "react": "^18.3.1",
-    "@huaqiu/dsh-tool-uncollapse": "0.3.7",
-    "@huaqiu/dsh-auth": "0.3.7",
-    "@huaqiu/dsh-artifacts": "0.3.7"
+    "@huaqiu/dsh-artifacts": "0.3.9",
+    "@huaqiu/dsh-auth": "0.3.9",
+    "@huaqiu/dsh-tool-uncollapse": "0.3.9"
   },
   "files": [
     "lib",

package/src/client/hit-card.tsx

@@ -22,6 +22,7 @@ import {
   resolveArtifactText, resolveArtifactBytes, renderSheetToCanvas,
   renderProjectZipToCanvas, sizeCanvasFor, downloadText, downloadBytes,
 } from './ecad.js'
+import { placeSupportOf, type HqEdgePlaceLike } from './place.js'
 import { useLocale, useTheme } from './theme.js'
 import { buildLoginUrl, loginIframeBackground } from './login-url.js'
 import { LiveProgress } from './stack-frame.jsx'
@@ -52,6 +53,13 @@ export interface GenHitProps {
   inspect?: () => void
   authState?: AuthStateLike
   sendPrompt?: PromptSender
+  /**
+   * Lazy accessor for the host's `hqEdge` service (edge-bridge browser half).
+   * Absent/undefined in standalone DSH — the Place button is then hidden.
+   * Lazy (not captured once) so plugin load order and HQ Edge restarts both
+   * resolve correctly at click time.
+   */
+  getHqEdge?: () => HqEdgePlaceLike | undefined
 }
 
 function kindOf(toolName: string): 'schematic' | 'system' {
@@ -267,6 +275,9 @@ export const GenHit = memo(function GenHit(props: GenHitProps): ReactElement {
   }, [artifactKey, state.phase])
 
   const [busy, setBusy] = useState<string | null>(null)
+  // Outcome of the last Place attempt: 'ok' | 'error:<detail>'. Rendered as a
+  // one-line status under the actions so the user knows the placement landed.
+  const [placeStatus, setPlaceStatus] = useState<string | null>(null)
 
   function onDownload(): void {
     if (busy || payload.phase !== 'ready') return
@@ -298,6 +309,59 @@ export const GenHit = memo(function GenHit(props: GenHitProps): ReactElement {
     )
   }
 
+  /**
+   * Place the generated design into the host EDA editor via HQ Edge.
+   *
+   * A system design sends ONE request (the project zip; HQ Edge derives the
+   * root from the `*.kicad_pro` name — the same convention as the preview).
+   * A multi-sheet schematic sends one request per sheet so every sheet lands
+   * in the editor. Failures are collected and reported as a one-line status;
+   * a partial success is explicitly surfaced, not swallowed.
+   */
+  function placeRequestsOf(): Array<{ artifactUri: string; filename: string | null }> {
+    if (!result) return []
+    // System kind: exactly one zip artifact (one request; HQ Edge derives the
+    // root from the `*.kicad_pro` name inside the zip). Schematic kind: one
+    // request per sheet. The wire shape is identical either way.
+    return result.artifacts
+      .filter((a) => a.uri)
+      .map((a) => ({ artifactUri: a.uri!, filename: a.filename }))
+  }
+
+  async function onPlace(): Promise<void> {
+    if (busy) return
+    const support = placeSupportOf(props.getHqEdge, 'schematic')?.()
+    if (!support) return
+    const requests = placeRequestsOf()
+    if (requests.length === 0) return
+    setBusy('place')
+    setPlaceStatus(null)
+    let placed = 0
+    const failures: string[] = []
+    for (const req of requests) {
+      try {
+        await support.place({
+          type: 'schematic',
+          artifactUri: req.artifactUri,
+          ...(req.filename ? { filename: req.filename } : {}),
+        })
+        placed++
+      } catch (err) {
+        const detail = String((err as Error)?.message || err)
+        console.warn('[hq-schematic-gen] place failed', detail)
+        failures.push(detail)
+      }
+    }
+    setBusy(null)
+    if (failures.length === 0) {
+      setPlaceStatus(t('card.place.done', { count: placed }))
+    } else if (placed > 0) {
+      setPlaceStatus(t('card.place.partial', { placed, failed: failures.length }) + ' ' + failures[0])
+    } else {
+      setPlaceStatus(t('card.place.failed') + ' ' + failures[0])
+    }
+  }
+
   // needs_auth
   if (state.phase === 'needs_auth') {
     return <LoginCard toolName={props.toolName} authState={props.authState} t={t} />
@@ -355,6 +419,12 @@ export const GenHit = memo(function GenHit(props: GenHitProps): ReactElement {
   }
 
   const canDownload = payload.phase === 'ready' && (payload.source != null || payload.bytes != null)
+  // Place is offered only when the host provides hqEdge, the current editor
+  // accepts schematics (frontend matrix; HQ Edge re-enforces server-side) and
+  // the node half resolved at least one artifact uri.
+  const placeSupport = placeSupportOf(props.getHqEdge, 'schematic')
+  const placeableCount = result.artifacts.filter((a) => a.uri).length
+  const canPlace = !!placeSupport?.() && placeableCount > 0
 
   return (
     <div className="hq-sch">
@@ -366,6 +436,13 @@ export const GenHit = memo(function GenHit(props: GenHitProps): ReactElement {
         <button type="button" className="hq-sch__act" onClick={onDownload} disabled={!canDownload || busy === 'download'}>
           ⭳ {busy === 'download' ? t('card.action.downloading') : t('card.action.download')}
         </button>
+        {canPlace
+          ? (
+            <button type="button" className="hq-sch__act" onClick={onPlace} disabled={busy === 'place'}>
+              ⇥ {busy === 'place' ? t('card.action.placing') : t('card.action.place')}
+            </button>
+          )
+          : null}
         <button type="button" className="hq-sch__act" onClick={onRegenerate} disabled={busy === 'regenerate'}>
           ↻ {busy === 'regenerate' ? t('card.action.regenerating') : t('card.action.regenerate')}
         </button>
@@ -373,6 +450,7 @@ export const GenHit = memo(function GenHit(props: GenHitProps): ReactElement {
           ? <button type="button" className="hq-sch__act" onClick={() => props.inspect?.()}>{t('card.action.inspect')}</button>
           : null}
       </div>
+      {placeStatus ? <div className="hq-sch__note">{placeStatus}</div> : null}
     </div>
   )
 })

package/src/client/i18n.ts

@@ -45,6 +45,11 @@ const ZH = {
     'card.meta.connections': '{count} 条连接',
     'card.action.download': '下载',
     'card.action.downloading': '下载中…',
+    'card.action.place': '放置到编辑器',
+    'card.action.placing': '放置中…',
+    'card.place.done': '已放置 {count} 个文件到编辑器',
+    'card.place.partial': '已放置 {placed} 个，{failed} 个失败：',
+    'card.place.failed': '放置失败：',
     'card.action.regenerate': '重新生成',
     'card.action.regenerating': '重新生成中…',
     'card.action.inspect': '详情',
@@ -95,6 +100,11 @@ const EN: Record<CopyKey, string> = {
     'card.meta.connections': '{count} connection(s)',
     'card.action.download': 'Download',
     'card.action.downloading': 'Downloading…',
+    'card.action.place': 'Place in editor',
+    'card.action.placing': 'Placing…',
+    'card.place.done': 'Placed {count} file(s) into the editor',
+    'card.place.partial': 'Placed {placed}, {failed} failed: ',
+    'card.place.failed': 'Placement failed: ',
     'card.action.regenerate': 'Regenerate',
     'card.action.regenerating': 'Regenerating…',
     'card.action.inspect': 'Inspect',

package/src/client/index.ts

@@ -17,6 +17,7 @@ import { createElement, useEffect, useState, type ComponentType } from 'react'
 import { GenHit } from './hit-card.jsx'
 import { injectStyles, removeStyles, disposeThemeObserver, installSchematicUncollapser } from './theme.js'
 import type { AuthStateLike, PromptSender } from './hit-card.jsx'
+import type { HqEdgePlaceLike } from './place.js'
 
 export type { AuthStateLike, PromptSender }
 
@@ -116,6 +117,12 @@ export function apply(ctx: ClientContext): () => void {
   const authService = ctx.get<HuaqiuAuthClientService | undefined>('huaqiuAuth')
   const useAuthState = createUseAuthState(authService?.auth)
 
+  // Lazy `hqEdge` accessor for the Place action. NOT captured once: the
+  // edge-bridge plugin may load after this one, and a click should see the
+  // service as soon as it exists. Undefined in standalone DSH (no edge-bridge)
+  // — the card then simply hides Place.
+  const getHqEdge = () => ctx.get<HqEdgePlaceLike | undefined>('hqEdge')
+
   const sendPrompt: PromptSender = (sessionId, message) => {
     const sessions = ctx.get<{ binding(id: string): { session: { prompt(content: Array<{ type: 'text'; text: string }>, mode: 'queue'): Promise<unknown> } } | undefined }>('sessions')
     if (!sessions || typeof sessions.binding !== 'function' || !sessionId) {
@@ -151,6 +158,7 @@ export function apply(ctx: ClientContext): () => void {
         callId: props.callId,
         sendPrompt,
         authState: useAuthState(),
+        getHqEdge,
       })
 
     for (const toolName of TOOLVIEW_KEYS) {

package/src/client/parse.ts

@@ -4,12 +4,14 @@
  * Result shapes produced by the node half (`src/tools.ts`):
  *   generate_schematic_from_description →
  *     { status:'generated', kind:'schematic', design_name, schFiles:[{filename}],
- *       schArtifacts:[{id,type,filename,size}], kicadPro, project_achieve_url, note? }
+ *       schArtifacts:[{id,type,filename,size,uri?}], kicadPro, project_achieve_url, note? }
  *   generate_system_module_graph →
  *     { status:'generated', kind:'system', design_name, module_count,
  *       connection_count, module_names, zip_bytes,
- *       zipArtifact:{id,type:'zip',filename,size}, note? }
+ *       zipArtifact:{id,type:'zip',filename,size,uri?}, note? }
  *   both may return { status:'needs_auth', kind, hint }
+ *
+ * `uri` (when present) is the HQ Edge-resolvable handle the Place action uses.
  */
 
 export interface ContentBlockLike {
@@ -28,12 +30,21 @@ export interface ArtifactRef {
   type: string | null
   filename: string | null
   size: number | null
+  /**
+   * HQ Edge-resolvable URI (`file://`) for the artifact bytes — the handle the
+   * Place action passes to `hqEdge.placeArtifact`. `null` when the node half
+   * could not resolve it (standalone DSH, older node half): the card then
+   * hides Place.
+   */
+  uri: string | null
 }
 
 export interface SchResult {
   status: string | null
   kind: string | null
   artifact: ArtifactRef | null
+  /** Every placeable artifact (schematic sheets / the project zip). */
+  artifacts: ArtifactRef[]
   designName: string | null
   fileCount: number | null
   moduleCount: number | null
@@ -79,6 +90,7 @@ function artOf(a: unknown): ArtifactRef | null {
     type: typeof o.type === 'string' ? o.type : null,
     filename: typeof o.filename === 'string' ? o.filename : null,
     size: typeof o.size === 'number' ? o.size : null,
+    uri: typeof o.uri === 'string' && o.uri.length > 0 ? o.uri : null,
   }
 }
 
@@ -98,17 +110,24 @@ export function parseSchResult(text: string): SchResult | null {
   const kind = typeof o.kind === 'string' ? o.kind : null
 
   let artifact: ArtifactRef | null = null
+  const artifacts: ArtifactRef[] = []
   if (kind === 'system') {
     artifact = artOf(o.zipArtifact)
+    if (artifact) artifacts.push(artifact)
   } else {
     const list = Array.isArray(o.schArtifacts) ? (o.schArtifacts as unknown[]) : []
-    artifact = list.length > 0 ? artOf(list[0]) : null
+    for (const entry of list) {
+      const ref = artOf(entry)
+      if (ref) artifacts.push(ref)
+    }
+    artifact = artifacts.length > 0 ? artifacts[0]! : null
   }
 
   return {
     status,
     kind,
     artifact,
+    artifacts,
     designName: typeof o.design_name === 'string' && o.design_name ? o.design_name : null,
     fileCount: Array.isArray(o.schFiles) ? (o.schFiles as unknown[]).length
       : (Array.isArray(o.schArtifacts) ? (o.schArtifacts as unknown[]).length : null),

package/src/client/place.ts

@@ -0,0 +1,17 @@
+/**
+ * Place-action seam for the schematic/system HIT card.
+ *
+ * Thin re-export of the shared, browser-safe placement module
+ * (`@huaqiu/dsh-artifacts/placement`): the frontend compatibility matrix plus
+ * the lazy `hqEdge` service accessor. Kept as a local module so the card's
+ * import paths stay stable and the client bundle only ever pulls the pure
+ * subpath — the package root exports the cordis plugin entry, which must not
+ * be bundled into the browser.
+ *
+ * @module
+ */
+export {
+  placeSupportOf,
+  type HqEdgePlaceLike,
+  type PlaceSupport,
+} from '@huaqiu/dsh-artifacts/placement'

package/src/tools.ts

@@ -166,6 +166,40 @@ async function createPreviewArtifact(
   return env.artifacts.create({ type, filename, content, contentEncoding })
 }
 
+/**
+ * Best-effort cross-process URI for a stored artifact (`file://` to its
+ * content on disk). This is what the Place action hands to HQ Edge — an
+ * artifact *id* is store-local and meaningless there. Never throws: a
+ * generation must not fail because the URI is unavailable; the card simply
+ * hides Place when there is no uri.
+ */
+async function artifactUriOf(env: SchematicGenEnv, id: string): Promise<string | null> {
+  try {
+    if (!env.artifacts || typeof env.artifacts.getDownloadUri !== 'function') return null
+    return await env.artifacts.getDownloadUri(id)
+  } catch (err) {
+    console.warn(LOG_TAG, 'getDownloadUri failed for', id, String((err as Error)?.message || err))
+    return null
+  }
+}
+
+/** Artifact entry shape in the tool result (parsed by the client card). */
+interface ArtifactEntry {
+  id: string
+  type: string
+  filename: string
+  size: number
+  /** HQ Edge-resolvable URI (`file://`), present when resolvable. */
+  uri?: string
+}
+
+async function toArtifactEntry(env: SchematicGenEnv, created: CreateArtifactResult): Promise<ArtifactEntry> {
+  const entry: ArtifactEntry = { id: created.id, type: created.type, filename: created.filename, size: created.size }
+  const uri = await artifactUriOf(env, created.id)
+  if (uri) entry.uri = uri
+  return entry
+}
+
 // ── Deliverable extraction ───────────────────────────────────────────────────
 
 export interface SchematicSheet {
@@ -219,7 +253,7 @@ export function extractModuleGraph(state: Record<string, unknown>): Record<strin
 
 interface MaterializedSchematic {
   schFiles: Array<{ filename: string; content?: string }>
-  schArtifacts?: Array<{ id: string; type: string; filename: string; size: number }>
+  schArtifacts?: Array<ArtifactEntry>
   /** User-safe status detail — the client card renders this. */
   note?: string
   /** Agent-only explanation/directive — the client card MUST NOT render it. */
@@ -234,7 +268,7 @@ interface MaterializedSchematic {
  */
 async function materializeSchematicArtifacts(env: SchematicGenEnv, schFiles: SchematicSheet[]): Promise<MaterializedSchematic> {
   const outFiles: Array<{ filename: string; content?: string }> = schFiles.map((f) => ({ filename: f.filename }))
-  const artifacts: Array<{ id: string; type: string; filename: string; size: number }> = []
+  const artifacts: ArtifactEntry[] = []
   let anyFailed = false
   let errorNote = ''
 
@@ -242,7 +276,7 @@ async function materializeSchematicArtifacts(env: SchematicGenEnv, schFiles: Sch
     const file = schFiles[i]!
     try {
       const created = await createPreviewArtifact(env, 'schematic', file.filename, file.content)
-      artifacts.push({ id: created.id, type: created.type, filename: created.filename, size: created.size })
+      artifacts.push(await toArtifactEntry(env, created))
     } catch (storeErr) {
       anyFailed = true
       outFiles[i]!.content = file.content // data-loss guard
@@ -445,11 +479,11 @@ export async function runGenerateSystem(
   // Store the project zip as a `zip` preview artifact (primary). Keeping the
   // zip OUT of the JSON keeps the result small — inlining base64 used to
   // truncate the tool result and fail the card.
-  let zipArtifact: { id: string; type: string; filename: string; size: number } | null = null
+  let zipArtifact: ArtifactEntry | null = null
   try {
     const safeName = sanitizeZipBaseName(designName)
     const created = await createPreviewArtifact(env, 'zip', safeName + '.zip', zipBuf.toString('base64'), 'base64')
-    zipArtifact = { id: created.id, type: created.type, filename: created.filename, size: created.size }
+    zipArtifact = await toArtifactEntry(env, created)
   } catch (storeErr) {
     notes.push('Could not store the project zip as an artifact (' +
       String((storeErr as Error)?.message || storeErr) + '); kept it in the result instead.')
@@ -507,7 +541,8 @@ function createSchematicTool(env: SchematicGenEnv) {
       'regulator power supply with input and output filter capacitors". Calls the ' +
       'online HQ-EDA schematic generation agent and returns ' +
       'schFiles (filename references), schArtifacts (preview artifact references ' +
-      'with id/type/filename/size per sheet), kicadPro and project_achieve_url. ' +
+      'with id/type/filename/size plus a uri when the cross-process placement ' +
+      'channel is available), kicadPro and project_achieve_url. ' +
       'Use this when the user asks to draw, generate or create a circuit ' +
       'schematic from a description (not from an image — for that use the ' +
       'symbol/footprint tools). ' +
@@ -549,7 +584,8 @@ function createSystemTool(env: SchematicGenEnv) {
       'parts, wires the connections, and produces a module graph; the graph is ' +
       'then exported to a KiCad project zip. Returns: a zipArtifact reference ' +
       '(preview-artifact id of the full project zip — the zip is never inlined ' +
-      'into the conversation) and a summary (design name, module count, ' +
+      'into the conversation; a uri field is included when the cross-process ' +
+      'placement channel is available) and a summary (design name, module count, ' +
       'connection count, module names). Use this when the user wants a whole ' +
       'system/module-level design, not a single schematic or symbol. ' +
       'IMPORTANT: The generated system design renders automatically as a result ' +