@elizaos/agent 0.25.9 → 2.0.0-alpha.144

package/packages/shared/src/contracts/permissions.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Shared system permission contracts.
+ */
+export type SystemPermissionId = "accessibility" | "screen-recording" | "microphone" | "camera" | "shell" | "website-blocking";
+export type PermissionStatus = "granted" | "denied" | "not-determined" | "restricted" | "not-applicable";
+export type Platform = "darwin" | "win32" | "linux";
+export interface SystemPermissionDefinition {
+    id: SystemPermissionId;
+    name: string;
+    description: string;
+    icon: string;
+    platforms: Platform[];
+    requiredForFeatures: string[];
+}
+export interface PermissionState {
+    id: SystemPermissionId;
+    status: PermissionStatus;
+    lastChecked: number;
+    canRequest: boolean;
+    reason?: string;
+}
+export interface PermissionCheckResult {
+    status: PermissionStatus;
+    canRequest: boolean;
+    reason?: string;
+}
+export interface AllPermissionsState {
+    accessibility: PermissionState;
+    "screen-recording": PermissionState;
+    microphone: PermissionState;
+    camera: PermissionState;
+    shell: PermissionState;
+    "website-blocking": PermissionState;
+}
+export interface PermissionManagerConfig {
+    cacheTimeoutMs: number;
+}
+//# sourceMappingURL=permissions.d.ts.map

package/packages/shared/src/contracts/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../../../../shared/src/contracts/permissions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,kBAAkB,GAC1B,eAAe,GACf,kBAAkB,GAClB,YAAY,GACZ,QAAQ,GACR,OAAO,GACP,kBAAkB,CAAC;AAEvB,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,QAAQ,GACR,gBAAgB,GAChB,YAAY,GACZ,gBAAgB,CAAC;AAErB,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AAEpD,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,kBAAkB,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,kBAAkB,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,eAAe,CAAC;IAC/B,kBAAkB,EAAE,eAAe,CAAC;IACpC,UAAU,EAAE,eAAe,CAAC;IAC5B,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,eAAe,CAAC;IACvB,kBAAkB,EAAE,eAAe,CAAC;CACrC;AAED,MAAM,WAAW,uBAAuB;IACtC,cAAc,EAAE,MAAM,CAAC;CACxB"}

package/packages/shared/src/contracts/permissions.js

@@ -0,0 +1,4 @@
+/**
+ * Shared system permission contracts.
+ */
+export {};

package/packages/shared/src/contracts/service-routing.d.ts

@@ -0,0 +1,77 @@
+export type LinkedAccountStatus = "linked" | "unlinked";
+export type LinkedAccountSource = "api-key" | "oauth" | "credentials" | "subscription";
+export type LinkedAccountConfig = {
+    status?: LinkedAccountStatus;
+    source?: LinkedAccountSource;
+    userId?: string;
+    organizationId?: string;
+};
+export type LinkedAccountsConfig = Record<string, LinkedAccountConfig>;
+export type ServiceCapability = "llmText" | "tts" | "media" | "embeddings" | "rpc";
+export type ServiceTransport = "direct" | "cloud-proxy" | "remote";
+export type ServiceRouteConfig = {
+    backend?: string;
+    transport?: ServiceTransport;
+    accountId?: string;
+    primaryModel?: string;
+    nanoModel?: string;
+    smallModel?: string;
+    mediumModel?: string;
+    largeModel?: string;
+    megaModel?: string;
+    remoteApiBase?: string;
+    /**
+     * Per-step model overrides for the fine-tuned pipeline.
+     * Each step can specify a model ID (e.g., a Vertex AI fine-tuned endpoint).
+     * Falls back to: stepModel -> plugin override -> smallModel/largeModel -> system default.
+     */
+    responseHandlerModel?: string;
+    shouldRespondModel?: string;
+    actionPlannerModel?: string;
+    plannerModel?: string;
+    responseModel?: string;
+    mediaDescriptionModel?: string;
+};
+export type ServiceRoutingConfig = Partial<Record<ServiceCapability, ServiceRouteConfig>>;
+export type DeploymentTargetRuntime = "local" | "cloud" | "remote";
+export type DeploymentTargetConfig = {
+    runtime: DeploymentTargetRuntime;
+    provider?: "elizacloud" | "remote";
+    remoteApiBase?: string;
+    remoteAccessToken?: string;
+};
+export declare const SERVICE_CAPABILITIES: readonly ["llmText", "tts", "media", "embeddings", "rpc"];
+export declare function buildElizaCloudServiceRoute(args?: {
+    nanoModel?: string;
+    smallModel?: string;
+    mediumModel?: string;
+    largeModel?: string;
+    megaModel?: string;
+    responseHandlerModel?: string;
+    shouldRespondModel?: string;
+    actionPlannerModel?: string;
+    plannerModel?: string;
+    responseModel?: string;
+    mediaDescriptionModel?: string;
+}): ServiceRouteConfig;
+export declare function buildDefaultElizaCloudServiceRouting(args?: {
+    base?: ServiceRoutingConfig | null;
+    includeInference?: boolean;
+    nanoModel?: string;
+    smallModel?: string;
+    mediumModel?: string;
+    largeModel?: string;
+    megaModel?: string;
+    responseHandlerModel?: string;
+    shouldRespondModel?: string;
+    actionPlannerModel?: string;
+    plannerModel?: string;
+    responseModel?: string;
+    mediaDescriptionModel?: string;
+}): ServiceRoutingConfig;
+export declare function normalizeLinkedAccountConfig(value: unknown): LinkedAccountConfig | null;
+export declare function normalizeLinkedAccountsConfig(value: unknown): LinkedAccountsConfig | null;
+export declare function normalizeServiceRouteConfig(value: unknown): ServiceRouteConfig | null;
+export declare function normalizeServiceRoutingConfig(value: unknown): ServiceRoutingConfig | null;
+export declare function normalizeDeploymentTargetConfig(value: unknown): DeploymentTargetConfig | null;
+//# sourceMappingURL=service-routing.d.ts.map

