@elizaos/api-client 1.4.4 → 1.5.0

package/dist/core/src/types/plugin.d.ts

@@ -0,0 +1,64 @@
+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;
+};
+/**
+ * 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;
+    init?: (config: Record<string, string>, runtime: IAgentRuntime) => Promise<void>;
+    config?: {
+        [key: string]: any;
+    };
+    services?: (typeof Service)[];
+    componentTypes?: {
+        name: string;
+        schema: Record<string, unknown>;
+        validator?: (data: any) => boolean;
+    }[];
+    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[];
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/core/src/types/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../../core/src/types/plugin.ts"],"names":[],"mappings":"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"}

package/dist/core/src/types/post.d.ts

@@ -0,0 +1,242 @@
+import { Service } 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 declare abstract class IPostService extends Service {
+    static readonly serviceType: "post";
+    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[]>;
+}
+//# sourceMappingURL=post.d.ts.map

package/dist/core/src/types/post.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post.d.ts","sourceRoot":"","sources":["../../../../../core/src/types/post.ts"],"names":[],"mappings":"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"}

package/dist/core/src/types/primitives.d.ts

@@ -0,0 +1,72 @@
+/**
+ * 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 declare function asUUID(id: string): 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 declare 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>;
+//# sourceMappingURL=primitives.d.ts.map

package/dist/core/src/types/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../../../core/src/types/primitives.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;AAEvE;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAKvC;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,8EAA8E;IAC9E,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,uDAAuD;IACvD,SAAS,CAAC,EAAE,IAAI,CAAC;IAEjB,iCAAiC;IACjC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC;IAEtB,gBAAgB;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG;IAClB,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IAEX,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAC;IAEZ,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,mBAAmB;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,mBAAmB;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B,CAAC;AAEF,oBAAY,WAAW;IACrB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,IAAI,SAAS;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/core/src/types/runtime.d.ts

@@ -0,0 +1,106 @@
+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 {
+    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;
+    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;
+    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>;
+    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>;
+    createRunId(): UUID;
+    startRun(): UUID;
+    endRun(): void;
+    getCurrentRunId(): UUID;
+    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>;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/core/src/types/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../../core/src/types/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC;;;;GAIG;AAEH,MAAM,WAAW,aAAc,SAAQ,gBAAgB;IAErD,OAAO,EAAE,IAAI,CAAC;IACd,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,GAAG,CAAC,eAAe,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1C,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;IACxD,KAAK,CAAC,EAAE,OAAO,KAAK,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,MAAM,EAAE,GAAG,CAAC;IAGZ,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;IAE9B,UAAU,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC;IAE3E,iBAAiB,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC;IAE7E,cAAc,IAAI,GAAG,CAAC,eAAe,EAAE,OAAO,EAAE,CAAC,CAAC;IAElD,eAAe,CAAC,OAAO,EAAE,OAAO,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD,qBAAqB,CAAC,WAAW,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtE,yBAAyB,IAAI,eAAe,EAAE,CAAC;IAE/C,UAAU,CAAC,WAAW,EAAE,eAAe,GAAG,MAAM,GAAG,OAAO,CAAC;IAG3D,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAEzD,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,GAAG,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAEtF,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,GAAG,CAAC;IAEvD,qBAAqB,IAAI,MAAM,CAAC;IAEhC,cAAc,CACZ,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EAAE,EACnB,KAAK,CAAC,EAAE,KAAK,EACb,QAAQ,CAAC,EAAE,eAAe,GACzB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB,QAAQ,CACN,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,KAAK,EACb,UAAU,CAAC,EAAE,OAAO,EACpB,QAAQ,CAAC,EAAE,eAAe,EAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC;IAE/B,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAE3C,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAE9C,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClG,gBAAgB,CAAC,EACf,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,IAAI,EACJ,MAAM,EACN,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,MAAM,GACP,EAAE;QACD,QAAQ,EAAE,IAAI,CAAC;QACf,MAAM,EAAE,IAAI,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,GAAG,CAAC;QACV,OAAO,EAAE,IAAI,CAAC;QACd,MAAM,CAAC,EAAE,IAAI,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElB,uBAAuB,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErE,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C,YAAY,CACV,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,WAAW,CAAC,EAAE,OAAO,EACrB,SAAS,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,KAAK,CAAC,CAAC;IAElB,QAAQ,CAAC,CAAC,SAAS,aAAa,EAAE,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,EACrD,SAAS,EAAE,CAAC,EACZ,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,GAAG,GAC/C,OAAO,CAAC,CAAC,CAAC,CAAC;IAEd,aAAa,CACX,SAAS,EAAE,aAAa,GAAG,MAAM,EACjC,OAAO,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,EACtC,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,CAAC;IAER,QAAQ,CACN,SAAS,EAAE,aAAa,GAAG,MAAM,GAChC,CAAC,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC;IAEvE,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAE5E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC;IAExE,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE,kBAAkB,CAAC,WAAW,EAAE,UAAU,GAAG,IAAI,CAAC;IAClD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IAEpD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEtD;;;;;;OAMG;IACH,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9F,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEpC,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,EAAE,cAAc,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAGlG,WAAW,IAAI,IAAI,CAAC;IACpB,QAAQ,IAAI,IAAI,CAAC;IACjB,MAAM,IAAI,IAAI,CAAC;IACf,eAAe,IAAI,IAAI,CAAC;IAIxB,aAAa,CAAC,QAAQ,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtD,OAAO,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAC5C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,UAAU,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1F,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,QAAQ,CAAC,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAEzC,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAExE,mBAAmB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1E"}

package/dist/core/src/types/service.d.ts

@@ -0,0 +1,147 @@
+import type { Metadata } from './primitives';
+import type { IAgentRuntime } from './runtime';
+/**
+ * Core service type registry that can be extended by plugins via module augmentation.
+ * Plugins can extend this interface to add their own service types:
+ *
+ * @example
+ * ```typescript
+ * declare module '@elizaos/core' {
+ *   interface ServiceTypeRegistry {
+ *     MY_CUSTOM_SERVICE: 'my_custom_service';
+ *   }
+ * }
+ * ```
+ */
+export interface ServiceTypeRegistry {
+    TRANSCRIPTION: 'transcription';
+    VIDEO: 'video';
+    BROWSER: 'browser';
+    PDF: 'pdf';
+    REMOTE_FILES: 'aws_s3';
+    WEB_SEARCH: 'web_search';
+    EMAIL: 'email';
+    TEE: 'tee';
+    TASK: 'task';
+    WALLET: 'wallet';
+    LP_POOL: 'lp_pool';
+    TOKEN_DATA: 'token_data';
+    MESSAGE: 'message';
+    POST: 'post';
+    UNKNOWN: 'unknown';
+}
+/**
+ * Type for service names that includes both core services and any plugin-registered services
+ */
+export type ServiceTypeName = ServiceTypeRegistry[keyof ServiceTypeRegistry];
+/**
+ * Helper type to extract service type values from the registry
+ */
+export type ServiceTypeValue<K extends keyof ServiceTypeRegistry> = ServiceTypeRegistry[K];
+/**
+ * Helper type to check if a service type exists in the registry
+ */
+export type IsValidServiceType<T extends string> = T extends ServiceTypeName ? true : false;
+/**
+ * Type-safe service class definition
+ */
+export type TypedServiceClass<T extends ServiceTypeName> = {
+    new (runtime?: IAgentRuntime): Service;
+    serviceType: T;
+    start(runtime: IAgentRuntime): Promise<Service>;
+};
+/**
+ * Map of service type names to their implementation classes
+ */
+export interface ServiceClassMap {
+}
+/**
+ * Helper to infer service instance type from service type name
+ */
+export type ServiceInstance<T extends ServiceTypeName> = T extends keyof ServiceClassMap ? InstanceType<ServiceClassMap[T]> : Service;
+/**
+ * Runtime service registry type
+ */
+export type ServiceRegistry<T extends ServiceTypeName = ServiceTypeName> = Map<T, Service>;
+/**
+ * Enumerates the recognized types of services that can be registered and used by the agent runtime.
+ * Services provide specialized functionalities like audio transcription, video processing,
+ * web browsing, PDF handling, file storage (e.g., AWS S3), web search, email integration,
+ * secure execution via TEE (Trusted Execution Environment), and task management.
+ * This constant is used in `AgentRuntime` for service registration and retrieval (e.g., `getService`).
+ * Each service typically implements the `Service` abstract class or a more specific interface like `IVideoService`.
+ */
+export declare const ServiceType: {
+    readonly TRANSCRIPTION: "transcription";
+    readonly VIDEO: "video";
+    readonly BROWSER: "browser";
+    readonly PDF: "pdf";
+    readonly REMOTE_FILES: "aws_s3";
+    readonly WEB_SEARCH: "web_search";
+    readonly EMAIL: "email";
+    readonly TEE: "tee";
+    readonly TASK: "task";
+    readonly WALLET: "wallet";
+    readonly LP_POOL: "lp_pool";
+    readonly TOKEN_DATA: "token_data";
+    readonly MESSAGE: "message";
+    readonly POST: "post";
+    readonly UNKNOWN: "unknown";
+};
+/**
+ * Client instance
+ */
+export declare abstract class Service {
+    /** Runtime instance */
+    protected runtime: IAgentRuntime;
+    constructor(runtime?: IAgentRuntime);
+    abstract stop(): Promise<void>;
+    /** Service type */
+    static serviceType: string;
+    /** Service name */
+    abstract capabilityDescription: string;
+    /** Service configuration */
+    config?: Metadata;
+    /** Start service connection */
+    static start(_runtime: IAgentRuntime): Promise<Service>;
+    /** Stop service connection */
+    static stop(_runtime: IAgentRuntime): Promise<unknown>;
+}
+/**
+ * Generic service interface that provides better type checking for services
+ * @template ConfigType The configuration type for this service
+ * @template ResultType The result type returned by the service operations
+ */
+export interface TypedService<ConfigType extends Metadata = Metadata, ResultType = unknown> extends Service {
+    /**
+     * The configuration for this service instance
+     */
+    config?: ConfigType;
+    /**
+     * Process an input with this service
+     * @param input The input to process
+     * @returns A promise resolving to the result
+     */
+    process(input: unknown): Promise<ResultType>;
+}
+/**
+ * Generic factory function to create a typed service instance
+ * @param runtime The agent runtime
+ * @param serviceType The type of service to get
+ * @returns The service instance or null if not available
+ */
+export declare function getTypedService<T extends TypedService<any, any>>(runtime: IAgentRuntime, serviceType: ServiceTypeName): T | null;
+/**
+ * Standardized service error type for consistent error handling
+ */
+export interface ServiceError {
+    code: string;
+    message: string;
+    details?: unknown;
+    cause?: Error;
+}
+/**
+ * Safely create a ServiceError from any caught error
+ */
+export declare function createServiceError(error: unknown, code?: string): ServiceError;
+//# sourceMappingURL=service.d.ts.map

package/dist/core/src/types/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../core/src/types/service.ts"],"names":[],"mappings":"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"}