Repository navigation
chore(core): track v0.1.9-pre.3 - #41
Closed
ai-openshell-sdk-python[bot] wants to merge 1 commit into
Closed
ai-openshell-sdk-python[bot] wants to merge 1 commit into
ai-openshell-sdk-python[bot] wants to merge 1 commit into
Conversation
Move the core pin from v0.1.8 to v0.1.9-pre.3 and regenerate the bindings. Signed-off-by: ai-openshell-sdk-python[bot] <354503561+ai-openshell-sdk-python[bot]@users.noreply.github.com>
1 task done
Contributor
Author
|
Superseded by #45, which tracks core |
PSchmiedmayer
added a commit
to SchmiedmayerLab/heartwood
that referenced
this pull request
Nov 17, 2026
…ersion (#324) ### ♻️ Current situation & Problem Managed workers compared the sandbox gateway's reported version with the operator-declared `gateway_versions`. That shows neither that the gateway has the two deletion behaviors revocation evidence depends on, nor anything when the declaration is simply extended. A launch refused for the gateway lost its diagnostic and asked the researcher for outside reconciliation, although nothing had been created. The carried upstream patches recorded neither the upstream change that would retire each one nor how a removal is verified. Closes #291 Closes #292 ### ⚙️ Release Notes - Managed native workers require the registered sandbox gateway to report exactly one compute driver, `openshell/docker`, whose negotiated capabilities include `openshell.compute.delete-awaits-provisioning` and `openshell.compute.delete-retries-deleting`. Otherwise serving, worker launch and reconciliation stop with `HW-WORKER-001` before any sandbox, volume or deletion request. Any gateway version is accepted when both capabilities are reported. - `gateway_versions` is removed from the deployment manifest's `[worker]` table. A 0.5.0 manifest that still contains it fails to load until the key is deleted. - A launch refused this way reports `HW-WORKER-001` in the session, now and for later commands of the same gateway process, and the attempt is recorded as revoked without a created worker. Restart `heartwood gateway serve` after correcting the gateway. - The decision and the reported gateway version, driver and capabilities (`WorkerGatewayReport`) are recorded with each attempt: an accepted report in the runtime binding and revocation evidence, a refused one in the evidence that records the attempt as not created. Existing journals still replay. - The qualification gateway patches report their behaviors as capabilities, and the sandbox SDK patch exposes `gateway_info()`: SDK wheel `openshell 0.1.8+heartwood.2`, qualification gateway `0.1.8+heartwood.3`. - The creation rejection status set from PR 9 is bound to the new gateway patch digests; the patches add only capability reporting and do not change the creation path. - No carried upstream patch can be removed yet. `documentation/architecture/testing.md` lists each patch with its purpose, the related upstream issue or pull request (or none filed), why it remains and the upstream change that would allow its removal, and documents the removal procedure: the pinned release provides the behavior, the build no longer applies the patch, dependent Heartwood workarounds are removed or their retention recorded, and native qualification passes without it. - The dependency patch can go only with an OpenHands release whose SDK metadata requires the security-fixed file-lock release and an inference-client range that admits it. A gateway release that reports the deletion behaviors under other capability names also changes what the managed-worker launcher requires. ### 📚 Documentation - `documentation/operate/platform-requirements.md`: **Gateway Behavior Behind Native Qualification** names both capabilities, the decision record and the self-report limit. - `documentation/reference/configuration.md` (manifest example and key table), `documentation/reference/cli.md`, `documentation/operate/index.md`, `documentation/operate/platform-contract.md` (requirement and failure-state row) and `documentation/reference/glossary.md`: `gateway_versions` removed. - `documentation/reference/troubleshooting.md`: `HW-WORKER-001` is now **Sandbox Gateway Lacks a Required Deletion Capability**, including what a refused launch and a refused reconciliation mean. - `documentation/architecture/system.md` (worker admission step 4, build and qualification) and `documentation/operate/security.md` (**Isolated Worker** and **Gateway Enforcement**). - `documentation/architecture/testing.md`: the gateway patches report their capabilities; the carried patch table with each patch's removal condition, the removal procedure, and how build records and qualification evidence identify the remaining patch set. ### ✅ Testing - Unit tests with the real generated protocol types cover each refusal (unreadable report, no driver, no capabilities, each one missing, another driver, two drivers, a malformed capability), assert that no spec, volume or deletion request is made, and assert the recorded report for every case. - Any reported version, including an unlisted one, is accepted when both capabilities are present, and the report is retained through launch, revocation and reconciliation. A manifest with `gateway_versions` is refused. - `test_gateway_capability_refusal_at_launch_keeps_its_diagnostic` drives a real `SessionGateway` through a refused launch: the session reports `HW-WORKER-001`, nothing asks for reconciliation, the attempt is revoked, and the next serving process replaces it. On this stack the worker's answer to the refused first read is discarded with its fenced attempt (PR 8), so the command's refusal, not a separate backend error record, carries the code. - Core-adapter and CLI tests cover the diagnostic at `SessionService.launch_worker` and at `gateway serve`. - The runtime wheels are rebuilt reproducibly from `sources.json`, and `uv sync --locked` installs `openshell 0.1.8+heartwood.2`. - On the stack tip the full Python suites, ruff, mypy, vulture, actionlint, the web UI checks and the strict documentation build pass, apart from the known macOS-only research-workflow conformance failures. - Strict documentation build passes. The upstream references (OpenHands/software-agent-sdk#4498, #4501, #4670, #5187, #6067, #6811 and ai-openshell/sdk-python#41) were checked read-only on 2026-11-15; all are open. - Not run: the gateway Rust build with its new regressions (`capabilities_report_delete_awaiting_provisioning`, `compute_driver_info_reports_explicit_delete_retry`) and native qualification. Both run in the worker candidate workflow on this PR. ### Code of Conduct & Contributing Guidelines - [x] I agree to follow the [Code of Conduct](https://github.com/SchmiedmayerLab/.github/blob/main/CODE_OF_CONDUCT.md) and [Contributing Guidelines](https://github.com/SchmiedmayerLab/.github/blob/main/CONTRIBUTING.md).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Move the core pin from
v0.1.8tov0.1.9-pre.3(prerelease).ghcr.io/nvidia/openshell/gateway:0.1.9-pre.3Proto changes
Showing 400 of 741 lines; see the full compare.
Before merging