@elizaos/api-client 1.3.2 → 1.4.3-alpha.0

package/dist/core/src/schemas/character.d.ts

@@ -0,0 +1,228 @@
+import { z } from 'zod';
+import type { Character } from '../types/agent';
+export declare const characterSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    username: z.ZodOptional<z.ZodString>;
+    system: z.ZodOptional<z.ZodString>;
+    templates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>]>>>;
+    bio: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
+    messageExamples: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        content: z.ZodObject<{
+            text: z.ZodOptional<z.ZodString>;
+            thought: z.ZodOptional<z.ZodString>;
+            actions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            providers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            source: z.ZodOptional<z.ZodString>;
+            target: z.ZodOptional<z.ZodString>;
+            url: z.ZodOptional<z.ZodString>;
+            inReplyTo: z.ZodOptional<z.ZodString>;
+            attachments: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
+            channelType: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            text: z.ZodOptional<z.ZodString>;
+            thought: z.ZodOptional<z.ZodString>;
+            actions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            providers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            source: z.ZodOptional<z.ZodString>;
+            target: z.ZodOptional<z.ZodString>;
+            url: z.ZodOptional<z.ZodString>;
+            inReplyTo: z.ZodOptional<z.ZodString>;
+            attachments: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
+            channelType: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            text: z.ZodOptional<z.ZodString>;
+            thought: z.ZodOptional<z.ZodString>;
+            actions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            providers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            source: z.ZodOptional<z.ZodString>;
+            target: z.ZodOptional<z.ZodString>;
+            url: z.ZodOptional<z.ZodString>;
+            inReplyTo: z.ZodOptional<z.ZodString>;
+            attachments: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
+            channelType: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>;
+    }, "strip", z.ZodTypeAny, {
+        content: {
+            thought?: string | undefined;
+            text?: string | undefined;
+            actions?: string[] | undefined;
+            providers?: string[] | undefined;
+            source?: string | undefined;
+            target?: string | undefined;
+            url?: string | undefined;
+            inReplyTo?: string | undefined;
+            attachments?: any[] | undefined;
+            channelType?: string | undefined;
+        } & {
+            [k: string]: unknown;
+        };
+        name: string;
+    }, {
+        content: {
+            thought?: string | undefined;
+            text?: string | undefined;
+            actions?: string[] | undefined;
+            providers?: string[] | undefined;
+            source?: string | undefined;
+            target?: string | undefined;
+            url?: string | undefined;
+            inReplyTo?: string | undefined;
+            attachments?: any[] | undefined;
+            channelType?: string | undefined;
+        } & {
+            [k: string]: unknown;
+        };
+        name: string;
+    }>, "many">, "many">>;
+    postExamples: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    adjectives: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    knowledge: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        path: z.ZodString;
+        shared: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        shared?: boolean | undefined;
+    }, {
+        path: string;
+        shared?: boolean | undefined;
+    }>, z.ZodObject<{
+        directory: z.ZodString;
+        shared: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        directory: string;
+        shared?: boolean | undefined;
+    }, {
+        directory: string;
+        shared?: boolean | undefined;
+    }>]>, "many">>;
+    plugins: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodBoolean, z.ZodNumber, z.ZodAny]>>>;
+    secrets: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodBoolean, z.ZodNumber]>>>;
+    style: z.ZodOptional<z.ZodObject<{
+        all: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        chat: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        post: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        post?: string[] | undefined;
+        all?: string[] | undefined;
+        chat?: string[] | undefined;
+    }, {
+        post?: string[] | undefined;
+        all?: string[] | undefined;
+        chat?: string[] | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    bio: string | string[];
+    knowledge?: (string | {
+        directory: string;
+        shared?: boolean | undefined;
+    } | {
+        path: string;
+        shared?: boolean | undefined;
+    })[] | undefined;
+    username?: string | undefined;
+    id?: string | undefined;
+    system?: string | undefined;
+    templates?: Record<string, string | ((...args: unknown[]) => unknown) | undefined> | undefined;
+    messageExamples?: {
+        content: {
+            thought?: string | undefined;
+            text?: string | undefined;
+            actions?: string[] | undefined;
+            providers?: string[] | undefined;
+            source?: string | undefined;
+            target?: string | undefined;
+            url?: string | undefined;
+            inReplyTo?: string | undefined;
+            attachments?: any[] | undefined;
+            channelType?: string | undefined;
+        } & {
+            [k: string]: unknown;
+        };
+        name: string;
+    }[][] | undefined;
+    postExamples?: string[] | undefined;
+    topics?: string[] | undefined;
+    adjectives?: string[] | undefined;
+    plugins?: string[] | undefined;
+    settings?: Record<string, any> | undefined;
+    secrets?: Record<string, string | number | boolean> | undefined;
+    style?: {
+        post?: string[] | undefined;
+        all?: string[] | undefined;
+        chat?: string[] | undefined;
+    } | undefined;
+}, {
+    name: string;
+    bio: string | string[];
+    knowledge?: (string | {
+        directory: string;
+        shared?: boolean | undefined;
+    } | {
+        path: string;
+        shared?: boolean | undefined;
+    })[] | undefined;
+    username?: string | undefined;
+    id?: string | undefined;
+    system?: string | undefined;
+    templates?: Record<string, string | ((...args: unknown[]) => unknown) | undefined> | undefined;
+    messageExamples?: {
+        content: {
+            thought?: string | undefined;
+            text?: string | undefined;
+            actions?: string[] | undefined;
+            providers?: string[] | undefined;
+            source?: string | undefined;
+            target?: string | undefined;
+            url?: string | undefined;
+            inReplyTo?: string | undefined;
+            attachments?: any[] | undefined;
+            channelType?: string | undefined;
+        } & {
+            [k: string]: unknown;
+        };
+        name: string;
+    }[][] | undefined;
+    postExamples?: string[] | undefined;
+    topics?: string[] | undefined;
+    adjectives?: string[] | undefined;
+    plugins?: string[] | undefined;
+    settings?: Record<string, any> | undefined;
+    secrets?: Record<string, string | number | boolean> | undefined;
+    style?: {
+        post?: string[] | undefined;
+        all?: string[] | undefined;
+        chat?: string[] | undefined;
+    } | undefined;
+}>;
+export interface CharacterValidationResult {
+    success: boolean;
+    data?: Character;
+    error?: {
+        message: string;
+        issues?: z.ZodIssue[];
+    };
+}
+/**
+ * Safely validates character data using Zod schema
+ * @param data - Raw character data to validate
+ * @returns Validation result with success flag and either data or error
+ */
+export declare function validateCharacter(data: unknown): CharacterValidationResult;
+/**
+ * Safely parses JSON string and validates as character
+ * @param jsonString - JSON string to parse and validate
+ * @returns Validation result with success flag and either data or error
+ */
+export declare function parseAndValidateCharacter(jsonString: string): CharacterValidationResult;
+/**
+ * Type guard to check if data is a valid Character
+ * @param data - Data to check
+ * @returns True if data is a valid Character
+ */
+export declare function isValidCharacter(data: unknown): data is Character;
+//# sourceMappingURL=character.d.ts.map

