@huaqiu/dsh-hqsch 0.4.8

package/skills/hqsch-scenario-b/docs/rpc/pattern-layout-get-page-occupancy.md

@@ -0,0 +1,100 @@
+---
+name: pattern-layout-get-page-occupancy
+metadata:
+  category: pattern-layout
+  service: PatternLayoutService
+  method: GetPageOccupancy
+  rpcKind: unary
+description: >-
+  Bounding boxes of what is already on the page, for floorplanning / avoidance.
+version: 0.1.0
+vendor: Huaqiu Electronics
+tags:
+  - eda
+  - huaqiu
+  - pattern-layout
+entry: "@huaqiu/hqeda"
+manifest: "@huaqiu/hqeda/skill.json"
+inputSchema:
+  name: GetPageOccupancyRequestSchema
+  namespace: HqServicesV1PatternLayoutService
+---
+
+# Get Page Occupancy
+
+Bounding boxes of what is already on the page, for floorplanning / avoidance.
+
+## Overview
+
+This skill provides access to the **`PatternLayoutService.GetPageOccupancy`** RPC method on the Huaqiu EDA engine. It is part of the **pattern-layout** domain and executes against the `patternLayout` client.
+
+| Property | Value |
+| --- | --- |
+| Skill ID | `pattern-layout-get-page-occupancy` |
+| Service | `PatternLayoutService` |
+| Method | `GetPageOccupancy` |
+| Transport | Unary (unary) |
+| Domain | pattern-layout |
+| Request type | `GetPageOccupancyRequest` |
+| Response type | `GetPageOccupancyResponse` |
+
+## Parameters
+
+| Name | Type | Required | Repeated | Description |
+| --- | --- | --- | --- | --- |
+| `context` | `ProjectContext` | no | no | — |
+| `area` | `Box2i64` | no | no | Restrict the scan to this box; empty (all-zero) box = whole page. |
+| `includeWires` | `boolean` | yes | no | Include wires / buses / graphics, not just parts and symbols. |
+
+## Response
+
+Returns a `GetPageOccupancyResponse` message with the following fields:
+
+| Name | Type | Repeated | Description |
+| --- | --- | --- | --- |
+| `pageBox` | `Box2i64` | no | — |
+| `items` | `PageOccupancyItem[]` | yes | — |
+
+## Response Example
+
+Representative response structure (field values are placeholders):
+
+```json
+{
+  "pageBox": {},
+  "items": [
+    {}
+  ]
+}
+```
+
+## Prerequisites
+
+- [project-get-active-project](../../project/get-active-project/SKILL.md) — Discover the active project before building project-scoped context.
+
+See also [skill-dependencies.md](../../references/skill-dependencies.md) for common workflows.
+
+## How to Use
+
+Execute via the HQ EDA skill runtime with a connected `EditorClient`. See [quickstart.md](../../references/quickstart.md) for the full `listEditors` → `connect` → `getSkill` → `execute` chain.
+
+```typescript
+import { getSkill, toJsonString } from "@huaqiu/hqeda";
+
+const skill = getSkill("pattern-layout-get-page-occupancy");
+const result = await skill.execute({ client }, {
+  context: "<ProjectContext via client.createProjectContext('my-project')>",
+  area: {},
+  includeWires: false,
+});
+console.log(toJsonString(result, { prettySpaces: 2 }));
+```
+
+Serialize responses with `toJsonString()` — see [serialization.md](../../references/serialization.md).
+
+## Related Skills
+
+- Other **pattern-layout** skills: [`pattern-layout/`](../)
+- Full index: [All EDA skills](../../SKILL.md)
+- Install: `npx skills add Huaqiu-Electronics/skills --path eda/pattern-layout/get-page-occupancy`
+

package/skills/hqsch-scenario-b/docs/rpc/pattern-layout-list-circuit-patterns.md

