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

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";

package/src/actions/lifecycle.ts

@@ -1,175 +0,0 @@
-/**
- * Lifecycle action helpers — extracted from AppContext.
- *
- * Provides pure-logic functions for agent lifecycle operations
- * (start, stop, restart, reset) that can be
- * called from any provider implementation.
- */
-
-import type { ElizaClient } from "../api/client";
-
-export type LifecycleAction = "start" | "stop" | "restart" | "reset";
-
-export interface LifecycleMessages {
-  progress: string;
-  success: string;
-  verb: string;
-  inProgress: string;
-}
-
-export const LIFECYCLE_MESSAGES: Record<LifecycleAction, LifecycleMessages> = {
-  start: {
-    progress: "Starting agent...",
-    success: "Agent started.",
-    verb: "start",
-    inProgress: "starting",
-  },
-  stop: {
-    progress: "Stopping agent...",
-    success: "Agent stopped.",
-    verb: "stop",
-    inProgress: "stopping",
-  },
-
-  restart: {
-    progress: "Restarting agent...",
-    success: "Agent restarted.",
-    verb: "restart",
-    inProgress: "restarting",
-  },
-  reset: {
-    progress: "Resetting agent...",
-    success: "Agent reset successfully.",
-    verb: "reset",
-    inProgress: "resetting",
-  },
-};
-
-export interface LifecycleActionContext {
-  client: ElizaClient;
-  isBusy: () => boolean;
-  setBusy: (busy: boolean) => void;
-  setNotice: (message: string, type: string, duration?: number) => void;
-}
-
-export async function executeLifecycleAction(
-  action: LifecycleAction,
-  ctx: LifecycleActionContext,
-): Promise<ReturnType<ElizaClient["getStatus"]> | null> {
-  if (ctx.isBusy()) {
-    ctx.setNotice(
-      `Agent action already in progress. Please wait.`,
-      "info",
-      2800,
-    );
-    return null;
-  }
-  ctx.setBusy(true);
-  ctx.setNotice(LIFECYCLE_MESSAGES[action].progress, "info", 3000);
-
-  try {
-    let result: Awaited<ReturnType<ElizaClient["getStatus"]>>;
-    switch (action) {
-      case "start":
-        result = await ctx.client.startAgent();
-        break;
-      case "stop":
-        result = await ctx.client.stopAgent();
-        break;
-
-      case "restart":
-        result = await ctx.client.restartAgent();
-        break;
-      default:
-        throw new Error(`Unknown lifecycle action: ${action}`);
-    }
-    ctx.setNotice(LIFECYCLE_MESSAGES[action].success, "success", 2400);
-    return result;
-  } catch (err) {
-    ctx.setNotice(
-      `Failed to ${LIFECYCLE_MESSAGES[action].verb} agent: ${
-        err instanceof Error ? err.message : "unknown error"
-      }`,
-      "error",
-      4200,
-    );
-    return null;
-  } finally {
-    ctx.setBusy(false);
-  }
-}
-
-// ── Startup helpers ─────────────────────────────────────────────────
-
-export const AGENT_READY_TIMEOUT_MS = 120_000;
-const DEFAULT_BACKEND_STARTUP_TIMEOUT_MS = 60_000;
-
-export function getBackendStartupTimeoutMs(): number {
-  try {
-    const envVal = (globalThis as Record<string, unknown>)
-      .ELIZA_STARTUP_TIMEOUT;
-    if (typeof envVal === "number" && envVal > 0) return envVal;
-  } catch {
-    /* ignore */
-  }
-  return DEFAULT_BACKEND_STARTUP_TIMEOUT_MS;
-}
-
-export interface StartupErrorState {
-  reason:
-    | "backend-unreachable"
-    | "backend-timeout"
-    | "agent-timeout"
-    | "agent-error";
-  phase: "starting-backend" | "initializing-agent";
-  message: string;
-  detail?: string;
-  status?: number;
-  path?: string;
-}
-
-export function formatStartupErrorDetail(err: unknown): string {
-  if (!err) return "";
-  if (err instanceof Error) return err.message;
-  if (typeof err === "string") return err;
-  try {
-    return JSON.stringify(err);
-  } catch {
-    return String(err);
-  }
-}
-
-export interface ApiLikeError {
-  kind: "http" | "timeout" | "network";
-  status?: number;
-  path?: string;
-  message?: string;
-}
-
-export function asApiLikeError(err: unknown): ApiLikeError | null {
-  if (!err || typeof err !== "object") return null;
-  const candidate = err as Record<string, unknown>;
-  if (typeof candidate.status === "number") {
-    return {
-      kind: "http",
-      status: candidate.status,
-      path: typeof candidate.path === "string" ? candidate.path : undefined,
-      message:
-        typeof candidate.message === "string" ? candidate.message : undefined,
-    };
-  }
-  if (
-    candidate.name === "AbortError" ||
-    (typeof candidate.message === "string" &&
-      candidate.message.includes("timeout"))
-  ) {
-    return {
-      kind: "timeout",
-      message:
-        typeof candidate.message === "string" ? candidate.message : undefined,
-    };
-  }
-  return null;
-}
-
-export const AGENT_TRANSFER_MIN_PASSWORD_LENGTH = 8;