Skip to documentation
DevelopersManaurum Platform v2
Back to Manaurum

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.

python
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.

This is a feature reference, not a live service-health dashboard. Availability also depends on workspace permissions, integrations and feature flags.

Getting startedFeature availability