@elizaos/test-utils 1.4.5 → 1.5.0

package/dist/src/DatabaseTestRegistry.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Database testing registry - ensures consistent database testing across all packages
+ * Replaces fragile database adapter fallback logic with explicit test database management
+ */
+import type { IDatabaseAdapter } from '@elizaos/core';
+export interface DatabaseTestCapabilities {
+    isReady: boolean;
+    tables: string[];
+    supportsTransactions: boolean;
+    adapter: string;
+}
+export interface TestDatabaseConfig {
+    /** Database type preference */
+    preferredAdapter: 'postgresql' | 'auto';
+    /** Whether to allow fallback to mock */
+    allowMockFallback: boolean;
+    /** Test isolation level */
+    isolation: 'shared' | 'per-test' | 'per-suite';
+    /** Connection timeout */
+    timeoutMs: number;
+    /** Test data persistence */
+    persistData: boolean;
+}
+export declare const DEFAULT_TEST_DB_CONFIG: TestDatabaseConfig;
+/**
+ * Centralized database testing management
+ */
+export declare class DatabaseTestRegistry {
+    private static instance;
+    private adapterCache;
+    private testDatabases;
+    private defaultConfig;
+    private constructor();
+    static getInstance(config?: TestDatabaseConfig): DatabaseTestRegistry;
+    /**
+     * Get a test database adapter with explicit requirements
+     */
+    getTestDatabase(testId: string, config?: Partial<TestDatabaseConfig>): Promise<TestDatabaseInstance>;
+    private createTestDatabase;
+    private createMockAdapter;
+    private getAdapterCapabilities;
+    private initializeTestSchema;
+    private validateDatabaseInstance;
+    /**
+     * Clean up a specific test database
+     */
+    cleanupTestDatabase(testId: string): Promise<void>;
+    /**
+     * Clean up all test databases
+     */
+    cleanupAll(): Promise<void>;
+    /**
+     * Validate test requirements before running tests
+     */
+    validateTestRequirements(requirements: DatabaseTestRequirements): Promise<DatabaseValidationResult>;
+    /**
+     * Get test database statistics
+     */
+    getTestDatabaseStats(): TestDatabaseStats;
+}
+export interface TestDatabaseInstance {
+    testId: string;
+    adapter: IDatabaseAdapter;
+    capabilities: DatabaseTestCapabilities;
+    config: TestDatabaseConfig;
+    createdAt: Date;
+    adapterType: string;
+}
+export interface DatabaseTestRequirements {
+    requiredAdapters: 'postgresql'[];
+    performanceRequirements?: {
+        maxQueryTime: number;
+        maxConnectionTime: number;
+    };
+}
+export interface DatabaseValidationResult {
+    isValid: boolean;
+    _errors: string[];
+    warnings: string[];
+    recommendations: string[];
+}
+export interface TestDatabaseStats {
+    totalDatabases: number;
+    adapterTypes: Map<string, number>;
+    oldestDatabase: TestDatabaseInstance | null;
+    newestDatabase: TestDatabaseInstance | null;
+}
+//# sourceMappingURL=DatabaseTestRegistry.d.ts.map

package/dist/src/DatabaseTestRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseTestRegistry.d.ts","sourceRoot":"","sources":["../../src/DatabaseTestRegistry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAQ,MAAM,eAAe,CAAC;AAE5D,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,gBAAgB,EAAE,YAAY,GAAG,MAAM,CAAC;IACxC,wCAAwC;IACxC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,2BAA2B;IAC3B,SAAS,EAAE,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;IAC/C,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,eAAO,MAAM,sBAAsB,EAAE,kBAMpC,CAAC;AAEF;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuB;IAC9C,OAAO,CAAC,YAAY,CAAuC;IAC3D,OAAO,CAAC,aAAa,CAA2C;IAChE,OAAO,CAAC,aAAa,CAAqB;IAE1C,OAAO;IAIP,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,oBAAoB;IAOrE;;OAEG;IACG,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM,GACvC,OAAO,CAAC,oBAAoB,CAAC;YAoBlB,kBAAkB;YA8BlB,iBAAiB;YAMjB,sBAAsB;YA8BtB,oBAAoB;YAWpB,wBAAwB;IAStC;;OAEG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBxD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IASjC;;OAEG;IACG,wBAAwB,CAC5B,YAAY,EAAE,wBAAwB,GACrC,OAAO,CAAC,wBAAwB,CAAC;IAsCpC;;OAEG;IACH,oBAAoB,IAAI,iBAAiB;CAwB1C;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,gBAAgB,CAAC;IAC1B,YAAY,EAAE,wBAAwB,CAAC;IACvC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,gBAAgB,EAAE,YAAY,EAAE,CAAC;IACjC,uBAAuB,CAAC,EAAE;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,cAAc,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC5C,cAAc,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAC7C"}

