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

package/src/types/pdf.ts

@@ -1,77 +0,0 @@
-import { Service, ServiceType } from './service';
-
-export interface PdfExtractionResult {
-  text: string;
-  pageCount: number;
-  metadata?: {
-    title?: string;
-    author?: string;
-    createdAt?: Date;
-    modifiedAt?: Date;
-  };
-}
-
-export interface PdfGenerationOptions {
-  format?: 'A4' | 'A3' | 'Letter';
-  orientation?: 'portrait' | 'landscape';
-  margins?: {
-    top?: number;
-    bottom?: number;
-    left?: number;
-    right?: number;
-  };
-  header?: string;
-  footer?: string;
-}
-
-export interface PdfConversionOptions {
-  quality?: 'high' | 'medium' | 'low';
-  outputFormat?: 'pdf' | 'pdf/a';
-  compression?: boolean;
-}
-
-/**
- * Interface for PDF processing services
- */
-export abstract class IPdfService extends Service {
-  static override readonly serviceType = ServiceType.PDF;
-
-  public readonly capabilityDescription = 'PDF processing, extraction, and generation capabilities';
-
-  /**
-   * Extract text and metadata from a PDF file
-   * @param pdfPath - Path to the PDF file or buffer
-   * @returns Promise resolving to extracted text and metadata
-   */
-  abstract extractText(pdfPath: string | Buffer): Promise<PdfExtractionResult>;
-
-  /**
-   * Generate a PDF from HTML content
-   * @param htmlContent - HTML content to convert to PDF
-   * @param options - PDF generation options
-   * @returns Promise resolving to PDF buffer
-   */
-  abstract generatePdf(htmlContent: string, options?: PdfGenerationOptions): Promise<Buffer>;
-
-  /**
-   * Convert a document to PDF format
-   * @param filePath - Path to the document file
-   * @param options - Conversion options
-   * @returns Promise resolving to PDF buffer
-   */
-  abstract convertToPdf(filePath: string, options?: PdfConversionOptions): Promise<Buffer>;
-
-  /**
-   * Merge multiple PDF files into one
-   * @param pdfPaths - Array of PDF file paths or buffers
-   * @returns Promise resolving to merged PDF buffer
-   */
-  abstract mergePdfs(pdfPaths: (string | Buffer)[]): Promise<Buffer>;
-
-  /**
-   * Split a PDF into individual pages
-   * @param pdfPath - Path to the PDF file or buffer
-   * @returns Promise resolving to array of page buffers
-   */
-  abstract splitPdf(pdfPath: string | Buffer): Promise<Buffer[]>;
-}

package/src/types/plugin.ts

@@ -1,78 +0,0 @@
-import type { Character } from './agent';
-import type { Action, Evaluator, Provider } from './components';
-import type { IDatabaseAdapter } from './database';
-import type { EventHandler, EventPayloadMap } from './events';
-import type { IAgentRuntime } from './runtime';
-import type { Service } from './service';
-import type { TestSuite } from './testing';
-
-export type Route = {
-  type: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'STATIC';
-  path: string;
-  filePath?: string;
-  public?: boolean;
-  name?: string extends { public: true } ? string : string | undefined;
-  handler?: (req: any, res: any, runtime: IAgentRuntime) => Promise<void>;
-  isMultipart?: boolean; // Indicates if the route expects multipart/form-data (file uploads)
-};
-
-/**
- * Plugin for extending agent functionality
- */
-
-export type PluginEvents = {
-  [K in keyof EventPayloadMap]?: EventHandler<K>[];
-} & {
-  [key: string]: ((params: any) => Promise<any>)[];
-};
-
-export interface Plugin {
-  name: string;
-  description: string;
-
-  // Initialize plugin with runtime services
-  init?: (config: Record<string, string>, runtime: IAgentRuntime) => Promise<void>;
-
-  // Configuration
-  config?: { [key: string]: any };
-
-  services?: (typeof Service)[];
-
-  // Entity component definitions
-  componentTypes?: {
-    name: string;
-    schema: Record<string, unknown>;
-    validator?: (data: any) => boolean;
-  }[];
-
-  // Optional plugin features
-  actions?: Action[];
-  providers?: Provider[];
-  evaluators?: Evaluator[];
-  adapter?: IDatabaseAdapter;
-  models?: {
-    [key: string]: (...args: any[]) => Promise<any>;
-  };
-  events?: PluginEvents;
-  routes?: Route[];
-  tests?: TestSuite[];
-
-  dependencies?: string[];
-
-  testDependencies?: string[];
-
-  priority?: number;
-
-  schema?: any;
-}
-
-export interface ProjectAgent {
-  character: Character;
-  init?: (runtime: IAgentRuntime) => Promise<void>;
-  plugins?: Plugin[];
-  tests?: TestSuite | TestSuite[];
-}
-
-export interface Project {
-  agents: ProjectAgent[];
-}

