Agent Mesh
Go a2aa2a-protocolagent-meshagentic-aiinferencemcpmeshmesh-networknetwork-securitynetworking-aip2p-network
tests: prove the sandbox boundary end to end
Antonio Ojeabfc9e4496361
diff --git a/tests/e2e/agent_sandbox.bats b/tests/e2e/agent_sandbox.batsnew file mode 100644index 00000000..c4a7c413--- /dev/null+++ b/tests/e2e/agent_sandbox.bats@@ -0,0 +1,108 @@+#!/usr/bin/env bats++# The sandbox boundary, as an agent actually meets it: a container with no+# network at all, holding nothing but a socket, reaching the mesh through it.+#+# Everything here runs with --network none. That is the assertion as much as the+# arrangement: if any of it worked because a container could route somewhere,+# the test would be measuring the wrong thing.++load "lib/container_mesh.bash"++setup() {+ mesh_setup_env+}++teardown() {+ docker rm -f "${MESH_PREFIX}-box" "${MESH_PREFIX}-agent" >/dev/null 2>&1 || true+ mesh_cleanup_test_resources+}++# agent_curl runs a command inside the agent sandbox, which reaches the boundary+# over the socket and nothing else.+agent_curl() {+ docker exec "${MESH_PREFIX}-agent" curl -s -o /dev/null -w '%{http_code}' \+ --max-time 10 --socks5-hostname 127.0.0.1:1080 "$@"+}++@test "an agent with no network reaches the mesh through its socket, and nothing else" {+ run mesh_start_mock_oidc+ [[ "$status" -eq 0 ]]+ mesh_start_router++ # The node keeps its API on a socket in a directory the gateway shares. Run it+ # as the invoking user so the socket it creates is usable from the host side,+ # which also means naming a data directory: with a uid the image does not know,+ # HOME is unwritable and the default location cannot be created.+ mesh_start_node 1 "--socket-path /sockets/node.sock --data-dir /sockets/node-data" "" \+ "-v ${MESH_SOCKET_DIR}:/sockets --user $(id -u):$(id -g) -e HOME=/sockets"+ mesh_wait_for_log "${MESH_PREFIX}-node-1" "SAM Node Online" 60+ mesh_wait_for_mcp_ready 1 20++ # The gateway consumes the node. It has no network either: the node's socket+ # is the only thing it needs.+ docker run -d --name "${MESH_PREFIX}-box" \+ --network none \+ --user "$(id -u):$(id -g)" \+ -v "${MESH_SOCKET_DIR}:/sockets" \+ "${MESH_RUNTIME_IMAGE}" \+ /usr/local/bin/sam-box run \+ --socket /sockets/agent.sock \+ --sidecar-socket /sockets/node.sock \+ --egress-allow example.invalid \+ --log-level debug >/dev/null++ local waited=0+ while [[ ! -S "${MESH_SOCKET_DIR}/agent.sock" ]] && [[ "${waited}" -lt 100 ]]; do+ sleep 0.1+ waited=$((waited + 1))+ done+ [[ -S "${MESH_SOCKET_DIR}/agent.sock" ]] || {+ docker logs "${MESH_PREFIX}-box"+ false+ }++ # The sandbox: no network, no credential, only the boundary socket. socat+ # stands in for the tun2socks a real sandbox runs, giving an ordinary client a+ # TCP address for a socket.+ docker run -d --name "${MESH_PREFIX}-agent" \+ --network none \+ --user "$(id -u):$(id -g)" \+ -v "${MESH_SOCKET_DIR}:/sockets" \+ "${MESH_RUNTIME_IMAGE}" \+ socat TCP-LISTEN:1080,fork,reuseaddr UNIX-CONNECT:/sockets/agent.sock >/dev/null+ sleep 1++ # What an agent is for: the mesh's inference and tool endpoints, by name.+ run agent_curl "http://mesh.sam.alt/v1/models"+ [[ "$status" -eq 0 ]]+ [[ "$output" == "200" ]] || {+ echo "GET /v1/models returned ${output}"+ docker logs "${MESH_PREFIX}-box"+ false+ }++ run agent_curl -X POST "http://mesh.sam.alt/mcp"+ [[ "$status" -eq 0 ]]+ # The MCP endpoint answers; which status it picks for a bare POST is the SDK's+ # business, but it must not be the gateway's 403.+ [[ "$output" != "403" ]]++ # The node's own API is not the agent's to reach. Registering would let it+ # advertise itself into the mesh under the node's identity.+ local forbidden+ for forbidden in /sam/service/register /sam/service/discover /metrics /healthz /; do+ run agent_curl "http://mesh.sam.alt${forbidden}"+ [[ "$status" -eq 0 ]]+ [[ "$output" == "403" ]] || {+ echo "GET ${forbidden} returned ${output}, want 403"+ false+ }+ done++ # Egress is deny-by-default, and a name nobody allowed fails the SOCKS5+ # handshake rather than being dialled.+ run docker exec "${MESH_PREFIX}-agent" curl -s --max-time 10 \+ --socks5-hostname 127.0.0.1:1080 "http://blocked.invalid/"+ [[ "$status" -ne 0 ]]+}diff --git a/tests/e2e/docker/Dockerfile.sam-runtime b/tests/e2e/docker/Dockerfile.sam-runtimeindex 9236c827..57a1f5fa 100644--- a/tests/e2e/docker/Dockerfile.sam-runtime+++ b/tests/e2e/docker/Dockerfile.sam-runtime@@ -19,7 +19,9 @@ RUN --mount=type=cache,target=/go/pkg/mod \# Final container: minimal alpine runtime hosting the built binaries.FROM alpine:3.20-RUN apk add --no-cache busybox+# socat and curl let a test container stand in for an agent sandbox: socat+# bridges a loopback port to the gateway's socket, and curl is the agent.+RUN apk add --no-cache busybox socat curlRUN addgroup -S sam && adduser -S -G sam samdiff --git a/tests/e2e/lib/container_mesh.bash b/tests/e2e/lib/container_mesh.bashindex ca912dee..b24eed71 100644--- a/tests/e2e/lib/container_mesh.bash+++ b/tests/e2e/lib/container_mesh.bash@@ -315,6 +315,9 @@ if [[ -z "${MESH_HELPERS_LOADED:-}" ]]; thenlocal idx="$1"local flags="${2:-}"local config_path="${3:-}"+ # Extra docker arguments, for tests that need to share something with the+ # node container, such as the directory its API socket lives in.+ local docker_args="${4:-}"local name="${MESH_PREFIX}-node-${idx}"local add_hosts@@ -338,6 +341,7 @@ if [[ -z "${MESH_HELPERS_LOADED:-}" ]]; then--network-alias "${name}" \${add_hosts} \"${mount_args[@]}" \+ ${docker_args} \-e SAM_CLIENT_SECRET="sam-e2e-secret" \-e SAM_API_TOKEN="secret-token" \"${MESH_RUNTIME_IMAGE}" \