@llmist/testing 16.0.4 → 16.1.0

package/dist/index.d.cts

@@ -648,25 +648,18 @@ declare class MockBuilder {
     /**
      * Match calls to a specific model (by name, supports partial matching).
      *
-     * @example
-     * mockLLM().forModel('gpt-5')
-     * mockLLM().forModel('claude') // matches any Claude model
+     * @alias forModel
      */
     forModel(modelName: string): this;
     /**
      * Match calls to any model.
      * Useful when you want to mock responses regardless of the model used.
-     *
-     * @example
-     * mockLLM().forAnyModel()
      */
     forAnyModel(): this;
     /**
      * Match calls to a specific provider.
      *
-     * @example
-     * mockLLM().forProvider('openai')
-     * mockLLM().forProvider('anthropic')
+     * @alias forProvider
      */
     forProvider(provider: string): this;
     /**
@@ -722,6 +715,12 @@ declare class MockBuilder {
      * })
      */
     when(matcher: MockMatcher): this;
+    /**
+     * Match when any message contains an image.
+     *
+     * @alias whenMessageHasImage
+     */
+    forImage(): this;
     /**
      * Match when any message contains an image.
      *
@@ -729,6 +728,12 @@ declare class MockBuilder {
      * mockLLM().whenMessageHasImage().returns("I see an image of a sunset.")
      */
     whenMessageHasImage(): this;
+    /**
+     * Match when any message contains audio.
+     *
+     * @alias whenMessageHasAudio
+     */
+    forAudio(): this;
     /**
      * Match when any message contains audio.
      *
@@ -739,10 +744,34 @@ declare class MockBuilder {
     /**
      * Match based on the number of images in the last message.
      *
+     * @alias whenImageCount
+     */
+    withImageCount(predicate: (count: number) => boolean | number): this;
+    /**
+     * Match based on the number of images in the conversation.
+     *
      * @example
      * mockLLM().whenImageCount((n) => n >= 2).returns("Comparing multiple images...")
      */
     whenImageCount(predicate: (count: number) => boolean): this;
+    /**
+     * Return a sequence of responses. Each time the mock matches, it will return the next response in the sequence.
+     * If the sequence reaches the end, it will cycle back to the beginning.
+     *
+     * @example
+     * mockLLM().returnsSequence([
+     *   { text: 'First response' },
+     *   { text: 'Second response' }
+     * ])
+     */
+    returnsSequence(responses: MockResponse[]): this;
+    /**
+     * Set a dynamic response generator function.
+     * Equivalent to withResponse(fn).
+     *
+     * @alias withResponse
+     */
+    returnsDynamic(generator: (context: MockMatcherContext) => MockResponse | Promise<MockResponse>): this;
     /**
      * Set the text response to return.
      * Can be a static string or a function that returns a string dynamically.
@@ -1291,6 +1320,11 @@ declare class MockManager {
  * Helper function to get the global mock manager instance.
  */
 declare function getMockManager(options?: MockOptions): MockManager;
+/**
+ * Reset the global MockManager instance.
+ * Useful for clearing all mocks and state between tests.
+ */
+declare function resetMocks(): void;
 
 /**
  * Create a mock LLM stream from a mock response.
@@ -1419,4 +1453,43 @@ declare function createEmptyStream(): LLMStream;
  */
 declare function createErrorStream(chunksBeforeError: LLMStreamChunk[], error: Error): LLMStream;
 
-export { type MockAudioData, MockBuilder, MockConversationManager, type MockGadget, MockGadgetBuilder, type MockGadgetConfig, type MockImageData, MockManager, type MockMatcher, type MockMatcherContext, type MockOptions, MockPromptRecorder, MockProviderAdapter, type MockRegistration, type MockResponse, type MockStats, type RecordedCall, type TestEnvironment, type TestEnvironmentOptions, type TestGadgetOptions, type TestGadgetResult, collectOutput, collectStream, collectStreamText, createAssistantMessage, createConversation, createConversationWithGadgets, createEmptyStream, createErrorStream, createLargeConversation, createMinimalConversation, createMockAdapter, createMockClient, createMockConversationManager, createMockGadget, createMockPrompt, createMockReadable, createMockStream, createMockWritable, createSystemMessage, createTestEnvironment, createTestStream, createTextMockStream, createTextStream, createUserMessage, estimateTokens, getBufferedOutput, getMockManager, getStreamFinalChunk, mockGadget, mockLLM, testGadget, testGadgetBatch, waitFor };
+/**
+ * Mock TUI App interface.
+ */
+interface MockTUIApp {
+    setProfiles: any;
+    setFocusMode: any;
+    startWaitingForPrompt: any;
+    destroy: any;
+    onQuit: any;
+    onCancel: any;
+    showLLMCallStart: any;
+    updateStreamingTokens: any;
+    clearRetry: any;
+    showThrottling: any;
+    addSystemMessage: any;
+    clearThrottling: any;
+    showRetry: any;
+    showApproval: any;
+    waitForInput: any;
+    subscribeToTree: any;
+    handleEvent: any;
+    addGadgetCost: any;
+    flushText: any;
+    resetAbort: any;
+    startNewSession: any;
+    showUserMessage: any;
+    clearPreviousSession: any;
+    clearStatusBar: any;
+    onMidSessionInput: any;
+    waitForPrompt: any;
+    getAbortSignal: any;
+}
+/**
+ * Creates a mock TUI app for testing.
+ *
+ * NOTE: This currently uses Vitest's `vi` for mocks.
+ */
+declare const createMockTUIApp: () => MockTUIApp;
+
+export { type MockAudioData, MockBuilder, MockConversationManager, type MockGadget, MockGadgetBuilder, type MockGadgetConfig, type MockImageData, MockManager, type MockMatcher, type MockMatcherContext, type MockOptions, MockPromptRecorder, MockProviderAdapter, type MockRegistration, type MockResponse, type MockStats, type MockTUIApp, type RecordedCall, type TestEnvironment, type TestEnvironmentOptions, type TestGadgetOptions, type TestGadgetResult, collectOutput, collectStream, collectStreamText, createAssistantMessage, createConversation, createConversationWithGadgets, createEmptyStream, createErrorStream, createLargeConversation, createMinimalConversation, createMockAdapter, createMockClient, createMockConversationManager, createMockGadget, createMockPrompt, createMockReadable, createMockStream, createMockTUIApp, createMockWritable, createSystemMessage, createTestEnvironment, createTestStream, createTextMockStream, createTextStream, createUserMessage, estimateTokens, getBufferedOutput, getMockManager, getStreamFinalChunk, mockGadget, mockLLM, resetMocks, testGadget, testGadgetBatch, waitFor };

package/dist/index.d.ts

@@ -648,25 +648,18 @@ declare class MockBuilder {
     /**
      * Match calls to a specific model (by name, supports partial matching).
      *
-     * @example
-     * mockLLM().forModel('gpt-5')
-     * mockLLM().forModel('claude') // matches any Claude model
+     * @alias forModel
      */
     forModel(modelName: string): this;
     /**
      * Match calls to any model.
      * Useful when you want to mock responses regardless of the model used.
-     *
-     * @example
-     * mockLLM().forAnyModel()
      */
     forAnyModel(): this;
     /**
      * Match calls to a specific provider.
      *
-     * @example
-     * mockLLM().forProvider('openai')
-     * mockLLM().forProvider('anthropic')
+     * @alias forProvider
      */
     forProvider(provider: string): this;
     /**
@@ -722,6 +715,12 @@ declare class MockBuilder {
      * })
      */
     when(matcher: MockMatcher): this;
+    /**
+     * Match when any message contains an image.
+     *
+     * @alias whenMessageHasImage
+     */
+    forImage(): this;
     /**
      * Match when any message contains an image.
      *
@@ -729,6 +728,12 @@ declare class MockBuilder {
      * mockLLM().whenMessageHasImage().returns("I see an image of a sunset.")
      */
     whenMessageHasImage(): this;
+    /**
+     * Match when any message contains audio.
+     *
+     * @alias whenMessageHasAudio
+     */
+    forAudio(): this;
     /**
      * Match when any message contains audio.
      *
@@ -739,10 +744,34 @@ declare class MockBuilder {
     /**
      * Match based on the number of images in the last message.
      *
+     * @alias whenImageCount
+     */
+    withImageCount(predicate: (count: number) => boolean | number): this;
+    /**
+     * Match based on the number of images in the conversation.
+     *
      * @example
      * mockLLM().whenImageCount((n) => n >= 2).returns("Comparing multiple images...")
      */
     whenImageCount(predicate: (count: number) => boolean): this;
+    /**
+     * Return a sequence of responses. Each time the mock matches, it will return the next response in the sequence.
+     * If the sequence reaches the end, it will cycle back to the beginning.
+     *
+     * @example
+     * mockLLM().returnsSequence([
+     *   { text: 'First response' },
+     *   { text: 'Second response' }
+     * ])
+     */
+    returnsSequence(responses: MockResponse[]): this;
+    /**
+     * Set a dynamic response generator function.
+     * Equivalent to withResponse(fn).
+     *
+     * @alias withResponse
+     */
+    returnsDynamic(generator: (context: MockMatcherContext) => MockResponse | Promise<MockResponse>): this;
     /**
      * Set the text response to return.
      * Can be a static string or a function that returns a string dynamically.
@@ -1291,6 +1320,11 @@ declare class MockManager {
  * Helper function to get the global mock manager instance.
  */
 declare function getMockManager(options?: MockOptions): MockManager;
+/**
+ * Reset the global MockManager instance.
+ * Useful for clearing all mocks and state between tests.
+ */
+declare function resetMocks(): void;
 
 /**
  * Create a mock LLM stream from a mock response.
@@ -1419,4 +1453,43 @@ declare function createEmptyStream(): LLMStream;
  */
 declare function createErrorStream(chunksBeforeError: LLMStreamChunk[], error: Error): LLMStream;
 
-export { type MockAudioData, MockBuilder, MockConversationManager, type MockGadget, MockGadgetBuilder, type MockGadgetConfig, type MockImageData, MockManager, type MockMatcher, type MockMatcherContext, type MockOptions, MockPromptRecorder, MockProviderAdapter, type MockRegistration, type MockResponse, type MockStats, type RecordedCall, type TestEnvironment, type TestEnvironmentOptions, type TestGadgetOptions, type TestGadgetResult, collectOutput, collectStream, collectStreamText, createAssistantMessage, createConversation, createConversationWithGadgets, createEmptyStream, createErrorStream, createLargeConversation, createMinimalConversation, createMockAdapter, createMockClient, createMockConversationManager, createMockGadget, createMockPrompt, createMockReadable, createMockStream, createMockWritable, createSystemMessage, createTestEnvironment, createTestStream, createTextMockStream, createTextStream, createUserMessage, estimateTokens, getBufferedOutput, getMockManager, getStreamFinalChunk, mockGadget, mockLLM, testGadget, testGadgetBatch, waitFor };
+/**
+ * Mock TUI App interface.
+ */
+interface MockTUIApp {
+    setProfiles: any;
+    setFocusMode: any;
+    startWaitingForPrompt: any;
+    destroy: any;
+    onQuit: any;
+    onCancel: any;
+    showLLMCallStart: any;
+    updateStreamingTokens: any;
+    clearRetry: any;
+    showThrottling: any;
+    addSystemMessage: any;
+    clearThrottling: any;
+    showRetry: any;
+    showApproval: any;
+    waitForInput: any;
+    subscribeToTree: any;
+    handleEvent: any;
+    addGadgetCost: any;
+    flushText: any;
+    resetAbort: any;
+    startNewSession: any;
+    showUserMessage: any;
+    clearPreviousSession: any;
+    clearStatusBar: any;
+    onMidSessionInput: any;
+    waitForPrompt: any;
+    getAbortSignal: any;
+}
+/**
+ * Creates a mock TUI app for testing.
+ *
+ * NOTE: This currently uses Vitest's `vi` for mocks.
+ */
+declare const createMockTUIApp: () => MockTUIApp;
+
+export { type MockAudioData, MockBuilder, MockConversationManager, type MockGadget, MockGadgetBuilder, type MockGadgetConfig, type MockImageData, MockManager, type MockMatcher, type MockMatcherContext, type MockOptions, MockPromptRecorder, MockProviderAdapter, type MockRegistration, type MockResponse, type MockStats, type MockTUIApp, type RecordedCall, type TestEnvironment, type TestEnvironmentOptions, type TestGadgetOptions, type TestGadgetResult, collectOutput, collectStream, collectStreamText, createAssistantMessage, createConversation, createConversationWithGadgets, createEmptyStream, createErrorStream, createLargeConversation, createMinimalConversation, createMockAdapter, createMockClient, createMockConversationManager, createMockGadget, createMockPrompt, createMockReadable, createMockStream, createMockTUIApp, createMockWritable, createSystemMessage, createTestEnvironment, createTestStream, createTextMockStream, createTextStream, createUserMessage, estimateTokens, getBufferedOutput, getMockManager, getStreamFinalChunk, mockGadget, mockLLM, resetMocks, testGadget, testGadgetBatch, waitFor };