@elizaos/app-core 2.0.0-alpha.73 → 2.0.0-alpha.75

package/src/state/parsers.ts

@@ -1,309 +0,0 @@
-import type {
-  AgentStartupDiagnostics,
-  AgentStatus,
-  ConversationMessage,
-  CustomActionDef,
-  StreamEventEnvelope,
-} from "../api/client";
-import {
-  computeStreamingDelta as computeStreamingDeltaInternal,
-  mergeStreamingText,
-} from "../utils/streaming-text";
-import {
-  AGENT_STATES,
-  type ApiLikeError,
-  type SlashCommandInput,
-} from "./types";
-
-export function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null;
-}
-
-export function parseAgentStatusEvent(
-  data: Record<string, unknown>,
-): AgentStatus | null {
-  const state = data.state;
-  const agentName = data.agentName;
-  if (
-    typeof state !== "string" ||
-    !AGENT_STATES.has(state as AgentStatus["state"])
-  ) {
-    return null;
-  }
-  if (typeof agentName !== "string") return null;
-  const model = typeof data.model === "string" ? data.model : undefined;
-  const startedAt =
-    typeof data.startedAt === "number" ? data.startedAt : undefined;
-  const uptime = typeof data.uptime === "number" ? data.uptime : undefined;
-  const startup = parseAgentStartupDiagnostics(data.startup);
-  return {
-    state: state as AgentStatus["state"],
-    agentName,
-    model,
-    startedAt,
-    uptime,
-    startup,
-  };
-}
-
-export function parseAgentStartupDiagnostics(
-  value: unknown,
-): AgentStartupDiagnostics | undefined {
-  if (!isRecord(value)) return undefined;
-  const phase = value.phase;
-  const attempt = value.attempt;
-  if (typeof phase !== "string" || typeof attempt !== "number") {
-    return undefined;
-  }
-  const startup: AgentStartupDiagnostics = { phase, attempt };
-  if (typeof value.lastError === "string") startup.lastError = value.lastError;
-  if (typeof value.lastErrorAt === "number")
-    startup.lastErrorAt = value.lastErrorAt;
-  if (typeof value.nextRetryAt === "number")
-    startup.nextRetryAt = value.nextRetryAt;
-  return startup;
-}
-
-export function parseStreamEventEnvelopeEvent(
-  data: Record<string, unknown>,
-): StreamEventEnvelope | null {
-  const type = data.type;
-  const eventId = data.eventId;
-  const ts = data.ts;
-  const payload = data.payload;
-  if (
-    (type !== "agent_event" &&
-      type !== "heartbeat_event" &&
-      type !== "training_event") ||
-    typeof eventId !== "string" ||
-    typeof ts !== "number" ||
-    !isRecord(payload)
-  ) {
-    return null;
-  }
-
-  const envelope: StreamEventEnvelope = {
-    type,
-    version: 1,
-    eventId,
-    ts,
-    payload,
-  };
-  if (typeof data.runId === "string") envelope.runId = data.runId;
-  if (typeof data.seq === "number") envelope.seq = data.seq;
-  if (typeof data.stream === "string") envelope.stream = data.stream;
-  if (typeof data.sessionKey === "string")
-    envelope.sessionKey = data.sessionKey;
-  if (typeof data.agentId === "string") envelope.agentId = data.agentId;
-  if (typeof data.roomId === "string") envelope.roomId = data.roomId;
-  return envelope;
-}
-
-export function parseConversationMessageEvent(
-  value: unknown,
-): ConversationMessage | null {
-  if (!isRecord(value)) return null;
-  const id = value.id;
-  const role = value.role;
-  const text = value.text;
-  const timestamp = value.timestamp;
-  const source = value.source;
-  const from = value.from;
-  if (
-    typeof id !== "string" ||
-    (role !== "user" && role !== "assistant") ||
-    typeof text !== "string" ||
-    typeof timestamp !== "number"
-  ) {
-    return null;
-  }
-  const parsed: ConversationMessage = { id, role, text, timestamp };
-  if (typeof source === "string" && source.length > 0) {
-    parsed.source = source;
-  }
-  if (typeof from === "string" && from.length > 0) {
-    parsed.from = from;
-  }
-  return parsed;
-}
-
-export function parseProactiveMessageEvent(
-  data: Record<string, unknown>,
-): { conversationId: string; message: ConversationMessage } | null {
-  const conversationId = data.conversationId;
-  if (typeof conversationId !== "string") return null;
-  const message = parseConversationMessageEvent(data.message);
-  if (!message) return null;
-  return { conversationId, message };
-}
-
-export { mergeStreamingText };
-
-export function computeStreamingDelta(
-  existing: string,
-  incoming: string,
-): string {
-  return computeStreamingDeltaInternal(existing, incoming);
-}
-
-export function normalizeStreamComparisonText(text: string): string {
-  return text.replace(/\s+/g, " ").trim();
-}
-
-export function shouldApplyFinalStreamText(
-  streamed: string,
-  finalText: string,
-): boolean {
-  if (!finalText.trim()) return false;
-  if (!streamed) return true;
-  if (streamed === finalText) return false;
-  return (
-    normalizeStreamComparisonText(streamed) !==
-    normalizeStreamComparisonText(finalText)
-  );
-}
-
-// Function previously local to chat-commands but used here
-function normalizeSlashCommandName(name: string): string {
-  if (!name.startsWith("/")) name = `/${name}`;
-  return name.trim().toLowerCase();
-}
-
-// A simple utility to split command arguments, equivalent to chat-commands splitCommandArgs
-function splitCommandArgs(text: string): string[] {
-  const parts: string[] = [];
-  const regex = /[^\s"']+|"([^"]*)"|'([^']*)'/g;
-  let match: RegExpExecArray | null = regex.exec(text);
-  while (match !== null) {
-    parts.push(match[1] || match[2] || match[0]);
-    match = regex.exec(text);
-  }
-  return parts;
-}
-
-export function parseSlashCommandInput(text: string): SlashCommandInput | null {
-  if (!text.startsWith("/")) return null;
-  const body = text.slice(1).trim();
-  if (!body) return null;
-  const firstSpace = body.search(/\s/);
-  if (firstSpace === -1) {
-    return { name: normalizeSlashCommandName(body), argsRaw: "" };
-  }
-  return {
-    name: normalizeSlashCommandName(body.slice(0, firstSpace)),
-    argsRaw: body.slice(firstSpace + 1).trim(),
-  };
-}
-
-export function normalizeCustomActionName(value: string): string {
-  return value
-    .trim()
-    .replace(/[\s-]+/g, "_")
-    .toUpperCase();
-}
-
-export function parseCustomActionParams(
-  action: CustomActionDef,
-  argsRaw: string,
-): {
-  params: Record<string, string>;
-  missingRequired: string[];
-} {
-  const tokens = splitCommandArgs(argsRaw);
-  const named = new Map<string, string>();
-  const positional: string[] = [];
-
-  for (const token of tokens) {
-    const eq = token.indexOf("=");
-    if (eq > 0) {
-      const key = token.slice(0, eq).trim().toLowerCase();
-      const value = token.slice(eq + 1).trim();
-      if (key) {
-        named.set(key, value);
-        continue;
-      }
-    }
-    positional.push(token);
-  }
-
-  const params: Record<string, string> = {};
-  const defs = Array.isArray(action.parameters) ? action.parameters : [];
-  const defsByLower = new Map(
-    defs.map((def) => [def.name.trim().toLowerCase(), def.name]),
-  );
-
-  for (const [key, value] of named) {
-    const canonical = defsByLower.get(key);
-    if (canonical) {
-      params[canonical] = value;
-    } else {
-      params[key] = value;
-    }
-  }
-
-  for (const def of defs) {
-    if (params[def.name] == null && positional.length > 0) {
-      params[def.name] = positional.shift() as string;
-    }
-  }
-
-  if (positional.length > 0) {
-    const sink = defs.find((def) =>
-      ["input", "text", "query", "message", "prompt"].includes(
-        def.name.toLowerCase(),
-      ),
-    );
-    if (sink) {
-      const existing = params[sink.name];
-      params[sink.name] = existing
-        ? `${existing} ${positional.join(" ")}`
-        : positional.join(" ");
-    }
-  }
-
-  const missingRequired = defs
-    .filter((def) => def.required)
-    .map((def) => def.name)
-    .filter((name) => !(params[name] ?? "").trim());
-
-  return { params, missingRequired };
-}
-
-export function formatSearchBullet(label: string, items: string[]): string {
-  if (items.length === 0) return `${label}: none`;
-  return `${label}:\n${items.map((item) => `- ${item}`).join("\n")}`;
-}
-
-export function asApiLikeError(err: unknown): ApiLikeError | null {
-  if (!isRecord(err)) return null;
-  const kind = err.kind;
-  const status = err.status;
-  const path = err.path;
-  const message = err.message;
-  const hasApiShape =
-    typeof kind === "string" ||
-    typeof status === "number" ||
-    typeof path === "string";
-  if (!hasApiShape) return null;
-  return {
-    kind: typeof kind === "string" ? kind : undefined,
-    status: typeof status === "number" ? status : undefined,
-    path: typeof path === "string" ? path : undefined,
-    message: typeof message === "string" ? message : undefined,
-  };
-}
-
-export function formatStartupErrorDetail(err: unknown): string | undefined {
-  const apiErr = asApiLikeError(err);
-  if (apiErr) {
-    const parts: string[] = [];
-    if (apiErr.path) parts.push(apiErr.path);
-    if (typeof apiErr.status === "number") parts.push(`HTTP ${apiErr.status}`);
-    if (apiErr.message) parts.push(apiErr.message);
-    return parts.filter(Boolean).join(" - ");
-  }
-  if (err instanceof Error && err.message.trim()) {
-    return err.message.trim();
-  }
-  return undefined;
-}

package/src/state/persistence.ts

@@ -1,379 +0,0 @@
-import type { ConversationMode } from "../api/client";
-import {
-  DEFAULT_UI_LANGUAGE,
-  normalizeLanguage,
-  type UiLanguage,
-} from "../i18n";
-import type { Tab } from "../navigation";
-import type { OnboardingStep } from "./types";
-import type { UiShellMode, UiTheme } from "./ui-preferences";
-import { normalizeAvatarIndex } from "./vrm";
-
-/* ── Theme persistence ────────────────────────────────────────────────── */
-
-export type { UiTheme } from "./ui-preferences";
-
-const UI_THEME_STORAGE_KEY = "eliza:ui-theme";
-
-function normalizeUiTheme(value: unknown): UiTheme {
-  return value === "light" ? "light" : "dark";
-}
-
-export { normalizeUiTheme };
-
-export function loadUiTheme(): UiTheme {
-  try {
-    return normalizeUiTheme(localStorage.getItem(UI_THEME_STORAGE_KEY));
-  } catch {
-    return "dark";
-  }
-}
-
-export function saveUiTheme(theme: UiTheme): void {
-  try {
-    localStorage.setItem(UI_THEME_STORAGE_KEY, normalizeUiTheme(theme));
-  } catch {
-    // ignore
-  }
-}
-
-/**
- * Apply the theme to the document root.
- * Sets both `data-theme` attribute and `.dark` class so both CSS selectors
- * in base.css (`[data-theme="dark"]` and `.dark`) are satisfied.
- */
-export function applyUiTheme(theme: UiTheme): void {
-  if (typeof document === "undefined") return;
-  const root = document.documentElement;
-  if (!root) return;
-  if (typeof root.setAttribute === "function") {
-    root.setAttribute("data-theme", theme);
-  } else if ("dataset" in root && root.dataset) {
-    root.dataset.theme = theme;
-  } else {
-    return;
-  }
-  if (!root.classList) return;
-  if (theme === "dark") {
-    root.classList.add("dark");
-  } else {
-    root.classList.remove("dark");
-  }
-}
-
-const UI_LANGUAGE_STORAGE_KEY = "eliza:ui-language";
-const UI_SHELL_MODE_STORAGE_KEY = "eliza:ui-shell-mode";
-const LAST_NATIVE_TAB_STORAGE_KEY = "eliza:last-native-tab";
-const ONBOARDING_STEP_STORAGE_KEY = "eliza:onboarding:step";
-
-function normalizeOnboardingStep(value: unknown): OnboardingStep | null {
-  switch (value) {
-    case "identity":
-    case "connection":
-    case "rpc":
-    case "senses":
-    case "activate":
-      return value;
-    default:
-      return null;
-  }
-}
-
-export function loadPersistedOnboardingStep(): OnboardingStep | null {
-  try {
-    return normalizeOnboardingStep(
-      localStorage.getItem(ONBOARDING_STEP_STORAGE_KEY),
-    );
-  } catch {
-    return null;
-  }
-}
-
-export function saveOnboardingStep(step: OnboardingStep): void {
-  try {
-    localStorage.setItem(ONBOARDING_STEP_STORAGE_KEY, step);
-  } catch {
-    /* ignore */
-  }
-}
-
-export function clearPersistedOnboardingStep(): void {
-  try {
-    localStorage.removeItem(ONBOARDING_STEP_STORAGE_KEY);
-  } catch {
-    /* ignore */
-  }
-}
-
-export function loadUiLanguage(): UiLanguage {
-  try {
-    const stored = localStorage.getItem(UI_LANGUAGE_STORAGE_KEY);
-    return normalizeLanguage(stored ?? DEFAULT_UI_LANGUAGE);
-  } catch {
-    return DEFAULT_UI_LANGUAGE;
-  }
-}
-
-export function saveUiLanguage(language: UiLanguage): void {
-  try {
-    localStorage.setItem(UI_LANGUAGE_STORAGE_KEY, normalizeLanguage(language));
-  } catch {
-    // ignore
-  }
-}
-
-function normalizeUiShellMode(mode: unknown): UiShellMode {
-  return mode === "native" ? "native" : "companion";
-}
-
-export { normalizeUiShellMode };
-
-export function loadUiShellMode(): UiShellMode {
-  try {
-    return normalizeUiShellMode(
-      localStorage.getItem(UI_SHELL_MODE_STORAGE_KEY),
-    );
-  } catch {
-    return "companion";
-  }
-}
-
-export function saveUiShellMode(mode: UiShellMode): void {
-  try {
-    localStorage.setItem(UI_SHELL_MODE_STORAGE_KEY, normalizeUiShellMode(mode));
-  } catch {
-    // ignore
-  }
-}
-
-function normalizeLastNativeTab(tab: unknown): Tab {
-  switch (tab) {
-    case "chat":
-    case "stream":
-    case "apps":
-    case "wallets":
-    case "knowledge":
-    case "connectors":
-    case "triggers":
-    case "plugins":
-    case "skills":
-    case "actions":
-    case "advanced":
-    case "fine-tuning":
-    case "voice":
-    case "runtime":
-    case "database":
-    case "settings":
-    case "logs":
-    case "security":
-      return tab;
-    default:
-      return "chat";
-  }
-}
-
-export function loadLastNativeTab(): Tab {
-  try {
-    return normalizeLastNativeTab(
-      localStorage.getItem(LAST_NATIVE_TAB_STORAGE_KEY),
-    );
-  } catch {
-    return "chat";
-  }
-}
-
-export function saveLastNativeTab(tab: Tab): void {
-  try {
-    localStorage.setItem(
-      LAST_NATIVE_TAB_STORAGE_KEY,
-      normalizeLastNativeTab(tab),
-    );
-  } catch {
-    // ignore
-  }
-}
-
-/* ── Avatar persistence ───────────────────────────────────────────────── */
-const AVATAR_INDEX_KEY = "eliza_avatar_index";
-
-export function loadAvatarIndex(): number {
-  try {
-    const stored = localStorage.getItem(AVATAR_INDEX_KEY);
-    if (stored) {
-      const n = parseInt(stored, 10);
-      return normalizeAvatarIndex(n);
-    }
-  } catch {
-    /* ignore */
-  }
-  return 1;
-}
-
-export function saveAvatarIndex(index: number): void {
-  try {
-    localStorage.setItem(AVATAR_INDEX_KEY, String(normalizeAvatarIndex(index)));
-  } catch {
-    /* ignore */
-  }
-}
-
-/* ── Chat UI persistence ──────────────────────────────────────────────── */
-const CHAT_AVATAR_VISIBLE_KEY = "eliza:chat:avatarVisible";
-const CHAT_VOICE_MUTED_KEY = "eliza:chat:voiceMuted";
-
-export function loadChatAvatarVisible(): boolean {
-  try {
-    const stored = localStorage.getItem(CHAT_AVATAR_VISIBLE_KEY);
-    return stored === null ? true : stored === "true";
-  } catch {
-    return true;
-  }
-}
-
-export function loadChatVoiceMuted(): boolean {
-  try {
-    const stored = localStorage.getItem(CHAT_VOICE_MUTED_KEY);
-    return stored === null ? false : stored === "true";
-  } catch {
-    return false;
-  }
-}
-
-export function saveChatAvatarVisible(value: boolean): void {
-  try {
-    localStorage.setItem(CHAT_AVATAR_VISIBLE_KEY, String(value));
-  } catch {
-    /* ignore */
-  }
-}
-
-export function saveChatVoiceMuted(value: boolean): void {
-  try {
-    localStorage.setItem(CHAT_VOICE_MUTED_KEY, String(value));
-  } catch {
-    /* ignore */
-  }
-}
-
-/* ── Chat mode persistence ─────────────────────────────────────────────── */
-const CHAT_MODE_KEY = "eliza:chat:mode";
-const ACTIVE_CONVERSATION_ID_KEY = "eliza:chat:activeConversationId";
-const COMPANION_MESSAGE_CUTOFF_TS_KEY = "eliza:chat:companionMessageCutoffTs";
-
-export function loadChatMode(): ConversationMode {
-  try {
-    const stored = localStorage.getItem(CHAT_MODE_KEY);
-    return stored === "power" ? "power" : "simple";
-  } catch {
-    return "simple";
-  }
-}
-
-export function saveChatMode(value: ConversationMode): void {
-  try {
-    localStorage.setItem(CHAT_MODE_KEY, value);
-  } catch {
-    /* ignore */
-  }
-}
-
-export function loadActiveConversationId(): string | null {
-  try {
-    const stored = localStorage.getItem(ACTIVE_CONVERSATION_ID_KEY)?.trim();
-    return stored ? stored : null;
-  } catch {
-    return null;
-  }
-}
-
-export function saveActiveConversationId(value: string | null): void {
-  try {
-    if (value?.trim()) {
-      localStorage.setItem(ACTIVE_CONVERSATION_ID_KEY, value);
-      return;
-    }
-    localStorage.removeItem(ACTIVE_CONVERSATION_ID_KEY);
-  } catch {
-    /* ignore */
-  }
-}
-
-export function loadCompanionMessageCutoffTs(): number {
-  try {
-    const stored = localStorage.getItem(COMPANION_MESSAGE_CUTOFF_TS_KEY);
-    const parsed = stored ? Number.parseInt(stored, 10) : Number.NaN;
-    return Number.isFinite(parsed) && parsed > 0 ? parsed : Date.now();
-  } catch {
-    return Date.now();
-  }
-}
-
-export function saveCompanionMessageCutoffTs(value: number): void {
-  try {
-    localStorage.setItem(
-      COMPANION_MESSAGE_CUTOFF_TS_KEY,
-      String(Math.max(0, Math.trunc(value))),
-    );
-  } catch {
-    /* ignore */
-  }
-}
-
-/* ── Connection mode persistence ──────────────────────────────────────── */
-
-/**
- * Persisted connection state so the app knows how to connect on restart
- * without waiting for a backend that may not exist yet.
- */
-export interface PersistedConnectionMode {
-  /** "local" = embedded agent, "cloud" = eliza cloud sandbox, "remote" = custom URL */
-  runMode: "local" | "cloud" | "remote";
-  /** For cloud: the eliza cloud API base URL */
-  cloudApiBase?: string;
-  /** For cloud: the auth token */
-  cloudAuthToken?: string;
-  /** For remote: the remote API base URL */
-  remoteApiBase?: string;
-  /** For remote: the access token/connection key */
-  remoteAccessToken?: string;
-}
-
-const CONNECTION_MODE_STORAGE_KEY = "eliza:connection-mode";
-
-export function loadPersistedConnectionMode(): PersistedConnectionMode | null {
-  try {
-    const stored = localStorage.getItem(CONNECTION_MODE_STORAGE_KEY);
-    if (!stored) return null;
-    const parsed = JSON.parse(stored);
-    if (
-      typeof parsed === "object" &&
-      parsed !== null &&
-      (parsed.runMode === "local" ||
-        parsed.runMode === "cloud" ||
-        parsed.runMode === "remote")
-    ) {
-      return parsed as PersistedConnectionMode;
-    }
-    return null;
-  } catch {
-    return null;
-  }
-}
-
-export function savePersistedConnectionMode(
-  mode: PersistedConnectionMode,
-): void {
-  try {
-    localStorage.setItem(CONNECTION_MODE_STORAGE_KEY, JSON.stringify(mode));
-  } catch {
-    /* ignore */
-  }
-}
-
-export function clearPersistedConnectionMode(): void {
-  try {
-    localStorage.removeItem(CONNECTION_MODE_STORAGE_KEY);
-  } catch {
-    /* ignore */
-  }
-}