package/dist/src/TestInfrastructure.d.ts

@@ -0,0 +1,64 @@
+import type { IAgentRuntime, IDatabaseAdapter, UUID, Memory } from '@elizaos/core';
+export interface TestEnvironmentConfig {
+    /** Test isolation level */
+    isolation: 'unit' | 'integration' | 'e2e';
+    /** Use real database vs in-memory */
+    useRealDatabase: boolean;
+    /** Performance thresholds */
+    performanceThresholds?: PerformanceThresholds;
+    /** Test data configuration */
+    testData?: TestDataConfig;
+}
+export interface PerformanceThresholds {
+    actionExecution: number;
+    memoryRetrieval: number;
+    databaseQuery: number;
+    modelInference: number;
+}
+export interface TestDataConfig {
+    entities: number;
+    memories: number;
+    messages: number;
+    relationships: number;
+}
+export declare const DEFAULT_PERFORMANCE_THRESHOLDS: PerformanceThresholds;
+export declare const DEFAULT_TEST_DATA: TestDataConfig;
+/**
+ * Test environment manager - ensures proper setup/teardown
+ */
+export declare class TestEnvironment {
+    private static activeEnvironments;
+    private runtime;
+    private databaseAdapter;
+    private testId;
+    private config;
+    constructor(testId: string, config: TestEnvironmentConfig);
+    static create(testId: string, config?: Partial<TestEnvironmentConfig>): Promise<TestEnvironment>;
+    private setup;
+    private createTestCharacter;
+    private seedTestData;
+    teardown(): Promise<void>;
+    private cleanupTestData;
+    static teardownAll(): Promise<void>;
+    get testRuntime(): IAgentRuntime;
+    get testDatabase(): IDatabaseAdapter;
+    /**
+     * Performance monitoring wrapper
+     */
+    measurePerformance<T>(operation: () => Promise<T>, threshold: keyof PerformanceThresholds, description: string): Promise<T>;
+}
+/**
+ * Test data builder for creating realistic test scenarios
+ */
+export declare class TestDataBuilder {
+    static createEntity(runtime: IAgentRuntime, data: {
+        names: string[];
+        metadata?: Record<string, any>;
+    }): Promise<UUID>;
+    static createTestConversation(runtime: IAgentRuntime, participants: string[], messageCount?: number): Promise<{
+        roomId: `${string}-${string}-${string}-${string}-${string}`;
+        messages: Memory[];
+    }>;
+    static createTestMemories(runtime: IAgentRuntime, roomId: string, count?: number): Promise<Memory[]>;
+}
+//# sourceMappingURL=TestInfrastructure.d.ts.map

package/dist/src/TestInfrastructure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestInfrastructure.d.ts","sourceRoot":"","sources":["../../src/TestInfrastructure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,IAAI,EAAa,MAAM,EAAE,MAAM,eAAe,CAAC;AAK9F,MAAM,WAAW,qBAAqB;IACpC,2BAA2B;IAC3B,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,KAAK,CAAC;IAC1C,qCAAqC;IACrC,eAAe,EAAE,OAAO,CAAC;IACzB,6BAA6B;IAC7B,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,8BAA8B,EAAE,qBAK5C,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAK/B,CAAC;AAEF;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAsC;IACvE,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,eAAe,CAAiC;IACxD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAwB;gBAE1B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB;WAK5C,MAAM,CACjB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,OAAO,CAAC,qBAAqB,CAAM,GAC1C,OAAO,CAAC,eAAe,CAAC;YAgBb,KAAK;IAmCnB,OAAO,CAAC,mBAAmB;YAeb,YAAY;IAwBpB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAcjB,eAAe;WAchB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IASzC,IAAI,WAAW,IAAI,aAAa,CAK/B;IAED,IAAI,YAAY,IAAI,gBAAgB,CAKnC;IAED;;OAEG;IACG,kBAAkB,CAAC,CAAC,EACxB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,SAAS,EAAE,MAAM,qBAAqB,EACtC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,CAAC,CAAC;CAcd;AAED;;GAEG;AACH,qBAAa,eAAe;WACb,YAAY,CACvB,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAChC,GACA,OAAO,CAAC,IAAI,CAAC;WAWH,sBAAsB,CACjC,OAAO,EAAE,aAAa,EACtB,YAAY,EAAE,MAAM,EAAE,EACtB,YAAY,GAAE,MAAU;;;;WA4Bb,kBAAkB,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW;CAkB3F"}

