@elizaos/core 1.5.4 → 1.5.5

package/src/types/lp.ts

@@ -1,124 +0,0 @@
-import type { Metadata } from './primitives';
-import { Service } from './service';
-import type { TokenBalance } from './token';
-
-/**
- * A standardized representation of a liquidity pool from any DEX.
- */
-export type PoolInfo = {
-  id: string; // Unique identifier for the pool (e.g., LP token mint or a DEX-specific ID).
-  displayName?: string; // User-friendly name for the pool.
-  dex: string; // Identifier for the DEX (e.g., "orca", "raydium").
-  tokenA: {
-    mint: string;
-    symbol?: string;
-    reserve?: string;
-    decimals?: number;
-  };
-  tokenB: {
-    mint: string;
-    symbol?: string;
-    reserve?: string;
-    decimals?: number;
-  };
-  lpTokenMint?: string;
-  apr?: number; // Annual Percentage Rate.
-  apy?: number; // Annual Percentage Yield.
-  tvl?: number; // Total Value Locked in USD.
-  fee?: number; // Trading fee percentage.
-  metadata?: Metadata; // For DEX-specific extra data.
-};
-
-/**
- * A standardized representation of a user's position in a liquidity pool.
- */
-export type LpPositionDetails = {
-  poolId: string;
-  dex: string;
-  lpTokenBalance: TokenBalance;
-  underlyingTokens: TokenBalance[]; // Array of two token balances.
-  valueUsd?: number;
-  accruedFees?: TokenBalance[];
-  rewards?: TokenBalance[];
-  metadata?: Metadata; // For additional DEX-specific position data.
-};
-
-/**
- * A standardized result for blockchain transactions.
- */
-export type TransactionResult = {
-  success: boolean;
-  transactionId?: string;
-  error?: string;
-  data?: any;
-};
-
-/**
- * Abstract interface for a Liquidity Pool Service.
- * DEX-specific plugins (e.g., for Orca, Raydium) must implement this service
- * to allow the LP Manager to interact with them in a standardized way.
- */
-export abstract class ILpService extends Service {
-  static override readonly serviceType = 'lp';
-
-  public readonly capabilityDescription = 'Provides standardized access to DEX liquidity pools.';
-
-  /**
-   * Returns the name of the DEX this service interacts with.
-   * @returns The name of the DEX (e.g., "Orca", "Raydium").
-   */
-  abstract getDexName(): string;
-
-  /**
-   * Fetches a list of available liquidity pools from the DEX.
-   * @param tokenAMint - Optional: Filter pools by the mint address of the first token.
-   * @param tokenBMint - Optional: Filter pools by the mint address of the second token.
-   * @returns A promise that resolves to an array of standardized PoolInfo objects.
-   */
-  abstract getPools(tokenAMint?: string, tokenBMint?: string): Promise<PoolInfo[]>;
-
-  /**
-   * Adds liquidity to a specified pool.
-   * @param params - The parameters for adding liquidity.
-   * @returns A promise resolving to a transaction result, including the LP tokens received.
-   */
-  abstract addLiquidity(params: {
-    userVault: any;
-    poolId: string;
-    tokenAAmountLamports: string;
-    tokenBAmountLamports?: string;
-    slippageBps: number;
-    tickLowerIndex?: number; // For concentrated liquidity
-    tickUpperIndex?: number; // For concentrated liquidity
-  }): Promise<TransactionResult & { lpTokensReceived?: TokenBalance }>;
-
-  /**
-   * Removes liquidity from a specified pool.
-   * @param params - The parameters for removing liquidity.
-   * @returns A promise resolving to a transaction result, including the tokens received.
-   */
-  abstract removeLiquidity(params: {
-    userVault: any;
-    poolId: string;
-    lpTokenAmountLamports: string;
-    slippageBps: number;
-  }): Promise<TransactionResult & { tokensReceived?: TokenBalance[] }>;
-
-  /**
-   * Fetches the details of a specific LP position for a user.
-   * @param userAccountPublicKey - The user's wallet public key.
-   * @param poolOrPositionIdentifier - The identifier for the pool or a specific position (e.g., position NFT mint).
-   * @returns A promise resolving to the position details or null if not found.
-   */
-  abstract getLpPositionDetails(
-    userAccountPublicKey: string,
-    poolOrPositionIdentifier: string
-  ): Promise<LpPositionDetails | null>;
-
-  /**
-   * Fetches the latest market data (e.g., APY, TVL) for a list of pools.
-   * @param poolIds - An array of pool IDs to fetch data for.
-   * @returns A promise resolving to a map of pool IDs to their partial market data.
-   */
-  abstract getMarketDataForPools(poolIds: string[]): Promise<Record<string, Partial<PoolInfo>>>;
-}

