Drop-In White-Label Agent Embeds
Turn any web product into an agent-native platform without building sandboxes, streaming UIs, or approval workflows yourself. Helix Embeds let your customers interact with white-labeled AI specialists inside your own portal with strict single-tenant (principalId) cryptographic isolation.
Available Embed Surfaces
| Surface Value | Purpose | Best Placement |
|---|---|---|
office | Full workspace hub: live agents, threads, approvals, files | Primary "AI Assistant" tab in your SaaS nav |
colleague | Single scoped specialist chat & live tool execution feed | Side drawer beside a specific record or ticket |
hire-studio | Conversational workflow for creating a custom customer specialist | Onboarding / Admin automations page |
approvals-inbox | Focused human review & sign-off queue (T2 gates) | Notifications popover or Compliance Inbox |
open-door | Live visual desktop/browser handoff viewer | Support / Live debugging modal |
receipts | Verifiable Ed25519 audit ledger explorer for end customers | Enterprise Security / Audit tab |
Step 1 — Mint a Customer-Scoped Token on Your Backend
Never expose hx_live_* in browser HTML. Always mint a short-lived hx_embed_* token on your backend bound to the exact end-user (principalId):
import { HelixClient } from "@launchverse/helix-sdk";
const helix = new HelixClient({
baseUrl: "https://launchverse.app",
apiKey: process.env.HELIX_API_KEY!, // hx_live_* kept strictly server-side
});
// Inside your authenticated API route (e.g. POST /api/acme/helix-token):
export async function issueCustomerEmbedToken(customerAccountId: string) {
const token = await helix.embeds.createToken({
principalId: customerAccountId,
surfaces: ["office", "colleague", "approvals-inbox", "receipts"],
ttlSeconds: 3600,
whiteLabel: true,
});
return token;
}Hard Isolation Guarantee: Even if an attacker extracts an
hx_embed_*token from DevTools, every endpoint rejects requests outside its pinnedprincipalId, and attempts against/api/webhooks/platformor key management immediately fail closed (403 principal_escalation_denied).
Step 2 — Mount the Web Component
Load /embed/helix-staff.js and pass the scoped token cleanly:
<script src="https://launchverse.app/embed/helix-staff.js" defer></script>
<helix-staff-embed
id="acme-copilot"
token="hx_embed_eyJ..."
surface="office"
principal-id="cust_acme_42"
theme="dark"
accent="gold"
white-label="true"
style="display: block; width: 100%; height: 720px;"
></helix-staff-embed>React / Next.js Integration Pattern
"use client";
import { useEffect, useRef } from "react";
export function CustomerHelixEmbed({ embedToken, accountId }: { embedToken: string; accountId: string }) {
const ref = useRef<HTMLElement | null>(null);
useEffect(() => {
const onMessage = (e: MessageEvent) => {
if (e.origin !== "https://launchverse.app") return;
if (e.data?.type === "helix:run.completed") {
console.log("Completed task:", e.data.payload);
}
if (e.data?.type === "helix:approval.requested") {
// Optionally show a badge in your host SaaS nav bar
}
};
window.addEventListener("message", onMessage);
return () => window.removeEventListener("message", onMessage);
}, []);
return (
<helix-staff-embed
ref={ref as never}
token={embedToken}
principal-id={accountId}
surface="office"
theme="dark"
white-label="true"
style={{ display: "block", width: "100%", height: "720px" }}
/>
);
}Step 3 — Host <-> Embed postMessage Event Protocol
Event type | Direction | Payload & Use Case |
|---|---|---|
helix:ready | Embed -> Host | Frame hydrated & session authenticated |
helix:prefill | Host -> Embed | Prefill the composer with context from the current CRM/ERP screen |
helix:theme | Host -> Embed | Dynamically synchronize dark / light theme & custom CSS variables |
helix:approval.requested | Embed -> Host | Notify your host UI when a T2 decision awaits the user |
helix:run.completed | Embed -> Host | Trigger toast / refresh tables in your SaaS when an agent finishes work |
Step 4 — White-Label Styling & Content Security Policy (CSP)
When white-label="true", LaunchVerse consumer logos are omitted so the experience inherits your brand colors cleanly. Add these directives to your host app CSP:
Content-Security-Policy:
script-src 'self' https://launchverse.app;
frame-src 'self' https://launchverse.app;
connect-src 'self' https://launchverse.app wss://launchverse.app;Preview and test custom accent themes visually in the Embed Studio or Desktop Embed Studio.

