feat(builds): expose builder VM instance ID in build response

[hiroTamada]

Summary

• Add builder_instance_id field to the Build API response for debugging purposes
• This exposes the existing BuilderInstance field that was already stored in build metadata but not returned to clients

Changes

• openapi.yaml: Add builder_instance_id to Build schema (nullable string)
• lib/builds/types.go: Add BuilderInstanceID field to domain Build struct
• lib/builds/storage.go: Update toBuild() to copy BuilderInstance → BuilderInstanceID
• cmd/api/api/builds.go: Update buildToOAPI() to map the new field

Test plan

• Run make oapi-generate to regenerate lib/oapi/oapi.go
• Verify API returns builder_instance_id in build responses
• Check that existing builds without the field return null

Notes

• No existing tests for buildToOAPI or toBuild conversion functions
• The lib/oapi/oapi.go file needs to be regenerated after checkout via make oapi-generate

---

Note

Adds the builder VM instance ID to build responses and ensures codegen stays in sync.

• Extend Build schema with builder_instance_id (nullable) in openapi.yaml; regenerate lib/oapi/oapi.go
• Add BuilderInstanceID to domain Build (lib/builds/types.go) and map from stored BuilderInstance in toBuild() (lib/builds/storage.go)
• Map field in API response via buildToOAPI() (cmd/api/api/builds.go)
• CI: update .github/workflows/test.yml to run make oapi-generate before build/tests

^{Written by Cursor Bugbot for commit f1ef89f. This will update automatically on new commits. Configure here.}

[github-actions]

✱ Stainless preview builds

This PR will update the hypeman SDKs with the following commit message.

feat(builds): expose builder VM instance ID in build response

⚠️ hypeman-typescript studio · code

There was a regression in your SDK.
generate ⚠️ → build ✅ → lint ✅ → test ✅

npm install https://pkg.stainless.com/s/hypeman-typescript/46d5e26a7c2d5f53b4a9d88558d0f96561cf1b7d/dist.tar.gz

⚠️ hypeman-go studio · code

There was a regression in your SDK.
generate ⚠️ → lint ✅ → test ✅

go get github.com/stainless-sdks/hypeman-go@7fea1660f3d17d8a35f5d2f6aa352b553785624b

❗ hypeman-cli studio

Code was not generated because there was a fatal error.

---

This comment is auto-generated by GitHub Actions and is automatically kept up to date as you push.
If you push custom code to the preview branch, re-run this workflow to update the comment.
Last updated: 2026-01-27 20:06:03 UTC