@elizaos/test-utils 1.4.4 → 1.5.0

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

@@ -0,0 +1,99 @@
+/**
+ * @fileoverview Mock implementations for Service and related interfaces
+ *
+ * This module provides comprehensive mock implementations for services,
+ * supporting both unit and integration testing scenarios.
+ */
+import type { Service } from '@elizaos/core';
+import { ServiceTypeName } from '@elizaos/core';
+/**
+ * Type representing overrides for Service mock creation
+ */
+export type MockServiceOverrides = Partial<Service>;
+/**
+ * Create a comprehensive mock Service with intelligent defaults
+ *
+ * This function provides a fully-featured service mock that implements
+ * the Service interface with sensible defaults and proper lifecycle methods.
+ *
+ * @param serviceType - Type/category of the service
+ * @param overrides - Partial object to override specific methods or properties
+ * @returns Complete mock Service implementation
+ *
+ * @example
+ * ```typescript
+ * import { createMockService } from '@elizaos/core/test-utils';
+ * import { mock } from 'bun:test';
+ *
+ * const mockService = createMockService(ServiceType.UNKNOWN, {
+ *   someMethod: mock().mockResolvedValue('custom result')
+ * });
+ * ```
+ */
+export declare function createMockService(serviceType?: ServiceTypeName, overrides?: MockServiceOverrides): Service;
+/**
+ * Create a mock database service
+ *
+ * @param overrides - Service-specific overrides
+ * @returns Mock database service
+ */
+export declare function createMockDatabaseService(overrides?: MockServiceOverrides): Service;
+/**
+ * Create a mock cache service
+ *
+ * @param overrides - Service-specific overrides
+ * @returns Mock cache service
+ */
+export declare function createMockCacheService(overrides?: MockServiceOverrides): Service;
+/**
+ * Create a mock HTTP service
+ *
+ * @param overrides - Service-specific overrides
+ * @returns Mock HTTP service
+ */
+export declare function createMockHttpService(overrides?: MockServiceOverrides): Service;
+/**
+ * Create a mock blockchain service
+ *
+ * @param overrides - Service-specific overrides
+ * @returns Mock blockchain service
+ */
+export declare function createMockBlockchainService(overrides?: MockServiceOverrides): Service;
+/**
+ * Create a mock AI model service
+ *
+ * @param overrides - Service-specific overrides
+ * @returns Mock AI model service
+ */
+export declare function createMockModelService(overrides?: MockServiceOverrides): Service;
+/**
+ * Create a mock messaging service
+ *
+ * @param overrides - Service-specific overrides
+ * @returns Mock messaging service
+ */
+export declare function createMockMessagingService(overrides?: MockServiceOverrides): Service;
+/**
+ * Create a service map with multiple mock services
+ *
+ * @param services - Array of service configurations
+ * @returns Map of service names to mock services
+ */
+export declare function createMockServiceMap(services?: Array<{
+    name: string;
+    type?: ServiceTypeName;
+    overrides?: MockServiceOverrides;
+}>): Map<string, Service>;
+/**
+ * Create a mock service registry for runtime
+ *
+ * @param runtime - Mock runtime instance
+ * @param services - Services to register
+ * @returns Updated runtime with registered services
+ */
+export declare function registerMockServices(runtime: any, services?: Array<{
+    name: string;
+    type?: ServiceTypeName;
+    overrides?: MockServiceOverrides;
+}>): any;
+//# sourceMappingURL=services.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../src/mocks/services.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAe,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7D;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,GAAE,eAAqC,EAClD,SAAS,GAAE,oBAAyB,GACnC,OAAO,CA+BT;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,GAAE,oBAAyB,GAAG,OAAO,CAKvF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,GAAE,oBAAyB,GAAG,OAAO,CAOpF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,GAAE,oBAAyB,GAAG,OAAO,CAKnF;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,GAAE,oBAAyB,GAAG,OAAO,CAKzF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,GAAE,oBAAyB,GAAG,OAAO,CAKpF;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,GAAE,oBAAyB,GAAG,OAAO,CAKxF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,GAAE,KAAK,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,SAAS,CAAC,EAAE,oBAAoB,CAAC;CAClC,CAAM,GACN,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBtB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,GAAG,EACZ,QAAQ,GAAE,KAAK,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,SAAS,CAAC,EAAE,oBAAoB,CAAC;CAClC,CAAM,GACN,GAAG,CAWL"}

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