package/dist/src/factories.d.ts

@@ -0,0 +1,141 @@
+/**
+ * @fileoverview Factory functions for creating complete test scenarios
+ *
+ * This module provides high-level factory functions that combine multiple
+ * mock objects to create realistic testing scenarios.
+ */
+import type { IAgentRuntime, Memory, State, Action, Provider, Evaluator, UUID, ActionResult } from '@elizaos/core';
+/**
+ * Create a complete test environment with runtime, character, and conversation
+ *
+ * @param options - Configuration options for the test environment
+ * @returns Complete test environment
+ *
+ * @example
+ * ```typescript
+ * import { createTestEnvironment } from '@elizaos/core/test-utils';
+ *
+ * const { runtime, character, conversation } = createTestEnvironment({
+ *   characterName: 'TestBot',
+ *   conversationLength: 5,
+ *   roomId: 'test-room-123'
+ * });
+ * ```
+ */
+export declare function createTestEnvironment(options?: {
+    characterName?: string;
+    conversationLength?: number;
+    roomId?: UUID;
+    plugins?: string[];
+    runtimeOverrides?: any;
+    characterOverrides?: any;
+}): {
+    runtime: IAgentRuntime;
+    character: import("@elizaos/core").Character;
+    conversation: Memory[];
+    state: State;
+    roomId: `${string}-${string}-${string}-${string}-${string}`;
+};
+/**
+ * Create a test action with complete mock setup
+ *
+ * @param name - Action name
+ * @param options - Action configuration options
+ * @returns Mock action with handlers
+ */
+export declare function createTestAction(name: string, options?: {
+    description?: string;
+    validateResult?: boolean;
+    handlerResult?: ActionResult;
+    examples?: any[];
+}): Action;
+/**
+ * Create a test provider with complete mock setup
+ *
+ * @param name - Provider name
+ * @param options - Provider configuration options
+ * @returns Mock provider
+ */
+export declare function createTestProvider(name: string, options?: {
+    description?: string;
+    text?: string;
+    values?: Record<string, any>;
+    data?: Record<string, any>;
+    dynamic?: boolean;
+    isPrivate?: boolean;
+}): Provider;
+/**
+ * Create a test evaluator with complete mock setup
+ *
+ * @param name - Evaluator name
+ * @param options - Evaluator configuration options
+ * @returns Mock evaluator
+ */
+export declare function createTestEvaluator(name: string, options?: {
+    description?: string;
+    alwaysRun?: boolean;
+    validateResult?: boolean;
+    handlerResult?: any;
+}): Evaluator;
+/**
+ * Create a complete plugin test scenario
+ *
+ * @param pluginName - Name of the plugin being tested
+ * @param options - Plugin test configuration
+ * @returns Complete plugin test scenario
+ */
+export declare function createPluginTestScenario(pluginName: string, options?: {
+    actions?: string[];
+    providers?: string[];
+    evaluators?: string[];
+    services?: string[];
+    conversationSteps?: string[];
+}): {
+    runtime: IAgentRuntime;
+    character: import("@elizaos/core").Character;
+    state: State;
+    roomId: `${string}-${string}-${string}-${string}-${string}`;
+    conversation: Memory[];
+    components: {
+        actions: Action[];
+        providers: Provider[];
+        evaluators: Evaluator[];
+    };
+    helpers: {
+        executeAction: (actionName: string, message?: Memory) => Promise<void | ActionResult>;
+        getProviderData: (providerName: string, message?: Memory) => Promise<import("@elizaos/core").ProviderResult>;
+        runEvaluator: (evaluatorName: string, message?: Memory) => Promise<void | ActionResult>;
+    };
+};
+/**
+ * Create a multi-agent test scenario
+ *
+ * @param agentCount - Number of agents to create
+ * @param options - Multi-agent test configuration
+ * @returns Multi-agent test scenario
+ */
+export declare function createMultiAgentScenario(agentCount?: number, options?: {
+    sharedRoomId?: UUID;
+    agentNames?: string[];
+    conversationSteps?: Array<{
+        agentIndex: number;
+        message: string;
+    }>;
+}): {
+    agents: {
+        runtime: IAgentRuntime;
+        character: import("@elizaos/core").Character;
+        index: number;
+    }[];
+    sharedRoomId: `${string}-${string}-${string}-${string}-${string}`;
+    conversation: Memory[];
+    helpers: {
+        sendMessage: (agentIndex: number, text: string) => Memory;
+        getAgentByName: (name: string) => {
+            runtime: IAgentRuntime;
+            character: import("@elizaos/core").Character;
+            index: number;
+        };
+    };
+};
+//# sourceMappingURL=factories.d.ts.map