package/src/types/post.ts

@@ -1,271 +0,0 @@
-import { Service, ServiceType } from './service';
-import type { UUID } from './primitives';
-
-export interface PostMedia {
-  id: UUID;
-  url: string;
-  type: 'image' | 'video' | 'audio' | 'document';
-  mimeType: string;
-  size: number;
-  width?: number;
-  height?: number;
-  duration?: number;
-  thumbnail?: string;
-  description?: string;
-  altText?: string;
-}
-
-export interface PostLocation {
-  name: string;
-  address?: string;
-  coordinates?: {
-    latitude: number;
-    longitude: number;
-  };
-  placeId?: string;
-}
-
-export interface PostAuthor {
-  id: UUID;
-  username: string;
-  displayName: string;
-  avatar?: string;
-  verified?: boolean;
-  followerCount?: number;
-  followingCount?: number;
-  bio?: string;
-  website?: string;
-}
-
-export interface PostEngagement {
-  likes: number;
-  shares: number;
-  comments: number;
-  views?: number;
-  hasLiked: boolean;
-  hasShared: boolean;
-  hasCommented: boolean;
-  hasSaved: boolean;
-}
-
-export interface PostContent {
-  text?: string;
-  html?: string;
-  media?: PostMedia[];
-  location?: PostLocation;
-  tags?: string[];
-  mentions?: UUID[];
-  links?: Array<{
-    url: string;
-    title?: string;
-    description?: string;
-    image?: string;
-  }>;
-  poll?: {
-    question: string;
-    options: Array<{
-      text: string;
-      votes: number;
-    }>;
-    expiresAt?: Date;
-    multipleChoice?: boolean;
-  };
-}
-
-export interface PostInfo {
-  id: UUID;
-  author: PostAuthor;
-  content: PostContent;
-  platform: string;
-  platformId: string;
-  url: string;
-  createdAt: Date;
-  editedAt?: Date;
-  scheduledAt?: Date;
-  engagement: PostEngagement;
-  visibility: 'public' | 'private' | 'followers' | 'friends' | 'unlisted';
-  replyTo?: UUID;
-  thread?: {
-    id: UUID;
-    position: number;
-    total: number;
-  };
-  crossPosted?: Array<{
-    platform: string;
-    platformId: string;
-    url: string;
-  }>;
-}
-
-export interface PostCreateOptions {
-  platforms?: string[];
-  scheduledAt?: Date;
-  visibility?: PostInfo['visibility'];
-  replyTo?: UUID;
-  thread?: boolean;
-  location?: PostLocation;
-  tags?: string[];
-  mentions?: UUID[];
-  enableComments?: boolean;
-  enableSharing?: boolean;
-  contentWarning?: string;
-  sensitive?: boolean;
-}
-
-export interface PostSearchOptions {
-  query?: string;
-  author?: UUID;
-  platform?: string;
-  tags?: string[];
-  mentions?: UUID[];
-  since?: Date;
-  before?: Date;
-  limit?: number;
-  offset?: number;
-  hasMedia?: boolean;
-  hasLocation?: boolean;
-  visibility?: PostInfo['visibility'];
-  sortBy?: 'date' | 'engagement' | 'relevance';
-}
-
-export interface PostAnalytics {
-  postId: UUID;
-  platform: string;
-  impressions: number;
-  reach: number;
-  engagement: PostEngagement;
-  clicks: number;
-  shares: number;
-  saves: number;
-  demographics?: {
-    age?: Record<string, number>;
-    gender?: Record<string, number>;
-    location?: Record<string, number>;
-  };
-  topPerformingHours?: Array<{
-    hour: number;
-    engagement: number;
-  }>;
-}
-
-/**
- * Interface for social media posting services
- */
-export abstract class IPostService extends Service {
-  static override readonly serviceType = ServiceType.POST;
-
-  public readonly capabilityDescription =
-    'Social media posting and content management capabilities';
-
-  /**
-   * Create and publish a new post
-   * @param content - Post content
-   * @param options - Publishing options
-   * @returns Promise resolving to post ID
-   */
-  abstract createPost(content: PostContent, options?: PostCreateOptions): Promise<UUID>;
-
-  /**
-   * Get posts from timeline or specific user
-   * @param options - Search options
-   * @returns Promise resolving to array of posts
-   */
-  abstract getPosts(options?: PostSearchOptions): Promise<PostInfo[]>;
-
-  /**
-   * Get a specific post by ID
-   * @param postId - Post ID
-   * @returns Promise resolving to post info
-   */
-  abstract getPost(postId: UUID): Promise<PostInfo>;
-
-  /**
-   * Edit an existing post
-   * @param postId - Post ID
-   * @param content - New post content
-   * @returns Promise resolving when edit completes
-   */
-  abstract editPost(postId: UUID, content: PostContent): Promise<void>;
-
-  /**
-   * Delete a post
-   * @param postId - Post ID
-   * @returns Promise resolving when deletion completes
-   */
-  abstract deletePost(postId: UUID): Promise<void>;
-
-  /**
-   * Like/unlike a post
-   * @param postId - Post ID
-   * @param like - True to like, false to unlike
-   * @returns Promise resolving when operation completes
-   */
-  abstract likePost(postId: UUID, like: boolean): Promise<void>;
-
-  /**
-   * Share/repost a post
-   * @param postId - Post ID
-   * @param comment - Optional comment when sharing
-   * @returns Promise resolving to share ID
-   */
-  abstract sharePost(postId: UUID, comment?: string): Promise<UUID>;
-
-  /**
-   * Save/unsave a post
-   * @param postId - Post ID
-   * @param save - True to save, false to unsave
-   * @returns Promise resolving when operation completes
-   */
-  abstract savePost(postId: UUID, save: boolean): Promise<void>;
-
-  /**
-   * Comment on a post
-   * @param postId - Post ID
-   * @param content - Comment content
-   * @returns Promise resolving to comment ID
-   */
-  abstract commentOnPost(postId: UUID, content: PostContent): Promise<UUID>;
-
-  /**
-   * Get comments for a post
-   * @param postId - Post ID
-   * @param options - Search options
-   * @returns Promise resolving to array of comments
-   */
-  abstract getComments(postId: UUID, options?: PostSearchOptions): Promise<PostInfo[]>;
-
-  /**
-   * Schedule a post for later publishing
-   * @param content - Post content
-   * @param scheduledAt - When to publish
-   * @param options - Publishing options
-   * @returns Promise resolving to scheduled post ID
-   */
-  abstract schedulePost(
-    content: PostContent,
-    scheduledAt: Date,
-    options?: PostCreateOptions
-  ): Promise<UUID>;
-
-  /**
-   * Get analytics for a post
-   * @param postId - Post ID
-   * @returns Promise resolving to post analytics
-   */
-  abstract getPostAnalytics(postId: UUID): Promise<PostAnalytics>;
-
-  /**
-   * Get trending posts
-   * @param options - Search options
-   * @returns Promise resolving to trending posts
-   */
-  abstract getTrendingPosts(options?: PostSearchOptions): Promise<PostInfo[]>;
-
-  /**
-   * Search posts across platforms
-   * @param query - Search query
-   * @param options - Search options
-   * @returns Promise resolving to search results
-   */
-  abstract searchPosts(query: string, options?: PostSearchOptions): Promise<PostInfo[]>;
-}

