didericis
20f411b22e
Ships the smolmachines backend's prepare side: subpackage layout,
`_BACKENDS` registration under "smolmachines", preflight check
for `smolvm` + `gvproxy` on PATH, and the two config-file
renderers (Smolfile TOML + gvproxy YAML). Launch raises
NotImplementedError until chunk 2.
New module layout (mirrors backend/docker/):
claude_bottle/backend/smolmachines/
__init__.py re-exports SmolmachinesBottleBackend
backend.py SmolmachinesBottleBackend façade
bottle.py SmolmachinesBottle stub (NotImpl until ch2)
bottle_plan.py SmolmachinesBottlePlan + .print()
bottle_cleanup_plan.py SmolmachinesBottleCleanupPlan stub
prepare.py resolve_plan: writes both config files
smolfile.py TOML renderer (stdlib, no tomli_w dep)
gvproxy_config.py YAML renderer (same shape as pipelock_yaml)
util.py preflight + per-slug subnet + loopback port
The renderers are pure functions. `resolve_plan` runs the
preflight, allocates one host-side loopback port per active
sidecar (pipelock always; git-gate / supervise conditional),
derives a per-slug gvproxy subnet (hash-mod-254, skipping the
docker-default 17), and writes:
- <stage>/gvproxy.yaml: subnet + DNS rule resolving only
`proxy.internal` + port_forwards (one per active sidecar).
- <stage>/smolfile.toml: guest command/env + virtio-net device
backed by gvproxy's unixgram socket. No TSI flags — see
PRD 0023 "Why gvproxy, not TSI".
The agent's HTTPS_PROXY etc. point at `proxy.internal:<gateway-
port>` so the guest dials through gvproxy. gvproxy resolves only
`proxy.internal` → the gateway IP, and forwards exactly the
listed ports to the host-side sidecar bundle (PRD 0024); every
other destination — host LAN, host loopback, public internet
directly — is unreachable by construction.
29 new unit tests covering renderer correctness, subnet
derivation stability + collision-avoidance, loopback port
allocation, and preflight error paths. Full unit suite: 532
passing.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
42 lines
1.2 KiB
Python
42 lines
1.2 KiB
Python
"""SmolmachinesBottle — runtime handle stub (PRD 0023 chunk 1).
|
|
|
|
The chunk-1 backend doesn't launch VMs yet, so this class only
|
|
exists to make `SmolmachinesBottleBackend.launch` resolvable at
|
|
import time. Every method raises NotImplementedError; chunk 2
|
|
gives it real `smolvm machine exec` plumbing."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from .. import Bottle, ExecResult
|
|
|
|
|
|
class SmolmachinesBottle(Bottle):
|
|
"""Stub. Real impl lands in chunk 2."""
|
|
|
|
def __init__(self, name: str) -> None:
|
|
self.name = name
|
|
|
|
def exec_claude(self, argv: list[str], *, tty: bool = True) -> int:
|
|
del argv, tty
|
|
raise NotImplementedError(
|
|
"smolmachines backend chunk 1 ships prepare-only; "
|
|
"exec_claude lands in chunk 2"
|
|
)
|
|
|
|
def exec(self, script: str) -> ExecResult:
|
|
del script
|
|
raise NotImplementedError(
|
|
"smolmachines backend chunk 1 ships prepare-only; "
|
|
"exec lands in chunk 2"
|
|
)
|
|
|
|
def cp_in(self, host_path: str, container_path: str) -> None:
|
|
del host_path, container_path
|
|
raise NotImplementedError(
|
|
"smolmachines backend chunk 1 ships prepare-only; "
|
|
"cp_in lands in chunk 2"
|
|
)
|
|
|
|
def close(self) -> None:
|
|
pass
|