@@ -0,0 +1,100 @@
+/**
+ * @fileoverview Mock implementations for State and related interfaces
+ *
+ * This module provides comprehensive mock implementations for state objects,
+ * provider results, and state composition utilities.
+ */
+import type { ActionResult, ProviderResult, State } from '@elizaos/core';
+/**
+ * Type representing overrides for State mock creation
+ */
+export type MockStateOverrides = Partial<State>;
+/**
+ * Type representing overrides for ProviderResult mock creation
+ */
+export type MockProviderResultOverrides = Partial<ProviderResult>;
+/**
+ * Type representing overrides for ActionResult mock creation
+ */
+export type MockActionResultOverrides = Partial<ActionResult>;
+/**
+ * Create a comprehensive mock State object with intelligent defaults
+ *
+ * This function provides a fully-featured state mock that includes
+ * realistic data structures and proper typing for agent context.
+ *
+ * @param overrides - Partial object to override specific properties
+ * @returns Complete mock State object
+ *
+ * @example
+ * ```typescript
+ * import { createMockState } from '@elizaos/core/test-utils';
+ *
+ * const mockState = createMockState({
+ *   values: { currentUser: 'john_doe' },
+ *   data: { conversationLength: 5 }
+ * });
+ * ```
+ */
+export declare function createMockState(overrides?: MockStateOverrides): State;
+/**
+ * Create a mock ProviderResult object
+ *
+ * @param overrides - Partial object to override specific properties
+ * @returns Complete mock ProviderResult object
+ *
+ * @example
+ * ```typescript
+ * import { createMockProviderResult } from '@elizaos/core/test-utils';
+ *
+ * const providerResult = createMockProviderResult({
+ *   text: '[WEATHER] Current weather is sunny',
+ *   values: { temperature: 72, conditions: 'sunny' }
+ * });
+ * ```
+ */
+export declare function createMockProviderResult(overrides?: MockProviderResultOverrides): ProviderResult;
+/**
+ * Create a mock ActionResult object
+ *
+ * @param overrides - Partial object to override specific properties
+ * @returns Complete mock ActionResult object
+ *
+ * @example
+ * ```typescript
+ * import { createMockActionResult } from '@elizaos/core/test-utils';
+ *
+ * const actionResult = createMockActionResult({
+ *   text: 'Action completed successfully',
+ *   values: { success: true, id: 'action-123' }
+ * });
+ * ```
+ */
+export declare function createMockActionResult(overrides?: MockActionResultOverrides): ActionResult;
+/**
+ * Create a state with specific provider context
+ *
+ * @param providerName - Name of the provider
+ * @param providerData - Data from the provider
+ * @param overrides - Additional state overrides
+ * @returns State with provider context
+ */
+export declare function createMockStateWithProvider(providerName: string, providerData: any, overrides?: MockStateOverrides): State;
+/**
+ * Create a state with action execution history
+ *
+ * @param actionResults - Array of action results
+ * @param overrides - Additional state overrides
+ * @returns State with action history
+ */
+export declare function createMockStateWithActions(actionResults: ActionResult[], overrides?: MockStateOverrides): State;
+/**
+ * Create a state with realistic conversation context
+ *
+ * @param conversationHistory - Array of recent messages
+ * @param currentUser - Current user name
+ * @param overrides - Additional state overrides
+ * @returns State with conversation context
+ */
+export declare function createMockConversationState(conversationHistory?: string[], currentUser?: string, overrides?: MockStateOverrides): State;
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/mocks/state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;AAE9D;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,SAAS,GAAE,kBAAuB,GAAG,KAAK,CA2CzE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,GAAE,2BAAgC,GAC1C,cAAc,CAiBhB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,GAAE,yBAA8B,GAAG,YAAY,CAmB9F;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,GAAG,EACjB,SAAS,GAAE,kBAAuB,GACjC,KAAK,CAYP;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,YAAY,EAAE,EAC7B,SAAS,GAAE,kBAAuB,GACjC,KAAK,CAgBP;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,mBAAmB,GAAE,MAAM,EAA2C,EACtE,WAAW,GAAE,MAAmB,EAChC,SAAS,GAAE,kBAAuB,GACjC,KAAK,CA6BP"}

package/dist/src/realRuntime.d.ts

