@elizaos/app-core 2.0.0-alpha.74 → 2.0.0-alpha.76

package/src/actions/character.test.ts

@@ -1,139 +0,0 @@
-import { describe, expect, it } from "vitest";
-
-import type { CharacterData } from "../api/client";
-import { prepareDraftForSave } from "./character";
-
-describe("prepareDraftForSave", () => {
-  it("builds a strict payload and preserves message actions", () => {
-    const draft = {
-      name: "Sakuya",
-      username: "sakuya-clockwork",
-      system: "Act composed.",
-      bio: " first line \n\n second line ",
-      adjectives: ["precise", "", "calm"],
-      topics: ["time", "", "duty"],
-      postExamples: ["Mission report", ""],
-      style: {
-        all: ["Be exact"],
-        chat: [],
-        post: ["Stay brief"],
-      },
-      messageExamples: [
-        {
-          examples: [
-            {
-              name: "{{user1}}",
-              content: {
-                text: "status?",
-                legacy: "remove",
-              },
-            },
-            {
-              name: "Sakuya",
-              content: {
-                text: "On track.",
-                actions: ["REPORT_STATUS"],
-                debug: true,
-              },
-            },
-            {
-              name: "",
-              content: { text: "skip me" },
-            },
-            {
-              name: "Sakuya",
-              content: { text: "   " },
-            },
-          ],
-        },
-        { examples: [] },
-      ],
-      extraField: "drop me",
-    } as unknown as CharacterData;
-
-    expect(prepareDraftForSave(draft)).toEqual({
-      name: "Sakuya",
-      username: "sakuya-clockwork",
-      system: "Act composed.",
-      bio: ["first line", "second line"],
-      adjectives: ["precise", "calm"],
-      topics: ["time", "duty"],
-      postExamples: ["Mission report"],
-      style: {
-        all: ["Be exact"],
-        post: ["Stay brief"],
-      },
-      messageExamples: [
-        {
-          examples: [
-            {
-              name: "{{user1}}",
-              content: { text: "status?" },
-            },
-            {
-              name: "Sakuya",
-              content: {
-                text: "On track.",
-                actions: ["REPORT_STATUS"],
-              },
-            },
-          ],
-        },
-      ],
-    });
-  });
-
-  it("omits empty collections and invalid message examples", () => {
-    const draft = {
-      bio: " \n ",
-      adjectives: ["", " "],
-      postExamples: [" "],
-      style: {
-        all: [],
-        chat: [],
-        post: [],
-      },
-      messageExamples: [
-        {
-          examples: [
-            { name: "", content: { text: "missing speaker" } },
-            { name: "User", content: { text: "   " } },
-          ],
-        },
-      ],
-    } as CharacterData;
-
-    expect(prepareDraftForSave(draft)).toEqual({});
-  });
-
-  it("preserves array bios and populated style groups", () => {
-    const draft: CharacterData = {
-      name: "Reimu",
-      bio: ["Line one", "Line two"],
-      style: {
-        chat: ["Stay direct"],
-      },
-    };
-
-    expect(prepareDraftForSave(draft)).toEqual({
-      name: "Reimu",
-      username: "Reimu",
-      bio: ["Line one", "Line two"],
-      style: {
-        chat: ["Stay direct"],
-      },
-    });
-  });
-
-  it("falls back username to name when no username is provided", () => {
-    const draft: CharacterData = {
-      name: "Marisa",
-      username: "   ",
-    };
-
-    expect(prepareDraftForSave(draft)).toEqual({
-      name: "Marisa",
-      username: "Marisa",
-    });
-  });
-});

package/src/actions/character.ts

