Un Contrato común de capacidad es el límite compartido que permite a distintos equipos trabajar antes de que esté disponible el hardware final. Describe la función, no un permiso ilimitado para usar un Resource.
contract_idIdentificador estable del contrato de función o Perfil.
functionAcción/resultado legible por humanos, por ejemplo locate_marks.
input_schemaObjetos de entrada versionados, unidades, rangos permitidos y archivos requeridos.
output_schemaResultado versionado, campos de calidad, unidades, referencias de Evidencia y estados de error.
resource_targetHSIMC Resource o clase objetivo; la instancia física real se vincula por separado.
execution_modesimulation / physical_reference / physical_delivered / operational.
conditionsEntorno, tooling, calibración, material y condiciones previas.
authority_requiredAutoridad mínima requerida para descubrir, leer, reservar, configurar, ejecutar, detener, aceptar o administrar.
effect_identityDigest o identificador que fija el efecto físico previsto independientemente de credenciales de corta duración.
operation_idIdentidad estable utilizada para reintento/lectura posterior de una solicitud con efecto físico.
freshness_requirementAntigüedad máxima aceptable de las observaciones utilizadas para autorizar o planificar la acción.
resource_lockingReserva, lease, comportamiento busy/conflict y regla de liberación.
safety_boundaryCondiciones que deben permanecer locales/deterministas y no pueden delegarse a un modelo remoto.
acceptanceMedición, tolerancias, Evidencia y paso de aceptación humana/organizacional.
recoveryComportamiento de parada, resultado desconocido, red interrumpida y reinicio.
versionReferencias de versión de contrato, adaptador, algoritmo, hardware/BOM, calibración y despliegue.
cost_timeCampos de tiempo esperado y real, material, energía y coste monetario.
rightsRestricciones de contribución, reutilización, atribución, confidencialidad y retirada.
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"]
}
El mismo contrato puede ejecutarse contra imágenes fijas, un simulador cloud, una cámara de referencia remota o un dispositivo entregado. Cada objetivo sigue requiriendo su propio adaptador y Evidencia.
Un reintento debería reutilizar el operation_id original cuando el efecto físico solicitado sea el mismo. Si el resultado es desconocido, consultar la operación original antes de crear un nuevo efecto. Nuevas credenciales o un token renovado no crean por sí mismos un nuevo Work físico.