package/dist/core/src/schemas/character.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"character.d.ts","sourceRoot":"","sources":["../../../../../core/src/schemas/character.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAmEhD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBjB,CAAC;AAGZ,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;KACvB,CAAC;CACH;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,yBAAyB,CAiB1E;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,yBAAyB,CAYvF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,SAAS,CAEjE"}

package/dist/core/src/search.d.ts

@@ -0,0 +1,317 @@
+/**
+ * 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: any[]) => 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: any[]) => 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?: any;
+}
+/**
+ * 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: any[];
+    /**
+     * 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?: any[], 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: any): 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): any;
+    /**
+     * 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: any[]): Promise<void[]>;
+}
+export {};
+//# sourceMappingURL=search.d.ts.map

package/dist/core/src/search.d.ts.map

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

package/dist/core/src/sentry/instrument.d.ts

@@ -0,0 +1,12 @@
+type SentryModule = {
+    init: (options: Record<string, any>) => void;
+    captureException: (error: unknown) => void;
+    flush?: (timeout?: number) => Promise<boolean>;
+    onLoad?: (cb: () => void) => void;
+};
+export declare const Sentry: {
+    captureException(error: unknown): Promise<void>;
+    flush(timeout?: number): Promise<boolean>;
+};
+export type { SentryModule };
+//# sourceMappingURL=instrument.d.ts.map

package/dist/core/src/sentry/instrument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrument.d.ts","sourceRoot":"","sources":["../../../../../core/src/sentry/instrument.ts"],"names":[],"mappings":"AAEA,KAAK,YAAY,GAAG;IAClB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;IAC7C,gBAAgB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CACnC,CAAC;AA0DF,eAAO,MAAM,MAAM;4BACa,OAAO;oBAMf,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAOhD,CAAC;AAEF,YAAY,EAAE,YAAY,EAAE,CAAC"}

package/dist/core/src/services.d.ts

@@ -0,0 +1,49 @@
+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;
+}
+/**
+ * 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;
+//# sourceMappingURL=services.d.ts.map

package/dist/core/src/services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../../core/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,KAAK,OAAO,CAAC,EAAE,aAAa,KAAK,QAAQ;CAyBnD;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,KAAK,OAAO,CAAC,EAAE,aAAa,KAAK,CAAC,CAMpC"}