package/dist/src/factories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factories.d.ts","sourceRoot":"","sources":["../../src/factories.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,MAAM,EACN,KAAK,EACL,MAAM,EACN,QAAQ,EACR,SAAS,EACT,IAAI,EACJ,YAAY,EAEb,MAAM,eAAe,CAAC;AAOvB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,GAAE;IACP,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,gBAAgB,CAAC,EAAE,GAAG,CAAC;IACvB,kBAAkB,CAAC,EAAE,GAAG,CAAC;CACrB;;;;;;EAwCP;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;CACb,GACL,MAAM,CAoCR;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CAChB,GACL,QAAQ,CAsBV;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,GAAG,CAAC;CAChB,GACL,SAAS,CAoBX;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;;;;;;;;;;;;oCA0CgC,MAAM,YAAY,MAAM;wCAKpB,MAAM,YAAY,MAAM;sCAK1B,MAAM,YAAY,MAAM;;EAOjE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,GAAE,MAAU,EACtB,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,CAAC,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/D;;;;;;;;;kCAkCwB,MAAM,QAAQ,MAAM;+BASvB,MAAM;;;;;;EAKlC"}

package/dist/src/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @fileoverview ElizaOS Testing Infrastructure
+ *
+ * This module provides both legacy mock utilities and new real runtime testing infrastructure.
+ *
+ * **RECOMMENDED**: Use real runtime testing for reliable, production-like validation
+ * **LEGACY**: Mock utilities are deprecated due to false confidence issues
+ *
+ * Real runtime testing:
+ * - Uses actual AgentRuntime instances
+ * - Tests real functionality, not mocks
+ * - Catches actual bugs that mocks miss
+ * - Provides genuine confidence in code reliability
+ *
+ * @example Real Runtime Testing (Recommended)
+ * ```typescript
+ * import { createTestRuntime, runIntegrationTest } from '@elizaos/core/test-utils';
+ *
+ * const result = await runIntegrationTest('Test name', async (runtime) => {
+ *   const response = await runtime.processMessage({
+ *     content: { text: 'Hello, world!' },
+ *     entityId: 'test-user',
+ *     roomId: 'test-room',
+ *   });
+ *
+ *   // Test actual functionality
+ *   expect(response.content.text).toBeDefined();
+ * });
+ * ```
+ *
+ * @example Legacy Mock Testing (Deprecated)
+ * ```typescript
+ * import { createMockRuntime, createMockMemory } from '@elizaos/core/test-utils';
+ *
+ * const mockRuntime = createMockRuntime({
+ *   getSetting: mock().mockReturnValue('test-value')
+ * });
+ * ```
+ */
+export * from './realRuntime';
+export * from './templates';
+export * from './testDatabase';
+export * from './testModels';
+export * from './factories';
+export * from './mocks/character';
+export * from './mocks/database';
+export * from './mocks/memory';
+export * from './mocks/mockUtils';
+export * from './mocks/runtime';
+export * from './mocks/services';
+export * from './mocks/state';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAKH,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAK7B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}