@@ -0,0 +1,97 @@
+---
+name: pattern-layout-list-circuit-patterns
+metadata:
+  category: pattern-layout
+  service: PatternLayoutService
+  method: ListCircuitPatterns
+  rpcKind: unary
+description: >-
+  Self-describing catalog — keeps the skill docs from drifting away from the implementation. Call it before Apply to learn the roles/terminals/options.
+version: 0.1.0
+vendor: Huaqiu Electronics
+tags:
+  - eda
+  - huaqiu
+  - pattern-layout
+entry: "@huaqiu/hqeda"
+manifest: "@huaqiu/hqeda/skill.json"
+inputSchema:
+  name: ListCircuitPatternsRequestSchema
+  namespace: HqServicesV1PatternLayoutService
+---
+
+# List Circuit Patterns
+
+Self-describing catalog — keeps the skill docs from drifting away from the
+implementation. Call it before Apply to learn the roles/terminals/options.
+
+## Overview
+
+This skill provides access to the **`PatternLayoutService.ListCircuitPatterns`** RPC method on the Huaqiu EDA engine. It is part of the **pattern-layout** domain and executes against the `patternLayout` client.
+
+| Property | Value |
+| --- | --- |
+| Skill ID | `pattern-layout-list-circuit-patterns` |
+| Service | `PatternLayoutService` |
+| Method | `ListCircuitPatterns` |
+| Transport | Unary (unary) |
+| Domain | pattern-layout |
+| Request type | `ListCircuitPatternsRequest` |
+| Response type | `ListCircuitPatternsResponse` |
+
+## Parameters
+
+| Name | Type | Required | Repeated | Description |
+| --- | --- | --- | --- | --- |
+| `context` | `ProjectContext` | no | no | — |
+| `pattern` | `CircuitPatternId` | yes | no | 0 / UNSPECIFIED = every pattern. |
+
+## Response
+
+Returns a `ListCircuitPatternsResponse` message with the following fields:
+
+| Name | Type | Repeated | Description |
+| --- | --- | --- | --- |
+| `patterns` | `CircuitPatternDescriptor[]` | yes | — |
+
+## Response Example
+
+Representative response structure (field values are placeholders):
+
+```json
+{
+  "patterns": [
+    {}
+  ]
+}
+```
+
+## Prerequisites
+
+- [project-get-active-project](../../project/get-active-project/SKILL.md) — Discover the active project before building project-scoped context.
+
+See also [skill-dependencies.md](../../references/skill-dependencies.md) for common workflows.
+
+## How to Use
+
+Execute via the HQ EDA skill runtime with a connected `EditorClient`. See [quickstart.md](../../references/quickstart.md) for the full `listEditors` → `connect` → `getSkill` → `execute` chain.
+
+```typescript
+import { getSkill, toJsonString } from "@huaqiu/hqeda";
+
+const skill = getSkill("pattern-layout-list-circuit-patterns");
+const result = await skill.execute({ client }, {
+  context: "<ProjectContext via client.createProjectContext('my-project')>",
+  pattern: {},
+});
+console.log(toJsonString(result, { prettySpaces: 2 }));
+```
+
+Serialize responses with `toJsonString()` — see [serialization.md](../../references/serialization.md).
+
+## Related Skills
+
+- Other **pattern-layout** skills: [`pattern-layout/`](../)
+- Full index: [All EDA skills](../../SKILL.md)
+- Install: `npx skills add Huaqiu-Electronics/skills --path eda/pattern-layout/list-circuit-patterns`
+

package/skills/hqsch-scenario-b/docs/rpc/placement-list-part-libraries.md

@@ -0,0 +1,94 @@
+---
+name: placement-list-part-libraries
+metadata:
+  category: placement
+  service: ComponentPlaceService
+  method: ListPartLibraries
+  rpcKind: unary
+description: >-
+  Fallback listing for local/builtin part libraries — agents prefer online part-search (searchParts → getEdaModels) first
+version: 0.1.0
+vendor: Huaqiu Electronics
+tags:
+  - eda
+  - huaqiu
+  - placement
+entry: "@huaqiu/hqeda"
+manifest: "@huaqiu/hqeda/skill.json"
+inputSchema:
+  name: ListPartLibrariesRequestSchema
+  namespace: HqServicesV1ComponentPlaceService
+---
+
+# List Part Libraries
+
+Fallback listing for local/builtin part libraries — agents prefer online part-search (searchParts → getEdaModels) first
+
+## Overview
+
+This skill provides access to the **`ComponentPlaceService.ListPartLibraries`** RPC method on the Huaqiu EDA engine. It is part of the **placement** domain and executes against the `componentPlace` client.
+
+| Property | Value |
+| --- | --- |
+| Skill ID | `placement-list-part-libraries` |
+| Service | `ComponentPlaceService` |
+| Method | `ListPartLibraries` |
+| Transport | Unary (unary) |
+| Domain | placement |
+| Request type | `ListPartLibrariesRequest` |
+| Response type | `ListPartLibrariesResponse` |
+
+## Parameters
+
+| Name | Type | Required | Repeated | Description |
+| --- | --- | --- | --- | --- |
+| `context` | `ProjectContext` | no | no | — |
+
+## Response
+
+Returns a `ListPartLibrariesResponse` message with the following fields:
+
+| Name | Type | Repeated | Description |
+| --- | --- | --- | --- |
+| `libraries` | `PartLibraryInfo[]` | yes | — |
+
+## Response Example
+
+Representative response structure (field values are placeholders):
+
+```json
+{
+  "libraries": [
+    {}
+  ]
+}
+```
+
+## Prerequisites
+
+- [project-get-active-project](../../project/get-active-project/SKILL.md) — Discover the active project before building project-scoped context.
+
+See also [skill-dependencies.md](../../references/skill-dependencies.md) for common workflows.
+
+## How to Use
+
+Execute via the HQ EDA skill runtime with a connected `EditorClient`. See [quickstart.md](../../references/quickstart.md) for the full `listEditors` → `connect` → `getSkill` → `execute` chain.
+
+```typescript
+import { getSkill, toJsonString } from "@huaqiu/hqeda";
+
+const skill = getSkill("placement-list-part-libraries");
+const result = await skill.execute({ client }, {
+  context: "<ProjectContext via client.createProjectContext('my-project')>",
+});
+console.log(toJsonString(result, { prettySpaces: 2 }));
+```
+
+Serialize responses with `toJsonString()` — see [serialization.md](../../references/serialization.md).
+
+## Related Skills
+
+- Other **placement** skills: [`placement/`](../)
+- Full index: [All EDA skills](../../SKILL.md)
+- Install: `npx skills add Huaqiu-Electronics/skills --path eda/placement/list-part-libraries`
+

