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
// Per-agent embed policy: one JSONB column on agent_identities holding
// origins + surfaces + brain + storage config. See prompts/embed-hardening/.
import { z } from 'zod';
import { sql } from './db.js';
import { isUuid } from './validate.js';
const hostPattern =
/^(\*\.)?([a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?)(\.[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?)*$/i;
export const POLICY_VERSION = 1;
export const policySchema = z.object({
version: z.literal(1).optional(),
origins: z.object({
mode: z.enum(['allowlist', 'denylist']),
hosts: z.array(z.string().trim().toLowerCase().min(1).max(253).regex(hostPattern)).max(100),
}),
surfaces: z.object({
script: z.boolean(),
iframe: z.boolean(),
widget: z.boolean(),
mcp: z.boolean(),
}),
brain: z
.object({
mode: z.enum(['we-pay', 'key-proxy', 'wallet-gated', 'none']),
proxy_url: z.string().url().nullable(),
monthly_quota: z.number().int().nonnegative().nullable(),
rate_limit_per_min: z.number().int().nonnegative().nullable(),
model: z.string().min(1).max(100),
})
.refine((b) => b.mode !== 'key-proxy' || !!b.proxy_url, {
message: 'proxy_url is required when brain.mode === "key-proxy"',
path: ['proxy_url'],
}),
storage: z.object({
primary: z.enum(['r2', 'ipfs']),
pinned_ipfs: z.boolean(),
onchain_attested: z.boolean(),
}),
});
export function defaultEmbedPolicy() {
return {
version: POLICY_VERSION,
origins: { mode: 'allowlist', hosts: [] },
surfaces: { script: true, iframe: true, widget: true, mcp: false },
brain: {
// Default to free OpenRouter Llama 3.3 70B: tool-call capable, no
// per-token cost to the host, daily rate cap shared across the org
// key. Owners can switch to a paid Claude model from the dashboard.
mode: 'we-pay',
proxy_url: null,
monthly_quota: 1000,
rate_limit_per_min: 10,
model: 'google/gemma-4-31b-it:free',
},
storage: { primary: 'r2', pinned_ipfs: false, onchain_attested: false },
};
}
export function normalizeLegacyPolicy(input) {
if (!input) return defaultEmbedPolicy();
const isLegacy =
!('version' in input) && !('origins' in input) && 'mode' in input && 'hosts' in input;
if (isLegacy) {
const d = defaultEmbedPolicy();
return { ...d, origins: { mode: input.mode, hosts: input.hosts ?? [] } };
}
const d = defaultEmbedPolicy();
return {
version: POLICY_VERSION,
origins: { ...d.origins, ...(input.origins || {}) },
surfaces: { ...d.surfaces, ...(input.surfaces || {}) },
brain: { ...d.brain, ...(input.brain || {}) },
storage: { ...d.storage, ...(input.storage || {}) },
};
}
export async function readEmbedPolicy(agentId) {
if (!isUuid(agentId)) return null;
let row;
try {
[row] = await sql`
SELECT embed_policy FROM agent_identities
WHERE id = ${agentId} AND deleted_at IS NULL
`;
} catch (err) {
if (
err.message &&
err.message.includes('column') &&
err.message.includes('does not exist')
) {
return null;
}
throw err;
}
if (!row) return null;
return normalizeLegacyPolicy(row.embed_policy);
}
// Read the embed policy for an agent_identity row identified by its avatar_id.
// Used by the MCP middleware where only the avatar id is on the request.
export async function readEmbedPolicyByAvatarId(avatarId) {
if (!isUuid(avatarId)) return null;
let row;
try {
[row] = await sql`
SELECT embed_policy FROM agent_identities
WHERE avatar_id = ${avatarId} AND deleted_at IS NULL
LIMIT 1
`;
} catch (err) {
if (
err.message &&
err.message.includes('column') &&
err.message.includes('does not exist')
) {
return null;
}
throw err;
}
if (!row) return null;
return normalizeLegacyPolicy(row.embed_policy);
}
// Check whether a request origin is permitted by the given policy.
// Returns true when no Referer is present (bots, direct requests).
export function originAllowed(refererHeader, policy, appOriginHost) {
if (!refererHeader) return true;
let host;
try {
host = new URL(refererHeader).hostname.toLowerCase();
} catch {
return true;
}
if (host === appOriginHost || host === 'localhost' || host.endsWith('.localhost')) return true;
const hosts = policy?.origins?.hosts ?? [];
const mode = policy?.origins?.mode ?? 'allowlist';
const matched = hosts.some((h) => {
const lower = h.toLowerCase();
if (lower.startsWith('*.')) return host.endsWith(lower.slice(1)) && host !== lower.slice(2);
return host === lower;
});
return mode === 'allowlist' ? matched : !matched;
}
export function validateEmbedPolicy(input) {
return policySchema.parse(normalizeLegacyPolicy(input));
}