package/dist/src/mocks/character.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @fileoverview Mock implementations for Character and related interfaces
+ *
+ * This module provides comprehensive mock implementations for character objects,
+ * agent configurations, and personality definitions.
+ */
+import type { Character } from '@elizaos/core';
+/**
+ * Type representing overrides for Character mock creation
+ */
+export type MockCharacterOverrides = Partial<Character>;
+/**
+ * Create a comprehensive mock Character with intelligent defaults
+ *
+ * This function provides a fully-featured character mock that includes
+ * realistic personality traits, message examples, and configuration.
+ *
+ * @param overrides - Partial object to override specific properties
+ * @returns Complete mock Character object
+ *
+ * @example
+ * ```typescript
+ * import { createMockCharacter } from '@elizaos/core/test-utils';
+ *
+ * const mockCharacter = createMockCharacter({
+ *   name: 'CustomAgent',
+ *   bio: ['A specialized test agent'],
+ *   plugins: ['@elizaos/plugin-test']
+ * });
+ * ```
+ */
+export declare function createMockCharacter(overrides?: MockCharacterOverrides): Character;
+/**
+ * Create a minimal mock character with only required fields
+ *
+ * @param name - Character name
+ * @param overrides - Additional overrides
+ * @returns Minimal mock character
+ */
+export declare function createMinimalMockCharacter(name?: string, overrides?: MockCharacterOverrides): Character;
+/**
+ * Create a mock character for specific plugin testing
+ *
+ * @param pluginName - Name of the plugin to test
+ * @param overrides - Additional overrides
+ * @returns Plugin-specific mock character
+ */
+export declare function createPluginTestCharacter(pluginName: string, overrides?: MockCharacterOverrides): Character;
+/**
+ * Create a mock character with extensive conversation examples
+ *
+ * @param overrides - Additional overrides
+ * @returns Character with rich conversation examples
+ */
+export declare function createRichConversationCharacter(overrides?: MockCharacterOverrides): Character;
+/**
+ * Create multiple mock characters for multi-agent testing
+ *
+ * @param count - Number of characters to create
+ * @param baseName - Base name for characters (will be numbered)
+ * @param overrides - Common overrides for all characters
+ * @returns Array of mock characters
+ */
+export declare function createMultipleCharacters(count?: number, baseName?: string, overrides?: MockCharacterOverrides): Character[];
+//# sourceMappingURL=character.d.ts.map

package/dist/src/mocks/character.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"character.d.ts","sourceRoot":"","sources":["../../../src/mocks/character.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAwB,MAAM,eAAe,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;AAExD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,GAAE,sBAA2B,GAAG,SAAS,CAuIrF;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,GAAE,MAA2B,EACjC,SAAS,GAAE,sBAA2B,GACrC,SAAS,CAcX;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,sBAA2B,GACrC,SAAS,CASX;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,SAAS,GAAE,sBAA2B,GAAG,SAAS,CA2CjG;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,GAAE,MAAU,EACjB,QAAQ,GAAE,MAAoB,EAC9B,SAAS,GAAE,sBAA2B,GACrC,SAAS,EAAE,CAgBb"}

package/dist/src/mocks/database.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview Mock implementations for IDatabaseAdapter and related database interfaces
+ *
+ * This module provides comprehensive mock implementations for database operations,
+ * supporting both unit and integration testing scenarios.
+ */
+import type { IDatabaseAdapter } from '@elizaos/core';
+/**
+ * Type representing overrides for IDatabaseAdapter mock creation
+ */
+export type MockDatabaseOverrides = Partial<IDatabaseAdapter>;
+/**
+ * Create a comprehensive mock of IDatabaseAdapter with intelligent defaults
+ *
+ * This function provides a fully-featured database adapter mock that implements
+ * all database operations with sensible defaults and proper return types.
+ *
+ * @param overrides - Partial object to override specific methods or properties
+ * @returns Complete mock implementation of IDatabaseAdapter
+ *
+ * @example
+ * ```typescript
+ * import { createMockDatabase } from '@elizaos/core/test-utils';
+ * import { mock } from 'bun:test';
+ *
+ * const mockDb = createMockDatabase({
+ *   getMemories: mock().mockResolvedValue([mockMemory]),
+ *   createMemory: mock().mockResolvedValue('memory-id')
+ * });
+ * ```
+ */
+export declare function createMockDatabase(overrides?: MockDatabaseOverrides): IDatabaseAdapter;
+/**
+ * Create a simple mock database connection object
+ *
+ * @param overrides - Partial object to override specific methods
+ * @returns Mock database connection
+ */
+export declare function createMockDbConnection(overrides?: any): any;
+//# sourceMappingURL=database.d.ts.map

