feat(research): Implement research APIs.

test/test.research.anthropic.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 = `${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 anthropicProvider: smartai.AnthropicProvider;
 
 tap.test('Anthropic Research: should initialize provider with web search', async () => {
@@ -28,6 +43,8 @@ tap.test('Anthropic 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_machine_learning', result);
+
   expect(result).toBeTruthy();
   expect(result.answer).toBeTruthy();
   expect(result.answer.toLowerCase()).toInclude('machine learning');
@@ -50,6 +67,8 @@ tap.test('Anthropic Research: should perform research with web search', async ()
     console.log('- Search queries:', result.searchQueries);
   }
 
+  await saveResearchResult('web_search_renewable_energy', result);
+
   expect(result.answer).toBeTruthy();
   expect(result.answer.toLowerCase()).toInclude('renewable');
 
@@ -70,6 +89,8 @@ tap.test('Anthropic Research: should handle deep research queries', async () =>
   console.log('- Answer length:', result.answer.length);
   console.log('- Token usage:', result.metadata?.tokensUsed);
 
+  await saveResearchResult('deep_research_rest_vs_graphql', result);
+
   expect(result.answer).toBeTruthy();
   expect(result.answer.length).toBeGreaterThan(300);
   expect(result.answer.toLowerCase()).toInclude('rest');
@@ -87,6 +108,8 @@ tap.test('Anthropic Research: should extract citations from response', async ()
   console.log('- Sources found:', result.sources.length);
   console.log('- Answer includes Docker:', result.answer.toLowerCase().includes('docker'));
 
+  await saveResearchResult('citation_extraction_docker', result);
+
   expect(result.answer).toInclude('Docker');
 
   // Check for URL extraction (both markdown and plain URLs)
@@ -114,6 +137,8 @@ tap.test('Anthropic Research: should use domain filtering when configured', asyn
   console.log('- Answer length:', result.answer.length);
   console.log('- Applied domain filters (allow: wikipedia, docs.microsoft)');
 
+  await saveResearchResult('domain_filtering_javascript', result);
+
   expect(result.answer).toBeTruthy();
   expect(result.answer.toLowerCase()).toInclude('javascript');
 
@@ -156,6 +181,9 @@ tap.test('Anthropic Research: should handle different search depths', async () =
   console.log('- Basic tokens:', basicResult.metadata?.tokensUsed);
   console.log('- Advanced tokens:', advancedResult.metadata?.tokensUsed);
 
+  await saveResearchResult('search_depth_python_basic', basicResult);
+  await saveResearchResult('search_depth_python_advanced', advancedResult);
+
   expect(basicResult.answer).toBeTruthy();
   expect(advancedResult.answer).toBeTruthy();
 
@@ -165,6 +193,28 @@ tap.test('Anthropic Research: should handle different search depths', async () =
   expect(advancedResult.answer.toLowerCase()).toInclude('python');
 });
 
+tap.test('Anthropic Research: ARM vs. Qualcomm comparison', async () => {
+  const result = await anthropicProvider.research({
+    query: 'Compare ARM and Qualcomm: their technologies, market positions, and recent developments in the mobile and computing sectors',
+    searchDepth: 'advanced',
+    includeWebSearch: true,
+    maxSources: 10
+  });
+
+  console.log('ARM vs. Qualcomm Research:');
+  console.log('- Answer length:', result.answer.length);
+  console.log('- Sources found:', result.sources.length);
+  console.log('- First 300 chars:', result.answer.substring(0, 300));
+
+  await saveResearchResult('arm_vs_qualcomm_comparison', result);
+
+  expect(result.answer).toBeTruthy();
+  expect(result.answer.length).toBeGreaterThan(500);
+  expect(result.answer.toLowerCase()).toInclude('arm');
+  expect(result.answer.toLowerCase()).toInclude('qualcomm');
+  expect(result.sources.length).toBeGreaterThan(0);
+});
+
 tap.test('Anthropic Research: should clean up provider', async () => {
   await anthropicProvider.stop();
   console.log('Anthropic research provider stopped successfully');