abelien-harness 0.15.0 → 0.16.0

package/skills/abelien-algorithm/contract/host-tools.generated.json

@@ -0,0 +1,1235 @@
+{
+  "schema": "abelien.host-tools.v1",
+  "package": "abelien-algorithm",
+  "actions": [
+    {
+      "action_id": "algorithm.candidates",
+      "contract_version": 1,
+      "definition_digest": "b56ce171dbde92d68a3aec1ae149b1e7ceeb1e35d71b3bc34561cf2f8fa0f012",
+      "audience": "agent",
+      "description": "核验 Agent 基于 implementation 研究为每个 reaction 提出的候选实现：引用须逐字出现在本次研究存下的正文，候选只能引用为自己 reaction 检索的页面，库内算法须来自研究输入的库清单；每个 reaction 要么有候选、要么写明未解决原因；保存为 status=proposed，不依赖硬件",
+      "input_schema": {
+        "title": "abelien.algorithm.candidates.input.v1",
+        "description": "基于 implementation 研究为每个 reaction 提出的候选实现；research_id 由宿主按本步检索结果填入，其余字段与 algorithm-candidates 相同。",
+        "type": "object",
+        "required": [
+          "research_id",
+          "candidates"
+        ],
+        "properties": {
+          "research_id": {
+            "type": "string",
+            "pattern": "^algorithm-research:[A-Za-z0-9][A-Za-z0-9_-]{0,127}$",
+            "description": "已存的算法研究资源"
+          },
+          "candidates": {
+            "type": "array",
+            "maxItems": 40,
+            "description": "每个 reaction 1–3 个候选；违反硬约束的不提交。",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "reaction_id",
+                "implementation_ref",
+                "implementation_type",
+                "execution_target",
+                "summary"
+              ],
+              "properties": {
+                "reaction_id": {
+                  "type": "string",
+                  "description": "需求里的 reaction id。"
+                },
+                "implementation_ref": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 80,
+                  "description": "实现的简短名称（如 FastLED、Open-Meteo Forecast API、microWakeWord），不带网址、括号说明或用途；说明写进 summary。绑定时原样引用。"
+                },
+                "implementation_version": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "maxLength": 60,
+                  "description": "来源写明的确定版本（如 3.9.0、v2.1.0、One Call 3.0 的 3.0）；来源没写就填 null，不填 latest、main。"
+                },
+                "implementation_type": {
+                  "enum": [
+                    "firmware",
+                    "library",
+                    "model",
+                    "cloud_service"
+                  ]
+                },
+                "execution_target": {
+                  "enum": [
+                    "edge",
+                    "cloud",
+                    "hybrid"
+                  ]
+                },
+                "library_entry_id": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "description": "库内已适配算法的 entry_id；库外候选省略或填 null。"
+                },
+                "summary": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 500,
+                  "description": "怎么用它实现这个 reaction。"
+                },
+                "needs": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "description": "对硬件的需求，按来源原文记录；原文没写的填 null 或留空列表，不猜。",
+                  "properties": {
+                    "compute": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "maxLength": 500
+                    },
+                    "memory": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "maxLength": 500
+                    },
+                    "storage": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "maxLength": 500
+                    },
+                    "runtime": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "maxLength": 500
+                    },
+                    "network": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "maxLength": 500
+                    },
+                    "interfaces": {
+                      "type": "array",
+                      "maxItems": 20,
+                      "items": {
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 120
+                      },
+                      "description": "每项一个接口的短名，如 I2C、GPIO、I2S microphone。"
+                    },
+                    "sensors": {
+                      "type": "array",
+                      "maxItems": 20,
+                      "items": {
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 120
+                      }
+                    }
+                  }
+                },
+                "quotes": {
+                  "type": "array",
+                  "maxItems": 6,
+                  "description": "逐字取自本次研究读到的正文（可以是为别的 reaction 读到的页面，同一份资料常常支撑几个 reaction）；库外候选至少一条。",
+                  "items": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": [
+                      "page_id",
+                      "text"
+                    ],
+                    "properties": {
+                      "page_id": {
+                        "type": "string",
+                        "description": "本次研究的页面 id，如 p3。"
+                      },
+                      "text": {
+                        "type": "string",
+                        "minLength": 8,
+                        "maxLength": 400
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "unresolved": {
+            "type": "array",
+            "description": "确实找不到候选的 reaction，每个只写一次。",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "reaction_id",
+                "reason"
+              ],
+              "properties": {
+                "reaction_id": {
+                  "type": "string"
+                },
+                "reason": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 500
+                }
+              }
+            }
+          },
+          "unknowns": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 500
+            }
+          }
+        },
+        "additionalProperties": false
+      },
+      "output_schema": {
+        "title": "abelien.algorithm.candidates.result.v1",
+        "description": "保存为 algorithm-research（status=proposed）的候选；不依赖硬件。",
+        "type": "object",
+        "required": [
+          "id",
+          "status",
+          "schema",
+          "collected_id",
+          "candidates",
+          "unresolved",
+          "unknowns"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "status": {
+            "const": "proposed"
+          },
+          "schema": {
+            "type": "string",
+            "minLength": 1
+          },
+          "collected_id": {
+            "type": "string",
+            "minLength": 1,
+            "description": "所依据的 collected 研究"
+          },
+          "candidates": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            }
+          },
+          "unresolved": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            }
+          },
+          "unknowns": {
+            "type": "array",
+            "description": "未解决的缺口"
+          }
+        }
+      }
+    },
+    {
+      "action_id": "algorithm.finalize",
+      "contract_version": 1,
+      "definition_digest": "97b448d37858372a35e5a4040102ccbbeccc9e5437657cf20724c8369594062e",
+      "audience": "agent",
+      "description": "把 Agent 基于硬件型号和官方联网证据做出的算法绑定归一化为版本化选型资源；operation=bind 时候选取自 algorithm.candidates，来源回执从 Harness 自己存下的研究正文解析，硬件基线尚未 verified 时结果固定为 needs_confirmation",
+      "input_schema": {
+        "title": "abelien.algorithm.finalize.input.v1",
+        "description": "把 Agent 的算法绑定归一化为版本化选型资源。operation=bind 时候选取自 algorithm.candidates（proposed_id），来源回执由 Harness 从存下的研究正文填写；硬件基线尚未 verified 时结果固定为 needs_confirmation。",
+        "type": "object",
+        "required": [
+          "hardware_selection_id",
+          "hardware_selection_revision",
+          "requirements",
+          "reactions",
+          "research"
+        ],
+        "properties": {
+          "operation": {
+            "enum": [
+              "select",
+              "bind"
+            ],
+            "description": "缺省 select"
+          },
+          "hardware_selection_id": {
+            "type": "string",
+            "pattern": "^hardware-selection:[A-Za-z0-9][A-Za-z0-9_-]{0,127}$",
+            "description": "已存的硬件选型资源"
+          },
+          "hardware_selection_revision": {
+            "type": "string",
+            "minLength": 1
+          },
+          "proposed_id": {
+            "type": "string",
+            "pattern": "^algorithm-research:[A-Za-z0-9][A-Za-z0-9_-]{0,127}$",
+            "description": "仅 bind：已提议候选所在的研究"
+          },
+          "requirements": {
+            "type": "object",
+            "required": [
+              "limits"
+            ],
+            "properties": {
+              "limits": {
+                "type": "array",
+                "description": "约束（没有时为空数组）"
+              }
+            },
+            "description": "clarify 整理后的需求原样"
+          },
+          "reactions": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object"
+            },
+            "description": "需求的 reaction[] 原样，必须覆盖全部 reaction"
+          },
+          "research": {
+            "title": "abelien.algorithm-bindings.v1",
+            "description": "绑定与来源（bind 时 candidates 由 Harness 从 proposed 候选填入）",
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "bindings",
+              "sources"
+            ],
+            "properties": {
+              "bindings": {
+                "type": "array",
+                "description": "每个 reaction 恰好一条。",
+                "items": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": [
+                    "reaction_id",
+                    "implementation_ref",
+                    "implementation_version",
+                    "implementation_type",
+                    "execution_target",
+                    "hardware_component_ids",
+                    "source_ids",
+                    "compatibility",
+                    "constraint_checks"
+                  ],
+                  "properties": {
+                    "reaction_id": {
+                      "type": "string"
+                    },
+                    "implementation_ref": {
+                      "type": "string",
+                      "maxLength": 80,
+                      "description": "该 reaction 已提议候选之一的 implementation_ref，原样照抄。"
+                    },
+                    "implementation_version": {
+                      "type": "string",
+                      "maxLength": 60,
+                      "description": "确定版本；候选没写版本时取厂商或实现资料写明的版本，查不到就照实填 unknown（结果会保持待确认）。"
+                    },
+                    "implementation_type": {
+                      "enum": [
+                        "firmware",
+                        "library",
+                        "model",
+                        "cloud_service"
+                      ]
+                    },
+                    "execution_target": {
+                      "enum": [
+                        "edge",
+                        "cloud",
+                        "hybrid"
+                      ]
+                    },
+                    "hardware_component_ids": {
+                      "type": "array",
+                      "minItems": 1,
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "已登记硬件选型里的 component_id。"
+                    },
+                    "source_ids": {
+                      "type": "array",
+                      "minItems": 1,
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "sources[].id：至少一条覆盖所列型号的 hardware_vendor 来源，和一条 implementation_ref 与版本都相同的实现来源。"
+                    },
+                    "compatibility": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "required": [
+                        "io",
+                        "runtime",
+                        "dependencies",
+                        "network",
+                        "license",
+                        "resources"
+                      ],
+                      "properties": {
+                        "io": {
+                          "type": "object",
+                          "additionalProperties": false,
+                          "required": [
+                            "status",
+                            "summary",
+                            "source_ids"
+                          ],
+                          "properties": {
+                            "status": {
+                              "enum": [
+                                "pass",
+                                "conflict",
+                                "unknown"
+                              ],
+                              "description": "来源能证明成立才写 pass；证据不够写 unknown，冲突写 conflict。"
+                            },
+                            "summary": {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 500
+                            },
+                            "source_ids": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              },
+                              "description": "支撑这条判断的 sources[].id。"
+                            }
+                          }
+                        },
+                        "runtime": {
+                          "type": "object",
+                          "additionalProperties": false,
+                          "required": [
+                            "status",
+                            "summary",
+                            "source_ids"
+                          ],
+                          "properties": {
+                            "status": {
+                              "enum": [
+                                "pass",
+                                "conflict",
+                                "unknown"
+                              ],
+                              "description": "来源能证明成立才写 pass；证据不够写 unknown，冲突写 conflict。"
+                            },
+                            "summary": {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 500
+                            },
+                            "source_ids": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              },
+                              "description": "支撑这条判断的 sources[].id。"
+                            }
+                          }
+                        },
+                        "dependencies": {
+                          "type": "object",
+                          "additionalProperties": false,
+                          "required": [
+                            "status",
+                            "summary",
+                            "source_ids"
+                          ],
+                          "properties": {
+                            "status": {
+                              "enum": [
+                                "pass",
+                                "conflict",
+                                "unknown"
+                              ],
+                              "description": "来源能证明成立才写 pass；证据不够写 unknown，冲突写 conflict。"
+                            },
+                            "summary": {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 500
+                            },
+                            "source_ids": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              },
+                              "description": "支撑这条判断的 sources[].id。"
+                            }
+                          }
+                        },
+                        "network": {
+                          "type": "object",
+                          "additionalProperties": false,
+                          "required": [
+                            "status",
+                            "summary",
+                            "source_ids"
+                          ],
+                          "properties": {
+                            "status": {
+                              "enum": [
+                                "pass",
+                                "conflict",
+                                "unknown"
+                              ],
+                              "description": "来源能证明成立才写 pass；证据不够写 unknown，冲突写 conflict。"
+                            },
+                            "summary": {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 500
+                            },
+                            "source_ids": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              },
+                              "description": "支撑这条判断的 sources[].id。"
+                            }
+                          }
+                        },
+                        "license": {
+                          "type": "object",
+                          "additionalProperties": false,
+                          "required": [
+                            "status",
+                            "summary",
+                            "source_ids"
+                          ],
+                          "properties": {
+                            "status": {
+                              "enum": [
+                                "pass",
+                                "conflict",
+                                "unknown"
+                              ],
+                              "description": "来源能证明成立才写 pass；证据不够写 unknown，冲突写 conflict。"
+                            },
+                            "summary": {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 500
+                            },
+                            "source_ids": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              },
+                              "description": "支撑这条判断的 sources[].id。"
+                            }
+                          }
+                        },
+                        "resources": {
+                          "type": "object",
+                          "additionalProperties": false,
+                          "required": [
+                            "status",
+                            "summary",
+                            "source_ids"
+                          ],
+                          "properties": {
+                            "status": {
+                              "enum": [
+                                "pass",
+                                "conflict",
+                                "unknown"
+                              ],
+                              "description": "来源能证明成立才写 pass；证据不够写 unknown，冲突写 conflict。"
+                            },
+                            "summary": {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 500
+                            },
+                            "source_ids": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              },
+                              "description": "支撑这条判断的 sources[].id。"
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "constraint_checks": {
+                      "type": "array",
+                      "description": "需求里每条非 preference 的 limits 各一条。",
+                      "items": {
+                        "type": "object",
+                        "additionalProperties": false,
+                        "required": [
+                          "constraint_id",
+                          "status",
+                          "summary",
+                          "source_ids"
+                        ],
+                        "properties": {
+                          "constraint_id": {
+                            "type": "string",
+                            "description": "limits[].id。"
+                          },
+                          "status": {
+                            "enum": [
+                              "pass",
+                              "conflict",
+                              "unknown"
+                            ]
+                          },
+                          "summary": {
+                            "type": "string",
+                            "minLength": 1,
+                            "maxLength": 500
+                          },
+                          "source_ids": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              "sources": {
+                "type": "array",
+                "maxItems": 64,
+                "items": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": [
+                    "id",
+                    "research_id",
+                    "page_id",
+                    "source_type",
+                    "title",
+                    "publisher",
+                    "version",
+                    "excerpt"
+                  ],
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "description": "本次提交内唯一。"
+                    },
+                    "research_id": {
+                      "type": "string",
+                      "description": "页面所在的 algorithm-research 资源 id（实现研究或本步厂商检索）。"
+                    },
+                    "page_id": {
+                      "type": "string",
+                      "description": "该研究里 text_source=page 的页面 id；检索摘要页不算证据。"
+                    },
+                    "source_type": {
+                      "enum": [
+                        "hardware_vendor",
+                        "implementation_official",
+                        "huggingface",
+                        "cloud_vendor"
+                      ],
+                      "description": "按发布方选：所选型号的厂商资料 hardware_vendor；库、固件或模型的官方资料 implementation_official；Hugging Face 模型卡 huggingface；云服务官方文档 cloud_vendor。分销商、博客、论坛不是一手来源，不要列为来源。"
+                    },
+                    "title": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 300
+                    },
+                    "publisher": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 200
+                    },
+                    "version": {
+                      "type": "string",
+                      "maxLength": 60,
+                      "description": "页面写明的文档版本、修订号或对应的实现版本；没写就填 unknown（结果会保持待确认）。"
+                    },
+                    "excerpt": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 1200,
+                      "description": "逐字取自该页正文的一段，支撑本来源被引用的结论。"
+                    },
+                    "hardware_component_ids": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "hardware_vendor 来源覆盖的 component_id。"
+                    },
+                    "implementation_ref": {
+                      "type": "string",
+                      "maxLength": 80,
+                      "description": "实现来源对应的 implementation_ref，与绑定一致。"
+                    }
+                  }
+                }
+              },
+              "unknowns": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "maxLength": 1000
+                }
+              },
+              "blocking_unknowns": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "maxLength": 1000
+                },
+                "description": "影响能否按此绑定实现的未知，写明怎么核实。"
+              },
+              "unavailable_sources": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "maxLength": 500
+                },
+                "description": "想读但读不到的资料及原因。"
+              }
+            }
+          }
+        }
+      },
+      "output_schema": {
+        "title": "abelien.algorithm.finalize.result.v1",
+        "description": "保存为 algorithm-selection 的算法选型。verified 必有绑定与来源、没有阻断未知。",
+        "type": "object",
+        "required": [
+          "id",
+          "status",
+          "hardware_selection_id",
+          "hardware_selection_revision",
+          "source_snapshot",
+          "revision",
+          "bindings",
+          "candidates",
+          "sources",
+          "unavailable_sources",
+          "unknowns",
+          "blocking_unknowns"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "status": {
+            "enum": [
+              "verified",
+              "needs_confirmation"
+            ]
+          },
+          "hardware_selection_id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "hardware_selection_revision": {
+            "type": "string",
+            "minLength": 1
+          },
+          "operation": {
+            "const": "bind"
+          },
+          "proposed_id": {
+            "type": "string"
+          },
+          "source_snapshot": {
+            "type": "string",
+            "minLength": 1
+          },
+          "revision": {
+            "type": "string",
+            "minLength": 1
+          },
+          "bindings": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            }
+          },
+          "candidates": {
+            "type": "array"
+          },
+          "sources": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            }
+          },
+          "unavailable_sources": {
+            "type": "array"
+          },
+          "unknowns": {
+            "type": "array",
+            "description": "未解决的缺口"
+          },
+          "blocking_unknowns": {
+            "type": "array"
+          }
+        },
+        "allOf": [
+          {
+            "if": {
+              "properties": {
+                "status": {
+                  "const": "verified"
+                }
+              },
+              "required": [
+                "status"
+              ]
+            },
+            "then": {
+              "properties": {
+                "bindings": {
+                  "minItems": 1
+                },
+                "sources": {
+                  "minItems": 1
+                },
+                "blocking_unknowns": {
+                  "maxItems": 0
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    {
+      "action_id": "algorithm.lane-state",
+      "contract_version": 1,
+      "definition_digest": "49dbca22c3b02beb0157012af6ec3042949f2d6e2efb98c887dbad746dce0e79",
+      "audience": "agent",
+      "description": "只读：按本草稿已存的资源回答当前需求有没有已提议的候选（落点、reaction、limits 与研究时一致），以及这些候选有没有绑定到给定的硬件选型 id 与 revision；宿主把结果映射成 workspace.lanes-next 的 artifacts",
+      "input_schema": {
+        "title": "abelien.algorithm.lane-state.input.v1",
+        "description": "只读：按本草稿已存的资源回答当前需求有没有已提议的候选，以及它们有没有绑定到给定的硬件选型。",
+        "type": "object",
+        "required": [
+          "requirements"
+        ],
+        "properties": {
+          "requirements": {
+            "description": "clarify 整理后的需求（Requirements），原样传入；研究只看 context、reaction 与 limits",
+            "type": "object",
+            "required": [
+              "reaction"
+            ],
+            "properties": {
+              "context": {
+                "type": "object",
+                "properties": {
+                  "text": {
+                    "type": "string"
+                  },
+                  "source": {
+                    "enum": [
+                      "user",
+                      "system"
+                    ]
+                  }
+                },
+                "description": "使用场景"
+              },
+              "reaction": {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 20,
+                "items": {
+                  "type": "object",
+                  "required": [
+                    "id",
+                    "text"
+                  ],
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "text": {
+                      "type": "string",
+                      "minLength": 1
+                    }
+                  }
+                },
+                "description": "触发→反应条目，1–20 条，id 不重复"
+              },
+              "limits": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "required": [
+                    "id"
+                  ],
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "text": {
+                      "type": "string"
+                    },
+                    "strength": {
+                      "enum": [
+                        "hard",
+                        "preference"
+                      ]
+                    }
+                  }
+                },
+                "description": "约束；只有明确的 preference 不阻断"
+              },
+              "intent": {
+                "type": "object"
+              }
+            }
+          },
+          "hardware_selection_id": {
+            "oneOf": [
+              {
+                "type": "null"
+              },
+              {
+                "type": "string",
+                "pattern": "^hardware-selection:[A-Za-z0-9][A-Za-z0-9_-]{0,127}$",
+                "description": "已存的硬件选型资源"
+              }
+            ],
+            "description": "当前硬件选型；还没有时省略或为 null"
+          },
+          "hardware_selection_revision": {
+            "type": "string",
+            "minLength": 1,
+            "description": "给出硬件选型时必填"
+          }
+        },
+        "additionalProperties": false
+      },
+      "output_schema": {
+        "title": "abelien.algorithm.lane-state.result.v1",
+        "description": "车道状态；宿主把它映射成 workspace.lanes-next 的 artifacts。",
+        "type": "object",
+        "required": [
+          "requirements_digest",
+          "proposed_id",
+          "selection_id",
+          "selection_status"
+        ],
+        "properties": {
+          "requirements_digest": {
+            "type": "string",
+            "minLength": 1,
+            "description": "落点、reaction、limits 的规范化摘要"
+          },
+          "proposed_id": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "同需求最新的已提议候选"
+          },
+          "selection_id": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "这些候选绑定到给定硬件的选型结果"
+          },
+          "selection_status": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "该绑定的状态"
+          }
+        }
+      }
+    },
+    {
+      "action_id": "algorithm.research",
+      "contract_version": 1,
+      "definition_digest": "2ef67d4c15ed3b06fb3772d7ec7ca83de4fb42b06ed740714e679f9bb08dc072",
+      "audience": "agent",
+      "description": "执行 Agent 的检索计划并保存证据：purpose=implementation 只凭需求检索实现资料（可与硬件选型并行），purpose=hardware 检索已选型号的厂商资料；Volc 检索（每次最多 5 条）与公开 HTTPS 页面安全直读，正文按 sha256 存证；每条付费检索先存 sent 再发送，重跑复用已完成检索、结果未知时要求对账而不重发；同一请求完成后重复运行直接返回已有结果",
+      "input_schema": {
+        "title": "abelien.algorithm.research.input.v1",
+        "description": "算法研究的检索计划：implementation 只凭需求检索实现资料（可与硬件选型并行），hardware 检索已选型号的厂商资料。",
+        "type": "object",
+        "required": [
+          "purpose",
+          "requirements",
+          "plan"
+        ],
+        "properties": {
+          "purpose": {
+            "enum": [
+              "implementation",
+              "hardware"
+            ]
+          },
+          "requirements": {
+            "description": "clarify 整理后的需求（Requirements），原样传入；研究只看 context、reaction 与 limits",
+            "type": "object",
+            "required": [
+              "reaction"
+            ],
+            "properties": {
+              "context": {
+                "type": "object",
+                "properties": {
+                  "text": {
+                    "type": "string"
+                  },
+                  "source": {
+                    "enum": [
+                      "user",
+                      "system"
+                    ]
+                  }
+                },
+                "description": "使用场景"
+              },
+              "reaction": {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 20,
+                "items": {
+                  "type": "object",
+                  "required": [
+                    "id",
+                    "text"
+                  ],
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "text": {
+                      "type": "string",
+                      "minLength": 1
+                    }
+                  }
+                },
+                "description": "触发→反应条目，1–20 条，id 不重复"
+              },
+              "limits": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "required": [
+                    "id"
+                  ],
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "text": {
+                      "type": "string"
+                    },
+                    "strength": {
+                      "enum": [
+                        "hard",
+                        "preference"
+                      ]
+                    }
+                  }
+                },
+                "description": "约束；只有明确的 preference 不阻断"
+              },
+              "intent": {
+                "type": "object"
+              }
+            }
+          },
+          "library": {
+            "type": [
+              "array",
+              "null"
+            ],
+            "maxItems": 50,
+            "description": "仅 implementation：库内已有算法清单，候选只能从中引用库内条目",
+            "items": {
+              "type": "object",
+              "required": [
+                "entry_id",
+                "name"
+              ],
+              "properties": {
+                "entry_id": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "name": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 200
+                },
+                "category": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "hardware_selection_id": {
+            "type": "string",
+            "pattern": "^hardware-selection:[A-Za-z0-9][A-Za-z0-9_-]{0,127}$",
+            "description": "仅 hardware：所查型号来自这份选型"
+          },
+          "hardware_selection_revision": {
+            "type": "string",
+            "minLength": 1,
+            "description": "仅 hardware：选型修订号，必须是当前修订"
+          },
+          "plan": {
+            "type": "object",
+            "required": [
+              "queries"
+            ],
+            "properties": {
+              "queries": {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 8,
+                "items": {
+                  "type": "object",
+                  "required": [
+                    "query"
+                  ],
+                  "properties": {
+                    "reaction_id": {
+                      "type": "string",
+                      "description": "implementation 必填：检索服务的 reaction；hardware 可选"
+                    },
+                    "component_id": {
+                      "type": "string",
+                      "description": "仅 hardware：选型里的 component_id"
+                    },
+                    "query": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 200
+                    },
+                    "count": {
+                      "type": "integer",
+                      "minimum": 1,
+                      "maximum": 5
+                    }
+                  },
+                  "additionalProperties": false
+                }
+              },
+              "max_pages": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 12,
+                "default": 8
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "additionalProperties": false
+      },
+      "output_schema": {
+        "title": "abelien.algorithm.research.result.v1",
+        "description": "保存为 algorithm-research 的研究证据（collected）：检索、页面与正文摘要；proposed 是 algorithm.candidates 另存的结果。",
+        "type": "object",
+        "required": [
+          "id",
+          "status",
+          "schema",
+          "request_digest"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "status": {
+            "enum": [
+              "collected",
+              "proposed"
+            ]
+          },
+          "schema": {
+            "type": "string",
+            "minLength": 1
+          },
+          "request_digest": {
+            "type": "string",
+            "minLength": 1
+          },
+          "purpose": {
+            "enum": [
+              "implementation",
+              "hardware"
+            ]
+          },
+          "reactions": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            }
+          },
+          "searches": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            }
+          },
+          "pages": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            },
+            "description": "读取的页面：url、status、text_sha256 与正文 blob 引用"
+          },
+          "unknowns": {
+            "type": "array",
+            "description": "未解决的缺口"
+          }
+        }
+      }
+    }
+  ],
+  "tools": []
+}