@elizaos/core 2.0.0-alpha.2 → 2.0.0-alpha.21

package/dist/types/message-service.d.ts

@@ -1,129 +0,0 @@
-import type { HandlerCallback } from "./components";
-import type { Room } from "./environment";
-import type { Memory } from "./memory";
-import type { Content, Media, MentionContext, UUID } from "./primitives";
-import type { MessageProcessingMode as ProtoMessageProcessingMode, MessageProcessingOptions as ProtoMessageProcessingOptions, ShouldRespondModelType as ProtoShouldRespondModelType } from "./proto.js";
-import type { IAgentRuntime } from "./runtime";
-import type { State } from "./state";
-/**
- * Configuration options for message processing
- */
-export interface MessageProcessingOptions extends Omit<ProtoMessageProcessingOptions, "$typeName" | "$unknown" | "maxRetries" | "timeoutDuration" | "useMultiStep" | "maxMultiStepIterations" | "shouldRespondModel"> {
-    maxRetries?: number;
-    timeoutDuration?: number;
-    useMultiStep?: boolean;
-    maxMultiStepIterations?: number;
-    shouldRespondModel?: ShouldRespondModelType;
-    onStreamChunk?: (chunk: string, messageId?: string) => Promise<void>;
-}
-/**
- * Result of message processing
- */
-export interface MessageProcessingResult {
-    didRespond: boolean;
-    responseContent?: Content | null;
-    responseMessages: Memory[];
-    state?: State;
-    mode?: MessageProcessingMode;
-    skipEvaluation?: boolean;
-    reason?: string;
-}
-/**
- * Response decision from the shouldRespond logic
- */
-export interface ResponseDecision {
-    shouldRespond: boolean;
-    skipEvaluation: boolean;
-    reason: string;
-}
-export type ShouldRespondModelType = ProtoShouldRespondModelType | "small" | "large";
-export type MessageProcessingMode = ProtoMessageProcessingMode | "simple" | "actions" | "none";
-/**
- * Core interface for message handling service.
- * This service is responsible for processing incoming messages and generating responses.
- *
- * Implementations of this interface control the entire message processing pipeline,
- * including:
- * - Message validation and memory creation
- * - Response decision logic (shouldRespond)
- * - Single-shot or multi-step processing
- * - Action execution and evaluation
- *
- * @example
- * ```typescript
- * // Custom implementation
- * class CustomMessageService implements IMessageService {
- *   async handleMessage(runtime, message, callback) {
- *     // Your custom message handling logic
- *     return {
- *       didRespond: true,
- *       responseContent: { text: "Custom response" },
- *       responseMessages: [],
- *       state: {},
- *       mode: 'simple'
- *     };
- *   }
- *
- *   shouldRespond(runtime, message, room, mentionContext) {
- *     // Your custom response decision logic
- *     return { shouldRespond: true, skipEvaluation: true, reason: "custom" };
- *   }
- * }
- *
- * // Register in runtime
- * await runtime.registerService(CustomMessageService);
- * ```
- */
-export interface IMessageService {
-    /**
-     * Main entry point for message processing.
-     * This method orchestrates the entire message handling flow.
-     *
-     * @param runtime - The agent runtime instance
-     * @param message - The incoming message to process
-     * @param callback - Callback function to send responses
-     * @param options - Optional processing options
-     * @returns Promise resolving to the processing result
-     */
-    handleMessage(runtime: IAgentRuntime, message: Memory, callback?: HandlerCallback, options?: MessageProcessingOptions): Promise<MessageProcessingResult>;
-    /**
-     * Determines whether the agent should respond to a message.
-     * Uses simple rules for obvious cases (DM, mentions) and defers to LLM for ambiguous cases.
-     *
-     * @param runtime - The agent runtime instance
-     * @param message - The message to evaluate
-     * @param room - The room context (optional)
-     * @param mentionContext - Platform mention/reply context (optional)
-     * @returns Response decision with reasoning
-     */
-    shouldRespond(runtime: IAgentRuntime, message: Memory, room?: Room, mentionContext?: MentionContext): ResponseDecision;
-    /**
-     * Processes attachments in a message (images, documents, etc.)
-     * Generates descriptions for images and extracts text from documents.
-     *
-     * @param runtime - The agent runtime instance
-     * @param attachments - Array of media attachments to process
-     * @returns Promise resolving to processed attachments with descriptions
-     */
-    processAttachments?(runtime: IAgentRuntime, attachments: Media[]): Promise<Media[]>;
-    /**
-     * Deletes a message from the agent's memory.
-     * This method handles the actual deletion logic that was previously in event handlers.
-     *
-     * @param runtime - The agent runtime instance
-     * @param message - The message memory to delete
-     * @returns Promise resolving when deletion is complete
-     */
-    deleteMessage(runtime: IAgentRuntime, message: Memory): Promise<void>;
-    /**
-     * Clears all messages from a channel/room.
-     * This method handles bulk deletion of all message memories in a room.
-     *
-     * @param runtime - The agent runtime instance
-     * @param roomId - The room ID to clear messages from
-     * @param channelId - The original channel ID (for logging)
-     * @returns Promise resolving when channel is cleared
-     */
-    clearChannel(runtime: IAgentRuntime, roomId: UUID, channelId: string): Promise<void>;
-}
-//# sourceMappingURL=message-service.d.ts.map

package/dist/types/message-service.d.ts.map

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

package/dist/types/messaging.d.ts