package/src/types/primitives.ts

@@ -1,97 +0,0 @@
-/**
- * Defines a custom type UUID representing a universally unique identifier
- */
-export type UUID = `${string}-${string}-${string}-${string}-${string}`;
-
-/**
- * Helper function to safely cast a string to strongly typed UUID
- * @param id The string UUID to validate and cast
- * @returns The same UUID with branded type information
- */
-export function asUUID(id: string): UUID {
-  if (!id || !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(id)) {
-    throw new Error(`Invalid UUID format: ${id}`);
-  }
-  return id as UUID;
-}
-
-/**
- * Represents the content of a memory, message, or other information
- */
-export interface Content {
-  /** The agent's internal thought process */
-  thought?: string;
-
-  /** The main text content visible to users */
-  text?: string;
-
-  /** Optional actions to be performed */
-  actions?: string[];
-
-  /** Optional providers to use for context generation */
-  providers?: string[];
-
-  /** Optional source/origin of the content */
-  source?: string;
-
-  /** Optional target/destination for responses */
-  target?: string;
-
-  /** URL of the original message/post (e.g. tweet URL, Discord message link) */
-  url?: string;
-
-  /** UUID of parent message if this is a reply/thread */
-  inReplyTo?: UUID;
-
-  /** Array of media attachments */
-  attachments?: Media[];
-
-  /** room type */
-  channelType?: string;
-
-  /**
-   * Additional dynamic properties
-   * Use specific properties above instead of this when possible
-   */
-  [key: string]: unknown;
-}
-
-/**
- * Represents a media attachment
- */
-export type Media = {
-  /** Unique identifier */
-  id: string;
-
-  /** Media URL */
-  url: string;
-
-  /** Media title */
-  title?: string;
-
-  /** Media source */
-  source?: string;
-
-  /** Media description */
-  description?: string;
-
-  /** Text content */
-  text?: string;
-
-  /** Content type */
-  contentType?: ContentType;
-};
-
-export enum ContentType {
-  IMAGE = 'image',
-  VIDEO = 'video',
-  AUDIO = 'audio',
-  DOCUMENT = 'document',
-  LINK = 'link',
-}
-
-/**
- * A generic type for metadata objects, allowing for arbitrary key-value pairs.
- * This encourages consumers to perform type checking or casting.
- */
-export type Metadata = Record<string, unknown>;

