@elizaos/ui 2.0.0-alpha.85 → 2.0.0-beta.2

package/config/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./allowed-hosts";
+export * from "./app-config";
+export * from "./boot-config";
+export * from "./branding";
+export * from "./cloud-only";
+export * from "./config-catalog";
+export { buildPluginConfigUiSpec, buildPluginListUiSpec, } from "./plugin-ui-spec";
+export * from "./ui-spec";
+//# sourceMappingURL=index.d.ts.map

package/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAI9B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,OAAO,EACL,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/config/index.js

@@ -0,0 +1,11 @@
+export * from "./allowed-hosts.js";
+export * from "./app-config.js";
+export * from "./boot-config.js";
+// boot-config-react.tsx eagerly imports React; not barrel-exported so node-side
+// consumers (bench server, agent boot) can import @elizaos/shared without
+// pulling React into the runtime closure.
+export * from "./branding.js";
+export * from "./cloud-only.js";
+export * from "./config-catalog.js";
+export { buildPluginConfigUiSpec, buildPluginListUiSpec, } from "./plugin-ui-spec.js";
+export * from "./ui-spec.js";

package/config/plugin-ui-spec.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Generates UiSpec JSON for plugin/connector configuration forms.
+ *
+ * When the agent wants to help a user configure a plugin, it generates
+ * a UiSpec that renders as an interactive form in chat. The form fields
+ * are derived from the plugin's parameter definitions.
+ *
+ * Actions:
+ *   - "plugin:save" → saves config via PUT /api/plugins/:id
+ *   - "plugin:enable" → enables the plugin
+ *   - "plugin:test" → tests connectivity
+ */
+export interface PluginParam {
+    key: string;
+    required?: boolean;
+    isSet?: boolean;
+    type?: string;
+    description?: string;
+    label?: string;
+}
+export interface PluginForUiSpec {
+    id: string;
+    name: string;
+    description?: string;
+    enabled?: boolean;
+    category?: string;
+    parameters: PluginParam[];
+}
+/** Declarative UI specification for rendering plugin forms in chat. */
+export interface PluginUiSpec {
+    version: number;
+    root: string;
+    elements: Record<string, Record<string, unknown>>;
+    state: Record<string, unknown>;
+}
+export declare function buildPluginConfigUiSpec(plugin: PluginForUiSpec): PluginUiSpec;
+/**
+ * Generate a compact plugin list UiSpec for the agent to show available
+ * plugins matching a query.
+ */
+export declare function buildPluginListUiSpec(plugins: PluginForUiSpec[], title: string): PluginUiSpec;
+//# sourceMappingURL=plugin-ui-spec.d.ts.map

package/config/plugin-ui-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-ui-spec.d.ts","sourceRoot":"","sources":["../../../../../src/config/plugin-ui-spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,WAAW,EAAE,CAAC;CAC3B;AAED,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,GAAG,YAAY,CAuL7E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,eAAe,EAAE,EAC1B,KAAK,EAAE,MAAM,GACZ,YAAY,CA+Ed"}

package/config/plugin-ui-spec.js

