Secure, Fast, and Extensible Sandbox runtime for AI agents.
docs(release): fold the post-rebase delta into the 1.2.0 release notes
高然551a5849166f
diff --git a/docs/releases/1.2.0.md b/docs/releases/1.2.0.mdindex 516a290a9..9913db1f2 100644--- a/docs/releases/1.2.0.md+++ b/docs/releases/1.2.0.md@@ -24,38 +24,47 @@ Stable cut of the `1.2.0` line, carrying everything merged since `release-1.1.1`Code changes below ride the `1.2.0` packages.-- Add the OSEP-0024 SDK contract to all five languages: a typed `lifecycle.idlePolicy` create field with client-side fail-fast validation, plus the wake-retry contract — on a `503` carrying the gateway-owned `OpenSandbox-Wake: expired` marker (its presence proves the request was parked and never forwarded, making any-method retry safe), the SDK resends after `Retry-After` under a bounded budget (default 5 attempts / 60 s, per-client knobs) and exhaustion raises a typed wake-timeout exception; SSE/streaming transports bypass wake retry ([#2198](https://github.com/opensandbox-group/OpenSandbox/pull/2198) [#2218](https://github.com/opensandbox-group/OpenSandbox/pull/2218))+- Add the OSEP-0024 SDK contract to all five languages: a typed `lifecycle.idlePolicy` create field with client-side fail-fast validation, plus the wake-retry contract — on a `503` carrying the gateway-owned `OpenSandbox-Wake: expired` marker (its presence proves the request was parked and never forwarded, making any-method retry safe), the SDK resends after `Retry-After` under a bounded budget (default 5 attempts / 60 s, per-client knobs) and exhaustion raises a typed wake-timeout exception; bare `503` handling is unchanged ([#2198](https://github.com/opensandbox-group/OpenSandbox/pull/2198) [#2218](https://github.com/opensandbox-group/OpenSandbox/pull/2218)). The contract initially bypassed streaming transports; the request that starts a stream now wake-retries in JavaScript, Python, and Go — established streams are never replayed — while C#/Kotlin stream starts currently fail fast ([#2357](https://github.com/opensandbox-group/OpenSandbox/pull/2357) [#2426](https://github.com/opensandbox-group/OpenSandbox/pull/2426))- Add the Credential Vault client contract to all five SDKs (OSEP-0022): template-backed sandboxes route vault calls through the server on the same template-origin signal as network policy, while sidecar-direct adapters stay untouched ([#2263](https://github.com/opensandbox-group/OpenSandbox/pull/2263))- Stop capping file uploads and downloads at the request timeout (30 s default) in all five SDKs — the whole-call timeout covered sending the body and reading the response, so any large or slow transfer failed mid-flight even while healthy; transfers now run on a dedicated client with no whole-call deadline that still bounds the wait for response headers, so a stalled transfer still fails instead of hanging ([#2165](https://github.com/opensandbox-group/OpenSandbox/pull/2165) [#2186](https://github.com/opensandbox-group/OpenSandbox/pull/2186) [#2196](https://github.com/opensandbox-group/OpenSandbox/pull/2196) [#2206](https://github.com/opensandbox-group/OpenSandbox/pull/2206))- Implement diagnostics across the SDK surface (with [#2292](https://github.com/opensandbox-group/OpenSandbox/pull/2292)): `context` is exposed through both the manager and sandbox facades in all five languages, and JavaScript, Go, and C# gain public logs/events APIs matching the existing Python/JVM surface ([#2292](https://github.com/opensandbox-group/OpenSandbox/pull/2292))- Add `lifecycle.renewalPolicy` to all five SDKs (OSEP-0009): a typed create field with client-side fail-fast validation (`extendSeconds` 300–86400), replacing the opaque extensions key ([#2296](https://github.com/opensandbox-group/OpenSandbox/pull/2296))- Support port-scoped egress rules in all five SDKs: `NetworkRule.ports` (TCP 1–65535, at most 256 per rule, `target` now optional) with client-side validation mirroring the server (range, duplicates, cap, domain+ports rejected); JavaScript encodes the target-or-ports invariant as a union type ([#2212](https://github.com/opensandbox-group/OpenSandbox/pull/2212))- Surface the authoritative `execution_complete.exit_code` in Go and Kotlin, preferring it over the previous `evalue`/inferred-0 fallbacks while staying compatible with older servers ([#2330](https://github.com/opensandbox-group/OpenSandbox/pull/2330)); honor an explicitly supplied `OPEN-SANDBOX-API-KEY` header over the configured key regardless of header-name casing in JavaScript, C#, and Kotlin ([#2348](https://github.com/opensandbox-group/OpenSandbox/pull/2348) [#2372](https://github.com/opensandbox-group/OpenSandbox/pull/2372) [#2375](https://github.com/opensandbox-group/OpenSandbox/pull/2375)); suppress `sandbox.create` metrics for client-pool warmup creates in Go, Python, and JavaScript ([#2199](https://github.com/opensandbox-group/OpenSandbox/pull/2199))+- Strip protected credentials on cross-origin redirects in JavaScript, C#, and Go: sandbox-prefixed headers, endpoint tokens (`X-EXECD-ACCESS-TOKEN`, `X-API-Key`), and configured authentication headers are removed whenever a redirect changes scheme/host/port, while same-origin hops and unrelated headers are preserved; file uploads never follow redirects in JavaScript, and in browsers an opaque redirect fails closed rather than risk replaying credentials ([#2178](https://github.com/opensandbox-group/OpenSandbox/pull/2178) [#2173](https://github.com/opensandbox-group/OpenSandbox/pull/2173) [#2183](https://github.com/opensandbox-group/OpenSandbox/pull/2183))+- Route the JavaScript and C# code-interpreter data-plane headers through the shared policy: direct-mode `/code` requests no longer carry the tenant `OPEN-SANDBOX-API-KEY` to execd, an explicitly configured connection key keeps precedence over the configured `apiKey` without duplicate case-variant entries, and endpoint-scoped credentials still win ([#2149](https://github.com/opensandbox-group/OpenSandbox/pull/2149))### Python+- Retry the gateway's wake timeout when starting a stream: the SSE clients stripped the retry wrapper entirely, so `commands.run`, session runs, and `codes.run` against an auto-paused sandbox failed with the marked 503 whenever the restore outlasted the gateway's park budget; streaming transports now carry a wake-only retry (no general retries, no added deadlines), and the docs no longer claim streams bypass retries ([#2357](https://github.com/opensandbox-group/OpenSandbox/pull/2357))- Normalize the connection domain: a trailing slash or `/v1` in `domain` / `OPEN_SANDBOX_DOMAIN` produced `//v1/...` URLs that the server 404'd — the same variable worked in every other SDK; Python now strips both ([#2347](https://github.com/opensandbox-group/OpenSandbox/pull/2347))- Reuse SSL contexts across owned transports: CA certificates were reloaded on every call, blocking the event loop under asyncio concurrency — measured create P50 improves ~18–28% under concurrency ([#2360](https://github.com/opensandbox-group/OpenSandbox/pull/2360))-- Preserve the first SSE event after a UTF-8 BOM (including one split across network chunks) ([#2226](https://github.com/opensandbox-group/OpenSandbox/pull/2226)); close wake-timeout response bodies on cancellation ([#2371](https://github.com/opensandbox-group/OpenSandbox/pull/2371)); raise the shared structured error from Code Interpreter `codes.run` failures instead of a hand-built exception that lost `retry_after` ([#2364](https://github.com/opensandbox-group/OpenSandbox/pull/2364)); stop propagating a cancelled endpoint fetch to concurrent waiters ([#2277](https://github.com/opensandbox-group/OpenSandbox/pull/2277)); forward `credential_proxy` through sandbox pools, which silently dropped it before ([#2283](https://github.com/opensandbox-group/OpenSandbox/pull/2283)); stop reporting failed file replacements as successful ([#2222](https://github.com/opensandbox-group/OpenSandbox/pull/2222)); clean up cancelled async pool startup instead of getting stuck in `STARTING` ([#2209](https://github.com/opensandbox-group/OpenSandbox/pull/2209)); regenerate the lifecycle client to drop stale hardcoded defaults (wire behavior unchanged) ([#2280](https://github.com/opensandbox-group/OpenSandbox/pull/2280))+- Preserve the first SSE event after a UTF-8 BOM (including one split across network chunks) ([#2226](https://github.com/opensandbox-group/OpenSandbox/pull/2226)); close wake-timeout response bodies on cancellation ([#2371](https://github.com/opensandbox-group/OpenSandbox/pull/2371)); close interrupted async file-download responses so a cancelled or failed read no longer occupies the connection ([#2369](https://github.com/opensandbox-group/OpenSandbox/pull/2369)); keep the status code when an error response carries a non-JSON body — a proxy's HTML/empty 404/500 previously surfaced as `InvalidArgumentException` with no status ([#2402](https://github.com/opensandbox-group/OpenSandbox/pull/2402)); raise the shared structured error from Code Interpreter `codes.run` failures instead of a hand-built exception that lost `retry_after` ([#2364](https://github.com/opensandbox-group/OpenSandbox/pull/2364)); keep code-interpreter output fragments together in `Execution.text` instead of inserting extra newlines ([#2408](https://github.com/opensandbox-group/OpenSandbox/pull/2408)); round sub-millisecond command timeouts up to 1 ms instead of sending 0 (which disabled the timeout) ([#2419](https://github.com/opensandbox-group/OpenSandbox/pull/2419)); stop propagating a cancelled endpoint fetch to concurrent waiters ([#2277](https://github.com/opensandbox-group/OpenSandbox/pull/2277)); forward `credential_proxy` through sandbox pools, which silently dropped it before ([#2283](https://github.com/opensandbox-group/OpenSandbox/pull/2283)); stop reporting failed file replacements as successful ([#2222](https://github.com/opensandbox-group/OpenSandbox/pull/2222)); clean up cancelled async pool startup instead of getting stuck in `STARTING` ([#2209](https://github.com/opensandbox-group/OpenSandbox/pull/2209)); regenerate the lifecycle client to drop stale hardcoded defaults (wire behavior unchanged) ([#2280](https://github.com/opensandbox-group/OpenSandbox/pull/2280)); MCP: cancelling one tool call no longer cancels a coalesced shared connect for the same sandbox, which failed every other waiting call ([#2355](https://github.com/opensandbox-group/OpenSandbox/pull/2355))### JavaScript- Preserve execution events with CR line endings: the SSE parsers only split on LF, so a valid CR-delimited stream silently dropped the execution ID, output, and completion event ([#2374](https://github.com/opensandbox-group/OpenSandbox/pull/2374))- Scope in-flight endpoint-cache invalidation to each sandbox, so invalidating sandbox B no longer discards a pending fetch's result for sandbox A ([#2349](https://github.com/opensandbox-group/OpenSandbox/pull/2349))+- Preserve reused byte chunks in file uploads: an async producer that reuses a `Uint8Array`/`Buffer` view uploaded the mutated content twice instead of both snapshots ([#2428](https://github.com/opensandbox-group/OpenSandbox/pull/2428)); keep caller cancellation active after response headers arrive — aborting mid-SSE-stream or mid-download previously left the body running ([#2350](https://github.com/opensandbox-group/OpenSandbox/pull/2350))+- Strip protected headers on cross-origin redirects (see the cross-SDK entry above) ([#2173](https://github.com/opensandbox-group/OpenSandbox/pull/2173))### Kotlin- Keep an explicit API key header ahead of the configured key in any casing, and stop attaching an empty key header when unconfigured ([#2375](https://github.com/opensandbox-group/OpenSandbox/pull/2375))+- Preserve the raw response body on deserialize failures and catch `LinkageError` from a serializer/runtime mismatch — previously an `AbstractMethodError` escaped every handler, killing SSE streams silently with the server's actual response unrecoverable ([#2416](https://github.com/opensandbox-group/OpenSandbox/pull/2416))### C#- Honor an explicit API key header regardless of casing: the case-sensitive check added a second, conflicting default entry, and the metrics reporter replaced the caller's credential ([#2372](https://github.com/opensandbox-group/OpenSandbox/pull/2372))+- Strip protected credentials on cross-origin redirects and route code-interpreter requests through the shared data-plane header policy (see the cross-SDK entries above) ([#2183](https://github.com/opensandbox-group/OpenSandbox/pull/2183) [#2149](https://github.com/opensandbox-group/OpenSandbox/pull/2149))### Go-- Stop retrying non-idempotent writes by default: with retry enabled, 27 POST/PATCH call sites (sandbox/session/command/file/snapshot/vault mutations) could execute twice and still return success — POST/PATCH no longer retry status codes by default, retry only transport failures proven to be pre-send (dial/CONNECT/TLS before request bytes), and SSE bootstraps bypass the retry loop; callers who accept duplicate-execution risk can opt in via `RetryConfig.RetryableStatusCodesNonIdempotent` ([#2342](https://github.com/opensandbox-group/OpenSandbox/pull/2342))+- Stop retrying non-idempotent writes by default: with retry enabled, 27 POST/PATCH call sites (sandbox/session/command/file/snapshot/vault mutations) could execute twice and still return success — POST/PATCH no longer retry status codes by default, retry only transport failures proven to be pre-send (dial/CONNECT/TLS before request bytes), and SSE bootstraps bypass the generic retry loop; callers who accept duplicate-execution risk can opt in via `RetryConfig.RetryableStatusCodesNonIdempotent` ([#2342](https://github.com/opensandbox-group/OpenSandbox/pull/2342))+- Retry the gateway's wake timeout when starting an SSE stream: the six streaming call sites (command/code/session runs, metrics watch) previously failed immediately with the marked 503; the bootstrap now parks within the same `Retry-After` budget and returns the typed wake-timeout error on exhaustion — established streams are never replayed, a bare 503 is still not retried even with write-status opt-in, and a 503 reached through a redirect chain loses wake provenance so an already-executed request is never resent; callers relying on fail-fast can pass `WakeRetryDisabled()` ([#2426](https://github.com/opensandbox-group/OpenSandbox/pull/2426))+- Keep line terminators in `Execution.Text()`: execd already includes `\n`/`\r` in event text and requires concatenation to reconstruct stdout, but the helper inserted an extra newline between terminated events (`"a\n"` + `"b\n"` became `"a\n\nb\n"`); a separator is now added only when the preceding event does not already end in a terminator ([#2381](https://github.com/opensandbox-group/OpenSandbox/pull/2381))- Strip the tenant API key from direct-mode data-plane requests: a tenant key supplied through `ConnectionConfig.Headers` was delivered to execd and the egress sidecar inside the untrusted sandbox — completing the credential-exposure fixes across all five SDKs ([#2337](https://github.com/opensandbox-group/OpenSandbox/pull/2337))-- Authenticate proxied data-plane requests with the API key header instead of smuggling the tenant key into the sandbox, fixing 401s in multi-tenant proxy mode ([#2274](https://github.com/opensandbox-group/OpenSandbox/pull/2274)); strip all sandbox-prefixed and authentication headers on cross-origin redirects ([#2178](https://github.com/opensandbox-group/OpenSandbox/pull/2178)); surface `execution_complete.exit_code` ([#2330](https://github.com/opensandbox-group/OpenSandbox/pull/2330))+- Authenticate proxied data-plane requests with the API key header instead of smuggling the tenant key into the sandbox, fixing 401s in multi-tenant proxy mode ([#2274](https://github.com/opensandbox-group/OpenSandbox/pull/2274)); surface `execution_complete.exit_code` ([#2330](https://github.com/opensandbox-group/OpenSandbox/pull/2330))## Controller@@ -98,8 +107,9 @@ The OSEP-0022 vault items concern the `fast-sandbox` profile's credential-vault## Fast Sandbox- Publish snapshots and template builds to OCI registries: each OverlayBD build can target an OCI registry (rootfs and snapfiles images, no name index — Sandboxes boot from `status.manifestRef`), Fastlets enable OCI by default with an explicit opt-out, OverlayBD templates require OCI storage, the controller consolidates snapshot artifact cleanup and refreshes Fastlet capacity after runtime deletion, and a bounded manifest cache survives Fastlet replacement; the SandboxSnapshot CRD gains `oci://` manifest references and makes `spec.templateName` optional for OCI snapshots ([#2338](https://github.com/opensandbox-group/OpenSandbox/pull/2338))+- Place pool sandboxes by resources instead of fixed slots: `spec.sandboxResources` gains a `mode` (`LegacySlot` | `ResourceAware`) with a separate cpu/memory `overcommitRatio` (required in ResourceAware mode); `cpu`/`memory` limits become runtime limits/defaults that a ResourceAware pool may override per request, Sandbox status gains caller-owned immutable `resources.limits` (ResourceAware pools only), and pool status reports resource commitment plus fastlet/sandbox counters ([#2442](https://github.com/opensandbox-group/OpenSandbox/pull/2442))- Make sandbox deletion reliable: deletion now sends a fenced Fastlet delete before any runtime-absence check, so a transport failure or empty inspect response is no longer treated as proof the sandbox is gone (which could orphan the microVM while the CR disappeared); the Fastlet records a per-identity tombstone so a delayed create cannot revive a deleted sandbox. Create placement also recovers faster: FastPath refreshes its candidate list within a bounded budget after proven rejections ([#2214](https://github.com/opensandbox-group/OpenSandbox/pull/2214))-- And the smaller items: batch guest NAT updates into one `iptables-restore --noflush` so reapplying a guest address no longer accumulates rules ([#2214](https://github.com/opensandbox-group/OpenSandbox/pull/2214)); defer `SET_BINDING` while the network attachment has no IP, stop SandboxPool status-update loops, gate route removal on runtime deletion, and canonicalize Docker Hub credential hosts ([#2338](https://github.com/opensandbox-group/OpenSandbox/pull/2338)); and emit per-create phase timing from Fastlets, feeding the create-latency evidence pipeline (steady-state warm delivery measured at 16–17 ms past create) ([#2327](https://github.com/opensandbox-group/OpenSandbox/pull/2327))+- And the smaller items: read-only snapfiles are shared within each Fastlet (fsb-vm shares them by default), with recovery of shared snapfiles and orphan-cache cleanup ([#2438](https://github.com/opensandbox-group/OpenSandbox/pull/2438)); batch guest NAT updates into one `iptables-restore --noflush` so reapplying a guest address no longer accumulates rules ([#2214](https://github.com/opensandbox-group/OpenSandbox/pull/2214)); defer `SET_BINDING` while the network attachment has no IP, stop SandboxPool status-update loops, gate route removal on runtime deletion, and canonicalize Docker Hub credential hosts ([#2338](https://github.com/opensandbox-group/OpenSandbox/pull/2338)); and emit per-create phase timing from Fastlets, feeding the create-latency evidence pipeline (steady-state warm delivery measured at 16–17 ms past create) ([#2327](https://github.com/opensandbox-group/OpenSandbox/pull/2327))## Misc@@ -108,7 +118,7 @@ The OSEP-0022 vault items concern the `fast-sandbox` profile's credential-vault- OSEPs: accept and document OSEP-0024 (proposal plus architecture page and user guide) ([#2152](https://github.com/opensandbox-group/OpenSandbox/pull/2152) [#2217](https://github.com/opensandbox-group/OpenSandbox/pull/2217)); revise OSEP-0022 around the sealed-revision binding and the per-pool pinned CA ([#2174](https://github.com/opensandbox-group/OpenSandbox/pull/2174) [#2282](https://github.com/opensandbox-group/OpenSandbox/pull/2282)); and withdraw the planned runtime driver ask ([#2259](https://github.com/opensandbox-group/OpenSandbox/pull/2259))- Docs: unify component telemetry metrics into one reference at `docs/guides/telemetry.md` ([#2205](https://github.com/opensandbox-group/OpenSandbox/pull/2205)); redesign the docs homepage with an animated dark theme ([#2345](https://github.com/opensandbox-group/OpenSandbox/pull/2345)); highlight the project's AAIF (Agentic AI Foundation / Linux Foundation) affiliation and update the legal footer ([#2395](https://github.com/opensandbox-group/OpenSandbox/pull/2395) [#2343](https://github.com/opensandbox-group/OpenSandbox/pull/2343)); update the gVisor notes for current upstream reality ([#2431](https://github.com/opensandbox-group/OpenSandbox/pull/2431)); and the usual upkeep — refreshed network architecture pages, markdown reflow across 148 files, CONTRIBUTING/test-path/PR-size-policy corrections, and `AGENTS.md` dedupe ([#2210](https://github.com/opensandbox-group/OpenSandbox/pull/2210) [#2285](https://github.com/opensandbox-group/OpenSandbox/pull/2285) [#2175](https://github.com/opensandbox-group/OpenSandbox/pull/2175) [#2339](https://github.com/opensandbox-group/OpenSandbox/pull/2339) [#2412](https://github.com/opensandbox-group/OpenSandbox/pull/2412) [#2211](https://github.com/opensandbox-group/OpenSandbox/pull/2211) [#2225](https://github.com/opensandbox-group/OpenSandbox/pull/2225))- Security/dependency bumps: resolve 41 of 46 open Dependabot security alerts across Go, Python, and npm manifests (klauspost/compress, moby/sys/user, certifi, setuptools, undici, fast-uri, …); five egress `h2` alerts remain open by design — three are not exploitable in this deployment, and the two real request-smuggling CVEs need a base-image/mitmproxy 12 migration tracked as follow-up ([#2411](https://github.com/opensandbox-group/OpenSandbox/pull/2411))-- Fast-sandbox integration environment: split the 2.4k-line entry script into entry + env + verify parts with sharpened policy-transfer coverage ([#2319](https://github.com/opensandbox-group/OpenSandbox/pull/2319)); drive the verify stages through the published `osb` CLI and add an opt-in `IDLE_PAUSE=1` profile verifying the full auto-pause → wake loop ([#2171](https://github.com/opensandbox-group/OpenSandbox/pull/2171) [#2202](https://github.com/opensandbox-group/OpenSandbox/pull/2202)); split the template verify matrix into per-stack steps ([#2389](https://github.com/opensandbox-group/OpenSandbox/pull/2389)); and let fast-sandbox upstream PRs trigger the OpenSandbox KVM integration suite against their head SHA pre-merge ([#2335](https://github.com/opensandbox-group/OpenSandbox/pull/2335))+- Fast-sandbox integration environment: split the 2.4k-line entry script into entry + env + verify parts with sharpened policy-transfer coverage ([#2319](https://github.com/opensandbox-group/OpenSandbox/pull/2319)); drive the verify stages through the published `osb` CLI and add an opt-in `IDLE_PAUSE=1` profile verifying the full auto-pause → wake loop ([#2171](https://github.com/opensandbox-group/OpenSandbox/pull/2171) [#2202](https://github.com/opensandbox-group/OpenSandbox/pull/2202)); exercise the full MITM CA chain end to end — CA-baked template, pinned egress trust anchor, real credential injection through the mitm, and trust surviving pause/resume ([#2393](https://github.com/opensandbox-group/OpenSandbox/pull/2393)); run the SDK e2e suites against the overlaybd template only when `OCI_STACK=1` ([#2436](https://github.com/opensandbox-group/OpenSandbox/pull/2436)); split the template verify matrix into per-stack steps ([#2389](https://github.com/opensandbox-group/OpenSandbox/pull/2389)); and let fast-sandbox upstream PRs trigger the OpenSandbox KVM integration suite against their head SHA pre-merge ([#2335](https://github.com/opensandbox-group/OpenSandbox/pull/2335))- node-agent: fix syscall BPF verification failing when system header changes affect only DWARF checksums ([#2325](https://github.com/opensandbox-group/OpenSandbox/pull/2325))- Tests/CI: cache Go modules for the Kubernetes nightly e2e jobs ([#2306](https://github.com/opensandbox-group/OpenSandbox/pull/2306)); close the credential-vault happy path in the fast-sandbox smoke ([#2256](https://github.com/opensandbox-group/OpenSandbox/pull/2256)); require the Fast Sandbox IP-rebind kernel regression in privileged CI ([#2415](https://github.com/opensandbox-group/OpenSandbox/pull/2415)); dump fastlet Pod container logs on pause/resume verify failure ([#2290](https://github.com/opensandbox-group/OpenSandbox/pull/2290)); align the node-agent log-collection e2e with execd's preserved trailing newline ([#2164](https://github.com/opensandbox-group/OpenSandbox/pull/2164)); and make the umbrella release workflow dispatch-only ([#2223](https://github.com/opensandbox-group/OpenSandbox/pull/2223))- Examples: add an all-in-one Docker image for the DeerFlow example bundling the OpenSandbox server and the DeerFlow backend, for one-command workshop starts ([#2262](https://github.com/opensandbox-group/OpenSandbox/pull/2262))@@ -117,6 +127,8 @@ The OSEP-0022 vault items concern the `fast-sandbox` profile's credential-vault## Upgrade & Compatibility- Breaking (Go SDK): POST/PATCH requests are no longer retried by default — status-code retries for writes require explicit opt-in via `RetryConfig.RetryableStatusCodesNonIdempotent`, and ambiguous transport failures (read/write timeouts, unexpected EOF) are no longer retried for writes; callers that relied on write retries must handle the returned error or opt in ([#2342](https://github.com/opensandbox-group/OpenSandbox/pull/2342))+- Behavior change (Python and Go SDKs): the request that starts a stream (`commands.run`, `codes.run`, session/isolated runs, metrics watch) now retries the gateway's marked wake-timeout 503 within the wake budget instead of failing fast — established streams are never replayed; keep the old fail-fast with `WakeRetryDisabled()` (Go) or disabled wake retry (Python) ([#2357](https://github.com/opensandbox-group/OpenSandbox/pull/2357) [#2426](https://github.com/opensandbox-group/OpenSandbox/pull/2426))+- Behavior change: SDK display helpers no longer insert extra newlines between already-terminated stdout events (Go `Execution.Text()`, Python code-interpreter `Execution.text`), and the Go helper treats a trailing CR as a terminator for legacy pre-1.2 bash-session events ([#2381](https://github.com/opensandbox-group/OpenSandbox/pull/2381) [#2408](https://github.com/opensandbox-group/OpenSandbox/pull/2408))- Behavior change: bash-session stdout event text now includes its original line endings, and blank lines appear as events — consumers must concatenate event text per run to recover exact output instead of treating each event as a newline-free line ([#2318](https://github.com/opensandbox-group/OpenSandbox/pull/2318))- Behavior change: a BatchSandbox past its `spec.expireTime` now reports `Terminated` / `SANDBOX_EXPIRED` instead of `Running`, even while the pod is still Ready — callers that treat `Running` as alive should check expiry ([#2238](https://github.com/opensandbox-group/OpenSandbox/pull/2238))- Behavior change: BatchSandbox pods now default to `restartPolicy: Never` — deployments that relied on the implicit `Always` and want restarts must set it explicitly in their `batchsandbox_template_file` ([#2128](https://github.com/opensandbox-group/OpenSandbox/pull/2128))@@ -143,6 +155,7 @@ The OSEP-0022 vault items concern the `fast-sandbox` profile's credential-vaultThanks to these contributors ❤️+- @0ranan- @Aling33- @BootstrapperSBL- @Claire-ovo