package/skills/hqsch-scenario-b/docs/rpc/placement-list-symbol-libraries.md

@@ -0,0 +1,94 @@
+---
+name: placement-list-symbol-libraries
+metadata:
+  category: placement
+  service: ComponentPlaceService
+  method: ListSymbolLibraries
+  rpcKind: unary
+description: >-
+  Agent path: list global/power/gnd, port, off-page symbols — call before PlaceSymbolFromLibrary
+version: 0.1.0
+vendor: Huaqiu Electronics
+tags:
+  - eda
+  - huaqiu
+  - placement
+entry: "@huaqiu/hqeda"
+manifest: "@huaqiu/hqeda/skill.json"
+inputSchema:
+  name: ListSymbolLibrariesRequestSchema
+  namespace: HqServicesV1ComponentPlaceService
+---
+
+# List Symbol Libraries
+
+Agent path: list global/power/gnd, port, off-page symbols — call before PlaceSymbolFromLibrary
+
+## Overview
+
+This skill provides access to the **`ComponentPlaceService.ListSymbolLibraries`** RPC method on the Huaqiu EDA engine. It is part of the **placement** domain and executes against the `componentPlace` client.
+
+| Property | Value |
+| --- | --- |
+| Skill ID | `placement-list-symbol-libraries` |
+| Service | `ComponentPlaceService` |
+| Method | `ListSymbolLibraries` |
+| Transport | Unary (unary) |
+| Domain | placement |
+| Request type | `ListSymbolLibrariesRequest` |
+| Response type | `ListSymbolLibrariesResponse` |
+
+## Parameters
+
+| Name | Type | Required | Repeated | Description |
+| --- | --- | --- | --- | --- |
+| `context` | `ProjectContext` | no | no | — |
+
+## Response
+
+Returns a `ListSymbolLibrariesResponse` message with the following fields:
+
+| Name | Type | Repeated | Description |
+| --- | --- | --- | --- |
+| `libraries` | `SymbolLibraryInfo[]` | yes | — |
+
+## Response Example
+
+Representative response structure (field values are placeholders):
+
+```json
+{
+  "libraries": [
+    {}
+  ]
+}
+```
+
+## Prerequisites
+
+- [project-get-active-project](../../project/get-active-project/SKILL.md) — Discover the active project before building project-scoped context.
+
+See also [skill-dependencies.md](../../references/skill-dependencies.md) for common workflows.
+
+## How to Use
+
+Execute via the HQ EDA skill runtime with a connected `EditorClient`. See [quickstart.md](../../references/quickstart.md) for the full `listEditors` → `connect` → `getSkill` → `execute` chain.
+
+```typescript
+import { getSkill, toJsonString } from "@huaqiu/hqeda";
+
+const skill = getSkill("placement-list-symbol-libraries");
+const result = await skill.execute({ client }, {
+  context: "<ProjectContext via client.createProjectContext('my-project')>",
+});
+console.log(toJsonString(result, { prettySpaces: 2 }));
+```
+
+Serialize responses with `toJsonString()` — see [serialization.md](../../references/serialization.md).
+
+## Related Skills
+
+- Other **placement** skills: [`placement/`](../)
+- Full index: [All EDA skills](../../SKILL.md)
+- Install: `npx skills add Huaqiu-Electronics/skills --path eda/placement/list-symbol-libraries`
+