@@ -0,0 +1,85 @@
+import type { Character, IAgentRuntime, Plugin } from '@elizaos/core';
+import { TestModelProvider, createSpecializedModelProvider, scenarios } from './testModels';
+export interface RuntimeConfig {
+    character: Character;
+    plugins: Array<Plugin | string>;
+    databaseUrl?: string;
+    apiKeys: Record<string, string>;
+    modelProviders?: Record<string, any>;
+    isolated?: boolean;
+}
+export interface RealRuntimeTestResult {
+    scenarioName: string;
+    passed: boolean;
+    errors: string[];
+    executedActions: string[];
+    createdMemories: number;
+    responseTime: number;
+    memoryUsage?: number;
+}
+/**
+ * Runtime Test Harness - Creates actual AgentRuntime instances for testing
+ * Uses the standard AgentRuntime without any mocks or proxies
+ */
+export declare class RuntimeTestHarness {
+    private runtimes;
+    private databaseManager;
+    private testId;
+    constructor(testId?: string);
+    /**
+     * Creates an AgentRuntime instance for testing
+     * This uses the standard AgentRuntime - it will actually execute all functionality
+     */
+    createTestRuntime(config: RuntimeConfig): Promise<IAgentRuntime>;
+    /**
+     * Loads a plugin by name from the ElizaOS ecosystem
+     * Uses dynamic imports to avoid circular dependencies during build
+     */
+    private loadPlugin;
+    /**
+     * Creates a test model provider that gives realistic responses
+     */
+    createRealisticModelProvider(scenarios?: Array<{
+        prompt: RegExp;
+        response: string;
+    }>): TestModelProvider;
+    /**
+     * Executes a real message processing test
+     */
+    processTestMessage(runtime: IAgentRuntime, messageText: string, options?: {
+        roomId?: string;
+        entityId?: string;
+        expectedActions?: string[];
+        timeoutMs?: number;
+    }): Promise<RealRuntimeTestResult>;
+    /**
+     * Gets actions that were actually executed (not mocked)
+     */
+    private getExecutedActions;
+    /**
+     * Validates that a runtime is actually functional
+     */
+    validateRuntimeHealth(runtime: IAgentRuntime): Promise<{
+        healthy: boolean;
+        issues: string[];
+        services: string[];
+        plugins: string[];
+    }>;
+    /**
+     * Cleanup all test resources
+     */
+    cleanup(): Promise<void>;
+}
+/**
+ * Convenience function to create and configure a test runtime
+ */
+export declare function createTestRuntime(config?: Partial<RuntimeConfig>): Promise<{
+    runtime: IAgentRuntime;
+    harness: RuntimeTestHarness;
+}>;
+/**
+ * Helper to run a quick integration test
+ */
+export declare function runIntegrationTest(testName: string, testFn: (runtime: IAgentRuntime) => Promise<void>, config?: Partial<RuntimeConfig>): Promise<RealRuntimeTestResult>;
+export { createSpecializedModelProvider, scenarios };
+//# sourceMappingURL=realRuntime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"realRuntime.d.ts","sourceRoot":"","sources":["../../src/realRuntime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAU,MAAM,EAAQ,MAAM,eAAe,CAAC;AAIpF,OAAO,EACL,iBAAiB,EACjB,8BAA8B,EAE9B,SAAS,EACV,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,CAAC,EAAE,MAAM;IAK3B;;;OAGG;IACG,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IA8CtE;;;OAGG;YACW,UAAU;IAqCxB;;OAEG;IACH,4BAA4B,CAC1B,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,GACD,iBAAiB;IAuBpB;;OAEG;IACG,kBAAkB,CACtB,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;KACf,GACL,OAAO,CAAC,qBAAqB,CAAC;IAuEjC;;OAEG;YACW,kBAAkB;IAyBhC;;OAEG;IACG,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC;QAC3D,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IAyEF;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CA8B/B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,OAAO,CAAC;IACpF,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,kBAAkB,CAAC;CAC7B,CAAC,CAsBD;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,EACjD,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAgChC;AAGD,OAAO,EAAE,8BAA8B,EAAE,SAAS,EAAE,CAAC"}