package/src/types/memory.ts

@@ -1,228 +0,0 @@
-import type { Content, UUID } from './primitives';
-
-/**
- * Memory type enumeration for built-in memory types
- */
-export type MemoryTypeAlias = string;
-
-/**
- * Enumerates the built-in types of memories that can be stored and retrieved.
- * - `DOCUMENT`: Represents a whole document or a large piece of text.
- * - `FRAGMENT`: A chunk or segment of a `DOCUMENT`, often created for embedding and search.
- * - `MESSAGE`: A conversational message, typically from a user or the agent.
- * - `DESCRIPTION`: A descriptive piece of information, perhaps about an entity or concept.
- * - `CUSTOM`: For any other type of memory not covered by the built-in types.
- * This enum is used in `MemoryMetadata` to categorize memories and influences how they are processed or queried.
- */
-export enum MemoryType {
-  DOCUMENT = 'document',
-  FRAGMENT = 'fragment',
-  MESSAGE = 'message',
-  DESCRIPTION = 'description',
-  CUSTOM = 'custom',
-}
-/**
- * Defines the scope of a memory, indicating its visibility and accessibility.
- * - `shared`: The memory is accessible to multiple entities or across different contexts (e.g., a public fact).
- * - `private`: The memory is specific to a single entity or a private context (e.g., a user's personal preference).
- * - `room`: The memory is scoped to a specific room or channel.
- * This is used in `MemoryMetadata` to control how memories are stored and retrieved based on context.
- */
-export type MemoryScope = 'shared' | 'private' | 'room';
-
-/**
- * Base interface for all memory metadata types.
- * It includes common properties for all memories, such as:
- * - `type`: The kind of memory (e.g., `MemoryType.MESSAGE`, `MemoryType.DOCUMENT`).
- * - `source`: An optional string indicating the origin of the memory (e.g., 'discord', 'user_input').
- * - `sourceId`: An optional UUID linking to a source entity or object.
- * - `scope`: The visibility scope of the memory (`shared`, `private`, or `room`).
- * - `timestamp`: An optional numerical timestamp (e.g., milliseconds since epoch) of when the memory was created or relevant.
- * - `tags`: Optional array of strings for categorizing or filtering memories.
- * Specific metadata types like `DocumentMetadata` or `MessageMetadata` extend this base.
- */
-export interface BaseMetadata {
-  type: MemoryTypeAlias;
-  source?: string;
-  sourceId?: UUID;
-  scope?: MemoryScope;
-  timestamp?: number;
-  tags?: string[];
-}
-
-export interface DocumentMetadata extends BaseMetadata {
-  type: MemoryType.DOCUMENT;
-}
-
-export interface FragmentMetadata extends BaseMetadata {
-  type: MemoryType.FRAGMENT;
-  documentId: UUID;
-  position: number;
-}
-
-export interface MessageMetadata extends BaseMetadata {
-  type: MemoryType.MESSAGE;
-}
-
-export interface DescriptionMetadata extends BaseMetadata {
-  type: MemoryType.DESCRIPTION;
-}
-
-export interface CustomMetadata extends BaseMetadata {
-  [key: string]: unknown;
-}
-
-export type MemoryMetadata =
-  | DocumentMetadata
-  | FragmentMetadata
-  | MessageMetadata
-  | DescriptionMetadata
-  | CustomMetadata;
-
-/**
- * Represents a stored memory/message
- */
-export interface Memory {
-  /** Optional unique identifier */
-  id?: UUID;
-
-  /** Associated user ID */
-  entityId: UUID;
-
-  /** Associated agent ID */
-  agentId?: UUID;
-
-  /** Optional creation timestamp in milliseconds since epoch */
-  createdAt?: number;
-
-  /** Memory content */
-  content: Content;
-
-  /** Optional embedding vector for semantic search */
-  embedding?: number[];
-
-  /** Associated room ID */
-  roomId: UUID;
-
-  /** Associated world ID (optional) */
-  worldId?: UUID;
-
-  /** Whether memory is unique (used to prevent duplicates) */
-  unique?: boolean;
-
-  /** Embedding similarity score (set when retrieved via search) */
-  similarity?: number;
-
-  /** Metadata for the memory */
-  metadata?: MemoryMetadata;
-}
-
-/**
- * Specialized memory type for messages with enhanced type checking
- */
-export interface MessageMemory extends Memory {
-  metadata: MessageMetadata;
-  content: Content & {
-    text: string; // Message memories must have text content
-  };
-}
-
-/**
- * Factory function to create a new message memory with proper defaults
- */
-export function createMessageMemory(params: {
-  id?: UUID;
-  entityId: UUID;
-  agentId?: UUID;
-  roomId: UUID;
-  content: Content & { text: string };
-  embedding?: number[];
-}): MessageMemory {
-  return {
-    ...params,
-    createdAt: Date.now(),
-    metadata: {
-      type: MemoryType.MESSAGE,
-      timestamp: Date.now(),
-      scope: params.agentId ? 'private' : 'shared',
-    },
-  };
-}
-
-/**
- * Type guard to check if a memory metadata is a DocumentMetadata
- * @param metadata The metadata to check
- * @returns True if the metadata is a DocumentMetadata
- */
-export function isDocumentMetadata(metadata: MemoryMetadata): metadata is DocumentMetadata {
-  return metadata.type === MemoryType.DOCUMENT;
-}
-
-/**
- * Type guard to check if a memory metadata is a FragmentMetadata
- * @param metadata The metadata to check
- * @returns True if the metadata is a FragmentMetadata
- */
-export function isFragmentMetadata(metadata: MemoryMetadata): metadata is FragmentMetadata {
-  return metadata.type === MemoryType.FRAGMENT;
-}
-
-/**
- * Type guard to check if a memory metadata is a MessageMetadata
- * @param metadata The metadata to check
- * @returns True if the metadata is a MessageMetadata
- */
-export function isMessageMetadata(metadata: MemoryMetadata): metadata is MessageMetadata {
-  return metadata.type === MemoryType.MESSAGE;
-}
-
-/**
- * Type guard to check if a memory metadata is a DescriptionMetadata
- * @param metadata The metadata to check
- * @returns True if the metadata is a DescriptionMetadata
- */
-export function isDescriptionMetadata(metadata: MemoryMetadata): metadata is DescriptionMetadata {
-  return metadata.type === MemoryType.DESCRIPTION;
-}
-
-/**
- * Type guard to check if a memory metadata is a CustomMetadata
- * @param metadata The metadata to check
- * @returns True if the metadata is a CustomMetadata
- */
-export function isCustomMetadata(metadata: MemoryMetadata): metadata is CustomMetadata {
-  return (
-    metadata.type !== MemoryType.DOCUMENT &&
-    metadata.type !== MemoryType.FRAGMENT &&
-    metadata.type !== MemoryType.MESSAGE &&
-    metadata.type !== MemoryType.DESCRIPTION
-  );
-}
-
-/**
- * Memory type guard for document memories
- */
-export function isDocumentMemory(
-  memory: Memory
-): memory is Memory & { metadata: DocumentMetadata } {
-  return memory.metadata?.type === MemoryType.DOCUMENT;
-}
-
-/**
- * Memory type guard for fragment memories
- */
-export function isFragmentMemory(
-  memory: Memory
-): memory is Memory & { metadata: FragmentMetadata } {
-  return memory.metadata?.type === MemoryType.FRAGMENT;
-}
-
-/**
- * Safely access the text content of a memory
- * @param memory The memory to extract text from
- * @param defaultValue Optional default value if no text is found
- * @returns The text content or default value
- */
-export function getMemoryText(memory: Memory, defaultValue = ''): string {
-  return memory.content.text ?? defaultValue;
-}