@@ -0,0 +1,256 @@
+/**
+ * Generates UiSpec JSON for plugin/connector configuration forms.
+ *
+ * When the agent wants to help a user configure a plugin, it generates
+ * a UiSpec that renders as an interactive form in chat. The form fields
+ * are derived from the plugin's parameter definitions.
+ *
+ * Actions:
+ *   - "plugin:save" → saves config via PUT /api/plugins/:id
+ *   - "plugin:enable" → enables the plugin
+ *   - "plugin:test" → tests connectivity
+ */
+export function buildPluginConfigUiSpec(plugin) {
+    const elements = {};
+    const rootChildren = [];
+    const state = {
+        pluginId: plugin.id,
+    };
+    // Header
+    elements.header = {
+        type: "Stack",
+        props: { gap: "1", children: ["title", "desc"] },
+    };
+    rootChildren.push("header");
+    elements.title = {
+        type: "Heading",
+        props: {
+            level: 3,
+            text: `Configure ${plugin.name}`,
+        },
+    };
+    if (plugin.description) {
+        elements.desc = {
+            type: "Text",
+            props: {
+                text: plugin.description,
+                className: "text-xs text-muted",
+            },
+        };
+    }
+    // Status badge
+    const statusText = plugin.enabled
+        ? plugin.parameters.every((p) => !p.required || p.isSet)
+            ? "Ready"
+            : "Needs Configuration"
+        : "Disabled";
+    const statusVariant = plugin.enabled
+        ? plugin.parameters.every((p) => !p.required || p.isSet)
+            ? "default"
+            : "secondary"
+        : "outline";
+    elements.status = {
+        type: "Badge",
+        props: { text: statusText, variant: statusVariant },
+    };
+    rootChildren.push("status");
+    // Separator
+    elements.sep = { type: "Separator", props: {} };
+    rootChildren.push("sep");
+    // Parameter fields
+    const fieldIds = [];
+    for (const param of plugin.parameters) {
+        const fieldId = `field_${param.key}`;
+        const statePath = `config.${param.key}`;
+        fieldIds.push(fieldId);
+        state[`config.${param.key}`] = "";
+        const isSecret = param.key.includes("KEY") ||
+            param.key.includes("TOKEN") ||
+            param.key.includes("SECRET") ||
+            param.key.includes("PASSWORD");
+        elements[fieldId] = {
+            type: "Input",
+            props: {
+                label: param.label || param.key,
+                placeholder: param.isSet
+                    ? "••••••• (already set)"
+                    : param.required
+                        ? "Required"
+                        : "Optional",
+                statePath,
+                type: isSecret ? "password" : "text",
+                className: "font-mono text-xs",
+            },
+            ...(param.required
+                ? {
+                    validation: {
+                        checks: [
+                            { rule: "required", message: `${param.key} is required` },
+                        ],
+                    },
+                }
+                : {}),
+        };
+        // Add description below field if available
+        if (param.description) {
+            const hintId = `hint_${param.key}`;
+            fieldIds.push(hintId);
+            elements[hintId] = {
+                type: "Text",
+                props: {
+                    text: param.description,
+                    className: "text-2xs text-muted -mt-1 mb-1",
+                },
+            };
+        }
+    }
+    elements.fields = {
+        type: "Stack",
+        props: { gap: "3", children: fieldIds },
+    };
+    rootChildren.push("fields");
+    // Action buttons
+    const buttonChildren = ["saveBtn"];
+    elements.saveBtn = {
+        type: "Button",
+        props: {
+            text: "Save Configuration",
+            variant: "default",
+            className: "font-semibold",
+            on: {
+                press: {
+                    action: "plugin:save",
+                    params: { pluginId: plugin.id },
+                },
+            },
+        },
+    };
+    if (!plugin.enabled) {
+        buttonChildren.push("enableBtn");
+        elements.enableBtn = {
+            type: "Button",
+            props: {
+                text: "Enable Plugin",
+                variant: "outline",
+                on: {
+                    press: {
+                        action: "plugin:enable",
+                        params: { pluginId: plugin.id },
+                    },
+                },
+            },
+        };
+    }
+    if (plugin.category === "connector") {
+        buttonChildren.push("testBtn");
+        elements.testBtn = {
+            type: "Button",
+            props: {
+                text: "Test Connection",
+                variant: "outline",
+                on: {
+                    press: {
+                        action: "plugin:test",
+                        params: { pluginId: plugin.id },
+                    },
+                },
+            },
+        };
+    }
+    elements.actions = {
+        type: "Stack",
+        props: { direction: "row", gap: "2", children: buttonChildren },
+    };
+    rootChildren.push("actions");
+    // Root
+    elements.root = {
+        type: "Card",
+        props: {
+            children: rootChildren,
+            className: "p-4 space-y-3",
+        },
+    };
+    return {
+        version: 1,
+        root: "root",
+        elements,
+        state,
+    };
+}
+/**
+ * Generate a compact plugin list UiSpec for the agent to show available
+ * plugins matching a query.
+ */
+export function buildPluginListUiSpec(plugins, title) {
+    const elements = {};
+    const cardIds = [];
+    elements.heading = {
+        type: "Heading",
+        props: { level: 3, text: title },
+    };
+    for (let i = 0; i < plugins.length; i++) {
+        const p = plugins[i];
+        const cardId = `card_${i}`;
+        const nameId = `name_${i}`;
+        const descId = `desc_${i}`;
+        const badgeId = `badge_${i}`;
+        const configBtnId = `cfgBtn_${i}`;
+        cardIds.push(cardId);
+        elements[nameId] = {
+            type: "Text",
+            props: {
+                text: p.name,
+                className: "font-semibold text-sm",
+            },
+        };
+        elements[descId] = {
+            type: "Text",
+            props: {
+                text: p.description || "No description",
+                className: "text-xs text-muted",
+            },
+        };
+        elements[badgeId] = {
+            type: "Badge",
+            props: {
+                text: p.enabled ? "Enabled" : "Available",
+                variant: p.enabled ? "default" : "outline",
+            },
+        };
+        elements[configBtnId] = {
+            type: "Button",
+            props: {
+                text: "Configure",
+                variant: "outline",
+                size: "sm",
+                on: {
+                    press: {
+                        action: "plugin:configure",
+                        params: { pluginId: p.id },
+                    },
+                },
+            },
+        };
+        elements[cardId] = {
+            type: "Card",
+            props: {
+                children: [nameId, descId, badgeId, configBtnId],
+                className: "p-3 space-y-1",
+            },
+        };
+    }
+    elements.list = {
+        type: "Stack",
+        props: { gap: "2", children: cardIds },
+    };
+    elements.root = {
+        type: "Stack",
+        props: { gap: "3", children: ["heading", "list"] },
+    };
+    return {
+        version: 1,
+        root: "root",
+        elements,
+        state: {},
+    };
+}

