@elizaos/core 1.5.3-beta.3 → 1.5.5-alpha.10

package/src/types/environment.ts

@@ -1,129 +0,0 @@
-import type { Metadata, UUID } from './primitives';
-
-export interface Component {
-  id: UUID;
-  entityId: UUID;
-  agentId: UUID;
-  roomId: UUID;
-  worldId: UUID;
-  sourceEntityId: UUID;
-  type: string;
-  createdAt: number;
-  data: Metadata;
-}
-
-/**
- * Represents a user account
- */
-export interface Entity {
-  /** Unique identifier, optional on creation */
-  id?: UUID;
-
-  /** Names of the entity */
-  names: string[];
-
-  /** Additional metadata */
-  metadata: Metadata;
-
-  /** Agent ID this account is related to, for agents should be themselves */
-  agentId: UUID;
-
-  /** Optional array of components */
-  components?: Component[];
-}
-
-/**
- * Defines roles within a system, typically for access control or permissions, often within a `World`.
- * - `OWNER`: Represents the highest level of control, typically the creator or primary administrator.
- * - `ADMIN`: Represents administrative privileges, usually a subset of owner capabilities.
- * - `NONE`: Indicates no specific role or default, minimal permissions.
- * These roles are often used in `World.metadata.roles` to assign roles to entities.
- */
-export enum Role {
-  OWNER = 'OWNER',
-  ADMIN = 'ADMIN',
-  NONE = 'NONE',
-}
-
-export type World = {
-  id: UUID;
-  name?: string;
-  agentId: UUID;
-  serverId: string;
-  metadata?: {
-    ownership?: {
-      ownerId: string;
-    };
-    roles?: {
-      [entityId: UUID]: Role;
-    };
-    [key: string]: unknown;
-  };
-};
-
-export enum ChannelType {
-  SELF = 'SELF', // Messages to self
-  DM = 'DM', // Direct messages between two participants
-  GROUP = 'GROUP', // Group messages with multiple participants
-  VOICE_DM = 'VOICE_DM', // Voice direct messages
-  VOICE_GROUP = 'VOICE_GROUP', // Voice channels with multiple participants
-  FEED = 'FEED', // Social media feed
-  THREAD = 'THREAD', // Threaded conversation
-  WORLD = 'WORLD', // World channel
-  FORUM = 'FORUM', // Forum discussion
-  // Legacy types - kept for backward compatibility but should be replaced
-  API = 'API', // @deprecated - Use DM or GROUP instead
-}
-
-export type Room = {
-  id: UUID;
-  name?: string;
-  agentId?: UUID;
-  source: string;
-  type: ChannelType;
-  channelId?: string;
-  serverId?: string;
-  worldId?: UUID;
-  metadata?: Metadata;
-};
-
-export type RoomMetadata = {
-  [key: string]: unknown;
-};
-
-/**
- * Room participant with account details
- */
-export interface Participant {
-  /** Unique identifier */
-  id: UUID;
-
-  /** Associated account */
-  entity: Entity;
-}
-
-/**
- * Represents a relationship between users
- */
-export interface Relationship {
-  /** Unique identifier */
-  id: UUID;
-
-  /** First user ID */
-  sourceEntityId: UUID;
-
-  /** Second user ID */
-  targetEntityId: UUID;
-
-  /** Agent ID */
-  agentId: UUID;
-
-  /** Tags for filtering/categorizing relationships */
-  tags: string[];
-
-  /** Additional metadata about the relationship */
-  metadata: Metadata;
-
-  /** Optional creation timestamp */
-  createdAt?: string;
-}

package/src/types/events.ts

