feat(research): Implement research APIs.

test/test.research.openai.ts

@@ -1,9 +1,24 @@
 import { expect, tap } from '@push.rocks/tapbundle';
 import * as qenv from '@push.rocks/qenv';
 import * as smartai from '../ts/index.js';
+import * as path from 'path';
+import { promises as fs } from 'fs';
 
 const testQenv = new qenv.Qenv('./', './.nogit/');
 
+// Helper function to save research results
+async function saveResearchResult(testName: string, result: any) {
+  const sanitizedName = testName.replace(/[^a-z0-9]/gi, '_').toLowerCase();
+  const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+  const filename = `openai_${sanitizedName}_${timestamp}.json`;
+  const filepath = path.join('.nogit', 'testresults', 'research', filename);
+
+  await fs.mkdir(path.dirname(filepath), { recursive: true });
+  await fs.writeFile(filepath, JSON.stringify(result, null, 2), 'utf-8');
+
+  console.log(`  💾 Saved to: ${filepath}`);
+}
+
 let openaiProvider: smartai.OpenAiProvider;
 
 tap.test('OpenAI Research: should initialize provider with research capabilities', async () => {
@@ -29,6 +44,8 @@ tap.test('OpenAI Research: should perform basic research query', async () => {
   console.log('- Sources found:', result.sources.length);
   console.log('- First 200 chars:', result.answer.substring(0, 200));
 
+  await saveResearchResult('basic_research_typescript', result);
+
   expect(result).toBeTruthy();
   expect(result.answer).toBeTruthy();
   expect(result.answer.toLowerCase()).toInclude('typescript');
@@ -52,6 +69,8 @@ tap.test('OpenAI Research: should perform research with web search enabled', asy
     console.log('- Search queries used:', result.searchQueries);
   }
 
+  await saveResearchResult('web_search_ecmascript', result);
+
   expect(result.answer).toBeTruthy();
   expect(result.answer.toLowerCase()).toInclude('ecmascript');
 
@@ -98,6 +117,8 @@ tap.test('OpenAI Research: should extract sources from markdown links', async ()
   console.log('OpenAI Source Extraction:');
   console.log('- Sources found:', result.sources.length);
 
+  await saveResearchResult('source_extraction_nodejs', result);
+
   if (result.sources.length > 0) {
     console.log('- Example source:', result.sources[0]);
     expect(result.sources[0].url).toBeTruthy();