package/packages/shared/src/contracts/service-routing.d.ts.map

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

package/packages/shared/src/contracts/service-routing.js

@@ -0,0 +1,227 @@
+const ELIZA_CLOUD_ROUTE_BASE = {
+    backend: "elizacloud",
+    transport: "cloud-proxy",
+    accountId: "elizacloud",
+};
+const ELIZA_CLOUD_DEFAULT_SERVICE_CAPABILITIES = [
+    "tts",
+    "media",
+    "embeddings",
+    "rpc",
+];
+export const SERVICE_CAPABILITIES = [
+    "llmText",
+    "tts",
+    "media",
+    "embeddings",
+    "rpc",
+];
+export function buildElizaCloudServiceRoute(args = {}) {
+    return {
+        ...ELIZA_CLOUD_ROUTE_BASE,
+        ...(args.nanoModel ? { nanoModel: args.nanoModel } : {}),
+        ...(args.smallModel ? { smallModel: args.smallModel } : {}),
+        ...(args.mediumModel ? { mediumModel: args.mediumModel } : {}),
+        ...(args.largeModel ? { largeModel: args.largeModel } : {}),
+        ...(args.megaModel ? { megaModel: args.megaModel } : {}),
+        ...(args.responseHandlerModel
+            ? { responseHandlerModel: args.responseHandlerModel }
+            : {}),
+        ...(args.shouldRespondModel
+            ? { shouldRespondModel: args.shouldRespondModel }
+            : {}),
+        ...(args.actionPlannerModel
+            ? { actionPlannerModel: args.actionPlannerModel }
+            : {}),
+        ...(args.plannerModel ? { plannerModel: args.plannerModel } : {}),
+        ...(args.responseModel ? { responseModel: args.responseModel } : {}),
+        ...(args.mediaDescriptionModel
+            ? { mediaDescriptionModel: args.mediaDescriptionModel }
+            : {}),
+    };
+}
+export function buildDefaultElizaCloudServiceRouting(args = {}) {
+    const next = { ...(args.base ?? {}) };
+    for (const capability of ELIZA_CLOUD_DEFAULT_SERVICE_CAPABILITIES) {
+        next[capability] ??= buildElizaCloudServiceRoute();
+    }
+    if (args.includeInference) {
+        next.llmText ??= buildElizaCloudServiceRoute({
+            nanoModel: args.nanoModel,
+            smallModel: args.smallModel,
+            mediumModel: args.mediumModel,
+            largeModel: args.largeModel,
+            megaModel: args.megaModel,
+            responseHandlerModel: args.responseHandlerModel,
+            shouldRespondModel: args.shouldRespondModel,
+            actionPlannerModel: args.actionPlannerModel,
+            plannerModel: args.plannerModel,
+            responseModel: args.responseModel,
+            mediaDescriptionModel: args.mediaDescriptionModel,
+        });
+    }
+    return next;
+}
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}
+function readTrimmedString(source, key) {
+    const value = source?.[key];
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function normalizeLinkedAccountStatus(value) {
+    return value === "linked" || value === "unlinked" ? value : undefined;
+}
+function normalizeLinkedAccountSource(value) {
+    return value === "api-key" ||
+        value === "oauth" ||
+        value === "credentials" ||
+        value === "subscription"
+        ? value
+        : undefined;
+}
+function normalizeServiceTransport(value) {
+    return value === "direct" ||
+        value === "cloud-proxy" ||
+        value === "remote"
+        ? value
+        : undefined;
+}
+export function normalizeLinkedAccountConfig(value) {
+    const account = asRecord(value);
+    if (!account) {
+        return null;
+    }
+    const status = normalizeLinkedAccountStatus(account.status);
+    const source = normalizeLinkedAccountSource(account.source);
+    const userId = readTrimmedString(account, "userId");
+    const organizationId = readTrimmedString(account, "organizationId");
+    if (!status && !source && !userId && !organizationId) {
+        return null;
+    }
+    return {
+        ...(status ? { status } : {}),
+        ...(source ? { source } : {}),
+        ...(userId ? { userId } : {}),
+        ...(organizationId ? { organizationId } : {}),
+    };
+}
+export function normalizeLinkedAccountsConfig(value) {
+    const accounts = asRecord(value);
+    if (!accounts) {
+        return null;
+    }
+    const normalizedEntries = [];
+    for (const [accountId, accountValue] of Object.entries(accounts)) {
+        const trimmedAccountId = accountId.trim();
+        const normalizedAccount = normalizeLinkedAccountConfig(accountValue);
+        if (!trimmedAccountId || !normalizedAccount) {
+            continue;
+        }
+        normalizedEntries.push([trimmedAccountId, normalizedAccount]);
+    }
+    const normalized = Object.fromEntries(normalizedEntries);
+    return Object.keys(normalized).length > 0 ? normalized : null;
+}
+export function normalizeServiceRouteConfig(value) {
+    const route = asRecord(value);
+    if (!route) {
+        return null;
+    }
+    const backend = readTrimmedString(route, "backend");
+    const transport = normalizeServiceTransport(route.transport);
+    const accountId = readTrimmedString(route, "accountId");
+    const primaryModel = readTrimmedString(route, "primaryModel");
+    const nanoModel = readTrimmedString(route, "nanoModel");
+    const smallModel = readTrimmedString(route, "smallModel");
+    const mediumModel = readTrimmedString(route, "mediumModel");
+    const largeModel = readTrimmedString(route, "largeModel");
+    const megaModel = readTrimmedString(route, "megaModel");
+    const responseHandlerModel = readTrimmedString(route, "responseHandlerModel");
+    const shouldRespondModel = readTrimmedString(route, "shouldRespondModel");
+    const actionPlannerModel = readTrimmedString(route, "actionPlannerModel");
+    const plannerModel = readTrimmedString(route, "plannerModel");
+    const responseModel = readTrimmedString(route, "responseModel");
+    const mediaDescriptionModel = readTrimmedString(route, "mediaDescriptionModel");
+    const remoteApiBase = readTrimmedString(route, "remoteApiBase");
+    if (!backend &&
+        !transport &&
+        !accountId &&
+        !primaryModel &&
+        !nanoModel &&
+        !smallModel &&
+        !mediumModel &&
+        !largeModel &&
+        !megaModel &&
+        !responseHandlerModel &&
+        !shouldRespondModel &&
+        !actionPlannerModel &&
+        !plannerModel &&
+        !responseModel &&
+        !mediaDescriptionModel &&
+        !remoteApiBase) {
+        return null;
+    }
+    return {
+        ...(backend ? { backend } : {}),
+        ...(transport ? { transport } : {}),
+        ...(accountId ? { accountId } : {}),
+        ...(primaryModel ? { primaryModel } : {}),
+        ...(nanoModel ? { nanoModel } : {}),
+        ...(smallModel ? { smallModel } : {}),
+        ...(mediumModel ? { mediumModel } : {}),
+        ...(largeModel ? { largeModel } : {}),
+        ...(megaModel ? { megaModel } : {}),
+        ...(responseHandlerModel ? { responseHandlerModel } : {}),
+        ...(shouldRespondModel ? { shouldRespondModel } : {}),
+        ...(actionPlannerModel ? { actionPlannerModel } : {}),
+        ...(plannerModel ? { plannerModel } : {}),
+        ...(responseModel ? { responseModel } : {}),
+        ...(mediaDescriptionModel ? { mediaDescriptionModel } : {}),
+        ...(remoteApiBase ? { remoteApiBase } : {}),
+    };
+}
+export function normalizeServiceRoutingConfig(value) {
+    const routing = asRecord(value);
+    if (!routing) {
+        return null;
+    }
+    const normalized = Object.fromEntries(SERVICE_CAPABILITIES.map((capability) => [
+        capability,
+        normalizeServiceRouteConfig(routing[capability]),
+    ]).filter((entry) => entry[1] !== null));
+    return Object.keys(normalized).length > 0 ? normalized : null;
+}
+export function normalizeDeploymentTargetConfig(value) {
+    const target = asRecord(value);
+    if (!target) {
+        return null;
+    }
+    const runtime = target.runtime === "local" ||
+        target.runtime === "cloud" ||
+        target.runtime === "remote"
+        ? target.runtime
+        : null;
+    if (!runtime) {
+        return null;
+    }
+    const provider = target.provider === "elizacloud" || target.provider === "remote"
+        ? target.provider
+        : undefined;
+    return {
+        runtime,
+        ...(provider ? { provider } : {}),
+        ...(readTrimmedString(target, "remoteApiBase")
+            ? { remoteApiBase: readTrimmedString(target, "remoteApiBase") }
+            : {}),
+        ...(readTrimmedString(target, "remoteAccessToken")
+            ? { remoteAccessToken: readTrimmedString(target, "remoteAccessToken") }
+            : {}),
+    };
+}

package/packages/shared/src/contracts/theme.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Theme definition types and utilities.
+ *
+ * A ThemeDefinition provides a complete set of design tokens (colors, fonts,
+ * radii, shadows) for both light and dark modes. Themes are applied at
+ * runtime by setting CSS custom properties on the document root, which
+ * propagate through the existing Tailwind @theme inline mapping.
+ */
+/** All themeable CSS custom properties for a single color mode. */
+export interface ThemeColorSet {
+    bg: string;
+    bgAccent: string;
+    bgElevated: string;
+    bgHover: string;
+    bgMuted: string;
+    card: string;
+    cardForeground: string;
+    surface: string;
+    text: string;
+    textStrong: string;
+    chatText: string;
+    muted: string;
+    mutedStrong: string;
+    border: string;
+    borderStrong: string;
+    borderHover: string;
+    input: string;
+    ring: string;
+    accent: string;
+    accentRgb: string;
+    accentHover: string;
+    accentMuted: string;
+    accentSubtle: string;
+    accentForeground: string;
+    primary: string;
+    primaryForeground: string;
+    ok: string;
+    okMuted: string;
+    okSubtle: string;
+    destructive: string;
+    destructiveForeground: string;
+    destructiveSubtle: string;
+    danger: string;
+    warn: string;
+    warnMuted: string;
+    warnSubtle: string;
+    info: string;
+    statusInfo: string;
+    statusInfoBg: string;
+    focus: string;
+    focusRing: string;
+    scrollbarTrack: string;
+    scrollbarThumbStart: string;
+    scrollbarThumbMid: string;
+    scrollbarThumbEnd: string;
+    scrollbarThumbHoverStart: string;
+    scrollbarThumbHoverMid: string;
+    scrollbarThumbHoverEnd: string;
+    scrollbarThumbEdge: string;
+    headerBarBg: string;
+    headerBarFg: string;
+    sectionBarBg: string;
+    sectionBarFg: string;
+    linkColor: string;
+    linkHoverColor: string;
+    shadowXs: string;
+    shadowSm: string;
+    shadowMd: string;
+    shadowLg: string;
+    shadowXl: string;
+    shadow2xl: string;
+    shadowInset: string;
+    radius: string;
+    radiusSm: string;
+    radiusMd: string;
+    radiusLg: string;
+    radiusXl: string;
+    radius2xl: string;
+    radius3xl: string;
+    durationNormal: string;
+}
+export interface ThemeFonts {
+    /** Body text font-family stack */
+    body?: string;
+    /** Display / heading font-family stack */
+    display?: string;
+    /** Chat message font-family stack */
+    chat?: string;
+    /** Monospace font-family stack */
+    mono?: string;
+    /**
+     * URL to load external fonts (e.g. Google Fonts).
+     * A <link rel="stylesheet"> is injected into <head> when the theme is applied.
+     */
+    fontImportUrl?: string;
+}
+export interface ThemeDefinition {
+    /** Unique theme identifier (kebab-case, e.g. "neon-cyber") */
+    id: string;
+    /** Human-readable display name */
+    name: string;
+    /** Short description shown in the theme picker */
+    description?: string;
+    /** Preview — CSS gradient string or image path for the theme card */
+    preview?: string;
+    /** Font overrides */
+    fonts?: ThemeFonts;
+    /** Color tokens for light mode */
+    light: Partial<ThemeColorSet>;
+    /** Color tokens for dark mode */
+    dark: Partial<ThemeColorSet>;
+}
+/**
+ * Maps ThemeColorSet camelCase keys to their CSS custom property names.
+ * Used by applyThemeToDocument() to set properties on the root element.
+ */
+export declare const THEME_CSS_VAR_MAP: Record<keyof ThemeColorSet, string>;
+/** All CSS variable names that the theme system manages. */
+export declare const THEME_CSS_VAR_NAMES: string[];
+/** Font CSS variable names set by ThemeFonts. */
+export declare const THEME_FONT_CSS_VARS: {
+    readonly body: "--font-body";
+    readonly display: "--font-display";
+    readonly chat: "--font-chat";
+    readonly mono: "--mono";
+};
+export interface ThemeValidationError {
+    field: string;
+    message: string;
+}
+export declare function validateThemeDefinition(data: unknown): ThemeValidationError[];
+/** Default theme ID applied when no theme is explicitly selected */
+export declare const DEFAULT_THEME_ID = "bsc-gold";
+/** Data attribute used to identify the injected font <link> */
+export declare const THEME_FONT_LINK_ID = "eliza-theme-font";
+//# sourceMappingURL=theme.d.ts.map

package/packages/shared/src/contracts/theme.d.ts.map

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

package/packages/shared/src/contracts/theme.js

@@ -0,0 +1,133 @@
+/**
+ * Theme definition types and utilities.
+ *
+ * A ThemeDefinition provides a complete set of design tokens (colors, fonts,
+ * radii, shadows) for both light and dark modes. Themes are applied at
+ * runtime by setting CSS custom properties on the document root, which
+ * propagate through the existing Tailwind @theme inline mapping.
+ */
+// ── CSS Variable Map ───────────────────────────────────────────────
+/**
+ * Maps ThemeColorSet camelCase keys to their CSS custom property names.
+ * Used by applyThemeToDocument() to set properties on the root element.
+ */
+export const THEME_CSS_VAR_MAP = {
+    bg: "--bg",
+    bgAccent: "--bg-accent",
+    bgElevated: "--bg-elevated",
+    bgHover: "--bg-hover",
+    bgMuted: "--bg-muted",
+    card: "--card",
+    cardForeground: "--card-foreground",
+    surface: "--surface",
+    text: "--text",
+    textStrong: "--text-strong",
+    chatText: "--chat-text",
+    muted: "--muted",
+    mutedStrong: "--muted-strong",
+    border: "--border",
+    borderStrong: "--border-strong",
+    borderHover: "--border-hover",
+    input: "--input",
+    ring: "--ring",
+    accent: "--accent",
+    accentRgb: "--accent-rgb",
+    accentHover: "--accent-hover",
+    accentMuted: "--accent-muted",
+    accentSubtle: "--accent-subtle",
+    accentForeground: "--accent-foreground",
+    primary: "--primary",
+    primaryForeground: "--primary-foreground",
+    ok: "--ok",
+    okMuted: "--ok-muted",
+    okSubtle: "--ok-subtle",
+    destructive: "--destructive",
+    destructiveForeground: "--destructive-foreground",
+    destructiveSubtle: "--destructive-subtle",
+    danger: "--danger",
+    warn: "--warn",
+    warnMuted: "--warn-muted",
+    warnSubtle: "--warn-subtle",
+    info: "--info",
+    statusInfo: "--status-info",
+    statusInfoBg: "--status-info-bg",
+    focus: "--focus",
+    focusRing: "--focus-ring",
+    scrollbarTrack: "--scrollbar-track",
+    scrollbarThumbStart: "--scrollbar-thumb-start",
+    scrollbarThumbMid: "--scrollbar-thumb-mid",
+    scrollbarThumbEnd: "--scrollbar-thumb-end",
+    scrollbarThumbHoverStart: "--scrollbar-thumb-hover-start",
+    scrollbarThumbHoverMid: "--scrollbar-thumb-hover-mid",
+    scrollbarThumbHoverEnd: "--scrollbar-thumb-hover-end",
+    scrollbarThumbEdge: "--scrollbar-thumb-edge",
+    headerBarBg: "--header-bar-bg",
+    headerBarFg: "--header-bar-fg",
+    sectionBarBg: "--section-bar-bg",
+    sectionBarFg: "--section-bar-fg",
+    linkColor: "--link-color",
+    linkHoverColor: "--link-hover-color",
+    shadowXs: "--shadow-xs",
+    shadowSm: "--shadow-sm",
+    shadowMd: "--shadow-md",
+    shadowLg: "--shadow-lg",
+    shadowXl: "--shadow-xl",
+    shadow2xl: "--shadow-2xl",
+    shadowInset: "--shadow-inset",
+    radius: "--radius",
+    radiusSm: "--radius-sm",
+    radiusMd: "--radius-md",
+    radiusLg: "--radius-lg",
+    radiusXl: "--radius-xl",
+    radius2xl: "--radius-2xl",
+    radius3xl: "--radius-3xl",
+    durationNormal: "--duration-normal",
+};
+/** All CSS variable names that the theme system manages. */
+export const THEME_CSS_VAR_NAMES = Object.values(THEME_CSS_VAR_MAP);
+/** Font CSS variable names set by ThemeFonts. */
+export const THEME_FONT_CSS_VARS = {
+    body: "--font-body",
+    display: "--font-display",
+    chat: "--font-chat",
+    mono: "--mono",
+};
+// ── Validation ─────────────────────────────────────────────────────
+const THEME_ID_PATTERN = /^[a-z0-9][a-z0-9-]*[a-z0-9]$/;
+export function validateThemeDefinition(data) {
+    const errors = [];
+    if (!data || typeof data !== "object" || Array.isArray(data)) {
+        errors.push({ field: "root", message: "Theme must be a JSON object" });
+        return errors;
+    }
+    const theme = data;
+    if (typeof theme.id !== "string" || !theme.id.trim()) {
+        errors.push({ field: "id", message: "Theme id is required" });
+    }
+    else if (!THEME_ID_PATTERN.test(theme.id)) {
+        errors.push({
+            field: "id",
+            message: "Theme id must be kebab-case (lowercase letters, numbers, hyphens)",
+        });
+    }
+    if (typeof theme.name !== "string" || !theme.name.trim()) {
+        errors.push({ field: "name", message: "Theme name is required" });
+    }
+    for (const mode of ["light", "dark"]) {
+        if (theme[mode] != null && typeof theme[mode] !== "object") {
+            errors.push({
+                field: mode,
+                message: `${mode} must be an object`,
+            });
+        }
+    }
+    if (theme.fonts != null && typeof theme.fonts !== "object") {
+        errors.push({ field: "fonts", message: "fonts must be an object" });
+    }
+    return errors;
+}
+// ── Constants ──────────────────────────────────────────────────────
+/** Default theme ID applied when no theme is explicitly selected */
+export const DEFAULT_THEME_ID = "bsc-gold";
+/** Data attribute used to identify the injected font <link> */
+export const THEME_FONT_LINK_ID = "eliza-theme-font";

package/packages/shared/src/contracts/verification.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared verification API contracts.
+ */
+export interface VerificationResult {
+    verified: boolean;
+    error: string | null;
+    handle: string | null;
+}
+//# sourceMappingURL=verification.d.ts.map

package/packages/shared/src/contracts/verification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification.d.ts","sourceRoot":"","sources":["../../../../../../shared/src/contracts/verification.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB"}

package/packages/shared/src/contracts/verification.js

@@ -0,0 +1,4 @@
+/**
+ * Shared verification API contracts.
+ */
+export {};