opencomputer-sdk 0.6.8__tar.gz → 1.0.0__tar.gz

{opencomputer_sdk-0.6.8 → opencomputer_sdk-1.0.0}/.gitignore

@@ -81,3 +81,19 @@ deploy/azure/.dev-vector-token-*
 /server
 /seed-dev-secrets
 /backfill
+
+# Claude Code agent memory (session-local, not source)
+/memory/
+
+# Per-env wrangler config generated for CI deploys (not source)
+cloudflare-workers/api-edge/wrangler.ci.toml
+
+# Wrangler local build/cache/state (never source)
+.wrangler/
+
+# stray binaries from `go build ./cmd/...` without -o
+/microvm-hooks
+/microvm-harness
+
+.dev.vars*
+!.dev.vars.example

{opencomputer_sdk-0.6.8 → opencomputer_sdk-1.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: opencomputer-sdk
-Version: 0.6.8
+Version: 1.0.0
 Summary: Python SDK for OpenComputer - cloud sandbox platform
 Project-URL: Homepage, https://github.com/diggerhq/opensandbox
 Project-URL: Repository, https://github.com/diggerhq/opensandbox

{opencomputer_sdk-0.6.8 → opencomputer_sdk-1.0.0}/opencomputer/__init__.py

@@ -68,4 +68,6 @@ __all__ = [
     "TagKeyInfo",
 ]
 
-__version__ = "0.6.8"
+# Single source of truth — pyproject.toml reads the same file, so the published
+# version and the version the SDK announces to the server cannot disagree.
+from opencomputer.version import __version__  # noqa: E402,F401

{opencomputer_sdk-0.6.8 → opencomputer_sdk-1.0.0}/opencomputer/browser.py

@@ -58,7 +58,7 @@ class Browser:
         kiosk_mode: bool | None = None,
         start_url: str | None = None,
         chrome_policy: dict[str, Any] | None = None,
-        telemetry: dict[str, Any] | None = None,
+        telemetry: bool | dict[str, Any] | None = None,
         recording: bool | None = None,
     ) -> Browser:
         """Create a browser session and return direct connection URLs."""

{opencomputer_sdk-0.6.8 → opencomputer_sdk-1.0.0}/opencomputer/project.py

@@ -7,6 +7,8 @@ from typing import Any
 
 import httpx
 
+from opencomputer.version import sdk_version_headers
+
 
 def _get_client(
     api_key: str | None = None,
@@ -18,7 +20,7 @@ def _get_client(
 
     api_base = url if url.endswith("/api") else f"{url}/api"
 
-    headers: dict[str, str] = {}
+    headers: dict[str, str] = dict(sdk_version_headers())
     if key:
         headers["X-API-Key"] = key
 

{opencomputer_sdk-0.6.8 → opencomputer_sdk-1.0.0}/opencomputer/sandbox.py

@@ -15,6 +15,7 @@ from opencomputer.image import Image
 from opencomputer.mounts import Mounts
 from opencomputer.pty import Pty
 from opencomputer.sse import parse_sse_stream
+from opencomputer.version import sdk_version_headers
 
 
 class ScalingLockedError(Exception):
@@ -149,7 +150,10 @@ class Sandbox:
         # Control plane client always uses /api prefix
         api_base = url if url.endswith("/api") else f"{url}/api"
 
-        headers: dict[str, str] = {}
+        # Which runtime serves this create. See version.py: an org that has not
+        # been pinned is routed by the calling SDK's major version, so upgrading
+        # this package is how a customer migrates.
+        headers: dict[str, str] = dict(sdk_version_headers())
         if key:
             headers["X-API-Key"] = key
 

{opencomputer_sdk-0.6.8 → opencomputer_sdk-1.0.0}/opencomputer/snapshot.py

@@ -9,6 +9,7 @@ import httpx
 
 from opencomputer.image import Image
 from opencomputer.sse import parse_sse_stream
+from opencomputer.version import sdk_version_headers
 
 
 class Snapshots:
@@ -41,7 +42,11 @@ class Snapshots:
 
         api_base = url if url.endswith("/api") else f"{url}/api"
 
-        self._headers: dict[str, str] = {}
+        # A template is built differently per runtime — a whole-disk checkpoint on
+        # one, a machine image on the other — so the same version header the
+        # create path sends has to ride along here, or a caller would build a
+        # template their sandboxes cannot use. See version.py.
+        self._headers: dict[str, str] = dict(sdk_version_headers())
         if key:
             self._headers["X-API-Key"] = key
 

opencomputer_sdk-1.0.0/opencomputer/version.py

@@ -0,0 +1,38 @@
+"""The SDK's own identity, sent on the requests that decide which runtime serves
+a customer: creating a sandbox and creating a template or snapshot.
+
+This is what makes self-service migration possible. An org that has not been
+pinned to a runtime lands on the MicroVM backend when it calls with a 1.x SDK
+and on the QEMU fleet when it calls with an older one — so upgrading the
+dependency IS the migration, and pinning the old version is the rollback.
+Nothing has to change in our database for either direction.
+
+Only the MAJOR is load-bearing: the server compares it against a minimum, so
+patch and minor releases never move anyone.
+
+1.0.0, not 2.0.0, even though the docs call this platform generation "v2": every
+version this package has ever published is 0.x, so 1.0.0 is both the first
+stable release and a clean major break from all of them. The product generation
+and the package major are not the same number.
+
+This file is the single source of truth for the version: pyproject.toml declares
+it dynamic and hatch's version hook reads the assignment below, and CI reads the
+same line to decide whether to publish. That is deliberate — a constant that
+drifted from the published version would ship a release still announcing the old
+one, leaving every customer who upgraded on the old runtime with no error
+anywhere. Keep the assignment on one line, at column 0, and do not let prose in
+this docstring start with that name: two readers of this file are greps.
+"""
+
+from __future__ import annotations
+
+__version__ = "1.0.0"
+
+#: Header carrying the version above. Lower-case to match the TypeScript SDK;
+#: HTTP/2 requires it there and consistency costs nothing here.
+SDK_VERSION_HEADER = "x-oc-sdk-version"
+
+
+def sdk_version_headers() -> dict[str, str]:
+    """The identifying header, ready to merge into a request's headers."""
+    return {SDK_VERSION_HEADER: __version__}

{opencomputer_sdk-0.6.8 → opencomputer_sdk-1.0.0}/pyproject.toml

@@ -4,7 +4,10 @@ build-backend = "hatchling.build"
 
 [project]
 name = "opencomputer-sdk"
-version = "0.6.8"
+# Read from opencomputer/version.py, which is also what the SDK announces to the
+# server in x-oc-sdk-version. One source, so the published version and the
+# routed-on version cannot disagree.
+dynamic = ["version"]
 description = "Python SDK for OpenComputer - cloud sandbox platform"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -41,6 +44,9 @@ Repository = "https://github.com/diggerhq/opensandbox"
 Documentation = "https://github.com/diggerhq/opensandbox/tree/main/sdks/python"
 Issues = "https://github.com/diggerhq/opensandbox/issues"
 
+[tool.hatch.version]
+path = "opencomputer/version.py"
+
 [tool.hatch.build.targets.wheel]
 packages = ["opencomputer"]
 exclude = ["__pycache__"]