Manaurum Platform v2
Wire protocol
The SDK wraps the browser handshake. Application HTTP and capability HTTP use separate authentication contracts.
Contracts reviewed: · SDK version: 2.6.1
Shell messages
manaurum:init arrives once with theme, appearance, accent, user, window, device and language context. Subscribe to manaurum:theme-change for current theme values; the legacy manaurum:theme companion only carries smoothie. Device and language changes use manaurum:device-change and manaurum:locale-change. The SDK checks the parent window and trusted shell origin. Handwritten listeners must explicitly trust https://manaurum.com and https://app.manaurum.com, never the first sender or www.manaurum.com.
HTTP from your handler
User API routes pass through Core, which strips the session credential and injects a signed 60-second user-context JWT. Verify that JWT in your handler. Call capabilities with the four injected runtime values below. Body arguments go at the top level, with no params wrapper. No bearer returns 401; missing tenant/app headers return 412; invalid input returns 422. Use the injected MANAURUM_APP_ID UUID, not the manifest slug. os.kv and os.events.emit require a UUID; other surfaces may resolve or retain the supplied identifier according to their contract. User-scoped calls also need the fresh user-context header. A mismatched app or tenant is rejected.
import os
import httpx
response = httpx.post(
f"{os.environ['MANAURUM_CORE_URL']}/api/capability/os.kv.get",
headers={
"Authorization": f"Bearer {os.environ['MANAURUM_RUNTIME_TOKEN']}",
"X-Manaurum-Tenant-Id": os.environ["MANAURUM_TENANT_ID"],
"X-Manaurum-App-Id": os.environ["MANAURUM_APP_ID"],
},
json={"key": "pref:theme"},
timeout=30,
)
response.raise_for_status()
value = response.json()Egress and internal handlers
os.http.fetch enforces declared egress_allowed_hosts and SSRF checks. Missing declarations return 412 egress_not_declared; a different host returns 412 host_not_in_allow_list. The container’s own socket egress is not restricted by that list today. Cron, Telegram and agent handlers are invoked over the internal network; they are not public API routes. Verify their signed context/system tokens and do not expose a generic capability proxy to the browser.