@@ -1,334 +0,0 @@
-/**
- * Character action helpers — extracted from AppContext.
- *
- * Pure functions for character CRUD and draft management.
- */
-
-import type { CharacterData, ElizaClient } from "../api/client";
-
-type MessageExampleGroup = {
-  examples: Array<{ name: string; content: { text: string } }>;
-};
-
-export interface CharacterActionContext {
-  client: ElizaClient;
-  setCharacterData: (data: CharacterData | null) => void;
-  setCharacterDraft: (
-    fn: CharacterData | ((prev: CharacterData) => CharacterData),
-  ) => void;
-  setCharacterLoading: (loading: boolean) => void;
-  setCharacterSaving: (saving: boolean) => void;
-  setCharacterSaveError: (error: string | null) => void;
-  setCharacterSaveSuccess: (message: string | null) => void;
-}
-
-export async function loadCharacter(
-  ctx: CharacterActionContext,
-): Promise<void> {
-  ctx.setCharacterLoading(true);
-  ctx.setCharacterSaveError(null);
-  ctx.setCharacterSaveSuccess(null);
-  try {
-    const { character } = await ctx.client.getCharacter();
-    ctx.setCharacterData(character);
-    ctx.setCharacterDraft({
-      name: character.name ?? "",
-      username: character.username ?? "",
-      bio: Array.isArray(character.bio)
-        ? character.bio.join("\n")
-        : (character.bio ?? ""),
-      system: character.system ?? "",
-      adjectives: character.adjectives ?? [],
-      topics: character.topics ?? [],
-      style: {
-        all: character.style?.all ?? [],
-        chat: character.style?.chat ?? [],
-        post: character.style?.post ?? [],
-      },
-      messageExamples: character.messageExamples ?? [],
-      postExamples: character.postExamples ?? [],
-    });
-  } catch {
-    ctx.setCharacterData(null);
-    ctx.setCharacterDraft({});
-  }
-  ctx.setCharacterLoading(false);
-}
-
-function extractLikelyJson(input: string): string {
-  const trimmed = input.trim();
-  if (!trimmed) return trimmed;
-
-  const withoutFences = trimmed
-    .replace(/^```(?:json)?\s*/i, "")
-    .replace(/\s*```$/i, "")
-    .trim();
-  if (withoutFences.startsWith("{") || withoutFences.startsWith("[")) {
-    return withoutFences;
-  }
-
-  const firstBracket = withoutFences.indexOf("[");
-  const firstBrace = withoutFences.indexOf("{");
-  const starts = [firstBracket, firstBrace].filter((index) => index >= 0);
-  if (starts.length === 0) return withoutFences;
-
-  const start = Math.min(...starts);
-  const opener = withoutFences[start];
-  const closer = opener === "[" ? "]" : "}";
-  const end = withoutFences.lastIndexOf(closer);
-  if (end <= start) return withoutFences;
-
-  return withoutFences.slice(start, end + 1);
-}
-
-function normalizeSpeakerName(
-  rawName: unknown,
-  fallbackAgentName: string,
-  options: { fallbackMissingSpeaker?: boolean } = {},
-): string {
-  const fallbackMissingSpeaker = options.fallbackMissingSpeaker ?? true;
-  if (typeof rawName === "string" && rawName.trim()) {
-    const trimmed = rawName.trim();
-    const normalized = trimmed.toLowerCase();
-    if (
-      normalized === "assistant" ||
-      normalized === "agent" ||
-      normalized === "ai" ||
-      normalized === "model" ||
-      normalized === "{{agentname}}"
-    ) {
-      return fallbackAgentName;
-    }
-    if (
-      normalized === "user" ||
-      normalized === "human" ||
-      normalized === "{{user}}" ||
-      normalized === "customer"
-    ) {
-      return "{{user1}}";
-    }
-    return trimmed;
-  }
-  return fallbackMissingSpeaker ? fallbackAgentName : "";
-}
-
-function normalizeMessageText(raw: unknown): string {
-  if (typeof raw === "string") return raw.trim();
-  return "";
-}
-
-function normalizeConversation(
-  conversation: unknown,
-  fallbackAgentName: string,
-  options: { fallbackMissingSpeaker?: boolean } = {},
-): MessageExampleGroup | null {
-  const rawExamples = Array.isArray(conversation)
-    ? conversation
-    : conversation &&
-        typeof conversation === "object" &&
-        Array.isArray(
-          (conversation as { examples?: unknown[] }).examples,
-        )
-      ? (conversation as { examples: unknown[] }).examples
-      : null;
-
-  if (!rawExamples) return null;
-
-  const examples = rawExamples
-    .map((message) => {
-      const record =
-        message && typeof message === "object"
-          ? (message as Record<string, unknown>)
-          : null;
-      if (!record) return null;
-
-      const content =
-        record.content && typeof record.content === "object"
-          ? (record.content as Record<string, unknown>)
-          : null;
-      const text = normalizeMessageText(
-        content?.text ?? record.text ?? record.message ?? record.content,
-      );
-      if (!text) return null;
-
-      return {
-        name: normalizeSpeakerName(
-          record.name ?? record.user ?? record.speaker ?? record.role,
-          fallbackAgentName,
-          options,
-        ),
-        content: { text },
-      };
-    })
-    .filter(
-      (
-        message,
-      ): message is { name: string; content: { text: string } } =>
-        Boolean(message?.name && message.content.text),
-    );
-
-  if (examples.length === 0) return null;
-  return { examples };
-}
-
-export function normalizeGeneratedMessageExamples(
-  input: unknown,
-  fallbackAgentName = "Agent",
-  options: { fallbackMissingSpeaker?: boolean } = {},
-): MessageExampleGroup[] {
-  let parsed = input;
-
-  if (typeof input === "string") {
-    const candidate = extractLikelyJson(input);
-    try {
-      parsed = JSON.parse(candidate);
-    } catch {
-      return [];
-    }
-  }
-
-  const source =
-    parsed &&
-    typeof parsed === "object" &&
-    Array.isArray(
-      (parsed as { messageExamples?: unknown[] }).messageExamples,
-    )
-      ? (parsed as { messageExamples: unknown[] }).messageExamples
-      : parsed;
-
-  if (!Array.isArray(source)) return [];
-
-  const groups =
-    source.length > 0 &&
-    source.every(
-      (entry) =>
-        entry && typeof entry === "object" && Array.isArray((entry as { examples?: unknown[] }).examples),
-    )
-      ? source
-      : source.every((entry) => Array.isArray(entry))
-        ? source
-        : [source];
-
-  return groups
-    .map((group) => normalizeConversation(group, fallbackAgentName, options))
-    .filter((group): group is MessageExampleGroup => Boolean(group));
-}
-
-export function prepareDraftForSave(
-  draft: CharacterData,
-): Record<string, unknown> {
-  // Only pick fields the API schema accepts (.strict() rejects unknown keys)
-  const result: Record<string, unknown> = {};
-
-  if (draft.name?.trim()) {
-    result.name = draft.name.trim();
-  }
-
-  if (draft.username?.trim()) {
-    result.username = draft.username.trim();
-  } else if (typeof result.name === "string") {
-    result.username = result.name;
-  }
-  if (draft.system) result.system = draft.system;
-
-  if (typeof draft.bio === "string") {
-    const lines = draft.bio
-      .split("\n")
-      .map((l: string) => l.trim())
-      .filter((l: string) => l.length > 0);
-    if (lines.length > 0) result.bio = lines;
-  } else if (Array.isArray(draft.bio) && draft.bio.length > 0) {
-    result.bio = draft.bio;
-  }
-
-  const adjectives = (draft.adjectives ?? []).filter(
-    (s) => s.trim().length > 0,
-  );
-  if (adjectives.length > 0) result.adjectives = adjectives;
-
-  const topics = (draft.topics ?? []).filter((s) => s.trim().length > 0);
-  if (topics.length > 0) result.topics = topics;
-
-  const postExamples = (draft.postExamples ?? []).filter(
-    (s) => s.trim().length > 0,
-  );
-  if (postExamples.length > 0) result.postExamples = postExamples;
-
-  if (draft.messageExamples != null) {
-    // Strip extra fields from content (schema is .strict() — only text + actions allowed)
-    const cleaned = normalizeGeneratedMessageExamples(
-      draft.messageExamples,
-      draft.name?.trim() || "Agent",
-      { fallbackMissingSpeaker: false },
-    ).map((group, groupIndex) => ({
-      examples: group.examples
-        .map((msg) => {
-          const originalGroup =
-            Array.isArray(draft.messageExamples) &&
-            draft.messageExamples[groupIndex] &&
-            typeof draft.messageExamples[groupIndex] === "object"
-              ? (draft.messageExamples[groupIndex] as {
-                  examples?: Array<{
-                    name?: string;
-                    content?: { text?: string; actions?: string[] };
-                  }>;
-                })
-              : null;
-          const originalMessage = originalGroup?.examples?.find(
-            (candidate) =>
-              candidate?.name?.trim() === msg.name &&
-              candidate?.content?.text?.trim() === msg.content.text,
-          );
-          return {
-            name: msg.name.trim(),
-            content: {
-              text: msg.content.text.trim(),
-              ...(originalMessage?.content?.actions
-                ? { actions: originalMessage.content.actions }
-                : {}),
-            },
-          };
-        })
-        .filter((msg) => msg.name && msg.content.text),
-    }));
-    if (cleaned.length > 0) result.messageExamples = cleaned;
-  }
-
-  if (draft.style) {
-    const style: Record<string, string[]> = {};
-    if (draft.style.all?.length) style.all = draft.style.all;
-    if (draft.style.chat?.length) style.chat = draft.style.chat;
-    if (draft.style.post?.length) style.post = draft.style.post;
-    if (Object.keys(style).length > 0) result.style = style;
-  }
-
-  return result;
-}
-
-export function parseMessageExamplesInput(value: string): Array<{
-  examples: Array<{ name: string; content: { text: string } }>;
-}> {
-  if (!value.trim()) return [];
-  const blocks = value.split(/\n\s*\n/).filter((b) => b.trim().length > 0);
-  return blocks.map((block) => {
-    const lines = block.split("\n").filter((l) => l.trim().length > 0);
-    const examples = lines.map((line) => {
-      const colonIdx = line.indexOf(":");
-      if (colonIdx > 0) {
-        return {
-          name: line.slice(0, colonIdx).trim(),
-          content: { text: line.slice(colonIdx + 1).trim() },
-        };
-      }
-      return { name: "User", content: { text: line.trim() } };
-    });
-    return { examples };
-  });
-}
-
-export function parseArrayInput(value: string): string[] {
-  return value
-    .split("\n")
-    .map((s) => s.trim())
-    .filter((s) => s.length > 0);
-}