package/src/types/runtime.ts

@@ -1,190 +0,0 @@
-import type { Character } from './agent';
-import type { Action, Evaluator, Provider } from './components';
-import { HandlerCallback } from './components';
-import type { IDatabaseAdapter } from './database';
-import type { Entity, Room, World } from './environment';
-import { Memory, MemoryMetadata } from './memory';
-import type { SendHandlerFunction, TargetInfo } from './messaging';
-import type { ModelParamsMap, ModelResultMap, ModelTypeName } from './model';
-import type { Plugin, Route } from './plugin';
-import type { Content, UUID } from './primitives';
-import type { Service, ServiceTypeName } from './service';
-import type { State } from './state';
-import type { TaskWorker } from './task';
-
-/**
- * Represents the core runtime environment for an agent.
- * Defines methods for database interaction, plugin management, event handling,
- * state composition, model usage, and task management.
- */
-
-export interface IAgentRuntime extends IDatabaseAdapter {
-  // Properties
-  agentId: UUID;
-  character: Character;
-  providers: Provider[];
-  actions: Action[];
-  evaluators: Evaluator[];
-  plugins: Plugin[];
-  services: Map<ServiceTypeName, Service[]>;
-  events: Map<string, ((params: any) => Promise<void>)[]>;
-  fetch?: typeof fetch | null;
-  routes: Route[];
-  logger: any;
-
-  // Methods
-  registerPlugin(plugin: Plugin): Promise<void>;
-
-  initialize(): Promise<void>;
-
-  getConnection(): Promise<any>;
-
-  getService<T extends Service>(service: ServiceTypeName | string): T | null;
-
-  getServicesByType<T extends Service>(service: ServiceTypeName | string): T[];
-
-  getAllServices(): Map<ServiceTypeName, Service[]>;
-
-  registerService(service: typeof Service): Promise<void>;
-
-  getServiceLoadPromise(serviceType: ServiceTypeName): Promise<Service>;
-
-  getRegisteredServiceTypes(): ServiceTypeName[];
-
-  hasService(serviceType: ServiceTypeName | string): boolean;
-
-  // Keep these methods for backward compatibility
-  registerDatabaseAdapter(adapter: IDatabaseAdapter): void;
-
-  setSetting(key: string, value: string | boolean | null | any, secret?: boolean): void;
-
-  getSetting(key: string): string | boolean | null | any;
-
-  getConversationLength(): number;
-
-  processActions(
-    message: Memory,
-    responses: Memory[],
-    state?: State,
-    callback?: HandlerCallback
-  ): Promise<void>;
-
-  evaluate(
-    message: Memory,
-    state?: State,
-    didRespond?: boolean,
-    callback?: HandlerCallback,
-    responses?: Memory[]
-  ): Promise<Evaluator[] | null>;
-
-  registerProvider(provider: Provider): void;
-
-  registerAction(action: Action): void;
-
-  registerEvaluator(evaluator: Evaluator): void;
-
-  ensureConnections(entities: Entity[], rooms: Room[], source: string, world: World): Promise<void>;
-  ensureConnection({
-    entityId,
-    roomId,
-    metadata,
-    userName,
-    worldName,
-    name,
-    source,
-    channelId,
-    serverId,
-    type,
-    worldId,
-    userId,
-  }: {
-    entityId: UUID;
-    roomId: UUID;
-    userName?: string;
-    name?: string;
-    worldName?: string;
-    source?: string;
-    channelId?: string;
-    serverId?: string;
-    type: any;
-    worldId: UUID;
-    userId?: UUID;
-    metadata?: Record<string, any>;
-  }): Promise<void>;
-
-  ensureParticipantInRoom(entityId: UUID, roomId: UUID): Promise<void>;
-
-  ensureWorldExists(world: World): Promise<void>;
-
-  ensureRoomExists(room: Room): Promise<void>;
-
-  composeState(
-    message: Memory,
-    includeList?: string[],
-    onlyInclude?: boolean,
-    skipCache?: boolean
-  ): Promise<State>;
-
-  useModel<T extends ModelTypeName, R = ModelResultMap[T]>(
-    modelType: T,
-    params: Omit<ModelParamsMap[T], 'runtime'> | any
-  ): Promise<R>;
-
-  registerModel(
-    modelType: ModelTypeName | string,
-    handler: (params: any) => Promise<any>,
-    provider: string,
-    priority?: number
-  ): void;
-
-  getModel(
-    modelType: ModelTypeName | string
-  ): ((runtime: IAgentRuntime, params: any) => Promise<any>) | undefined;
-
-  registerEvent(event: string, handler: (params: any) => Promise<void>): void;
-
-  getEvent(event: string): ((params: any) => Promise<void>)[] | undefined;
-
-  emitEvent(event: string | string[], params: any): Promise<void>;
-  // In-memory task definition methods
-  registerTaskWorker(taskHandler: TaskWorker): void;
-  getTaskWorker(name: string): TaskWorker | undefined;
-
-  stop(): Promise<void>;
-
-  addEmbeddingToMemory(memory: Memory): Promise<Memory>;
-
-  /**
-   * Queue a memory for async embedding generation.
-   * This method is non-blocking and returns immediately.
-   * The embedding will be generated asynchronously via event handlers.
-   * @param memory The memory to generate embeddings for
-   * @param priority Priority level for the embedding generation
-   */
-  queueEmbeddingGeneration(memory: Memory, priority?: 'high' | 'normal' | 'low'): Promise<void>;
-
-  getAllMemories(): Promise<Memory[]>;
-
-  clearAllAgentMemories(): Promise<void>;
-
-  updateMemory(memory: Partial<Memory> & { id: UUID; metadata?: MemoryMetadata }): Promise<boolean>;
-
-  // Run tracking methods
-  createRunId(): UUID;
-  startRun(): UUID;
-  endRun(): void;
-  getCurrentRunId(): UUID;
-
-  // easy/compat wrappers
-
-  getEntityById(entityId: UUID): Promise<Entity | null>;
-  getRoom(roomId: UUID): Promise<Room | null>;
-  createEntity(entity: Entity): Promise<boolean>;
-  createRoom({ id, name, source, type, channelId, serverId, worldId }: Room): Promise<UUID>;
-  addParticipant(entityId: UUID, roomId: UUID): Promise<boolean>;
-  getRooms(worldId: UUID): Promise<Room[]>;
-
-  registerSendHandler(source: string, handler: SendHandlerFunction): void;
-
-  sendMessageToTarget(target: TargetInfo, content: Content): Promise<void>;
-}