package/config/ui-spec.d.ts

@@ -0,0 +1,164 @@
+/**
+ * ui-spec.ts — TypeScript types for the json-render declarative UI spec.
+ *
+ * A UiSpec describes a tree of UI components that can be rendered
+ * from a JSON declaration. This is the full json-render component model.
+ *
+ * Structure:
+ *   { root: "main", elements: { [id]: UiElement }, state: { ... } }
+ *
+ * Each element has a type, props, optional children (IDs), event bindings,
+ * conditional visibility, validation, and repeat/list support.
+ */
+/** A value that can be either a literal or a path reference. */
+export type DynamicProp<T = string> = T | {
+    $path: string;
+};
+/** Conditional expression for dynamic prop resolution. */
+export interface CondExpr {
+    $cond: {
+        eq?: [unknown, unknown];
+        neq?: [unknown, unknown];
+        gt?: [unknown, unknown];
+        lt?: [unknown, unknown];
+        gte?: [unknown, unknown];
+        lte?: [unknown, unknown];
+        truthy?: unknown;
+        falsy?: unknown;
+        path?: string;
+    };
+    $then: unknown;
+    $else: unknown;
+}
+export type VisibilityOperator = "eq" | "ne" | "gt" | "gte" | "lt" | "lte";
+/** Path-based visibility condition. */
+export interface PathVisibility {
+    path: string;
+    operator: VisibilityOperator;
+    value: unknown;
+}
+/** Auth-based visibility condition. */
+export interface AuthVisibility {
+    auth: "signedIn" | "signedOut" | "admin" | string;
+}
+/** Logical combinators for complex visibility. */
+export interface AndVisibility {
+    and: UiSpecVisibilityCondition[];
+}
+export interface OrVisibility {
+    or: UiSpecVisibilityCondition[];
+}
+export interface NotVisibility {
+    not: UiSpecVisibilityCondition;
+}
+export type UiSpecVisibilityCondition = PathVisibility | AuthVisibility | AndVisibility | OrVisibility | NotVisibility;
+/** Built-in validator function names. */
+export type BuiltinValidator = "required" | "email" | "minLength" | "maxLength" | "pattern" | "min" | "max";
+/** A single validation check on a field. */
+export interface UiSpecValidationCheck {
+    fn: string;
+    args?: Record<string, unknown>;
+    message: string;
+}
+/** Validation configuration for a form element. */
+export interface UiSpecValidationConfig {
+    checks: UiSpecValidationCheck[];
+    validateOn?: "change" | "blur" | "submit";
+}
+/** Action success/error handlers. */
+export interface ActionOnSuccess {
+    action: string;
+    params?: Record<string, unknown>;
+}
+export interface ActionOnError {
+    action: string;
+    params?: Record<string, unknown>;
+}
+/** Confirmation prompt before action execution. */
+export interface ActionConfirm {
+    title: string;
+    message?: string;
+    confirmLabel?: string;
+    cancelLabel?: string;
+}
+export interface UiAction {
+    action: string;
+    params?: Record<string, unknown>;
+    confirm?: ActionConfirm;
+    onSuccess?: ActionOnSuccess;
+    onError?: ActionOnError;
+}
+export type UiEventBindings = Record<string, UiAction>;
+export interface RepeatConfig {
+    path: string;
+    key: string;
+}
+export type UiComponentType = "Stack" | "Grid" | "Card" | "Separator" | "Heading" | "Text" | "Input" | "Textarea" | "Select" | "Checkbox" | "Radio" | "Switch" | "Slider" | "Toggle" | "ToggleGroup" | "ButtonGroup" | "Table" | "Carousel" | "Badge" | "Avatar" | "Image" | "Alert" | "Progress" | "Rating" | "Skeleton" | "Spinner" | "Button" | "Link" | "DropdownMenu" | "Tabs" | "Pagination" | "Metric" | "BarGraph" | "LineGraph" | "Tooltip" | "Popover" | "Collapsible" | "Accordion" | "Dialog" | "Drawer";
+export interface UiElement {
+    type: UiComponentType;
+    props: Record<string, unknown>;
+    children: string[];
+    on?: UiEventBindings;
+    repeat?: RepeatConfig;
+    visible?: UiSpecVisibilityCondition;
+    validation?: UiSpecValidationConfig;
+}
+export interface UiSpec {
+    root: string;
+    elements: Record<string, UiElement>;
+    state: Record<string, unknown>;
+}
+export interface AuthState {
+    isSignedIn: boolean;
+    roles?: string[];
+}
+export interface UiRenderContext {
+    spec: UiSpec;
+    state: Record<string, unknown>;
+    setState: (path: string, value: unknown) => void;
+    onAction?: (action: string, params?: Record<string, unknown>) => void;
+    /** Current repeat item data (set when inside a repeat block). */
+    repeatItem?: Record<string, unknown>;
+    /** Auth state for visibility evaluation. */
+    auth?: AuthState;
+    /** Whether the renderer is in a loading/streaming state. */
+    loading?: boolean;
+    /** Custom validator functions. */
+    validators?: Record<string, (value: unknown, args?: Record<string, unknown>) => boolean | Promise<boolean>>;
+    /** Field validation errors keyed by statePath. */
+    fieldErrors?: Record<string, string[]>;
+    /** Trigger validation for a field. */
+    validateField?: (statePath: string) => void;
+}
+/** RFC 6902 JSON Patch operation. */
+export type PatchOp = {
+    op: "add";
+    path: string;
+    value: unknown;
+} | {
+    op: "remove";
+    path: string;
+} | {
+    op: "replace";
+    path: string;
+    value: unknown;
+} | {
+    op: "move";
+    from: string;
+    path: string;
+} | {
+    op: "copy";
+    from: string;
+    path: string;
+} | {
+    op: "test";
+    path: string;
+    value: unknown;
+};
+/** Stream configuration for useUIStream. */
+export interface UIStreamConfig {
+    api: string;
+    onComplete?: (spec: UiSpec) => void;
+    onError?: (error: Error) => void;
+}
+//# sourceMappingURL=ui-spec.d.ts.map