package/src/types/message.ts

@@ -1,233 +0,0 @@
-import { Service, ServiceType } from './service';
-import type { UUID } from './primitives';
-
-export interface MessageParticipant {
-  id: UUID;
-  name: string;
-  username?: string;
-  avatar?: string;
-  status?: 'online' | 'offline' | 'away' | 'busy';
-}
-
-export interface MessageAttachment {
-  id: UUID;
-  filename: string;
-  url: string;
-  mimeType: string;
-  size: number;
-  width?: number;
-  height?: number;
-  duration?: number;
-  thumbnail?: string;
-}
-
-export interface MessageReaction {
-  emoji: string;
-  count: number;
-  users: UUID[];
-  hasReacted: boolean;
-}
-
-export interface MessageReference {
-  messageId: UUID;
-  channelId: UUID;
-  type: 'reply' | 'forward' | 'quote';
-}
-
-export interface MessageContent {
-  text?: string;
-  html?: string;
-  markdown?: string;
-  attachments?: MessageAttachment[];
-  reactions?: MessageReaction[];
-  reference?: MessageReference;
-  mentions?: UUID[];
-  embeds?: Array<{
-    title?: string;
-    description?: string;
-    url?: string;
-    image?: string;
-    fields?: Array<{
-      name: string;
-      value: string;
-      inline?: boolean;
-    }>;
-  }>;
-}
-
-export interface MessageInfo {
-  id: UUID;
-  channelId: UUID;
-  senderId: UUID;
-  content: MessageContent;
-  timestamp: Date;
-  edited?: Date;
-  deleted?: Date;
-  pinned?: boolean;
-  thread?: {
-    id: UUID;
-    messageCount: number;
-    participants: UUID[];
-    lastMessageAt: Date;
-  };
-}
-
-export interface MessageSendOptions {
-  replyTo?: UUID;
-  ephemeral?: boolean;
-  silent?: boolean;
-  scheduled?: Date;
-  thread?: UUID;
-  nonce?: string;
-}
-
-export interface MessageSearchOptions {
-  query?: string;
-  channelId?: UUID;
-  senderId?: UUID;
-  before?: Date;
-  after?: Date;
-  limit?: number;
-  offset?: number;
-  hasAttachments?: boolean;
-  pinned?: boolean;
-  mentions?: UUID;
-}
-
-export interface MessageChannel {
-  id: UUID;
-  name: string;
-  type: 'text' | 'voice' | 'dm' | 'group' | 'announcement' | 'thread';
-  description?: string;
-  participants?: MessageParticipant[];
-  permissions?: {
-    canSend: boolean;
-    canRead: boolean;
-    canDelete: boolean;
-    canPin: boolean;
-    canManage: boolean;
-  };
-  lastMessageAt?: Date;
-  messageCount?: number;
-  unreadCount?: number;
-}
-
-/**
- * Interface for messaging services
- */
-export abstract class IMessageService extends Service {
-  static override readonly serviceType = ServiceType.MESSAGE;
-
-  public readonly capabilityDescription = 'Message sending, receiving, and management capabilities';
-
-  /**
-   * Send a message to a channel
-   * @param channelId - Channel ID
-   * @param content - Message content
-   * @param options - Send options
-   * @returns Promise resolving to message ID
-   */
-  abstract sendMessage(
-    channelId: UUID,
-    content: MessageContent,
-    options?: MessageSendOptions
-  ): Promise<UUID>;
-
-  /**
-   * Get messages from a channel
-   * @param channelId - Channel ID
-   * @param options - Search options
-   * @returns Promise resolving to array of messages
-   */
-  abstract getMessages(channelId: UUID, options?: MessageSearchOptions): Promise<MessageInfo[]>;
-
-  /**
-   * Get a specific message by ID
-   * @param messageId - Message ID
-   * @returns Promise resolving to message
-   */
-  abstract getMessage(messageId: UUID): Promise<MessageInfo>;
-
-  /**
-   * Edit a message
-   * @param messageId - Message ID
-   * @param content - New message content
-   * @returns Promise resolving when edit completes
-   */
-  abstract editMessage(messageId: UUID, content: MessageContent): Promise<void>;
-
-  /**
-   * Delete a message
-   * @param messageId - Message ID
-   * @returns Promise resolving when deletion completes
-   */
-  abstract deleteMessage(messageId: UUID): Promise<void>;
-
-  /**
-   * Add a reaction to a message
-   * @param messageId - Message ID
-   * @param emoji - Reaction emoji
-   * @returns Promise resolving when reaction is added
-   */
-  abstract addReaction(messageId: UUID, emoji: string): Promise<void>;
-
-  /**
-   * Remove a reaction from a message
-   * @param messageId - Message ID
-   * @param emoji - Reaction emoji
-   * @returns Promise resolving when reaction is removed
-   */
-  abstract removeReaction(messageId: UUID, emoji: string): Promise<void>;
-
-  /**
-   * Pin a message
-   * @param messageId - Message ID
-   * @returns Promise resolving when message is pinned
-   */
-  abstract pinMessage(messageId: UUID): Promise<void>;
-
-  /**
-   * Unpin a message
-   * @param messageId - Message ID
-   * @returns Promise resolving when message is unpinned
-   */
-  abstract unpinMessage(messageId: UUID): Promise<void>;
-
-  /**
-   * Get available channels
-   * @returns Promise resolving to array of channels
-   */
-  abstract getChannels(): Promise<MessageChannel[]>;
-
-  /**
-   * Get channel information
-   * @param channelId - Channel ID
-   * @returns Promise resolving to channel info
-   */
-  abstract getChannel(channelId: UUID): Promise<MessageChannel>;
-
-  /**
-   * Create a new channel
-   * @param name - Channel name
-   * @param type - Channel type
-   * @param options - Channel options
-   * @returns Promise resolving to new channel ID
-   */
-  abstract createChannel(
-    name: string,
-    type: MessageChannel['type'],
-    options?: {
-      description?: string;
-      participants?: UUID[];
-      private?: boolean;
-    }
-  ): Promise<UUID>;
-
-  /**
-   * Search messages across channels
-   * @param query - Search query
-   * @param options - Search options
-   * @returns Promise resolving to search results
-   */
-  abstract searchMessages(query: string, options?: MessageSearchOptions): Promise<MessageInfo[]>;
-}

