Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
import json
import sys
import tempfile
import unittest
from pathlib import Path
from services.scene_input import validate_scene_input, revalidate_scene_manifest
class SceneInputTests(unittest.TestCase):
def setUp(self):
self.tmp = tempfile.TemporaryDirectory()
self.workspace = Path(self.tmp.name) / "workspace"
self.scene = self.workspace / "Workflows" / "room"
self.scene.mkdir(parents=True)
(self.scene / "model.glb").write_bytes(b"mesh")
self.manifest = self.scene / "scene-manifest.json"
self.manifest.write_text(json.dumps({
"schema": "three-ws.forge.scene-manifest.v1",
"sceneRoot": ".",
"assets": [{"path": "model.glb"}],
}))
def tearDown(self):
self.tmp.cleanup()
def test_directory_and_manifest_are_canonical_paths(self):
expected = self.manifest.resolve()
self.assertEqual(validate_scene_input(self.workspace, "Workflows/room"), expected)
self.assertEqual(validate_scene_input(self.workspace, "Workflows/room/scene-manifest.json"), expected)
self.assertEqual(revalidate_scene_manifest(self.workspace, expected), expected)
def test_rejects_traversal_absolute_encoded_and_non_manifest_json(self):
for path in ("../outside", "/etc/passwd", "C:/outside", "Workflows/room/../room", "Workflows/room/other.json", "Workflows/%2e%2e"):
with self.subTest(path=path), self.assertRaises(ValueError):
validate_scene_input(self.workspace, path)
def test_rejects_symlink_escape_when_supported(self):
outside = Path(self.tmp.name) / "outside"
outside.mkdir()
(outside / "scene-manifest.json").write_text(self.manifest.read_text())
try:
(self.workspace / "Workflows" / "link").symlink_to(outside, target_is_directory=True)
except OSError as exc:
self.skipTest(f"directory symlinks are unavailable on this host: {exc}")
with self.assertRaises(ValueError):
validate_scene_input(self.workspace, "Workflows/link")
@unittest.skipUnless(sys.platform == "win32", "directory junctions are Windows-only")
def test_rejects_junction_escape_on_windows(self):
# Junctions need no privilege (unlike symlinks), so they are the
# realistic escape on Windows and keep the reparse-point check covered.
import _winapi
outside = Path(self.tmp.name) / "outside"
outside.mkdir()
(outside / "scene-manifest.json").write_text(self.manifest.read_text())
(outside / "model.glb").write_bytes(b"mesh")
_winapi.CreateJunction(str(outside), str(self.workspace / "Workflows" / "link"))
with self.assertRaises(ValueError):
validate_scene_input(self.workspace, "Workflows/link")
data = json.loads(self.manifest.read_text())
data["assets"] = [{"workspacePath": "Workflows/link/model.glb"}]
self.manifest.write_text(json.dumps(data))
with self.assertRaises(ValueError):
validate_scene_input(self.workspace, "Workflows/room")
def test_rejects_missing_assets_and_oversized_manifest(self):
data = json.loads(self.manifest.read_text())
data["assets"] = [{"path": "missing.glb"}]
self.manifest.write_text(json.dumps(data))
with self.assertRaises(ValueError):
validate_scene_input(self.workspace, "Workflows/room")
self.manifest.write_text(" " * (1024 * 1024 + 1))
with self.assertRaises(ValueError):
validate_scene_input(self.workspace, "Workflows/room")
def test_rejects_malformed_manifest_and_asset_paths(self):
original = json.loads(self.manifest.read_text())
for patch in (
{"schema": "wrong"},
{"assets": "bad"},
{"assets": [{"path": "../escape.glb"}]},
{"preview": {"image": None}},
{"initialView": {"position": [0, 0, 0], "target": [0, 0, 0]}},
):
with self.subTest(patch=patch):
self.manifest.write_text(json.dumps({**original, **patch}))
with self.assertRaises(ValueError):
validate_scene_input(self.workspace, "Workflows/room")