package/skills/hqsch-scenario-b/docs/rpc/placement-place-kicad-symbol.md

@@ -0,0 +1,105 @@
+---
+name: placement-place-kicad-symbol
+metadata:
+  category: placement
+  service: ComponentPlaceService
+  method: PlaceKicadSymbol
+  rpcKind: unary
+description: >-
+  Place R/C/Q/U from online KiCad symbol URL (SCH_PlaceKicadSymbolFromResource). Invoke after part-search getEdaModels returns symbol.uri; requires active schematic page and project context.
+version: 0.1.0
+vendor: Huaqiu Electronics
+tags:
+  - eda
+  - huaqiu
+  - placement
+entry: "@huaqiu/hqeda"
+manifest: "@huaqiu/hqeda/skill.json"
+inputSchema:
+  name: PlaceKicadSymbolRequestSchema
+  namespace: HqServicesV1ComponentPlaceService
+---
+
+# Place Kicad Symbol
+
+Place R/C/Q/U from online KiCad symbol URL (SCH_PlaceKicadSymbolFromResource). Invoke after part-search getEdaModels returns symbol.uri; requires active schematic page and project context.
+
+## Overview
+
+This skill provides access to the **`ComponentPlaceService.PlaceKicadSymbol`** RPC method on the Huaqiu EDA engine. It is part of the **placement** domain and executes against the `componentPlace` client.
+
+| Property | Value |
+| --- | --- |
+| Skill ID | `placement-place-kicad-symbol` |
+| Service | `ComponentPlaceService` |
+| Method | `PlaceKicadSymbol` |
+| Transport | Unary (unary) |
+| Domain | placement |
+| Request type | `PlaceKicadSymbolRequest` |
+| Response type | `ObjectPlaceResponse` |
+
+## Parameters
+
+| Name | Type | Required | Repeated | Description |
+| --- | --- | --- | --- | --- |
+| `context` | `ProjectContext` | no | no | — |
+| `component` | `ComponentResource` | no | no | — |
+| `localPos` | `Vector2i64` | no | no | — |
+| `sectionPlacements` | `SectionPlacement[]` | no | yes | — |
+
+## Response
+
+Returns a `ObjectPlaceResponse` message with the following fields:
+
+| Name | Type | Repeated | Description |
+| --- | --- | --- | --- |
+| `success` | `boolean` | no | — |
+| `objectId` | `bigint` | no | Canvas object id (objBase::m_nID). For part/symbol placement (PlacePart / PlacePartFromLibrary / PlaceKicadSymbol / PlaceSymbol / PlaceSymbolFromLibrary), this is the schem_part_enc container id — same as kernel snapshot symbol_instances[].canvas_object_id and pin_instances[].canvas_object_id. |
+| `objectIds` | `bigint[]` | yes | All placed section object ids (PlaceKicadSymbol multi-section loop). |
+| `sectionCount` | `number` | no | Number of sections in the package (GetSectionCount); set by PlaceKicadSymbol when available. |
+
+## Response Example
+
+Representative response structure (field values are placeholders):
+
+```json
+{
+  "success": false,
+  "objectId": "123456789",
+  "objectIds": [
+    "123456789"
+  ],
+  "sectionCount": 0
+}
+```
+
+## Prerequisites
+
+- [project-get-active-project](../../project/get-active-project/SKILL.md) — Discover the active project before building project-scoped context.
+
+See also [skill-dependencies.md](../../references/skill-dependencies.md) for common workflows.
+
+## How to Use
+
+Execute via the HQ EDA skill runtime with a connected `EditorClient`. See [quickstart.md](../../references/quickstart.md) for the full `listEditors` → `connect` → `getSkill` → `execute` chain.
+
+```typescript
+import { getSkill, toJsonString } from "@huaqiu/hqeda";
+
+const skill = getSkill("placement-place-kicad-symbol");
+const result = await skill.execute({ client }, {
+  context: "<ProjectContext via client.createProjectContext('my-project')>",
+  component: {},
+  localPos: {"x":0,"y":0},
+});
+console.log(toJsonString(result, { prettySpaces: 2 }));
+```
+
+Serialize responses with `toJsonString()` — see [serialization.md](../../references/serialization.md).
+
+## Related Skills
+
+- Other **placement** skills: [`placement/`](../)
+- Full index: [All EDA skills](../../SKILL.md)
+- Install: `npx skills add Huaqiu-Electronics/skills --path eda/placement/place-kicad-symbol`
+