package/config/ui-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-spec.d.ts","sourceRoot":"","sources":["../../../../../src/config/ui-spec.ts"],"names":[],"mappings":"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"}

package/config/ui-spec.js

@@ -0,0 +1,13 @@
+/**
+ * ui-spec.ts — TypeScript types for the json-render declarative UI spec.
+ *
+ * A UiSpec describes a tree of UI components that can be rendered
+ * from a JSON declaration. This is the full json-render component model.
+ *
+ * Structure:
+ *   { root: "main", elements: { [id]: UiElement }, state: { ... } }
+ *
+ * Each element has a type, props, optional children (IDs), event bindings,
+ * conditional visibility, validation, and repeat/list support.
+ */
+export {};

package/content-packs/apply-pack.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Content pack application.
+ *
+ * Takes a ResolvedContentPack and applies its assets to the app state.
+ * This is called from the splash page after the user selects a pack.
+ */
+import type { ContentPackColorScheme, ResolvedContentPack } from "@elizaos/shared";
+/** Minimal state setters needed to apply a content pack. */
+export interface ContentPackApplyDeps {
+    setCustomVrmUrl: (url: string) => void;
+    setCustomVrmPreviewUrl: (url: string) => void;
+    setCustomBackgroundUrl: (url: string) => void;
+    setCustomWorldUrl: (url: string) => void;
+    setSelectedVrmIndex: (index: number) => void;
+    setOnboardingName: (name: string) => void;
+    setOnboardingStyle: (style: string) => void;
+    setCustomCatchphrase: (phrase: string) => void;
+    setCustomVoicePresetId: (id: string) => void;
+}
+/**
+ * Apply a content pack to the app state.
+ * Call this on the splash page after the user selects a pack.
+ */
+export declare function applyContentPack(pack: ResolvedContentPack, deps: ContentPackApplyDeps): void;
+/**
+ * Apply a content pack's color scheme as CSS custom properties on the
+ * document root. Returns a cleanup function that removes them.
+ *
+ * If the pack includes a full ThemeDefinition (via `theme` field),
+ * it takes precedence over the narrow colorScheme.
+ */
+export declare function applyColorScheme(scheme: ContentPackColorScheme | undefined, pack?: ResolvedContentPack): () => void;
+//# sourceMappingURL=apply-pack.d.ts.map