package/src/actions/chat-helpers.ts

@@ -1,100 +0,0 @@
-/**
- * Chat helpers — streaming delta computation, formatting, and common patterns.
- *
- * Extracted from AppContext to be reusable across providers.
- */
-
-import {
-  computeStreamingDelta as computeStreamingDeltaInternal,
-  mergeStreamingText,
-} from "../utils/streaming-text";
-
-export { mergeStreamingText };
-
-/**
- * Compute the streaming delta between the accumulated text and the new token.
- * The SSE endpoint may emit the full text so far or just the delta — this
- * function handles both by returning only the new characters.
- */
-export function computeStreamingDelta(
-  accumulated: string,
-  token: string,
-): string {
-  return computeStreamingDeltaInternal(accumulated, token);
-}
-
-/**
- * Determine whether the final stream response text should replace the
- * accumulated text in the UI. This handles cases where the final text
- * differs from what was streamed (e.g., post-processing on the server).
- */
-export function shouldApplyFinalStreamText(
-  streamed: string,
-  final: string,
-): boolean {
-  if (!final) return false;
-  return final !== streamed;
-}
-
-/**
- * Format a search result section with a label and bullet items.
- */
-export function formatSearchBullet(label: string, items: string[]): string {
-  if (items.length === 0) return `**${label}**: (none)`;
-  return `**${label}**:\n${items.map((item) => `• ${item}`).join("\n")}`;
-}
-
-/**
- * Parse slash command input into a command name and raw arguments.
- */
-export function parseSlashCommandInput(
-  rawText: string,
-): { name: string; argsRaw: string } | null {
-  if (!rawText.startsWith("/")) return null;
-  const rest = rawText.slice(1);
-  const spaceIdx = rest.indexOf(" ");
-  if (spaceIdx < 0) {
-    return { name: rest.toLowerCase(), argsRaw: "" };
-  }
-  return {
-    name: rest.slice(0, spaceIdx).toLowerCase(),
-    argsRaw: rest.slice(spaceIdx + 1),
-  };
-}
-
-/**
- * Normalize a custom action name for slash command matching.
- */
-export function normalizeCustomActionName(name: string): string {
-  return name.trim().toLowerCase().replace(/\s+/g, "-");
-}
-
-/**
- * Parse custom action params from a slash command args string.
- */
-export function parseCustomActionParams(
-  action: { params?: Array<{ name: string; required?: boolean }> },
-  argsRaw: string,
-): { params: Record<string, string>; missingRequired: string[] } {
-  const params: Record<string, string> = {};
-  const missingRequired: string[] = [];
-
-  if (!action.params || action.params.length === 0) {
-    if (argsRaw.trim()) {
-      params.input = argsRaw.trim();
-    }
-    return { params, missingRequired };
-  }
-
-  const tokens = argsRaw.trim().split(/\s+/);
-  for (let i = 0; i < action.params.length; i++) {
-    const param = action.params[i];
-    if (i < tokens.length && tokens[i]) {
-      params[param.name] = tokens[i];
-    } else if (param.required) {
-      missingRequired.push(param.name);
-    }
-  }
-
-  return { params, missingRequired };
-}

