@elizaos/core 2.0.0-alpha.7 → 2.0.0-alpha.71

package/dist/search.d.ts

@@ -1,316 +0,0 @@
-/**
- * Interface for tokenization statistics.
- */
-interface TokenizationStats {
-    /** Number of words in the original text before any processing. */
-    originalWordCount: number;
-    /** Number of words removed because they were identified as stop words. */
-    stopWordsRemoved: number;
-    /** Number of words that were stemmed (only if stemming is enabled). */
-    stemmedWords: number;
-    /** Time taken for tokenization in milliseconds. */
-    processingTimeMs: number;
-}
-/**
- * Interface for the result of tokenization.
- */
-interface TokenizationResult {
-    /** Array of processed tokens (words). */
-    tokens: string[];
-    /** Optional statistics about the tokenization process. */
-    stats?: TokenizationStats;
-}
-/**
- * Interface for stemming rules.
- */
-interface StemmingRule {
-    /** A RegExp pattern or string to match suffixes. */
-    pattern: RegExp | string;
-    /** The replacement string or function. */
-    replacement: string | ((substring: string, ...args: unknown[]) => string);
-    /** Optional minimum measure (complexity) of the word stem for the rule to apply. */
-    minMeasure?: number;
-}
-/**
- * Options for configuring the Tokenizer.
- */
-interface TokenizerOptions {
-    /** A set of words to be ignored during tokenization. Defaults to an empty set. */
-    stopWords?: Set<string>;
-    /** The minimum length for a token to be kept. Defaults to 2. Numeric tokens are always kept. */
-    minLength?: number;
-    /** Whether to apply stemming to tokens. Defaults to false. */
-    stemming?: boolean;
-    /** Custom stemming rules to apply before the default Porter2 stemmer. Defaults to an empty array. */
-    stemmingRules?: StemmingRule[];
-}
-/**
- * Flexible text tokenizer with support for stop words, minimum token length,
- * Unicode normalization, and optional Porter2 stemming with custom rules.
- */
-declare class Tokenizer {
-    /** Set of stop words to ignore. */
-    readonly stopWords: Set<string>;
-    /** Minimum length of tokens to keep. */
-    readonly minLength: number;
-    /** Flag indicating if stemming is enabled. */
-    readonly stemming: boolean;
-    /** Custom stemming rules. */
-    readonly stemmingRules: {
-        pattern: RegExp;
-        replacement: string | ((substring: string, ...args: unknown[]) => string);
-        minMeasure?: number;
-    }[];
-    /** Default options for the Tokenizer. */
-    static readonly DEFAULT_OPTIONS: Required<TokenizerOptions>;
-    /**
-     * Creates a new tokenizer instance.
-     * @param options - Tokenization options including stop words, min length, stemming, and custom rules.
-     */
-    constructor(options?: TokenizerOptions);
-    /**
-     * Tokenizes input text into an array of processed terms.
-     * Steps:
-     * 1. Cleans the text (lowercase, normalize, remove punctuation/symbols).
-     * 2. Splits the text into potential tokens.
-     * 3. Filters tokens based on `minLength` and `stopWords`.
-     * 4. Applies stemming if `stemming` is true (custom rules first, then Porter2).
-     * 5. Optionally calculates statistics.
-     *
-     * @param text - The input text string to tokenize.
-     * @param includeStats - If true, returns tokenization statistics along with tokens. Defaults to false.
-     * @returns A `TokenizationResult` object containing the array of tokens and optional stats.
-     * @throws {Error} If the input text is null, undefined, or empty.
-     */
-    tokenize(text: string, includeStats?: boolean): TokenizationResult;
-    /**
-     * Cleans and normalizes text for tokenization.
-     * - Converts to lowercase.
-     * - Normalizes Unicode characters (NFKD).
-     * - Removes control characters and zero-width spaces.
-     * - Removes diacritical marks (accents).
-     * - Removes emojis and pictographs.
-     * - Removes common symbols (™, ®, ©, ℠, ‼).
-     * - Replaces Unicode punctuation with spaces.
-     * - Removes characters not matching basic Latin, CJK, Hangul, or whitespace.
-     * - Collapses multiple spaces into single spaces.
-     * - Trims leading/trailing whitespace.
-     *
-     * @param text - Input text to clean.
-     * @returns Cleaned and normalized text, ready for splitting into tokens.
-     *
-     * @example
-     * cleanText("Hello, World™!") // "hello world"
-     * cleanText("héllo 👋") // "hello"
-     * cleanText("Hello 世界!") // "hello 世界"
-     * cleanText("I'm don't") // "i'm don't" (apostrophes kept by replacing punctuation with space)
-     * cleanText("test©2023") // "test 2023"
-     */
-    cleanText(text: string): string;
-    /**
-     * Checks if a token is valid (meets `minLength` criteria and is not a stop word).
-     * Numeric tokens are always considered valid regardless of length.
-     * @param token - The token string to validate.
-     * @returns `true` if the token is valid, `false` otherwise.
-     */
-    isValidToken(token: string): boolean;
-    /**
-     * Applies stemming to a single word.
-     * First, tries to apply custom stemming rules defined in `stemmingRules`.
-     * If no custom rule matches, applies the default Porter2 stemming algorithm.
-     * Words shorter than 3 characters are not stemmed.
-     * @param word - The word to stem.
-     * @returns The stemmed word.
-     */
-    stemWord(word: string): string;
-    /**
-     * Checks if the character at a given index in a word is a consonant.
-     * Treats 'y' as a consonant if it's the first letter or follows a consonant.
-     * @param word - The word string.
-     * @param i - The index of the character to check.
-     * @returns `true` if the character is a consonant, `false` otherwise.
-     */
-    isConsonant(word: string, i: number): boolean;
-    /**
-     * Calculates the "measure" of a word stem (approximates syllable count).
-     * The measure (m) is the number of times a sequence of vowels is followed by a
-     * sequence of consonants (VC). Used in some stemming rules.
-     * Example: measure("tree") = 0, measure("trouble") = 1, measure("private") = 2
-     * @param word - The word (or stem) to measure.
-     * @returns The measure (m) of the word.
-     */
-    measure(word: string): number;
-}
-/**
- * BM25 Options Interface.
- * Extends TokenizerOptions and adds BM25 specific parameters.
- */
-interface BM25Options extends TokenizerOptions {
-    /**
-     * Term frequency saturation parameter (k1). Controls how quickly term frequency
-     * saturates. Higher values mean TF contributes more significantly even for high counts.
-     * Typical values are between 1.2 and 2.0. Default: 1.2.
-     */
-    k1?: number;
-    /**
-     * Document length normalization parameter (b). Controls the influence of document
-     * length. 0 means no length normalization, 1 means full normalization.
-     * Typical values are around 0.75. Default: 0.75.
-     */
-    b?: number;
-    /**
-     * A dictionary defining boost factors for specific document fields.
-     * Terms found in fields with higher boost factors will contribute more to the score.
-     * Example: `{ title: 2, body: 1 }`. Default: `{}` (no boosts).
-     */
-    fieldBoosts?: {
-        [key: string]: number;
-    };
-}
-/**
- * Represents a search result item.
- */
-interface SearchResult {
-    /** The index of the matching document in the original document array. */
-    index: number;
-    /** The BM25 relevance score for the document. Higher scores indicate better relevance. */
-    score: number;
-    /** The actual document object (optional, depends on how results are retrieved). */
-    doc?: Record<string, unknown>;
-}
-/**
- * Implements the Okapi BM25 (Best Matching 25) ranking function for information retrieval.
- *
- * BM25 ranks documents based on the query terms appearing in each document,
- * considering term frequency (TF) and inverse document frequency (IDF).
- * It improves upon basic TF-IDF by incorporating:
- * - Term Frequency Saturation (k1): Prevents overly frequent terms from dominating the score.
- * - Document Length Normalization (b): Penalizes documents that are longer than average,
- *   assuming longer documents are more likely to contain query terms by chance.
- *
- * Key Components:
- * - Tokenizer: Processes text into terms (words), handles stop words and stemming.
- * - Document Indexing: Stores document lengths, term frequencies per document,
- *   and overall document frequency for each term.
- * - IDF Calculation: Measures the informativeness of a term based on how many documents contain it.
- * - Scoring: Combines TF, IDF, document length, and parameters k1/b to calculate relevance.
- */
-export declare class BM25 {
-    /** Term frequency saturation parameter (k1). */
-    readonly termFrequencySaturation: number;
-    /** Document length normalization factor (b). */
-    readonly lengthNormalizationFactor: number;
-    /** Tokenizer instance used for processing text. */
-    readonly tokenizer: Tokenizer;
-    /** Array storing the length (number of tokens, adjusted by field boosts) of each document. */
-    documentLengths: Uint32Array;
-    /** Average length of all documents in the index. */
-    averageDocLength: number;
-    /** Map from term (string) to its unique integer index. */
-    termToIndex: Map<string, number>;
-    /** Array storing the document frequency (number of docs containing the term) for each term index. */
-    documentFrequency: Uint32Array;
-    /** Map from term index to another map storing `docIndex: termFrequencyInDoc`. */
-    termFrequencies: Map<number, Map<number, number>>;
-    /** Boost factors for different fields within documents. */
-    readonly fieldBoosts: {
-        [key: string]: number;
-    };
-    /** Array storing the original documents added to the index. */
-    documents: Array<Record<string, unknown>>;
-    /**
-     * Creates a new BM25 search instance.
-     * @param docs - Optional array of initial documents (objects with string fields) to index.
-     * @param options - Configuration options for BM25 parameters (k1, b), tokenizer (stopWords, stemming, minLength), and field boosts.
-     */
-    constructor(docs?: Array<Record<string, unknown>>, options?: BM25Options);
-    /**
-     * Processes an array of documents to build the initial index structures.
-     * Calculates document lengths, term frequencies, document frequencies, and average document length.
-     * @param docs - Array of documents to process.
-     * @returns An object containing the calculated index data.
-     * @internal
-     */
-    private processDocuments;
-    /**
-     * Recalculates the average document length based on the current `documentLengths`.
-     * @internal
-     */
-    private recalculateAverageLength;
-    /**
-     * Searches the indexed documents for a given query string using the BM25 ranking formula.
-     *
-     * @param query - The search query text.
-     * @param topK - The maximum number of top-scoring results to return. Defaults to 10.
-     * @returns An array of `SearchResult` objects, sorted by descending BM25 score.
-     */
-    search(query: string, topK?: number): SearchResult[];
-    /**
-     * Searches for an exact phrase within the indexed documents.
-     * Ranks documents containing the exact sequence of tokens higher.
-     * Note: This is a basic implementation. More sophisticated phrase search might consider proximity.
-     *
-     * @param phrase - The exact phrase to search for.
-     * @param topK - The maximum number of results to return. Defaults to 10.
-     * @returns An array of `SearchResult` objects, sorted by score, for documents containing the phrase.
-     */
-    searchPhrase(phrase: string, topK?: number): SearchResult[];
-    /**
-     * Calculates a BM25-like score for a sequence of phrase tokens within a specific document.
-     * Sums the individual BM25 scores of the terms in the phrase for that document.
-     * @param phraseTokens - The tokenized phrase.
-     * @param docIndex - The index of the document to score against.
-     * @returns The calculated phrase score for the document.
-     * @internal
-     */
-    private calculatePhraseScore;
-    /**
-     * Adds a single new document to the index.
-     * Updates all internal index structures incrementally.
-     * Note: For adding many documents, `addDocumentsParallel` is generally more efficient.
-     *
-     * @param doc - The document object (with string fields) to add.
-     * @throws {Error} If the document is null or undefined.
-     */
-    addDocument(doc: Record<string, unknown>): Promise<void>;
-    /**
-     * Calculates the Inverse Document Frequency (IDF) for a given term index.
-     * Uses the BM25 IDF formula: log(1 + (N - n + 0.5) / (n + 0.5))
-     * where N is the total number of documents and n is the number of documents
-     * containing the term. The +1 smooths the logarithm.
-     *
-     * @param termIndex - The integer index of the term.
-     * @returns The IDF score for the term. Returns 0 if the term is not found or has 0 DF.
-     */
-    calculateIdf(termIndex: number): number;
-    /**
-     * Retrieves the term frequency (TF) for a specific term in a specific document.
-     * @param termIndex - The integer index of the term.
-     * @param docIndex - The index of the document.
-     * @returns The term frequency, or 0 if the term is not in the document or indices are invalid.
-     */
-    getTermFrequency(termIndex: number, docIndex: number): number;
-    /**
-     * Retrieves the original document object stored at a given index.
-     * @param index - The index of the document to retrieve.
-     * @returns The document object.
-     * @throws {Error} If the index is out of bounds.
-     */
-    getDocument(index: number): Record<string, unknown>;
-    /**
-     * Clears all indexed documents and resets the BM25 instance to its initial state.
-     */
-    clearDocuments(): void;
-    /**
-     * Gets the total number of documents currently indexed.
-     * @returns The document count.
-     */
-    getDocumentCount(): number;
-    /**
-     * Adds multiple documents sequentially by calling `addDocument` for each.
-     * This method processes documents sequentially in the main thread.
-     * @param docs - An array of documents to add.
-     */
-    addDocuments(docs: Array<Record<string, unknown>>): Promise<void[]>;
-}
-export {};

