
package com.smartgwt.client.docs;

/**
 * Facilities for testing CoT workflows without contacting an AI engine. Use  CoTProcess.mockMode
 * to set a process-wide default and  CoTTask.mockMode to opt individual tasks in or out. <p>
 * <b>Precedence:</b> a task's setting overrides the process default: <ul>  
 * <li><b>task.mockMode:true</b> ? this task mocks, even if the process is not mocking.</li>  
 * <li><b>task.mockMode:false</b> ? this task calls the real AI, even if the process is
 * mocking.</li>   <li><b>task.mockMode:null</b> (or unset) ? inherit  CoTProcess.mockMode.</li>
 * </ul> When mocking is in effect for a task, the framework calls  CoTTask.mockOutput() (if
 * defined), otherwise  CoTProcess.mockOutput(). The returned Object is processed exactly like
 * real AI output (validation, history, state updates, routing). <p> <h4>MockData Capture and
 * Replay</h4> For regression testing, you can capture real AI responses during a live run and
 * replay them later without contacting the AI. Set  captureMockData:true to record responses,
 * then use  mockMode:true with the captured  CoTProcess.mockData array for replay. <p>
 * <b>Note:</b> Replay is sensitive to environment differences. See  CoTProcess.captureMockData
 * for details on avoiding false regressions.
 */
public interface CoTMocking {
}
