Skip to content

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.

docs(skills): say when trusted-main-thread is honored and when it is sandboxed

nirholasa82964802496
diff --git a/docs/skills.md b/docs/skills.md
index ba264c305..a49e368f0 100644
--- a/docs/skills.md
+++ b/docs/skills.md
@@ -366,7 +366,7 @@ Owner-signed skills that require direct Three.js access, `window.*` APIs, or per
}
```
-When this flag is present, `handlers.js` is loaded via a direct `import()` in the main thread. This opt-out only applies to skills that pass the `owned-only` or `whitelist` trust check — `any`-trust skills remain sandboxed regardless.
+When this flag is honored, `handlers.js` is loaded via a direct `import()` in the main thread. It is honored only for bundles served from the embedding page's own origin or from the origin that served the `<agent-3d>` library, and never under `any` trust. A bundle from any other origin that sets the flag still installs and runs, inside the worker sandbox.
---
diff --git a/specs/SKILL_SPEC.md b/specs/SKILL_SPEC.md
index e04bf0ccc..012a2aaa4 100644
--- a/specs/SKILL_SPEC.md
+++ b/specs/SKILL_SPEC.md
@@ -280,7 +280,7 @@ Owner-signed skills that require main-thread capabilities (Three.js direct acces
}
```
-When this flag is present, `handlers.js` is loaded via a direct `import()` in the main thread and called synchronously — the same as the pre-sandbox behavior. This opt-out is only meaningful for skills that pass the `owned-only` or `whitelist` trust check; `any`-trust skills should remain sandboxed.
+When this flag is honored, `handlers.js` is loaded via a direct `import()` in the main thread and called synchronously, the same as the pre-sandbox behavior. The flag is a request, not a grant: the manifest is written by whoever hosts the bundle. The registry honors it only when the bundle is served from an origin the host trusts (for `<agent-3d>`, the page's own origin or the origin that served the library) and the trust mode is not `any`. Any other bundle that sets it still installs, but runs in the worker sandbox.
Rationale for the name: it describes where the code runs (`main-thread`) and the precondition (`trusted`), making the security trade-off explicit to manifest authors.