package/dist/src/mocks/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../../src/mocks/database.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAQ,MAAM,eAAe,CAAC;AAG5D;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,GAAE,qBAA0B,GAAG,gBAAgB,CAgH1F;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,GAAE,GAAQ,OAczD"}

package/dist/src/mocks/memory.d.ts

@@ -0,0 +1,106 @@
+/**
+ * @fileoverview Mock implementations for Memory and related interfaces
+ *
+ * This module provides comprehensive mock implementations for memory objects,
+ * content structures, and memory-related operations.
+ */
+import type { Content, Media, Memory, UUID } from '@elizaos/core';
+/**
+ * Type representing overrides for Memory mock creation
+ */
+export type MockMemoryOverrides = Partial<Memory>;
+/**
+ * Type representing overrides for Content mock creation
+ */
+export type MockContentOverrides = Partial<Content>;
+/**
+ * Create a comprehensive mock Memory object with intelligent defaults
+ *
+ * This function provides a fully-featured memory mock that includes
+ * realistic content, metadata, and proper typing.
+ *
+ * @param overrides - Partial object to override specific properties
+ * @returns Complete mock Memory object
+ *
+ * @example
+ * ```typescript
+ * import { createMockMemory } from '@elizaos/core/test-utils';
+ *
+ * const mockMessage = createMockMemory({
+ *   content: { text: 'Hello, world!' },
+ *   entityId: 'user-123'
+ * });
+ * ```
+ */
+export declare function createMockMemory(overrides?: MockMemoryOverrides): Memory;
+/**
+ * Create a mock Content object with intelligent defaults
+ *
+ * @param overrides - Partial object to override specific properties
+ * @returns Complete mock Content object
+ *
+ * @example
+ * ```typescript
+ * import { createMockContent } from '@elizaos/core/test-utils';
+ *
+ * const mockContent = createMockContent({
+ *   text: 'Custom message',
+ *   actions: ['SEND_MESSAGE']
+ * });
+ * ```
+ */
+export declare function createMockContent(overrides?: MockContentOverrides): Content;
+/**
+ * Create a mock conversation memory (user message)
+ *
+ * @param text - The message text
+ * @param overrides - Additional overrides
+ * @returns Mock user message memory
+ */
+export declare function createMockUserMessage(text: string, overrides?: MockMemoryOverrides): Memory;
+/**
+ * Create a mock agent response memory
+ *
+ * @param text - The response text
+ * @param thought - Optional internal thought
+ * @param actions - Optional actions executed
+ * @param overrides - Additional overrides
+ * @returns Mock agent response memory
+ */
+export declare function createMockAgentResponse(text: string, thought?: string, actions?: string[], overrides?: MockMemoryOverrides): Memory;
+/**
+ * Create a mock fact memory for knowledge storage
+ *
+ * @param fact - The factual claim
+ * @param confidence - Confidence level (0-1)
+ * @param overrides - Additional overrides
+ * @returns Mock fact memory
+ */
+export declare function createMockFact(fact: string, confidence?: number, overrides?: MockMemoryOverrides): Memory;
+/**
+ * Create a mock memory with embedding vector
+ *
+ * @param text - The text content
+ * @param dimension - Embedding dimension (default: 1536 for OpenAI)
+ * @param overrides - Additional overrides
+ * @returns Mock memory with embedding
+ */
+export declare function createMockMemoryWithEmbedding(text: string, dimension?: number, overrides?: MockMemoryOverrides): Memory;
+/**
+ * Create a batch of mock conversation memories
+ *
+ * @param count - Number of memories to create
+ * @param roomId - Room ID for all memories
+ * @returns Array of mock conversation memories
+ */
+export declare function createMockConversation(count?: number, roomId?: UUID): Memory[];
+/**
+ * Create a mock Media attachment
+ *
+ * @param type - Media type
+ * @param url - Media URL
+ * @param overrides - Additional overrides
+ * @returns Mock Media object
+ */
+export declare function createMockMedia(type?: 'image' | 'video' | 'audio' | 'document', url?: string, overrides?: Partial<Media>): Media;
+//# sourceMappingURL=memory.d.ts.map