package/dist/src/templates.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Standardized testing templates and patterns for ElizaOS
+ *
+ * This module provides consistent testing patterns, templates, and utilities
+ * to ensure testing consistency across all packages.
+ */
+import { Character, Content, IAgentRuntime, Memory, Plugin } from '@elizaos/core';
+/**
+ * Standard test configuration interface
+ */
+export interface TestConfig {
+    name: string;
+    timeout?: number;
+    retries?: number;
+    skipCondition?: () => boolean;
+    setup?: () => Promise<void>;
+    teardown?: () => Promise<void>;
+    expectedErrors?: unknown[];
+}
+/**
+ * Template test result interface
+ */
+export interface TemplateTestResult {
+    name: string;
+    passed: boolean;
+    duration: number;
+    error?: Error;
+    warnings?: string[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Base test template class
+ */
+export declare abstract class TestTemplate {
+    protected config: TestConfig;
+    protected runtime?: IAgentRuntime;
+    constructor(config: TestConfig);
+    abstract execute(): Promise<TemplateTestResult>;
+    protected setup(): Promise<void>;
+    protected teardown(): Promise<void>;
+    protected shouldSkip(): boolean;
+    getConfig(): TestConfig;
+}
+/**
+ * Unit test template for isolated component testing
+ */
+export declare class UnitTestTemplate extends TestTemplate {
+    private testFunction;
+    constructor(config: TestConfig, testFunction: () => Promise<void>);
+    execute(): Promise<TemplateTestResult>;
+}
+/**
+ * Integration test template for real runtime testing
+ */
+export declare class IntegrationTestTemplate extends TestTemplate {
+    private testFunction;
+    private character?;
+    constructor(config: TestConfig, testFunction: (runtime: IAgentRuntime) => Promise<void>, character?: Character);
+    execute(): Promise<TemplateTestResult>;
+}
+/**
+ * Plugin test template for plugin-specific testing
+ */
+export declare class PluginTestTemplate extends TestTemplate {
+    private plugin;
+    private testFunction;
+    constructor(config: TestConfig, plugin: Plugin, testFunction: (runtime: IAgentRuntime, plugin: Plugin) => Promise<void>);
+    execute(): Promise<TemplateTestResult>;
+}
+/**
+ * Error handling test template
+ */
+export declare class ErrorTestTemplate extends TestTemplate {
+    private testFunction;
+    private expectedError;
+    constructor(config: TestConfig, testFunction: () => Promise<void>, expectedError: string);
+    execute(): Promise<TemplateTestResult>;
+}
+/**
+ * Performance test template
+ */
+export declare class PerformanceTestTemplate extends TestTemplate {
+    private testFunction;
+    private maxDuration;
+    private maxMemoryMB;
+    constructor(config: TestConfig, testFunction: () => Promise<void>, maxDuration: number, maxMemoryMB: number);
+    execute(): Promise<TemplateTestResult>;
+}
+/**
+ * Test suite for organizing related tests
+ */
+export declare class TestSuite {
+    private tests;
+    private name;
+    constructor(name: string);
+    addTest(test: TestTemplate): void;
+    run(): Promise<{
+        suiteName: string;
+        totalTests: number;
+        passed: number;
+        failed: number;
+        duration: number;
+        results: TemplateTestResult[];
+    }>;
+}
+/**
+ * Factory functions for creating common test scenarios
+ */
+export declare function createUnitTest(name: string, testFunction: () => Promise<void>, options?: Partial<TestConfig>): UnitTestTemplate;
+export declare function createIntegrationTest(name: string, testFunction: (runtime: IAgentRuntime) => Promise<void>, character?: Character, options?: Partial<TestConfig>): IntegrationTestTemplate;
+export declare function createPluginTest(name: string, plugin: Plugin, testFunction: (runtime: IAgentRuntime, plugin: Plugin) => Promise<void>, options?: Partial<TestConfig>): PluginTestTemplate;
+export declare function createErrorTest(name: string, testFunction: () => Promise<void>, expectedError: any, options?: Partial<TestConfig>): ErrorTestTemplate;
+export declare function createPerformanceTest(name: string, testFunction: () => Promise<void>, maxDurationMs: number, maxMemoryMB: number, options?: Partial<TestConfig>): PerformanceTestTemplate;
+/**
+ * Standard test data generators
+ */
+export declare class TestDataGenerator {
+    static generateUUID(): string;
+    static generateMemory(overrides?: Partial<Memory>): Memory;
+    static generateCharacter(overrides?: Partial<Character>): Character;
+    static generateContent(overrides?: Partial<Content>): Content;
+}
+//# sourceMappingURL=templates.d.ts.map

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

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

package/dist/src/testDatabase.d.ts

@@ -0,0 +1,44 @@
+import type { IDatabaseAdapter } from '@elizaos/core';
+/**
+ * Test Database Manager - Creates isolated database instances for testing
+ * Each test gets its own database to prevent interference and ensure isolation
+ */
+export declare class TestDatabaseManager {
+    private testDatabases;
+    private tempPaths;
+    /**
+     * Creates an isolated database for testing
+     * Uses PostgreSQL for testing when available, falls back to mock database
+     */
+    createIsolatedDatabase(testId: string): Promise<IDatabaseAdapter>;
+    /**
+     * Creates a minimal mock database adapter for testing when real database unavailable
+     * This is a FUNCTIONAL mock that actually stores data in memory
+     */
+    private createMockDatabase;
+    /**
+     * Cleanup a specific test database
+     */
+    cleanupDatabase(testId: string): Promise<void>;
+    /**
+     * Cleanup all test databases
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Get statistics about test databases
+     */
+    getStats(): {
+        activeDatabases: number;
+        tempPaths: string[];
+        memoryUsage: string;
+    };
+}
+/**
+ * Convenience function to create an isolated test database
+ */
+export declare function createTestDatabase(testId?: string): Promise<{
+    adapter: IDatabaseAdapter;
+    manager: TestDatabaseManager;
+    testId: string;
+}>;
+//# sourceMappingURL=testDatabase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"testDatabase.d.ts","sourceRoot":"","sources":["../../src/testDatabase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAQ,MAAM,eAAe,CAAC;AAI5D;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,aAAa,CAA4C;IACjE,OAAO,CAAC,SAAS,CAA0B;IAE3C;;;OAGG;IACG,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA0EvE;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAysB1B;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAepD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B;;OAEG;IACH,QAAQ,IAAI;QACV,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB;CAOF;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACjE,OAAO,EAAE,gBAAgB,CAAC;IAC1B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAMD"}

package/dist/src/testModels.d.ts

@@ -0,0 +1,105 @@
+import type { IAgentRuntime, TextGenerationParams, TextEmbeddingParams } from '@elizaos/core';
+/**
+ * Realistic Test Model Provider - Provides configurable but realistic AI model responses
+ * Replaces hardcoded mock responses with intelligent, context-aware responses
+ */
+export declare class TestModelProvider {
+    private responses;
+    private patterns;
+    private defaultResponse;
+    private contextHistory;
+    constructor(defaultResponse?: string, _options?: {
+        enableContextMemory?: boolean;
+        maxContextHistory?: number;
+    });
+    /**
+     * Add realistic default response patterns
+     */
+    private addDefaultPatterns;
+    /**
+     * Generate text response based on prompt
+     */
+    generateText(params: TextGenerationParams): Promise<string>;
+    /**
+     * Generate embeddings for text (mock implementation with consistent vectors)
+     */
+    generateEmbedding(params: TextEmbeddingParams): Promise<number[]>;
+    /**
+     * Generate object-structured responses
+     */
+    generateObject(params: any): Promise<Record<string, any>>;
+    /**
+     * Make response more contextual based on prompt content
+     */
+    private makeContextual;
+    /**
+     * Generate intelligent default response based on prompt analysis
+     */
+    private generateIntelligentDefault;
+    /**
+     * Extract key terms from prompt for contextualization
+     */
+    private extractKeyTerms;
+    /**
+     * Simple hash function for deterministic embeddings
+     */
+    private simpleHash;
+    /**
+     * Add interaction to context history
+     */
+    private addToHistory;
+    /**
+     * Set a specific response for a prompt
+     */
+    setResponse(prompt: string, response: string): void;
+    /**
+     * Add a pattern-based response
+     */
+    addPattern(pattern: RegExp, response: string): void;
+    /**
+     * Set the default response
+     */
+    setDefaultResponse(response: string): void;
+    /**
+     * Clear all custom responses and patterns
+     */
+    clear(): void;
+    /**
+     * Get conversation history
+     */
+    getHistory(): Array<{
+        prompt: string;
+        response: string;
+    }>;
+}
+/**
+ * Create a test model provider with specific scenarios
+ */
+export declare function createTestModelProvider(scenarios?: Array<{
+    prompt: RegExp | string;
+    response: string;
+}>, defaultResponse?: string): TestModelProvider;
+/**
+ * Create specialized model provider for different types of testing
+ */
+export declare function createSpecializedModelProvider(type: 'conversational' | 'analytical' | 'creative' | 'factual'): TestModelProvider;
+/**
+ * Model handler wrapper that integrates with ElizaOS runtime
+ */
+export declare function createModelHandler(provider: TestModelProvider): (runtime: IAgentRuntime, params: any) => Promise<any>;
+/**
+ * Test scenario builder for common testing patterns
+ */
+export declare class TestScenarioBuilder {
+    private scenarios;
+    addGreeting(response?: string): this;
+    addTaskCreation(response?: string): this;
+    addSearch(response?: string): this;
+    addCustom(prompt: RegExp | string, response: string): this;
+    build(defaultResponse?: string): TestModelProvider;
+}
+/**
+ * Convenience function to quickly create test scenarios
+ */
+export declare function scenarios(): TestScenarioBuilder;
+//# sourceMappingURL=testModels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"testModels.d.ts","sourceRoot":"","sources":["../../src/testModels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAG9F;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,QAAQ,CAAoD;IACpE,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,cAAc,CAAmD;gBAGvE,eAAe,GAAE,MAAgD,EACjE,QAAQ,GAAE;QACR,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;KACvB;IAQR;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiH1B;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;IAgCjE;;OAEG;IACG,iBAAiB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAgBvE;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAuC/D;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA0BlC;;OAEG;IACH,OAAO,CAAC,eAAe;IA4DvB;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAInD;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAInD;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI1C;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,UAAU,IAAI,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAG1D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,GAAE,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAM,EACpE,eAAe,CAAC,EAAE,MAAM,GACvB,iBAAiB,CAYnB;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,gBAAgB,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,GAC7D,iBAAiB,CAkCnB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,IAC9C,SAAS,aAAa,EAAE,QAAQ,GAAG,KAAG,OAAO,CAAC,GAAG,CAAC,CAmBjE;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,SAAS,CAA4D;IAE7E,WAAW,CAAC,QAAQ,GAAE,MAAqC,GAAG,IAAI;IAQlE,eAAe,CAAC,QAAQ,GAAE,MAAyC,GAAG,IAAI;IAQ1E,SAAS,CAAC,QAAQ,GAAE,MAA8C,GAAG,IAAI;IAQzE,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAK1D,KAAK,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,iBAAiB;CAGnD;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,mBAAmB,CAE/C"}

package/dist/src/unifiedTestSuite.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Unified Testing Infrastructure for ElizaOS
+ *
+ * This module provides the standardized TestSuite interface that all ElizaOS packages
+ * should use for consistent testing across the monorepo. It integrates with Bun's
+ * testing framework while providing a unified API.
+ */
+/**
+ * Unified TestSuite class for consistent testing across ElizaOS packages
+ * This provides the same interface used by all migrated packages
+ */
+export declare class TestSuite {
+    private name;
+    private tests;
+    private beforeEachFn?;
+    private afterEachFn?;
+    constructor(name: string);
+    beforeEach<T = any>(fn: (context: T) => Promise<void> | void): void;
+    afterEach<T = any>(fn: (context: T) => Promise<void> | void): void;
+    addTest<T = any>(name: string, fn: (context: T) => Promise<void> | void): void;
+    run(): void;
+}
+/**
+ * Helper function to create a TestSuite for unit tests
+ * This is the primary way packages should create test suites
+ */
+export declare function createUnitTest(name: string): TestSuite;
+/**
+ * Helper function to create a TestSuite for plugin tests
+ */
+export declare function createPluginTest(name: string): TestSuite;
+/**
+ * Helper function to create a TestSuite for integration tests
+ */
+export declare function createIntegrationTest(name: string): TestSuite;
+/**
+ * Helper function to create a TestSuite for E2E tests
+ */
+export declare function createE2ETest(name: string): TestSuite;
+//# sourceMappingURL=unifiedTestSuite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unifiedTestSuite.d.ts","sourceRoot":"","sources":["../../src/unifiedTestSuite.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;GAGG;AACH,qBAAa,SAAS;IAQR,OAAO,CAAC,IAAI;IAPxB,OAAO,CAAC,KAAK,CAGL;IACR,OAAO,CAAC,YAAY,CAAC,CAAyC;IAC9D,OAAO,CAAC,WAAW,CAAC,CAAyC;gBAEzC,IAAI,EAAE,MAAM;IAEhC,UAAU,CAAC,CAAC,GAAG,GAAG,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAInE,SAAS,CAAC,CAAC,GAAG,GAAG,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAIlE,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAI9E,GAAG,IAAI,IAAI;CA0BZ;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAUtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAExD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAE7D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAErD"}