Common Capability Contract 是讓不同團隊在最終硬件完成前共同工作的 shared boundary,描述的是 function,不是無限使用某 Resource 的 permission。
contract_id穩定 contract/Profile identifier。 ## C.Field - function
人類可讀動作/結果,例如 locate_marks。 ## C.Field -
input_schema 版本化輸入對象、單位、範圍和必需文件。 ##
C.Field - output_schema 版本化結果、quality
fields、units、Evidence refs、error states。 ## C.Field -
resource_target HSIMC Resource 或 target class;真實
physical instance 單獨綁定。 ## C.Field - execution_mode
simulation / physical_reference / physical_delivered / operational。
## C.Field - conditions
環境、tooling、calibration、material、prerequisites。 ## C.Field -
authority_required
discover/read/reserve/configure/execute/stop/accept/administer 所需最低
Authority。 ## C.Field - effect_identity 獨立於短期
credential 的 intended physical effect digest/identifier。 ## C.Field -
operation_id 用於 retry/read-back 的穩定物理副作用請求
identity。 ## C.Field - freshness_requirement 用於
planning/authorization 的 observation 最大可接受年齡。 ## C.Field -
resource_locking reservation、lease、busy/conflict 和
release rule。 ## C.Field - safety_boundary
必須留在本地/deterministic、不委託遠程模型的條件。 ## C.Field -
acceptance measurement、tolerance、Evidence 與
human/organization acceptance。 ## C.Field - recovery
stop、unknown-result、network interruption、restart behavior。 ##
C.Field - version
contract、adapter、algorithm、hardware/BOM、calibration、deployment
refs。 ## C.Field - cost_time
預期/實際時間、材料、能源、money cost。 ## C.Field - rights
contribution、reuse、attribution、confidentiality、withdrawal
constraints。
locate_marks{
"contract_id": "hsimc.locate_marks.v0",
"function": "locate_marks",
"input": {"image_ref": "sha256:...", "marker_profile": "marker-profile-v3", "calibration_ref": null},
"target": {"resource_id": null, "mode": "simulation"},
"authority": {"subject": "bound-at-runtime", "scope": ["read_input", "run_observation"]},
"output": {"coordinate_space": "pixels", "marks": [], "quality": {}, "evidence_refs": []},
"limits": ["No millimetre conversion without calibration evidence", "Observation only; no machine motion or laser action"]
}同一 contract 可以運行於 fixed image、cloud simulator、remote reference camera 或 delivered device,但每個 target 都需要自己的 adapter 和 Evidence。
請求相同 physical effect 時 retry 復用原
operation_id;結果未知時先 query 原 operation,再考慮新
effect。更新 credential/token 本身不會創建新的 physical Work。