package/dist/src/mocks/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/mocks/memory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAEV,OAAO,EACP,KAAK,EACL,MAAM,EAGN,IAAI,EACL,MAAM,eAAe,CAAC;AAGvB;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,GAAE,mBAAwB,GAAG,MAAM,CA8B5E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,oBAAyB,GAAG,OAAO,CAgB/E;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,mBAAwB,GAAG,MAAM,CAY/F;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,GAAE,MAAM,EAAO,EACtB,SAAS,GAAE,mBAAwB,GAClC,MAAM,CAeR;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAY,EACxB,SAAS,GAAE,mBAAwB,GAClC,MAAM,CAaR;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,MAAa,EACxB,SAAS,GAAE,mBAAwB,GAClC,MAAM,CAQR;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,GAAE,MAAU,EAAE,MAAM,CAAC,EAAE,IAAI,GAAG,MAAM,EAAE,CAkBjF;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,IAAI,GAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAoB,EACxD,GAAG,GAAE,MAAuC,EAC5C,SAAS,GAAE,OAAO,CAAC,KAAK,CAAM,GAC7B,KAAK,CAkBP"}

package/dist/src/mocks/mockUtils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Simple mock utility for test utils that doesn't depend on bun:test
+ */
+export interface MockFunction<T = any> {
+    (...args: any[]): T;
+    mockReturnValue: (value: T) => MockFunction<T>;
+    mockResolvedValue: (value: T) => MockFunction<T>;
+    mockRejectedValue: (error: any) => MockFunction<T>;
+    mockImplementation: (fn: (...args: any[]) => T) => MockFunction<T>;
+    calls: any[][];
+    mock: {
+        calls: any[][];
+        results: any[];
+    };
+}
+export declare function mock<T = any>(implementation?: (...args: any[]) => T): MockFunction<T>;
+//# sourceMappingURL=mockUtils.d.ts.map

package/dist/src/mocks/mockUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockUtils.d.ts","sourceRoot":"","sources":["../../../src/mocks/mockUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,GAAG;IACnC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IACpB,eAAe,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/C,iBAAiB,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,YAAY,CAAC,CAAC,CAAC,CAAC;IACjD,iBAAiB,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,YAAY,CAAC,CAAC,CAAC,CAAC;IACnD,kBAAkB,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,KAAK,YAAY,CAAC,CAAC,CAAC,CAAC;IACnE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC;IAGf,IAAI,EAAE;QACJ,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC;QACf,OAAO,EAAE,GAAG,EAAE,CAAC;KAChB,CAAC;CACH;AAED,wBAAgB,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,cAAc,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CA8DrF"}

package/dist/src/mocks/runtime.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview Mock implementations for IAgentRuntime and related interfaces
+ *
+ * This module provides comprehensive mock implementations for the core runtime interfaces,
+ * designed to support both unit testing and integration testing scenarios.
+ */
+import type { IAgentRuntime, IDatabaseAdapter } from '@elizaos/core';
+/**
+ * Type representing overrides for IAgentRuntime mock creation
+ */
+export type MockRuntimeOverrides = Partial<IAgentRuntime & IDatabaseAdapter>;
+/**
+ * Create a comprehensive mock of IAgentRuntime with intelligent defaults
+ *
+ * This function provides a fully-featured mock that implements both IAgentRuntime
+ * and IDatabaseAdapter interfaces, ensuring compatibility with all test scenarios.
+ *
+ * @param overrides - Partial object to override specific methods or properties
+ * @returns Complete mock implementation of IAgentRuntime
+ *
+ * @deprecated Use real runtime testing instead: import { createTestRuntime } from '@elizaos/core/test-utils'
+ *
+ * @example Legacy Mock Testing (Deprecated)
+ * ```typescript
+ * import { createMockRuntime } from '@elizaos/core/test-utils';
+ *
+ * const mockRuntime = createMockRuntime({
+ *   getSetting: () => 'test-api-key',
+ *   useModel: () => Promise.resolve('mock response')
+ * });
+ * ```
+ */
+export declare function createMockRuntime(overrides?: MockRuntimeOverrides): IAgentRuntime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/src/mocks/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/mocks/runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAEV,aAAa,EACb,gBAAgB,EAIjB,MAAM,eAAe,CAAC;AAGvB;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,oBAAyB,GAAG,aAAa,CA6MrF"}