package/skills/hqsch-scenario-b/docs/rpc/placement-place-part-from-library.md

@@ -0,0 +1,106 @@
+---
+name: placement-place-part-from-library
+metadata:
+  category: placement
+  service: ComponentPlaceService
+  method: PlacePartFromLibrary
+  rpcKind: unary
+description: >-
+  Place a part from local/builtin library (discrete, etc.). Invoke when online part-search has no match or user specifies a local libraryName/partName; requires active schematic page.
+version: 0.1.0
+vendor: Huaqiu Electronics
+tags:
+  - eda
+  - huaqiu
+  - placement
+entry: "@huaqiu/hqeda"
+manifest: "@huaqiu/hqeda/skill.json"
+inputSchema:
+  name: PlacePartFromLibraryRequestSchema
+  namespace: HqServicesV1ComponentPlaceService
+---
+
+# Place Part From Library
+
+Place a part from local/builtin library (discrete, etc.). Invoke when online part-search has no match or user specifies a local libraryName/partName; requires active schematic page.
+
+## Overview
+
+This skill provides access to the **`ComponentPlaceService.PlacePartFromLibrary`** RPC method on the Huaqiu EDA engine. It is part of the **placement** domain and executes against the `componentPlace` client.
+
+| Property | Value |
+| --- | --- |
+| Skill ID | `placement-place-part-from-library` |
+| Service | `ComponentPlaceService` |
+| Method | `PlacePartFromLibrary` |
+| Transport | Unary (unary) |
+| Domain | placement |
+| Request type | `PlacePartFromLibraryRequest` |
+| Response type | `ObjectPlaceResponse` |
+
+## Parameters
+
+| Name | Type | Required | Repeated | Description |
+| --- | --- | --- | --- | --- |
+| `context` | `ProjectContext` | no | no | — |
+| `localPos` | `Vector2i64` | no | no | — |
+| `libraryName` | `string` | yes | no | — |
+| `partName` | `string` | yes | no | — |
+| `libraryFilePath` | `string` | yes | no | — |
+
+## Response
+
+Returns a `ObjectPlaceResponse` message with the following fields:
+
+| Name | Type | Repeated | Description |
+| --- | --- | --- | --- |
+| `success` | `boolean` | no | — |
+| `objectId` | `bigint` | no | Canvas object id (objBase::m_nID). For part/symbol placement (PlacePart / PlacePartFromLibrary / PlaceKicadSymbol / PlaceSymbol / PlaceSymbolFromLibrary), this is the schem_part_enc container id — same as kernel snapshot symbol_instances[].canvas_object_id and pin_instances[].canvas_object_id. |
+| `objectIds` | `bigint[]` | yes | All placed section object ids (PlaceKicadSymbol multi-section loop). |
+| `sectionCount` | `number` | no | Number of sections in the package (GetSectionCount); set by PlaceKicadSymbol when available. |
+
+## Response Example
+
+Representative response structure (field values are placeholders):
+
+```json
+{
+  "success": false,
+  "objectId": "123456789",
+  "objectIds": [
+    "123456789"
+  ],
+  "sectionCount": 0
+}
+```
+
+## Prerequisites
+
+- [project-get-active-project](../../project/get-active-project/SKILL.md) — Discover the active project before building project-scoped context.
+
+See also [skill-dependencies.md](../../references/skill-dependencies.md) for common workflows.
+
+## How to Use
+
+Execute via the HQ EDA skill runtime with a connected `EditorClient`. See [quickstart.md](../../references/quickstart.md) for the full `listEditors` → `connect` → `getSkill` → `execute` chain.
+
+```typescript
+import { getSkill, toJsonString } from "@huaqiu/hqeda";
+
+const skill = getSkill("placement-place-part-from-library");
+const result = await skill.execute({ client }, {
+  context: "<ProjectContext via client.createProjectContext('my-project')>",
+  localPos: {"x":0,"y":0},
+  libraryName: "Device",
+});
+console.log(toJsonString(result, { prettySpaces: 2 }));
+```
+
+Serialize responses with `toJsonString()` — see [serialization.md](../../references/serialization.md).
+
+## Related Skills
+
+- Other **placement** skills: [`placement/`](../)
+- Full index: [All EDA skills](../../SKILL.md)
+- Install: `npx skills add Huaqiu-Electronics/skills --path eda/placement/place-part-from-library`
+