package/content-packs/apply-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-pack.d.ts","sourceRoot":"","sources":["../../../../../src/content-packs/apply-pack.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,iBAAiB,CAAC;AAGzB,4DAA4D;AAC5D,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,sBAAsB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,sBAAsB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,iBAAiB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,mBAAmB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,kBAAkB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,oBAAoB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,sBAAsB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,mBAAmB,EACzB,IAAI,EAAE,oBAAoB,GACzB,IAAI,CAiCN;AAgBD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,sBAAsB,GAAG,SAAS,EAC1C,IAAI,CAAC,EAAE,mBAAmB,GACzB,MAAM,IAAI,CAwCZ"}

package/content-packs/apply-pack.js

@@ -0,0 +1,96 @@
+/**
+ * Content pack application.
+ *
+ * Takes a ResolvedContentPack and applies its assets to the app state.
+ * This is called from the splash page after the user selects a pack.
+ */
+import { applyThemeToDocument } from "../themes/apply-theme.js";
+/**
+ * Apply a content pack to the app state.
+ * Call this on the splash page after the user selects a pack.
+ */
+export function applyContentPack(pack, deps) {
+    // VRM — bundled packs use avatarIndex, custom packs use vrmUrl
+    if (pack.avatarIndex != null && pack.avatarIndex > 0) {
+        deps.setSelectedVrmIndex(pack.avatarIndex);
+        deps.setCustomVrmUrl("");
+        deps.setCustomVrmPreviewUrl("");
+    }
+    else if (pack.vrmUrl) {
+        deps.setCustomVrmUrl(pack.vrmUrl);
+        deps.setCustomVrmPreviewUrl(pack.vrmPreviewUrl ?? "");
+        deps.setSelectedVrmIndex(0); // 0 = custom VRM
+    }
+    // Background
+    if (pack.backgroundUrl) {
+        deps.setCustomBackgroundUrl(pack.backgroundUrl);
+    }
+    // Companion world scene
+    deps.setCustomWorldUrl(pack.worldUrl ?? "");
+    // Personality
+    if (pack.personality?.name) {
+        deps.setOnboardingName(pack.personality.name);
+    }
+    if (pack.personality?.catchphrase) {
+        deps.setCustomCatchphrase(pack.personality.catchphrase);
+    }
+    if (pack.personality?.voicePresetId) {
+        deps.setCustomVoicePresetId(pack.personality.voicePresetId);
+    }
+    if (pack.avatarIndex != null && pack.avatarIndex > 0 && pack.manifest.id) {
+        deps.setOnboardingStyle(pack.manifest.id);
+    }
+}
+// ── Color scheme CSS variable application ───────────────────────────
+const COLOR_SCHEME_CSS_MAP = {
+    accent: "--pack-accent",
+    bg: "--pack-bg",
+    card: "--pack-card",
+    border: "--pack-border",
+    text: "--pack-text",
+    textMuted: "--pack-text-muted",
+};
+/**
+ * Apply a content pack's color scheme as CSS custom properties on the
+ * document root. Returns a cleanup function that removes them.
+ *
+ * If the pack includes a full ThemeDefinition (via `theme` field),
+ * it takes precedence over the narrow colorScheme.
+ */
+export function applyColorScheme(scheme, pack) {
+    // Full theme takes precedence
+    if (pack?.manifest.assets.theme) {
+        const mode = typeof document !== "undefined" &&
+            document.documentElement.getAttribute("data-theme") === "light"
+            ? "light"
+            : "dark";
+        return applyThemeToDocument(pack.manifest.assets.theme, mode);
+    }
+    if (!scheme || typeof document === "undefined")
+        return () => { };
+    const root = document.documentElement;
+    const applied = [];
+    for (const [key, cssVar] of Object.entries(COLOR_SCHEME_CSS_MAP)) {
+        const value = scheme[key];
+        if (value) {
+            root.style.setProperty(cssVar, value);
+            applied.push(cssVar);
+        }
+    }
+    if (scheme.customProperties) {
+        for (const [key, value] of Object.entries(scheme.customProperties)) {
+            // Sanitize: reject values containing url() to prevent external
+            // resource fetches when CSS vars are consumed by components.
+            if (/url\s*\(/i.test(value))
+                continue;
+            const cssVar = key.startsWith("--") ? key : `--${key}`;
+            root.style.setProperty(cssVar, value);
+            applied.push(cssVar);
+        }
+    }
+    return () => {
+        for (const cssVar of applied) {
+            root.style.removeProperty(cssVar);
+        }
+    };
+}

package/content-packs/bundled-packs.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Bundled content packs derived from the existing character presets.
+ *
+ * Each of the 8 built-in characters (Chen, Jin, Kei, etc.) becomes a
+ * content pack with their VRM, background, and personality.
+ */
+import type { ResolvedContentPack } from "@elizaos/shared";
+/**
+ * Get all bundled content packs (derived from the 8 built-in characters).
+ * Bundled packs use avatarIndex (1-8) to reference existing VRM assets
+ * rather than generating custom VRM URLs.
+ */
+export declare function getBundledContentPacks(): ResolvedContentPack[];
+//# sourceMappingURL=bundled-packs.d.ts.map

package/content-packs/bundled-packs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundled-packs.d.ts","sourceRoot":"","sources":["../../../../../src/content-packs/bundled-packs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAuB,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAuGhF;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,mBAAmB,EAAE,CAI9D"}