package/src/types/messaging.ts

@@ -1,57 +0,0 @@
-import type { Content, UUID } from './primitives';
-import type { IAgentRuntime } from './runtime';
-
-/**
- * Information describing the target of a message.
- */
-export interface TargetInfo {
-  source: string; // Platform identifier (e.g., 'discord', 'telegram', 'websocket-api')
-  roomId?: UUID; // Target room ID (platform-specific or runtime-specific)
-  channelId?: string; // Platform-specific channel/chat ID
-  serverId?: string; // Platform-specific server/guild ID
-  entityId?: UUID; // Target user ID (for DMs)
-  threadId?: string; // Platform-specific thread ID (e.g., Telegram topics)
-  // Add other relevant platform-specific identifiers as needed
-}
-
-/**
- * Function signature for handlers responsible for sending messages to specific platforms.
- */
-export type SendHandlerFunction = (
-  runtime: IAgentRuntime,
-  target: TargetInfo,
-  content: Content
-) => Promise<void>;
-
-export enum SOCKET_MESSAGE_TYPE {
-  ROOM_JOINING = 1,
-  SEND_MESSAGE = 2,
-  MESSAGE = 3,
-  ACK = 4,
-  THINKING = 5,
-  CONTROL = 6,
-}
-
-/**
- * Interface for control messages sent from the backend to the frontend
- * to manage UI state and interaction capabilities
- */
-export interface ControlMessage {
-  /** Message type identifier */
-  type: 'control';
-
-  /** Control message payload */
-  payload: {
-    /** Action to perform */
-    action: 'disable_input' | 'enable_input';
-
-    /** Optional target element identifier */
-    target?: string;
-
-    /** Additional optional parameters */
-    [key: string]: unknown;
-  };
-
-  /** Room ID to ensure signal is directed to the correct chat window */
-  roomId: UUID;
-}