package/dist/search.d.ts.map

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

package/dist/secrets.d.ts

@@ -1,11 +0,0 @@
-import { type Character } from './types';
-export declare function setAllowedEnvVars(vars: Set<string> | null): void;
-export declare function getAllowedEnvVars(): Set<string> | null;
-export declare function hasCharacterSecrets(character: Character): boolean;
-/**
- * Merges process.env into character.settings.secrets with character values taking precedence.
- * Node.js-only - returns false in browser environments.
- */
-export declare function setDefaultSecretsFromEnv(character: Character, options?: {
-    skipEnvMerge?: boolean;
-}): Promise<boolean>;

package/dist/secrets.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAKzC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,IAAI,CAEhE;AAED,wBAAgB,iBAAiB,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAEtD;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CASjE;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GACnC,OAAO,CAAC,OAAO,CAAC,CAoClB"}

package/dist/services/default-message-service.d.ts

@@ -1,69 +0,0 @@
-import type { IAgentRuntime } from '../types/runtime';
-import type { Memory } from '../types/memory';
-import type { UUID, Media, MentionContext } from '../types/primitives';
-import type { HandlerCallback } from '../types/components';
-import type { Room } from '../types/environment';
-import { type IMessageService, type MessageProcessingOptions, type MessageProcessingResult, type ResponseDecision } from './message-service';
-/**
- * Default implementation of the MessageService interface.
- * This service handles the complete message processing pipeline including:
- * - Message validation and memory creation
- * - Smart response decision (shouldRespond)
- * - Single-shot or multi-step processing strategies
- * - Action execution and evaluation
- * - Attachment processing
- * - Message deletion and channel clearing
- *
- * This is the standard message handler used by ElizaOS and can be replaced
- * with custom implementations via the IMessageService interface.
- */
-export declare class DefaultMessageService implements IMessageService {
-    /**
-     * Main message handling entry point
-     */
-    handleMessage(runtime: IAgentRuntime, message: Memory, callback?: HandlerCallback, options?: MessageProcessingOptions): Promise<MessageProcessingResult>;
-    /**
-     * Internal message processing implementation
-     */
-    private processMessage;
-    /**
-     * Determines whether the agent should respond to a message.
-     * Uses simple rules for obvious cases (DM, mentions) and defers to LLM for ambiguous cases.
-     */
-    shouldRespond(runtime: IAgentRuntime, message: Memory, room?: Room, mentionContext?: MentionContext): ResponseDecision;
-    /**
-     * Processes attachments by generating descriptions for supported media types.
-     */
-    processAttachments(runtime: IAgentRuntime, attachments: Media[]): Promise<Media[]>;
-    /**
-     * Single-shot strategy: one LLM call to generate response
-     */
-    private runSingleShotCore;
-    /**
-     * Multi-step strategy: iterative action execution with final summary
-     */
-    private runMultiStepCore;
-    /**
-     * Helper to emit run ended events
-     */
-    private emitRunEnded;
-    /**
-     * 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>;
-}

package/dist/services/default-message-service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"default-message-service.d.ts","sourceRoot":"","sources":["../../src/services/default-message-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAW,IAAI,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEhF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACtB,MAAM,mBAAmB,CAAC;AAyF3B;;;;;;;;;;;;GAYG;AACH,qBAAa,qBAAsB,YAAW,eAAe;IAC3D;;OAEG;IACG,aAAa,CACjB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,eAAe,EAC1B,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,uBAAuB,CAAC;IA+GnC;;OAEG;YACW,cAAc;IAmc5B;;;OAGG;IACH,aAAa,CACX,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,IAAI,EACX,cAAc,CAAC,EAAE,cAAc,GAC9B,gBAAgB;IAyEnB;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IA+IxF;;OAEG;YACW,iBAAiB;IAkR/B;;OAEG;YACW,gBAAgB;IAovB9B;;OAEG;YACW,YAAY;IAqB1B;;;;;;;OAOG;IACG,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiC3E;;;;;;;;OAQG;IACG,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAoD3F"}

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

@@ -1,171 +0,0 @@
-import type { IAgentRuntime } from '../types/runtime';
-import type { Memory } from '../types/memory';
-import type { Content, UUID, Media } from '../types/primitives';
-import type { State } from '../types/state';
-import type { HandlerCallback } from '../types/components';
-import type { Room } from '../types/environment';
-import type { MentionContext } from '../types/primitives';
-/**
- * Configuration options for message processing
- */
-export interface MessageProcessingOptions {
-    /**
-     * Maximum number of retries for LLM calls if required fields are missing
-     * @default 3
-     */
-    maxRetries?: number;
-    /**
-     * Timeout for message processing in milliseconds
-     * @default 3600000 (1 hour)
-     */
-    timeoutDuration?: number;
-    /**
-     * Whether to use multi-step workflow
-     * @default false
-     */
-    useMultiStep?: boolean;
-    /**
-     * Maximum number of iterations for multi-step workflow
-     * @default 6
-     */
-    maxMultiStepIterations?: number;
-    /**
-     * Called for each chunk of streaming text as it's generated.
-     * Streaming is enabled by default for all TEXT_* model types.
-     * The first chunk indicates streaming has started (useful for typing indicators).
-     *
-     * @param chunk - The text chunk being streamed
-     * @param messageId - ID of the message being generated
-     */
-    onStreamChunk?: (chunk: string, messageId?: UUID) => Promise<void>;
-}
-/**
- * Result of message processing
- */
-export interface MessageProcessingResult {
-    /**
-     * Whether the agent decided to respond
-     */
-    didRespond: boolean;
-    /**
-     * The response content generated by the agent
-     */
-    responseContent: Content | null;
-    /**
-     * Response messages generated
-     */
-    responseMessages: Memory[];
-    /**
-     * Final state after processing
-     */
-    state: State;
-    /**
-     * Processing mode used ('simple', 'actions', or 'none')
-     */
-    mode?: 'simple' | 'actions' | 'none';
-}
-/**
- * Response decision from the shouldRespond logic
- */
-export interface ResponseDecision {
-    /**
-     * Whether the agent should respond
-     */
-    shouldRespond: boolean;
-    /**
-     * Whether LLM evaluation can be skipped (decision made by rules)
-     */
-    skipEvaluation: boolean;
-    /**
-     * Reason for the decision (for debugging)
-     */
-    reason: string;
-}
-/**
- * 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>;
-}

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

@@ -1 +0,0 @@
-{"version":3,"file":"message-service.d.ts","sourceRoot":"","sources":["../../src/services/message-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAEhC;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,eAAe,EAAE,OAAO,GAAG,IAAI,CAAC;IAEhC;;OAEG;IACH,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAE3B;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC;IAEb;;OAEG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,aAAa,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,cAAc,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;OASG;IACH,aAAa,CACX,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,eAAe,EAC1B,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAEpC;;;;;;;;;OASG;IACH,aAAa,CACX,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,IAAI,EACX,cAAc,CAAC,EAAE,cAAc,GAC9B,gBAAgB,CAAC;IAEpB;;;;;;;OAOG;IACH,kBAAkB,CAAC,CAAC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAEpF;;;;;;;OAOG;IACH,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtE;;;;;;;;OAQG;IACH,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtF"}

package/dist/services.d.ts

@@ -1,56 +0,0 @@
-import { Service } from './types';
-import type { IAgentRuntime, ServiceTypeName } from './types';
-/**
- * Service builder class that provides type-safe service creation
- * with automatic type inference
- */
-export declare class ServiceBuilder<TService extends Service = Service> {
-    protected serviceType: ServiceTypeName | string;
-    protected startFn: (runtime: IAgentRuntime) => Promise<TService>;
-    protected stopFn?: () => Promise<void>;
-    protected description: string;
-    constructor(serviceType: ServiceTypeName | string);
-    /**
-     * Set the service description
-     */
-    withDescription(description: string): this;
-    /**
-     * Set the start function for the service
-     */
-    withStart(startFn: (runtime: IAgentRuntime) => Promise<TService>): this;
-    /**
-     * Set the stop function for the service
-     */
-    withStop(stopFn: () => Promise<void>): this;
-    /**
-     * Build the service class with all configured properties
-     */
-    build(): {
-        new (runtime?: IAgentRuntime): TService;
-        serviceType: string;
-        start(runtime: IAgentRuntime): Promise<TService>;
-    };
-}
-/**
- * Create a type-safe service builder
- * @param serviceType - The service type name
- * @returns A new ServiceBuilder instance
- */
-export declare function createService<TService extends Service = Service>(serviceType: ServiceTypeName | string): ServiceBuilder<TService>;
-/**
- * Type-safe service definition helper
- */
-export interface ServiceDefinition<T extends Service = Service> {
-    serviceType: ServiceTypeName;
-    description: string;
-    start: (runtime: IAgentRuntime) => Promise<T>;
-    stop?: () => Promise<void>;
-}
-/**
- * Define a service with type safety
- */
-export declare function defineService<T extends Service = Service>(definition: ServiceDefinition<T>): {
-    new (runtime?: IAgentRuntime): T;
-    serviceType: ServiceTypeName;
-    start(runtime: IAgentRuntime): Promise<T>;
-};

package/dist/services.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../src/services.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE9D;;;GAGG;AACH,qBAAa,cAAc,CAAC,QAAQ,SAAS,OAAO,GAAG,OAAO;IAC5D,SAAS,CAAC,WAAW,EAAE,eAAe,GAAG,MAAM,CAAC;IAChD,SAAS,CAAC,OAAO,EAAG,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClE,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC;gBAElB,WAAW,EAAE,eAAe,GAAG,MAAM;IAKjD;;OAEG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAK1C;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI;IAKvE;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAK3C;;OAEG;IACH,KAAK,IAAI;QACP,KAAK,OAAO,CAAC,EAAE,aAAa,GAAG,QAAQ,CAAC;QACxC,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;KAClD;CAiCF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,SAAS,OAAO,GAAG,OAAO,EAC9D,WAAW,EAAE,eAAe,GAAG,MAAM,GACpC,cAAc,CAAC,QAAQ,CAAC,CAE1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO;IAC5D,WAAW,EAAE,eAAe,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9C,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EACvD,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC/B;IACD,KAAK,OAAO,CAAC,EAAE,aAAa,GAAG,CAAC,CAAC;IACjC,WAAW,EAAE,eAAe,CAAC;IAC7B,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC3C,CAQA"}

package/dist/sessions/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * Session management utilities for ElizaOS.
- *
- * @module sessions
- */
-export { buildAcpSessionKey, buildAgentMainSessionKey, buildAgentPeerSessionKey, buildAgentSessionKey, buildGroupHistoryKey, buildSubagentSessionKey, DEFAULT_ACCOUNT_ID, DEFAULT_AGENT_ID, DEFAULT_MAIN_KEY, isAcpSessionKey, isSubagentSessionKey, normalizeAccountId, normalizeAgentId, normalizeMainKey, type ParsedAgentSessionKey, parseAgentSessionKey, resolveAgentIdFromSessionKey, resolveThreadParentSessionKey, resolveThreadSessionKeys, sanitizeAgentId, toAgentRequestSessionKey, toAgentStoreSessionKey, } from './session-key';
-export { createSessionEntry, DEFAULT_IDLE_MINUTES, DEFAULT_RESET_TRIGGER, DEFAULT_RESET_TRIGGERS, type GroupKeyResolution, isValidSessionEntry, mergeSessionEntry, type SessionChatType, type SessionDeliveryContext, type SessionEntry, type SessionOrigin, type SessionResolution, type SessionSkillsSnapshot, type SessionStore, } from './types';
-export { clearSessionStoreCacheForTest, deleteSessionEntry, getSessionEntry, getSessionEntryById, listSessionKeys, listSessions, loadSessionStore, type LoadSessionStoreOptions, readSessionUpdatedAt, saveSessionStore, updateSessionStore, updateSessionStoreEntry, upsertSessionEntry, } from './store';
-export { ensureSafeSessionPath, isWithinStateDir, resolveAgentSessionsDir, resolveDefaultSessionStorePath, resolveSessionFilePath, resolveSessionTranscriptPath, resolveSessionTranscriptsDir, resolveSessionTranscriptsDirForAgent, resolveStateDir, resolveStorePath, } from './paths';
-export { createSendPolicyProvider, createSessionProvider, createSessionSkillsProvider, extractSessionContext, getSessionProviders, SessionStateManager, } from './provider';