package/src/actions/cloud.ts

@@ -1,59 +0,0 @@
-/**
- * Cloud action helpers — extracted from AppContext.
- *
- * Pure functions for Eliza Cloud status polling and credit management.
- */
-
-import type { ElizaClient } from "../api/client";
-
-export interface CloudStatusResult {
-  enabled: boolean;
-  connected: boolean;
-  userId: string | null;
-  topUpUrl: string | null;
-  credits: number | null;
-  creditsLow: boolean;
-  creditsCritical: boolean;
-}
-
-export async function pollCloudStatus(
-  client: ElizaClient,
-): Promise<CloudStatusResult> {
-  const cloudStatus = await client.getCloudStatus().catch(() => null);
-  if (!cloudStatus) {
-    return {
-      enabled: false,
-      connected: false,
-      userId: null,
-      topUpUrl: null,
-      credits: null,
-      creditsLow: false,
-      creditsCritical: false,
-    };
-  }
-
-  const isConnected = Boolean(cloudStatus.connected || cloudStatus.hasApiKey);
-  const result: CloudStatusResult = {
-    enabled: Boolean(cloudStatus.enabled ?? false),
-    connected: isConnected,
-    userId: cloudStatus.userId ?? null,
-    topUpUrl: cloudStatus.topUpUrl ?? null,
-    credits: null,
-    creditsLow: false,
-    creditsCritical: false,
-  };
-
-  if (isConnected) {
-    const credits = await client.getCloudCredits().catch(() => null);
-    if (credits && typeof credits.balance === "number") {
-      result.credits = credits.balance;
-      result.creditsLow = credits.low ?? false;
-      result.creditsCritical = credits.critical ?? false;
-      if (credits.topUpUrl) result.topUpUrl = credits.topUpUrl;
-    } else if (credits?.topUpUrl) {
-      result.topUpUrl = credits.topUpUrl;
-    }
-  }
-
-  return result;
-}

package/src/actions/index.ts

@@ -1,12 +0,0 @@
-/**
- * Domain action modules — barrel export.
- *
- * Re-exports all action helpers for use by providers and components.
- */
-
-export * from "./character";
-export * from "./chat-helpers";
-export * from "./cloud";
-export * from "./lifecycle";
-export * from "./onboarding";
-export * from "./triggers";