@@ -1,249 +0,0 @@
-import type { HandlerCallback } from './components';
-import type { Entity, Room, World } from './environment';
-import type { Memory } from './memory';
-import type { ModelTypeName } from './model';
-import type { Metadata, UUID } from './primitives';
-import type { IAgentRuntime } from './runtime';
-
-/**
- * Standard event types across all platforms
- */
-export enum EventType {
-  // World events
-  WORLD_JOINED = 'WORLD_JOINED',
-  WORLD_CONNECTED = 'WORLD_CONNECTED',
-  WORLD_LEFT = 'WORLD_LEFT',
-
-  // Entity events
-  ENTITY_JOINED = 'ENTITY_JOINED',
-  ENTITY_LEFT = 'ENTITY_LEFT',
-  ENTITY_UPDATED = 'ENTITY_UPDATED',
-
-  // Room events
-  ROOM_JOINED = 'ROOM_JOINED',
-  ROOM_LEFT = 'ROOM_LEFT',
-
-  // Message events
-  MESSAGE_RECEIVED = 'MESSAGE_RECEIVED',
-  MESSAGE_SENT = 'MESSAGE_SENT',
-  MESSAGE_DELETED = 'MESSAGE_DELETED',
-
-  // Channel events
-  CHANNEL_CLEARED = 'CHANNEL_CLEARED',
-
-  // Voice events
-  VOICE_MESSAGE_RECEIVED = 'VOICE_MESSAGE_RECEIVED',
-  VOICE_MESSAGE_SENT = 'VOICE_MESSAGE_SENT',
-
-  // Interaction events
-  REACTION_RECEIVED = 'REACTION_RECEIVED',
-  POST_GENERATED = 'POST_GENERATED',
-  INTERACTION_RECEIVED = 'INTERACTION_RECEIVED',
-
-  // Run events
-  RUN_STARTED = 'RUN_STARTED',
-  RUN_ENDED = 'RUN_ENDED',
-  RUN_TIMEOUT = 'RUN_TIMEOUT',
-
-  // Action events
-  ACTION_STARTED = 'ACTION_STARTED',
-  ACTION_COMPLETED = 'ACTION_COMPLETED',
-
-  // Evaluator events
-  EVALUATOR_STARTED = 'EVALUATOR_STARTED',
-  EVALUATOR_COMPLETED = 'EVALUATOR_COMPLETED',
-
-  // Model events
-  MODEL_USED = 'MODEL_USED',
-
-  // Embedding events
-  EMBEDDING_GENERATION_REQUESTED = 'EMBEDDING_GENERATION_REQUESTED',
-  EMBEDDING_GENERATION_COMPLETED = 'EMBEDDING_GENERATION_COMPLETED',
-  EMBEDDING_GENERATION_FAILED = 'EMBEDDING_GENERATION_FAILED',
-}
-
-/**
- * Platform-specific event type prefix
- */
-export enum PlatformPrefix {
-  DISCORD = 'DISCORD',
-  TELEGRAM = 'TELEGRAM',
-  TWITTER = 'TWITTER',
-}
-
-/**
- * Base payload interface for all events
- */
-export interface EventPayload {
-  runtime: IAgentRuntime;
-  source: string;
-  onComplete?: () => void;
-}
-
-/**
- * Payload for world-related events
- */
-export interface WorldPayload extends EventPayload {
-  world: World;
-  rooms: Room[];
-  entities: Entity[];
-}
-
-/**
- * Payload for entity-related events
- */
-export interface EntityPayload extends EventPayload {
-  entityId: UUID;
-  worldId?: UUID;
-  roomId?: UUID;
-  metadata?: {
-    orginalId: string;
-    username: string;
-    displayName?: string;
-    [key: string]: any;
-  };
-}
-
-/**
- * Payload for reaction-related events
- */
-export interface MessagePayload extends EventPayload {
-  message: Memory;
-  callback?: HandlerCallback;
-  onComplete?: () => void;
-}
-
-/**
- * Payload for channel cleared events
- */
-export interface ChannelClearedPayload extends EventPayload {
-  roomId: UUID;
-  channelId: string;
-  memoryCount: number;
-}
-
-/**
- * Payload for events that are invoked without a message
- */
-export interface InvokePayload extends EventPayload {
-  worldId: UUID;
-  userId: string;
-  roomId: UUID;
-  callback?: HandlerCallback;
-  source: string;
-}
-
-/**
- * Run event payload type
- */
-export interface RunEventPayload extends EventPayload {
-  runId: UUID;
-  messageId: UUID;
-  roomId: UUID;
-  entityId: UUID;
-  startTime: number;
-  status: 'started' | 'completed' | 'timeout';
-  endTime?: number;
-  duration?: number;
-  error?: string;
-}
-
-/**
- * Action event payload type
- */
-export interface ActionEventPayload extends EventPayload {
-  actionId: UUID;
-  actionName: string;
-  startTime?: number;
-  completed?: boolean;
-  error?: Error;
-}
-
-/**
- * Evaluator event payload type
- */
-export interface EvaluatorEventPayload extends EventPayload {
-  evaluatorId: UUID;
-  evaluatorName: string;
-  startTime?: number;
-  completed?: boolean;
-  error?: Error;
-}
-
-/**
- * Model event payload type
- */
-export interface ModelEventPayload extends EventPayload {
-  provider: string;
-  type: ModelTypeName;
-  prompt: string;
-  tokens?: {
-    prompt: number;
-    completion: number;
-    total: number;
-  };
-}
-
-/**
- * Payload for embedding generation events
- */
-export interface EmbeddingGenerationPayload extends EventPayload {
-  memory: Memory;
-  priority?: 'high' | 'normal' | 'low';
-  retryCount?: number;
-  maxRetries?: number;
-  embedding?: number[];
-  error?: any;
-}
-
-export type MessageReceivedHandlerParams = {
-  runtime: IAgentRuntime;
-  message: Memory;
-  callback: HandlerCallback;
-  onComplete?: () => void;
-};
-
-/**
- * Maps event types to their corresponding payload types
- */
-export interface EventPayloadMap {
-  [EventType.WORLD_JOINED]: WorldPayload;
-  [EventType.WORLD_CONNECTED]: WorldPayload;
-  [EventType.WORLD_LEFT]: WorldPayload;
-  [EventType.ENTITY_JOINED]: EntityPayload;
-  [EventType.ENTITY_LEFT]: EntityPayload;
-  [EventType.ENTITY_UPDATED]: EntityPayload;
-  [EventType.MESSAGE_RECEIVED]: MessagePayload;
-  [EventType.MESSAGE_SENT]: MessagePayload;
-  [EventType.MESSAGE_DELETED]: MessagePayload;
-  [EventType.CHANNEL_CLEARED]: ChannelClearedPayload;
-  [EventType.REACTION_RECEIVED]: MessagePayload;
-  [EventType.POST_GENERATED]: InvokePayload;
-  [EventType.INTERACTION_RECEIVED]: MessagePayload;
-  [EventType.RUN_STARTED]: RunEventPayload;
-  [EventType.RUN_ENDED]: RunEventPayload;
-  [EventType.RUN_TIMEOUT]: RunEventPayload;
-  [EventType.ACTION_STARTED]: ActionEventPayload;
-  [EventType.ACTION_COMPLETED]: ActionEventPayload;
-  [EventType.EVALUATOR_STARTED]: EvaluatorEventPayload;
-  [EventType.EVALUATOR_COMPLETED]: EvaluatorEventPayload;
-  [EventType.MODEL_USED]: ModelEventPayload;
-  [EventType.EMBEDDING_GENERATION_REQUESTED]: EmbeddingGenerationPayload;
-  [EventType.EMBEDDING_GENERATION_COMPLETED]: EmbeddingGenerationPayload;
-  [EventType.EMBEDDING_GENERATION_FAILED]: EmbeddingGenerationPayload;
-}
-
-/**
- * Event handler function type
- */
-export type EventHandler<T extends keyof EventPayloadMap> = (
-  payload: EventPayloadMap[T]
-) => Promise<void>;
-
-/**
- * Defines a more specific type for event handlers, expecting an `Metadata`.
- * This aims to improve upon generic 'any' type handlers, providing a clearer contract
- * for functions that respond to events emitted within the agent runtime (see `emitEvent` in `AgentRuntime`).
- * Handlers can be synchronous or asynchronous.
- */
-export type TypedEventHandler = (data: Metadata) => Promise<void> | void;

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