@@ -1,117 +0,0 @@
-import type { Memory } from "./memory";
-import type { Content, UUID } from "./primitives";
-import type { MessageResult as ProtoMessageResult, MessageStreamChunkPayload as ProtoMessageStreamChunkPayload, MessageStreamErrorPayload as ProtoMessageStreamErrorPayload, TargetInfo as ProtoTargetInfo } from "./proto.js";
-import type { IAgentRuntime } from "./runtime";
-/**
- * Information describing the target of a message.
- */
-export interface TargetInfo extends ProtoTargetInfo {
-    roomId?: UUID;
-    entityId?: UUID;
-}
-/**
- * Function signature for handlers responsible for sending messages to specific platforms.
- */
-export type SendHandlerFunction = (runtime: IAgentRuntime, target: TargetInfo, content: Content) => Promise<void>;
-export declare enum SOCKET_MESSAGE_TYPE {
-    ROOM_JOINING = 1,
-    SEND_MESSAGE = 2,
-    MESSAGE = 3,
-    ACK = 4,
-    THINKING = 5,
-    CONTROL = 6
-}
-/**
- * WebSocket/SSE event names for message streaming.
- * Used for real-time streaming of agent responses to clients.
- *
- * Event flow:
- * 1. First `messageStreamChunk` indicates stream start
- * 2. Multiple `messageStreamChunk` events with text chunks
- * 3. `messageBroadcast` event with complete message (indicates stream end)
- * 4. `messageStreamError` if an error occurs during streaming
- */
-export declare const MESSAGE_STREAM_EVENT: {
-    /** Text chunk during streaming. First chunk indicates stream start. */
-    readonly messageStreamChunk: "messageStreamChunk";
-    /** Error occurred during streaming */
-    readonly messageStreamError: "messageStreamError";
-    /** Complete message broadcast (existing event, indicates stream end) */
-    readonly messageBroadcast: "messageBroadcast";
-};
-export type MessageStreamEventType = (typeof MESSAGE_STREAM_EVENT)[keyof typeof MESSAGE_STREAM_EVENT];
-/**
- * Payload for messageStreamChunk event
- * Uses camelCase for client-facing WebSocket events (JS convention)
- */
-export interface MessageStreamChunkPayload extends Omit<ProtoMessageStreamChunkPayload, "messageId" | "agentId"> {
-    messageId: UUID;
-    agentId: UUID;
-}
-/**
- * Payload for messageStreamError event
- * Uses camelCase for client-facing WebSocket events (JS convention)
- */
-export interface MessageStreamErrorPayload extends Omit<ProtoMessageStreamErrorPayload, "messageId" | "agentId"> {
-    messageId: UUID;
-    agentId: UUID;
-}
-/**
- * Control message actions that can be sent to the frontend
- */
-export type ControlMessageAction = "disable_input" | "enable_input";
-/**
- * Payload for UI control messages
- */
-export interface UIControlPayload {
-    /** Action to perform */
-    action: ControlMessageAction;
-    /** Optional target element identifier */
-    target?: string;
-    /** Optional reason for the action */
-    reason?: string;
-    /** Optional duration in milliseconds */
-    duration?: number;
-}
-/**
- * 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: UIControlPayload;
-    /** Room ID to ensure signal is directed to the correct chat window */
-    roomId: UUID;
-}
-/**
- * Handler options for async message processing (User → Agent)
- * Follows the core pattern: HandlerOptions, HandlerCallback, etc.
- */
-export interface MessageHandlerOptions {
-    /**
-     * Called when the agent generates a response
-     * If provided, method returns immediately (async mode)
-     * If not provided, method waits for response (sync mode)
-     */
-    onResponse?: (content: Content) => Promise<void>;
-    /**
-     * Called if an error occurs during processing
-     */
-    onError?: (error: Error) => Promise<void>;
-    /**
-     * Called when processing is complete
-     */
-    onComplete?: () => Promise<void>;
-}
-/**
- * Result of sending a message to an agent (User → Agent)
- * Follows the core pattern: ActionResult, ProviderResult, GenerateTextResult, etc.
- */
-export interface MessageResult extends Omit<ProtoMessageResult, "messageId" | "userMessage" | "agentResponses"> {
-    messageId: UUID;
-    userMessage?: Memory;
-    agentResponses?: Content[];
-}
-//# sourceMappingURL=messaging.d.ts.map

package/dist/types/messaging.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"messaging.d.ts","sourceRoot":"","sources":["../../src/types/messaging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EACV,aAAa,IAAI,kBAAkB,EACnC,yBAAyB,IAAI,8BAA8B,EAC3D,yBAAyB,IAAI,8BAA8B,EAC3D,UAAU,IAAI,eAAe,EAC9B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,eAAe;IACjD,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,QAAQ,CAAC,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,oBAAY,mBAAmB;IAC7B,YAAY,IAAI;IAChB,YAAY,IAAI;IAChB,OAAO,IAAI;IACX,GAAG,IAAI;IACP,QAAQ,IAAI;IACZ,OAAO,IAAI;CACZ;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB;IAC/B,uEAAuE;;IAEvE,sCAAsC;;IAEtC,wEAAwE;;CAEhE,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAChC,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAC;AAEnE;;;GAGG;AACH,MAAM,WAAW,yBACf,SAAQ,IAAI,CAAC,8BAA8B,EAAE,WAAW,GAAG,SAAS,CAAC;IACrE,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,yBACf,SAAQ,IAAI,CAAC,8BAA8B,EAAE,WAAW,GAAG,SAAS,CAAC;IACrE,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,eAAe,GAAG,cAAc,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB;IACxB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,8BAA8B;IAC9B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,sEAAsE;IACtE,MAAM,EAAE,IAAI,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,aACf,SAAQ,IAAI,CACV,kBAAkB,EAClB,WAAW,GAAG,aAAa,GAAG,gBAAgB,CAC/C;IACD,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;CAC5B"}