abelien-harness 0.16.0 → 0.17.0

package/skills/abelien-hardware/workflows/definitions/d560de3b0aeeaf9447f7bf2d7f831d638067ab7f6cd028527c892ff623ccd00d.json

@@ -0,0 +1,297 @@
+{
+  "name": "user-journey-hardware-candidates",
+  "domain": "abelien-hardware",
+  "description": "Library recall, suitability review, English Volc query and direct source reads (Prismer switchable, off by default) for unresolved slots, source-bound merge, then candidate proposal",
+  "input": {
+    "required": [
+      "requirements"
+    ]
+  },
+  "steps": [
+    {
+      "id": "record-requirements",
+      "executor": "cli",
+      "action": "resource.put",
+      "args": {
+        "kind": "draft",
+        "id": "hardware-candidates-d-{{hash}}",
+        "body": {
+          "requirements": "{{input.requirements}}"
+        }
+      }
+    },
+    {
+      "id": "classify-hardware",
+      "executor": "agent",
+      "instruction": "需求已澄清；requirements 是 clarify 交回的 Requirements：context 为落点与场景，reaction[] 为全部触发→反应，limits[] 每项带 strength。按全部 reaction 推导功能槽位与数量，strength=hard 的 limits 进 hard_constraints，preference 只作排序提示；缺 reaction 或只有品类标签时停止并说明。读取同级 abelien-hardware/SKILL.md，并用其 scripts/load-guide.mjs 依次按需加载 entry、命中的 level1、命中的 level2、contract；只提交功能槽位、数量、受控三级路径和本次硬约束。回复 {\"slots\":[...]}，不要提交型号。",
+      "task": {
+        "actions": [
+          "hardware.guide"
+        ],
+        "skills": [
+          {
+            "package": "abelien-hardware",
+            "path": "SKILL.md"
+          },
+          {
+            "package": "abelien-hardware",
+            "path": "references/selection-service-contract.md"
+          }
+        ],
+        "budget": {
+          "tool_calls": 32
+        },
+        "refs": {
+          "input": "input"
+        },
+        "output": {
+          "package": "abelien-hardware",
+          "schema": "schemas/classify-reply.v1.json"
+        }
+      }
+    },
+    {
+      "id": "search-hardware-wikis",
+      "executor": "cli",
+      "action": "capability.run",
+      "args": {
+        "capability": "hardware.search",
+        "input": {
+          "operation": "search",
+          "query": "{{input.requirements}}",
+          "requirements": "{{input.requirements}}",
+          "slots": "{{steps.classify-hardware.result.slots}}",
+          "policy": {
+            "prefer_system_candidates": true,
+            "top_k_per_slot": 8,
+            "include_content": true
+          }
+        }
+      }
+    },
+    {
+      "id": "hardware-knowledge-recalled",
+      "executor": "cli",
+      "action": "machine.send",
+      "args": {
+        "machine": "hardware-recall",
+        "event": "confirmRecall",
+        "instance": "{{steps.search-hardware-wikis.resource.id}}"
+      }
+    },
+    {
+      "id": "review-hardware-candidates",
+      "executor": "agent",
+      "instruction": "The library candidates are listed in refs.search-hardware-wikis.data.candidate_table: one row per candidate, no page text. Judge candidates from the table first; read a full record or Wiki only for candidates you may keep or whose fit the table cannot decide (one step's reads are budgeted: a reply read_budget_exhausted means decide from what you have read, a candidate already read in this step is answered already_read, and slots with the same candidate list are judged once). Read a full record with hardware.resource {\"resourceId\": refs.search-hardware-wikis.data.resource.id, \"sourcePath\": [\"results\", \"<slot position>\", \"candidates\", \"<row index>\"]} (every segment is a string, e.g. [\"results\", \"0\", \"candidates\", \"3\"]) and its full Wiki with hardware.wiki {\"componentIds\": [...]}; read the original requirements/slots in full. Review suitability against function and every hard constraint. Reply {\"unresolved_slots\":[{\"slot_id\":\"original slot\",\"reason\":\"no candidates or specific reasons all candidates are unsuitable\",\"query\":\"official model search targeting function/category/key hard constraints\",\"count\":5}]}. Every zero-candidate slot requires supplemental search. All unsuitable candidates also require search. Preserve rechargeable built-in battery, wireless charging, and all other original requirements; do not ask the user to drop a requirement because the catalog is empty. unresolved_slots contains only slots that need search. Omit suitable library slots entirely; never add placeholder rows with an empty query or count=0. Return [] when all slots are suitable. Before committing this review, the trusted host validates the full original requirements, slots and recall with validate-web-search-plan.mjs; a VALIDATION reply preserves this pause so the same run can be corrected. Write every query in English and keep model numbers and manufacturer names; a query containing Chinese, Japanese or Korean characters is rejected by that validation at this same pause. Count is optional, an integer from 1 to 5, and defaults to 5. When you already know the exact part for a slot, add optional \"models\":[{\"manufacturer\":\"exact manufacturer\",\"model\":\"full model with every suffix and version\"}] (1-5); the source registry is checked for those models before any search, and a slot whose every named model already has registered documents sends no search. Do not truncate requirements. The trusted host currently records Prismer as disabled for both the query and source reads: it searches Volc directly and reads source pages over public HTTPS, so PDF/image sources stay unavailable. When the host enables Prismer, Volc runs only after a saved definitive denial, successful empty query or unsent missing Key, and sources are read Prismer-first. Unknown dispatched effects never authorize fallback or a new invocation. Do not supply URLs, credentials, commands or providers. System reuse is optional: poor matches must not force complex whole systems. Concept visuals and the original requirements come first.",
+      "replySchema": {
+        "unresolved_slots": "array"
+      },
+      "task": {
+        "actions": [
+          "hardware.resource",
+          "hardware.wiki"
+        ],
+        "skills": [
+          {
+            "package": "abelien-hardware",
+            "path": "SKILL.md"
+          },
+          {
+            "package": "abelien-hardware",
+            "path": "references/selection-service-contract.md"
+          }
+        ],
+        "budget": {
+          "tool_calls": 32
+        },
+        "refs": {
+          "input": "input",
+          "classify-hardware": "steps.classify-hardware.result",
+          "search-hardware-wikis": {
+            "from": "steps.search-hardware-wikis.result",
+            "pick": [
+              "id",
+              "status",
+              "request_digest",
+              "source_snapshot",
+              "retrieval_mode",
+              "candidate_table",
+              "resource.id"
+            ]
+          }
+        }
+      }
+    },
+    {
+      "id": "search-hardware-web",
+      "executor": "cli",
+      "action": "capability.run",
+      "args": {
+        "capability": "hardware.web-search",
+        "input": {
+          "requirements": "{{input.requirements}}",
+          "slots": "{{steps.classify-hardware.result.slots}}",
+          "recall_id": "{{steps.search-hardware-wikis.resource.id}}",
+          "unresolved_slots": "{{steps.review-hardware-candidates.result.unresolved_slots}}",
+          "plan_rules": "volc-english-5"
+        }
+      }
+    },
+    {
+      "id": "extract-web-hardware",
+      "executor": "agent",
+      "instruction": "When pages contain blob_ref or have text null (their text lives in the source registry), use resource get <evidenceResourceId> --page <pageId> to read each required full original page; never copy page bodies into replies. Read the persisted hardware-web-evidence pages from search-hardware-web in full. Search Content/snippets/provider official labels are not complete official pages or proof of authority. Extract only manufacturer pages; uncertain source authority remains unknown and third-party mirrors are not official merely because their URL contains a manufacturer domain. Reply {\"candidates\":[{\"slot_id\":\"original slot\",\"page_id\":\"persisted page ID\",\"manufacturer\":\"exact manufacturer\",\"manufacturer_quote\":\"at least 8 source characters\",\"model\":\"exact model\",\"model_quote\":\"at least 8 source characters\",\"parts\":[{\"name\":\"physical part name\",\"name_quote\":\"exact source quote\",\"shape\":\"box|cylinder|sphere|unknown\",\"shape_quote\":\"exact source quote\",\"dimensions_mm\":{\"length\":20,\"width\":12,\"height\":3},\"dimension_quotes\":{\"length\":\"exact quote identifying this part, axis, numeric value and unit\",\"width\":\"exact quote\",\"height\":\"exact quote\"}}]}]}. Quotes must include the exact part/name/shape they support. Each physical part has separate dimensions; cylinders use diameter/height, spheres use diameter. Unknown dimensions are omitted, never invented or defaulted. Conflicting versions and unknown multi-part overall dimensions remain unknown; do not combine contradictory versions. Do not submit page bodies, official/verified/CAD_available/source/geometry claims. Missing reliable pages or no network means candidates empty. This is envelope_only, not true component CAD or engineering verification. For an attributed tuple such as Back Panel: 48mm x 32mm x 0.5mm, add dimensions_quote with the entire exact source string and dimension_axes:[\"length\",\"width\",\"height\"] in original order; dimensions_mm must map each original value/unit to that explicitly declared axis. Preserve alternate imperial tuples in the quote; never use their values as mm or borrow another part's measurements. A 2-value tuple leaves height unknown. A box inferred from dimensions is only an envelope expression: actual part shape and orientation remain unknown. dimension_quotes may be empty for this tuple mode. Never invent coil thickness or total assembly dimensions. A read PDF lists its drawing pages under transcriptions[] (kind vision_transcription): sizes the vision model read from a drawing. They are estimates, never datasheet facts and never quotes. A part may take its sizes from one completed transcription in the same slot instead of quotes: \"vision_dimensions\":{\"transcription_id\":\"vision-...\",\"items\":{\"length\":0,\"width\":1,\"height\":2}}, where each axis names the index of an item whose value in mm equals that dimension; name_quote still comes from a read page, and a box needs no shape_quote. Pick the item that is the whole outline, not the display area, PCB, mounting-hole pitch or connector.",
+      "replySchema": {
+        "candidates": "array"
+      },
+      "task": {
+        "actions": [
+          "hardware.resource"
+        ],
+        "skills": [
+          {
+            "package": "abelien-hardware",
+            "path": "SKILL.md"
+          },
+          {
+            "package": "abelien-hardware",
+            "path": "references/selection-service-contract.md"
+          }
+        ],
+        "budget": {
+          "tool_calls": 32
+        },
+        "refs": {
+          "input": "input",
+          "classify-hardware": "steps.classify-hardware.result",
+          "search-hardware-wikis": {
+            "from": "steps.search-hardware-wikis.result",
+            "pick": [
+              "id",
+              "status",
+              "request_digest",
+              "source_snapshot",
+              "retrieval_mode",
+              "candidate_table",
+              "resource.id"
+            ]
+          },
+          "review-hardware-candidates": "steps.review-hardware-candidates.result",
+          "search-hardware-web": {
+            "from": "steps.search-hardware-web.result",
+            "omit": [
+              "resource.body"
+            ]
+          }
+        }
+      }
+    },
+    {
+      "id": "merge-hardware-web",
+      "executor": "cli",
+      "action": "capability.run",
+      "args": {
+        "capability": "hardware.web-merge",
+        "input": {
+          "requirements": "{{input.requirements}}",
+          "slots": "{{steps.classify-hardware.result.slots}}",
+          "recall_id": "{{steps.search-hardware-wikis.resource.id}}",
+          "evidence_id": "{{steps.search-hardware-web.resource.id}}",
+          "candidates": "{{steps.extract-web-hardware.result.candidates}}"
+        }
+      }
+    },
+    {
+      "id": "select-hardware-from-wikis",
+      "executor": "agent",
+      "instruction": "读取 context-json 中 merge-hardware-web 的候选和完整 Wiki；按用户硬约束与功能覆盖为各槽位选择零部件；同类整机配置只作参考，不先提出或套用整机（还原、基于现成产品修改或用户明确要求沿用整机时才可提出整机方案），并检查接口、供电、机械、热和软件依赖。只选择候选中的 component_id，不按 draft、selection_gate 或 CAD 状态过滤。召回结果里 unmatched_slots 列出的槽位一个候选都没有：这些槽位必须逐条写进 remaining_slots，status 只能是 needs_confirmation——finalize 会拒绝把无候选槽位静默丢掉的「完整」提案。回复 {\"status\":\"proposed|needs_confirmation\",\"plan_mode\":\"adapt_system|assemble_new\",\"selected_models\":[...],\"coverage_ledger\":[...],\"remaining_slots\":[...],\"unknowns\":[...],\"replacement_plan\":[...]}，每个型号带 slot_id、component_id（候选中的真实值）、manufacturer、model、quantity（1–128 的整数，本槽位实际要用几个，缺失或非整数会被 finalize 拒绝）、selection_reason（字符串）和 wiki_evidence（非空字符串数组，逐条引用该候选完整 Wiki 中支持此选择的原文要点）；coverage_ledger、remaining_slots、unknowns、replacement_plan 均为数组，没有内容时给空数组。 提案不具有正式选型权限；不能提交 hardware-selected 或据此开始算法选型，须另走 hardware.select。 Read only merge-hardware-web candidates for the final choice. Preserve structured limits.envelope and source strength; dimension metadata/name/selection-line identity are supplied by the trusted finalizer, never invented. Incompatible dimension candidates require replacement; only decision_required (user hard limit, measured/datasheet size, no axis-aligned fit) returns needs_confirmation, other risk/unknown stays advisory and risk candidates rank last. A bus type or count shortfall on trusted data (ELECTRICAL_BUS_UNCONFIRMED) needs confirmation: prefer replacing one side, or explain the expansion or driver board that covers it; ELECTRICAL_SUPPLY_GAP means add a power or regulator part. all_indexed_candidates_rejected is scoped to this indexed category; occupancy is advisory and clear is only coarse single-part screening. Whole-system reuse is optional; a poor match never forces a complex baseline. External IDs are external:<hash>, with source authority and engineering unknowns; envelopes are not component CAD and cannot grant adoption or delivery.只读打算选用或需要核对的候选的完整 Wiki；同一步骤的读取有预算：回复 read_budget_exhausted 时按已读内容决定，本步骤已读过的候选回 already_read，不必重读。",
+      "replySchema": {
+        "status": "proposed|needs_confirmation",
+        "plan_mode": "adapt_system|assemble_new",
+        "selected_models": "array",
+        "coverage_ledger": "array",
+        "remaining_slots": "array",
+        "unknowns": "array",
+        "replacement_plan": "array"
+      },
+      "task": {
+        "actions": [
+          "hardware.resource",
+          "hardware.wiki"
+        ],
+        "skills": [
+          {
+            "package": "abelien-hardware",
+            "path": "SKILL.md"
+          },
+          {
+            "package": "abelien-hardware",
+            "path": "references/selection-service-contract.md"
+          }
+        ],
+        "budget": {
+          "tool_calls": 32
+        },
+        "refs": {
+          "input": "input",
+          "classify-hardware": "steps.classify-hardware.result",
+          "search-hardware-wikis": {
+            "from": "steps.search-hardware-wikis.result",
+            "pick": [
+              "id",
+              "status",
+              "request_digest",
+              "source_snapshot",
+              "retrieval_mode",
+              "candidate_table",
+              "resource.id"
+            ]
+          },
+          "review-hardware-candidates": "steps.review-hardware-candidates.result",
+          "search-hardware-web": {
+            "from": "steps.search-hardware-web.result",
+            "omit": [
+              "resource.body"
+            ]
+          },
+          "extract-web-hardware": "steps.extract-web-hardware.result",
+          "merge-hardware-web": {
+            "from": "steps.merge-hardware-web.result",
+            "omit": [
+              "resource.body"
+            ]
+          }
+        }
+      }
+    },
+    {
+      "id": "finalize-hardware-proposal",
+      "executor": "cli",
+      "action": "capability.run",
+      "args": {
+        "capability": "hardware.finalize",
+        "input": {
+          "operation": "create",
+          "planning_mode": "auto",
+          "requirements": "{{input.requirements}}",
+          "slots": "{{steps.classify-hardware.result.slots}}",
+          "knowledge_recall": "{{steps.merge-hardware-web.resource.body}}",
+          "selection_proposal": "{{steps.select-hardware-from-wikis.result}}"
+        }
+      }
+    },
+    {
+      "id": "record-hardware-proposal",
+      "executor": "cli",
+      "action": "resource.update",
+      "args": {
+        "id": "{{steps.record-requirements.resource.id}}",
+        "bodyPatch": {
+          "hardwareProposalId": "{{steps.finalize-hardware-proposal.resource.id}}",
+          "hardwareProposalStatus": "{{steps.finalize-hardware-proposal.result.status}}",
+          "hardwareProposalRevision": "{{steps.finalize-hardware-proposal.result.revision}}"
+        }
+      }
+    }
+  ]
+}