Add instance health checks

[sjmiller609]

Summary

• add instance health_check policy and health_status response fields for http, tcp, and exec probes
• add a lib/healthcheck controller with timing, thresholds, start-period handling, and runtime status persistence
• wire the controller into the api process and document lifecycle semantics in lib/healthcheck/README.md

Tests

• go test ./lib/healthcheck
• go test ./lib/instances -run 'TestValidateCreateRequestHealthCheck|TestValidateUpdateInstanceRequest|TestManagerUpdateInstanceHealthCheckOnlyPublishesLifecycleUpdate|TestLifecycleEventMetrics_ObserveSubscribersQueueDepthAndDrops|TestLifecycleSubscribers'\n- go test ./cmd/api/api -run 'TestCreateInstance_MapsHealthCheckPolicy|TestUpdateInstance_MapsHealthCheckPatch|TestCreateInstance_MapsAutoStandbyPolicy|TestUpdateInstance_MapsAutoStandbyPatch'\n- go test ./cmd/api -run TestDoesNotExist\n- go test ./lib/providers\n\n## Notes\n- go test ./cmd/api/api is currently blocked by Docker Hub unauthenticated pull rate limits and local network bridge permissions in existing integration tests.\n- make generate-wire is currently blocked because the checked-in wire binary was built with Go 1.24 and this package now requires Go 1.25; wire_gen.go was updated in the same small shape and go test ./cmd/api -run TestDoesNotExist passes.

[github-actions]

✱ Stainless preview builds for hypeman

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

feat: Add instance health checks

Edit this comment to update it. It will appear in the SDK's changelogs.

✅ hypeman-openapi studio · code · diff

Your SDK build had at least one new note diagnostic, which is a regression from the base state.
generate ✅

New diagnostics (5 note)

💡 Model/Recommended: We recommend you use a model for `#/components/schemas/HealthCheck`

💡 Model/Recommended: We recommend you use a model for `#/components/schemas/HealthCheckExec`

💡 Model/Recommended: We recommend you use a model for `#/components/schemas/HealthCheckHTTP`

💡 Model/Recommended: We recommend you use a model for `#/components/schemas/HealthCheckTCP`

💡 Model/Recommended: We recommend you use a model for `#/components/schemas/InstanceHealthStatus`

✅ hypeman-typescript studio · code · diff

Your SDK build had at least one new note diagnostic, which is a regression from the base state.
generate ✅ → build ✅ → lint ❗ → test ✅

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

New diagnostics (5 note)

💡 Model/Recommended: We recommend you use a model for `#/components/schemas/HealthCheck`

💡 Model/Recommended: We recommend you use a model for `#/components/schemas/HealthCheckExec`

💡 Model/Recommended: We recommend you use a model for `#/components/schemas/HealthCheckHTTP`

💡 Model/Recommended: We recommend you use a model for `#/components/schemas/HealthCheckTCP`

💡 Model/Recommended: We recommend you use a model for `#/components/schemas/InstanceHealthStatus`

✅ hypeman-go studio · code · diff

Your SDK build had at least one new note diagnostic, which is a regression from the base state.
generate ✅ → build ✅ → lint ✅ → test ✅

go get github.com/stainless-sdks/hypeman-go@831d6b440183ca8bd08b193a7a2089896784c88e

New diagnostics (5 note)

💡 Model/Recommended: We recommend you use a model for `#/components/schemas/HealthCheck`

💡 Model/Recommended: We recommend you use a model for `#/components/schemas/HealthCheckExec`

💡 Model/Recommended: We recommend you use a model for `#/components/schemas/HealthCheckHTTP`

💡 Model/Recommended: We recommend you use a model for `#/components/schemas/HealthCheckTCP`

💡 Model/Recommended: We recommend you use a model for `#/components/schemas/InstanceHealthStatus`

---

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-05-16 02:50:49 UTC