@thanh01.pmt/research-kit 1.2.3 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (69) hide show
  1. package/dist/academic/index.cjs +122 -0
  2. package/dist/academic/index.cjs.map +1 -1
  3. package/dist/academic/index.d.cts +27 -4
  4. package/dist/academic/index.d.ts +27 -4
  5. package/dist/academic/index.js +2 -1
  6. package/dist/agent/index.cjs +3441 -0
  7. package/dist/agent/index.cjs.map +1 -0
  8. package/dist/agent/index.d.cts +10 -0
  9. package/dist/agent/index.d.ts +10 -0
  10. package/dist/agent/index.js +10 -0
  11. package/dist/agent/index.js.map +1 -0
  12. package/dist/{catalogBuilder-B4eiLS_S.d.cts → catalogBuilder-BBCa9jqI.d.cts} +2 -2
  13. package/dist/{catalogBuilder-BNB_gaWP.d.ts → catalogBuilder-D-UiM37y.d.ts} +2 -2
  14. package/dist/chunk-2GBXVPOQ.js +3 -0
  15. package/dist/{chunk-J3VCGH7Z.js.map → chunk-2GBXVPOQ.js.map} +1 -1
  16. package/dist/chunk-2RMBLKP5.js +581 -0
  17. package/dist/chunk-2RMBLKP5.js.map +1 -0
  18. package/dist/{chunk-2XIEWCUE.js → chunk-32B5PVTQ.js} +2 -2
  19. package/dist/{chunk-2XIEWCUE.js.map → chunk-32B5PVTQ.js.map} +1 -1
  20. package/dist/chunk-LDCZ33AC.js +3 -0
  21. package/dist/chunk-LDCZ33AC.js.map +1 -0
  22. package/dist/chunk-NSY6KU4G.js +125 -0
  23. package/dist/chunk-NSY6KU4G.js.map +1 -0
  24. package/dist/{chunk-SAHBBO3U.js → chunk-RYLZYZRF.js} +4 -580
  25. package/dist/chunk-RYLZYZRF.js.map +1 -0
  26. package/dist/{chunk-P6RHBJY2.js → chunk-S3JUCDKD.js} +62 -40
  27. package/dist/chunk-S3JUCDKD.js.map +1 -0
  28. package/dist/chunk-TYQEC24G.js +3 -0
  29. package/dist/chunk-TYQEC24G.js.map +1 -0
  30. package/dist/chunk-WWQ45RQK.js +1114 -0
  31. package/dist/chunk-WWQ45RQK.js.map +1 -0
  32. package/dist/{chunk-YICMTZS5.js → chunk-ZNGU4ZYX.js} +171 -3
  33. package/dist/chunk-ZNGU4ZYX.js.map +1 -0
  34. package/dist/config/index.d.cts +1 -1
  35. package/dist/config/index.d.ts +1 -1
  36. package/dist/evidence/index.d.cts +2 -2
  37. package/dist/evidence/index.d.ts +2 -2
  38. package/dist/evidence/index.js +2 -1
  39. package/dist/harvester/index.cjs +168 -1
  40. package/dist/harvester/index.cjs.map +1 -1
  41. package/dist/harvester/index.d.cts +5 -161
  42. package/dist/harvester/index.d.ts +5 -161
  43. package/dist/harvester/index.js +4 -2
  44. package/dist/index-CN8gei7k.d.ts +518 -0
  45. package/dist/{index-9rDiFuR4.d.ts → index-CxoD81QN.d.cts} +1 -1
  46. package/dist/{index-9rDiFuR4.d.cts → index-CxoD81QN.d.ts} +1 -1
  47. package/dist/index-onQDKDNo.d.cts +518 -0
  48. package/dist/index.cjs +1463 -36
  49. package/dist/index.cjs.map +1 -1
  50. package/dist/index.d.cts +11 -174
  51. package/dist/index.d.ts +11 -174
  52. package/dist/index.js +25 -10
  53. package/dist/index.js.map +1 -1
  54. package/dist/{literatureReview-DOzgm9Q2.d.ts → literatureReview-Bn2iEGRO.d.ts} +1 -1
  55. package/dist/{literatureReview-BwidpYJo.d.cts → literatureReview-Bvlqk4DB.d.cts} +1 -1
  56. package/dist/pipeline/index.cjs +59 -38
  57. package/dist/pipeline/index.cjs.map +1 -1
  58. package/dist/pipeline/index.d.cts +5 -4
  59. package/dist/pipeline/index.d.ts +5 -4
  60. package/dist/pipeline/index.js +3 -2
  61. package/dist/socialPulseHarvester-CN4MwrpY.d.cts +204 -0
  62. package/dist/socialPulseHarvester-IbdT3zD1.d.ts +204 -0
  63. package/dist/{webScraper-CAQjE46m.d.cts → webScraper-BVvNW4yj.d.cts} +1 -1
  64. package/dist/{webScraper-CXIpvyA6.d.ts → webScraper-C9pB5Rgd.d.ts} +1 -1
  65. package/package.json +6 -1
  66. package/dist/chunk-J3VCGH7Z.js +0 -3
  67. package/dist/chunk-P6RHBJY2.js.map +0 -1
  68. package/dist/chunk-SAHBBO3U.js.map +0 -1
  69. package/dist/chunk-YICMTZS5.js.map +0 -1
package/dist/index.d.cts CHANGED
@@ -1,175 +1,12 @@
1
- import { R as ResearchApiKeys, L as LlmTextFn, C as CourseResearchContext, a as CustomSearchAdapter, b as CustomCrawlerAdapter, c as CustomAcademicSearchAdapter, d as CustomSynthesizerAdapter, E as ExtractedConceptNode, A as AcademicPaper } from './index-9rDiFuR4.cjs';
2
- export { j as AcademicPaperSchema, l as AcademicSearchEngine, k as AcademicSearchOptions, f as ConceptFacets, e as CrawlerProviderType, D as DEFAULT_RESEARCH_CONFIG, i as ResearchConfig, h as ResearchConfigSchema, S as SearchProviderType, g as SynthesizedResearchInsights, r as reconstructOpenAlexAbstract } from './index-9rDiFuR4.cjs';
3
- export { ArXivSearchEngine, CitationItem, CitationManager } from './academic/index.cjs';
4
- import { T as TaxonomyMappingResult, L as LiteratureReviewReport } from './literatureReview-BwidpYJo.cjs';
5
- export { C as CS2023KnowledgeArea, c as CS2023_KNOWLEDGE_AREAS, a as CSTAK12Strand, b as CSTA_K12_STRANDS, d as LiteratureReviewSynthesizer, S as SotaComparisonRow, m as mapTopicToCS2023 } from './literatureReview-BwidpYJo.cjs';
6
- import { S as ScrapedDocument, T as TechnicalDomain } from './webScraper-CAQjE46m.cjs';
7
- export { D as DomainClassificationResult, E as ExtractedCodeBlock, a as WebScraper, W as WebScraperOptions, c as classifyTechnicalDomain, e as extractSubstantiveExcerpts, i as inferPrimaryCodeLanguage } from './webScraper-CAQjE46m.cjs';
8
- import { S as SearchHit } from './catalogBuilder-B4eiLS_S.cjs';
9
- export { C as CatalogBuilder, H as HarvestedResourceItem, M as MultiSearchOptions, b as MultiSourceSearchEngine, R as ResourceCatalogBundle, a as SearchTimeRange } from './catalogBuilder-B4eiLS_S.cjs';
10
- import { YouTubeTranscriptResult, StemResearchOptions, StemResourceCatalog, TermExtractionBundle, HealthAuditResult } from './harvester/index.cjs';
11
- export { ContentQualityScore, ECOMMERCE_AND_COMMERCIAL_PATTERNS, ECOMMERCE_DOMAINS, GitHubCurriculumClient, GraphEdge, HealthAuditor, NasaMediaClient, OpenverseClient, PedagogicalTermExtractor, ReducedGraphResult, StemResourceItem, StemResourceLicense, StemResourceProvider, StemResourceQueryType, StemResourceResearcher, StemResourceType, TopoSortResult, TranscriptSegment, YouTubeIngestionService, evaluateTechnicalDensity, extractYouTubeVideoId, formatTimestamp, isCommercialOrNoise, isYouTubeUrl, kahnTopologicalSort, stitchCaptionSegments, transitiveReduction } from './harvester/index.cjs';
12
- import { ScoredEvidence, ClaimSweepReport } from './evidence/index.cjs';
13
- export { ClaimVerdict, ClaimVerifier, EvidenceScorer, VerifiedClaim, extractTopSentences } from './evidence/index.cjs';
14
- import { P as ProvenanceRecord, a as ProvenanceSidecar } from './provenanceTracker-ct4s5lJV.cjs';
15
- export { b as ProvenanceTracker } from './provenanceTracker-ct4s5lJV.cjs';
16
- import { ResearchPlan, HarvestPipelineOptions, HarvestPipelineResult, TechnicalFactsheet } from './pipeline/index.cjs';
17
- export { CampaignPlanner, ExemplarProject, HarvestPipeline, ReferencePackBuilder, ReferencePackOutput, ReferenceRegistryItem, TechnicalGroundingEngine, normalizeUrlForDedup } from './pipeline/index.cjs';
1
+ export { j as AcademicPaper, A as AcademicPaperSchema, l as AcademicSearchEngine, k as AcademicSearchOptions, e as ConceptFacets, a as CourseResearchContext, C as CrawlerProviderType, d as CustomAcademicSearchAdapter, c as CustomCrawlerAdapter, b as CustomSearchAdapter, g as CustomSynthesizerAdapter, D as DEFAULT_RESEARCH_CONFIG, E as ExtractedConceptNode, L as LlmTextFn, R as ResearchApiKeys, i as ResearchConfig, h as ResearchConfigSchema, S as SearchProviderType, f as SynthesizedResearchInsights, r as reconstructOpenAlexAbstract } from './index-CxoD81QN.cjs';
2
+ export { ArXivSearchEngine, CitationItem, CitationManager, OpenAlexClient, OpenAlexSearchOptions, cleanCrossrefAbstract } from './academic/index.cjs';
3
+ export { C as CS2023KnowledgeArea, c as CS2023_KNOWLEDGE_AREAS, a as CSTAK12Strand, b as CSTA_K12_STRANDS, L as LiteratureReviewReport, d as LiteratureReviewSynthesizer, S as SotaComparisonRow, T as TaxonomyMappingResult, m as mapTopicToCS2023 } from './literatureReview-Bvlqk4DB.cjs';
4
+ export { D as DomainClassificationResult, E as ExtractedCodeBlock, S as ScrapedDocument, T as TechnicalDomain, a as WebScraper, W as WebScraperOptions, c as classifyTechnicalDomain, e as extractSubstantiveExcerpts, i as inferPrimaryCodeLanguage } from './webScraper-BVvNW4yj.cjs';
5
+ export { C as CatalogBuilder, H as HarvestedResourceItem, M as MultiSearchOptions, b as MultiSourceSearchEngine, R as ResourceCatalogBundle, S as SearchHit, a as SearchTimeRange } from './catalogBuilder-BBCa9jqI.cjs';
6
+ export { G as GitHubCurriculumClient, H as HealthAuditResult, c as HealthAuditor, N as NasaMediaClient, O as OpenverseClient, P as PedagogicalTermExtractor, r as SocialPulseHarvester, o as SocialPulseItem, p as SocialPulseOptions, n as SocialPulsePlatform, q as SocialPulseReport, k as StemResearchOptions, l as StemResourceCatalog, j as StemResourceItem, h as StemResourceLicense, g as StemResourceProvider, d as StemResourceQueryType, m as StemResourceResearcher, S as StemResourceType, b as TermExtractionBundle, T as TranscriptSegment, a as YouTubeIngestionService, Y as YouTubeTranscriptResult, e as extractYouTubeVideoId, f as formatTimestamp, i as isYouTubeUrl, s as stitchCaptionSegments } from './socialPulseHarvester-CN4MwrpY.cjs';
7
+ export { ContentQualityScore, ECOMMERCE_AND_COMMERCIAL_PATTERNS, ECOMMERCE_DOMAINS, GraphEdge, ReducedGraphResult, TopoSortResult, evaluateTechnicalDensity, isCommercialOrNoise, kahnTopologicalSort, transitiveReduction } from './harvester/index.cjs';
8
+ export { ClaimSweepReport, ClaimVerdict, ClaimVerifier, EvidenceScorer, ScoredEvidence, VerifiedClaim, extractTopSentences } from './evidence/index.cjs';
9
+ export { P as ProvenanceRecord, a as ProvenanceSidecar, b as ProvenanceTracker } from './provenanceTracker-ct4s5lJV.cjs';
10
+ export { CampaignPlanner, ExemplarProject, HarvestPipeline, HarvestPipelineOptions, HarvestPipelineResult, ReferencePackBuilder, ReferencePackOutput, ReferenceRegistryItem, ResearchPlan, TechnicalFactsheet, TechnicalGroundingEngine, normalizeUrlForDedup } from './pipeline/index.cjs';
11
+ export { A as AcademicStandardsService, C as CitationReceipt, E as EvidenceLedger, n as EvidenceVerificationService, K as KnowledgeDiscoveryService, L as LedgerItem, o as PedagogicalSynthesisService, P as ProfilePreset, g as RESEARCH_PROFILE_PRESETS, a as ResearchAcceptanceCriteria, f as ResearchAgentResult, d as ResearchAgentStatus, k as ResearchAgentToolInput, j as ResearchAgentToolInputSchema, b as ResearchBudget, c as ResearchContract, q as ResearchKitClient, m as ResearchKitClientConfig, R as ResearchProfile, e as ResearchRoundTrace, h as ResearchSubAgent, p as TechnicalGroundingService, T as TerminologyGraphService, l as createResearchAgentTool, r as resolveResearchProfile, i as runResearchSubAgent } from './index-onQDKDNo.cjs';
18
12
  import 'zod';
19
-
20
- interface ResearchKitClientConfig {
21
- /**
22
- * API keys configured in the host application (e.g., Settings UI / DB / Vault).
23
- */
24
- apiKeys?: ResearchApiKeys;
25
- /**
26
- * Whether to fall back to `process.env.*` if a key is not provided in `apiKeys`.
27
- * Set to `false` in strict multi-tenant or desktop apps where only app-configured keys are allowed.
28
- * Defaults to `true`.
29
- */
30
- allowEnvFallback?: boolean;
31
- /**
32
- * Optional Crawl4AI self-hosted endpoint.
33
- */
34
- crawl4aiHost?: string;
35
- /**
36
- * Optional LLM text completion callback injected from the host application
37
- * (e.g., NineRouter / OpenRouter / AI SDK in smart-curriculum).
38
- */
39
- llm?: LlmTextFn;
40
- /**
41
- * Default course context (age band, hardware/software tools, language) applied across services.
42
- */
43
- defaultCourseContext?: CourseResearchContext;
44
- /**
45
- * Optional custom adapters.
46
- */
47
- customSearchAdapter?: CustomSearchAdapter;
48
- customCrawlerAdapter?: CustomCrawlerAdapter;
49
- customAcademicSearchAdapter?: CustomAcademicSearchAdapter;
50
- customSynthesizerAdapter?: CustomSynthesizerAdapter;
51
- }
52
- /**
53
- * Service 1: Crawl, Search & Multimodal Knowledge Discovery
54
- */
55
- declare class KnowledgeDiscoveryService {
56
- private config;
57
- private searchEngine;
58
- private webScraper;
59
- private youtubeService;
60
- private stemResearcher;
61
- constructor(config: ResearchKitClientConfig);
62
- search(query: string, limit?: number): Promise<SearchHit[]>;
63
- scrapeUrl(url: string): Promise<ScrapedDocument>;
64
- ingestYouTube(urlOrVideoId: string, preferredLanguages?: string[]): Promise<YouTubeTranscriptResult>;
65
- findStemResources(query: string, options?: StemResearchOptions): Promise<StemResourceCatalog>;
66
- }
67
- /**
68
- * Service 2: Bilingual Term Extraction & Prerequisite Concept Graph (DAG)
69
- */
70
- declare class TerminologyGraphService {
71
- private config;
72
- private extractor;
73
- constructor(config: ResearchKitClientConfig);
74
- extractConceptsDeterministic(topic: string, docs: Array<{
75
- resourceId: string;
76
- doc: ScrapedDocument;
77
- }> | string, domain?: TechnicalDomain): TermExtractionBundle;
78
- extractConcepts(topic: string, docs: Array<{
79
- resourceId: string;
80
- doc: ScrapedDocument;
81
- }> | string, options?: {
82
- domain?: TechnicalDomain;
83
- context?: CourseResearchContext;
84
- llm?: LlmTextFn;
85
- maxTerms?: number;
86
- }): Promise<TermExtractionBundle>;
87
- formatConceptDagTsv(concepts: ExtractedConceptNode[]): string;
88
- }
89
- /**
90
- * Service 3: Academic Literature & Curricular Standards Alignment (ACM/IEEE CS2023 + CSTA K-12)
91
- */
92
- declare class AcademicStandardsService {
93
- private config;
94
- private academicSearch;
95
- private litSynthesizer;
96
- constructor(config: ResearchKitClientConfig);
97
- alignStandards(topic: string, context?: CourseResearchContext): TaxonomyMappingResult;
98
- searchPapers(query: string, limit?: number): Promise<AcademicPaper[]>;
99
- synthesizeLiteratureReview(topic: string, papers: AcademicPaper[], context?: CourseResearchContext): LiteratureReviewReport;
100
- synthesizeLiteratureReviewWithLlm(topic: string, papers: AcademicPaper[], context?: CourseResearchContext, options?: {
101
- llm?: LlmTextFn;
102
- }): Promise<LiteratureReviewReport>;
103
- }
104
- /**
105
- * Service 4: Document Health Audit, Evidence Scoring, Claim Verification & Provenance
106
- */
107
- declare class EvidenceVerificationService {
108
- private config;
109
- private healthAuditor;
110
- private evidenceScorer;
111
- private claimVerifier;
112
- private provenanceTracker;
113
- constructor(config?: ResearchKitClientConfig);
114
- auditDocument(doc: ScrapedDocument): HealthAuditResult;
115
- scoreDocument(doc: ScrapedDocument, domain: TechnicalDomain, topic: string): ScoredEvidence;
116
- scoreDocumentWithLlm(doc: ScrapedDocument, domain: TechnicalDomain, topic: string, options?: {
117
- llm?: LlmTextFn;
118
- context?: CourseResearchContext;
119
- }): Promise<ScoredEvidence>;
120
- verifyClaimsDeterministic(claimsToVerify: string[], sourceCorpusText: string): ClaimSweepReport;
121
- verifyClaims(claimsToVerify: string[], sourceCorpusText: string, options?: {
122
- llm?: LlmTextFn;
123
- }): Promise<ClaimSweepReport>;
124
- buildProvenance(topic: string, records: ProvenanceRecord[]): ProvenanceSidecar;
125
- }
126
- /**
127
- * Service 5: Pedagogical Synthesis & Ground Truth Reference Pack Orchestration
128
- */
129
- declare class PedagogicalSynthesisService {
130
- private config;
131
- private planner;
132
- private pipeline;
133
- constructor(config: ResearchKitClientConfig);
134
- planCampaign(topic: string, options?: {
135
- domain?: TechnicalDomain;
136
- isDeep?: boolean;
137
- maxRounds?: number;
138
- context?: CourseResearchContext;
139
- }): Promise<ResearchPlan>;
140
- runFullHarvest(topic: string, overrides?: Partial<HarvestPipelineOptions>): Promise<HarvestPipelineResult>;
141
- }
142
- /**
143
- * Service 6: Empirical Factsheet & Hardware/Software Technical Grounding (v1.2.0)
144
- */
145
- declare class TechnicalGroundingService {
146
- private config;
147
- private engine;
148
- constructor(config: ResearchKitClientConfig);
149
- buildFactsheet(topic: string, options?: {
150
- domain?: TechnicalDomain;
151
- context?: CourseResearchContext;
152
- }): Promise<TechnicalFactsheet>;
153
- }
154
- /**
155
- * Unified facade exposing all 6 core services of `@thanh01.pmt/research-kit`
156
- * configured with host-application API keys and LLM callbacks.
157
- */
158
- declare class ResearchKitClient {
159
- private readonly config;
160
- /** Service 1: Multi-Engine Web Search, Scraper & YouTube Transcript Ingestion */
161
- readonly discovery: KnowledgeDiscoveryService;
162
- /** Service 2: Bilingual Pedagogical Term Extraction & Prerequisite Concept Graph (DAG) */
163
- readonly terminology: TerminologyGraphService;
164
- /** Service 3: Academic Literature Search, BibTeX Citations & CS2023/CSTA K-12 Alignment */
165
- readonly academic: AcademicStandardsService;
166
- /** Service 4: Health Audit, Evidence Scoring, Claim Verification & Provenance Tracking */
167
- readonly verification: EvidenceVerificationService;
168
- /** Service 5: Campaign Planning, Semantic Synthesis & Canonical Reference Pack Orchestration */
169
- readonly orchestrator: PedagogicalSynthesisService;
170
- /** Service 6: Technical Grounding, Hardware/Software Compatibility & Empirical Exemplars */
171
- readonly grounding: TechnicalGroundingService;
172
- constructor(config?: ResearchKitClientConfig);
173
- }
174
-
175
- export { AcademicPaper, AcademicStandardsService, ClaimSweepReport, CourseResearchContext, CustomAcademicSearchAdapter, CustomCrawlerAdapter, CustomSearchAdapter, CustomSynthesizerAdapter, EvidenceVerificationService, ExtractedConceptNode, HarvestPipelineOptions, HarvestPipelineResult, HealthAuditResult, KnowledgeDiscoveryService, LiteratureReviewReport, LlmTextFn, PedagogicalSynthesisService, ProvenanceRecord, ProvenanceSidecar, ResearchApiKeys, ResearchKitClient, type ResearchKitClientConfig, ResearchPlan, ScoredEvidence, ScrapedDocument, SearchHit, StemResearchOptions, StemResourceCatalog, TaxonomyMappingResult, TechnicalDomain, TechnicalFactsheet, TechnicalGroundingService, TermExtractionBundle, TerminologyGraphService, YouTubeTranscriptResult };
package/dist/index.d.ts CHANGED
@@ -1,175 +1,12 @@
1
- import { R as ResearchApiKeys, L as LlmTextFn, C as CourseResearchContext, a as CustomSearchAdapter, b as CustomCrawlerAdapter, c as CustomAcademicSearchAdapter, d as CustomSynthesizerAdapter, E as ExtractedConceptNode, A as AcademicPaper } from './index-9rDiFuR4.js';
2
- export { j as AcademicPaperSchema, l as AcademicSearchEngine, k as AcademicSearchOptions, f as ConceptFacets, e as CrawlerProviderType, D as DEFAULT_RESEARCH_CONFIG, i as ResearchConfig, h as ResearchConfigSchema, S as SearchProviderType, g as SynthesizedResearchInsights, r as reconstructOpenAlexAbstract } from './index-9rDiFuR4.js';
3
- export { ArXivSearchEngine, CitationItem, CitationManager } from './academic/index.js';
4
- import { T as TaxonomyMappingResult, L as LiteratureReviewReport } from './literatureReview-DOzgm9Q2.js';
5
- export { C as CS2023KnowledgeArea, c as CS2023_KNOWLEDGE_AREAS, a as CSTAK12Strand, b as CSTA_K12_STRANDS, d as LiteratureReviewSynthesizer, S as SotaComparisonRow, m as mapTopicToCS2023 } from './literatureReview-DOzgm9Q2.js';
6
- import { S as ScrapedDocument, T as TechnicalDomain } from './webScraper-CXIpvyA6.js';
7
- export { D as DomainClassificationResult, E as ExtractedCodeBlock, a as WebScraper, W as WebScraperOptions, c as classifyTechnicalDomain, e as extractSubstantiveExcerpts, i as inferPrimaryCodeLanguage } from './webScraper-CXIpvyA6.js';
8
- import { S as SearchHit } from './catalogBuilder-BNB_gaWP.js';
9
- export { C as CatalogBuilder, H as HarvestedResourceItem, M as MultiSearchOptions, b as MultiSourceSearchEngine, R as ResourceCatalogBundle, a as SearchTimeRange } from './catalogBuilder-BNB_gaWP.js';
10
- import { YouTubeTranscriptResult, StemResearchOptions, StemResourceCatalog, TermExtractionBundle, HealthAuditResult } from './harvester/index.js';
11
- export { ContentQualityScore, ECOMMERCE_AND_COMMERCIAL_PATTERNS, ECOMMERCE_DOMAINS, GitHubCurriculumClient, GraphEdge, HealthAuditor, NasaMediaClient, OpenverseClient, PedagogicalTermExtractor, ReducedGraphResult, StemResourceItem, StemResourceLicense, StemResourceProvider, StemResourceQueryType, StemResourceResearcher, StemResourceType, TopoSortResult, TranscriptSegment, YouTubeIngestionService, evaluateTechnicalDensity, extractYouTubeVideoId, formatTimestamp, isCommercialOrNoise, isYouTubeUrl, kahnTopologicalSort, stitchCaptionSegments, transitiveReduction } from './harvester/index.js';
12
- import { ScoredEvidence, ClaimSweepReport } from './evidence/index.js';
13
- export { ClaimVerdict, ClaimVerifier, EvidenceScorer, VerifiedClaim, extractTopSentences } from './evidence/index.js';
14
- import { P as ProvenanceRecord, a as ProvenanceSidecar } from './provenanceTracker-ct4s5lJV.js';
15
- export { b as ProvenanceTracker } from './provenanceTracker-ct4s5lJV.js';
16
- import { ResearchPlan, HarvestPipelineOptions, HarvestPipelineResult, TechnicalFactsheet } from './pipeline/index.js';
17
- export { CampaignPlanner, ExemplarProject, HarvestPipeline, ReferencePackBuilder, ReferencePackOutput, ReferenceRegistryItem, TechnicalGroundingEngine, normalizeUrlForDedup } from './pipeline/index.js';
1
+ export { j as AcademicPaper, A as AcademicPaperSchema, l as AcademicSearchEngine, k as AcademicSearchOptions, e as ConceptFacets, a as CourseResearchContext, C as CrawlerProviderType, d as CustomAcademicSearchAdapter, c as CustomCrawlerAdapter, b as CustomSearchAdapter, g as CustomSynthesizerAdapter, D as DEFAULT_RESEARCH_CONFIG, E as ExtractedConceptNode, L as LlmTextFn, R as ResearchApiKeys, i as ResearchConfig, h as ResearchConfigSchema, S as SearchProviderType, f as SynthesizedResearchInsights, r as reconstructOpenAlexAbstract } from './index-CxoD81QN.js';
2
+ export { ArXivSearchEngine, CitationItem, CitationManager, OpenAlexClient, OpenAlexSearchOptions, cleanCrossrefAbstract } from './academic/index.js';
3
+ export { C as CS2023KnowledgeArea, c as CS2023_KNOWLEDGE_AREAS, a as CSTAK12Strand, b as CSTA_K12_STRANDS, L as LiteratureReviewReport, d as LiteratureReviewSynthesizer, S as SotaComparisonRow, T as TaxonomyMappingResult, m as mapTopicToCS2023 } from './literatureReview-Bn2iEGRO.js';
4
+ export { D as DomainClassificationResult, E as ExtractedCodeBlock, S as ScrapedDocument, T as TechnicalDomain, a as WebScraper, W as WebScraperOptions, c as classifyTechnicalDomain, e as extractSubstantiveExcerpts, i as inferPrimaryCodeLanguage } from './webScraper-C9pB5Rgd.js';
5
+ export { C as CatalogBuilder, H as HarvestedResourceItem, M as MultiSearchOptions, b as MultiSourceSearchEngine, R as ResourceCatalogBundle, S as SearchHit, a as SearchTimeRange } from './catalogBuilder-D-UiM37y.js';
6
+ export { G as GitHubCurriculumClient, H as HealthAuditResult, c as HealthAuditor, N as NasaMediaClient, O as OpenverseClient, P as PedagogicalTermExtractor, r as SocialPulseHarvester, o as SocialPulseItem, p as SocialPulseOptions, n as SocialPulsePlatform, q as SocialPulseReport, k as StemResearchOptions, l as StemResourceCatalog, j as StemResourceItem, h as StemResourceLicense, g as StemResourceProvider, d as StemResourceQueryType, m as StemResourceResearcher, S as StemResourceType, b as TermExtractionBundle, T as TranscriptSegment, a as YouTubeIngestionService, Y as YouTubeTranscriptResult, e as extractYouTubeVideoId, f as formatTimestamp, i as isYouTubeUrl, s as stitchCaptionSegments } from './socialPulseHarvester-IbdT3zD1.js';
7
+ export { ContentQualityScore, ECOMMERCE_AND_COMMERCIAL_PATTERNS, ECOMMERCE_DOMAINS, GraphEdge, ReducedGraphResult, TopoSortResult, evaluateTechnicalDensity, isCommercialOrNoise, kahnTopologicalSort, transitiveReduction } from './harvester/index.js';
8
+ export { ClaimSweepReport, ClaimVerdict, ClaimVerifier, EvidenceScorer, ScoredEvidence, VerifiedClaim, extractTopSentences } from './evidence/index.js';
9
+ export { P as ProvenanceRecord, a as ProvenanceSidecar, b as ProvenanceTracker } from './provenanceTracker-ct4s5lJV.js';
10
+ export { CampaignPlanner, ExemplarProject, HarvestPipeline, HarvestPipelineOptions, HarvestPipelineResult, ReferencePackBuilder, ReferencePackOutput, ReferenceRegistryItem, ResearchPlan, TechnicalFactsheet, TechnicalGroundingEngine, normalizeUrlForDedup } from './pipeline/index.js';
11
+ export { A as AcademicStandardsService, C as CitationReceipt, E as EvidenceLedger, n as EvidenceVerificationService, K as KnowledgeDiscoveryService, L as LedgerItem, o as PedagogicalSynthesisService, P as ProfilePreset, g as RESEARCH_PROFILE_PRESETS, a as ResearchAcceptanceCriteria, f as ResearchAgentResult, d as ResearchAgentStatus, k as ResearchAgentToolInput, j as ResearchAgentToolInputSchema, b as ResearchBudget, c as ResearchContract, q as ResearchKitClient, m as ResearchKitClientConfig, R as ResearchProfile, e as ResearchRoundTrace, h as ResearchSubAgent, p as TechnicalGroundingService, T as TerminologyGraphService, l as createResearchAgentTool, r as resolveResearchProfile, i as runResearchSubAgent } from './index-CN8gei7k.js';
18
12
  import 'zod';
19
-
20
- interface ResearchKitClientConfig {
21
- /**
22
- * API keys configured in the host application (e.g., Settings UI / DB / Vault).
23
- */
24
- apiKeys?: ResearchApiKeys;
25
- /**
26
- * Whether to fall back to `process.env.*` if a key is not provided in `apiKeys`.
27
- * Set to `false` in strict multi-tenant or desktop apps where only app-configured keys are allowed.
28
- * Defaults to `true`.
29
- */
30
- allowEnvFallback?: boolean;
31
- /**
32
- * Optional Crawl4AI self-hosted endpoint.
33
- */
34
- crawl4aiHost?: string;
35
- /**
36
- * Optional LLM text completion callback injected from the host application
37
- * (e.g., NineRouter / OpenRouter / AI SDK in smart-curriculum).
38
- */
39
- llm?: LlmTextFn;
40
- /**
41
- * Default course context (age band, hardware/software tools, language) applied across services.
42
- */
43
- defaultCourseContext?: CourseResearchContext;
44
- /**
45
- * Optional custom adapters.
46
- */
47
- customSearchAdapter?: CustomSearchAdapter;
48
- customCrawlerAdapter?: CustomCrawlerAdapter;
49
- customAcademicSearchAdapter?: CustomAcademicSearchAdapter;
50
- customSynthesizerAdapter?: CustomSynthesizerAdapter;
51
- }
52
- /**
53
- * Service 1: Crawl, Search & Multimodal Knowledge Discovery
54
- */
55
- declare class KnowledgeDiscoveryService {
56
- private config;
57
- private searchEngine;
58
- private webScraper;
59
- private youtubeService;
60
- private stemResearcher;
61
- constructor(config: ResearchKitClientConfig);
62
- search(query: string, limit?: number): Promise<SearchHit[]>;
63
- scrapeUrl(url: string): Promise<ScrapedDocument>;
64
- ingestYouTube(urlOrVideoId: string, preferredLanguages?: string[]): Promise<YouTubeTranscriptResult>;
65
- findStemResources(query: string, options?: StemResearchOptions): Promise<StemResourceCatalog>;
66
- }
67
- /**
68
- * Service 2: Bilingual Term Extraction & Prerequisite Concept Graph (DAG)
69
- */
70
- declare class TerminologyGraphService {
71
- private config;
72
- private extractor;
73
- constructor(config: ResearchKitClientConfig);
74
- extractConceptsDeterministic(topic: string, docs: Array<{
75
- resourceId: string;
76
- doc: ScrapedDocument;
77
- }> | string, domain?: TechnicalDomain): TermExtractionBundle;
78
- extractConcepts(topic: string, docs: Array<{
79
- resourceId: string;
80
- doc: ScrapedDocument;
81
- }> | string, options?: {
82
- domain?: TechnicalDomain;
83
- context?: CourseResearchContext;
84
- llm?: LlmTextFn;
85
- maxTerms?: number;
86
- }): Promise<TermExtractionBundle>;
87
- formatConceptDagTsv(concepts: ExtractedConceptNode[]): string;
88
- }
89
- /**
90
- * Service 3: Academic Literature & Curricular Standards Alignment (ACM/IEEE CS2023 + CSTA K-12)
91
- */
92
- declare class AcademicStandardsService {
93
- private config;
94
- private academicSearch;
95
- private litSynthesizer;
96
- constructor(config: ResearchKitClientConfig);
97
- alignStandards(topic: string, context?: CourseResearchContext): TaxonomyMappingResult;
98
- searchPapers(query: string, limit?: number): Promise<AcademicPaper[]>;
99
- synthesizeLiteratureReview(topic: string, papers: AcademicPaper[], context?: CourseResearchContext): LiteratureReviewReport;
100
- synthesizeLiteratureReviewWithLlm(topic: string, papers: AcademicPaper[], context?: CourseResearchContext, options?: {
101
- llm?: LlmTextFn;
102
- }): Promise<LiteratureReviewReport>;
103
- }
104
- /**
105
- * Service 4: Document Health Audit, Evidence Scoring, Claim Verification & Provenance
106
- */
107
- declare class EvidenceVerificationService {
108
- private config;
109
- private healthAuditor;
110
- private evidenceScorer;
111
- private claimVerifier;
112
- private provenanceTracker;
113
- constructor(config?: ResearchKitClientConfig);
114
- auditDocument(doc: ScrapedDocument): HealthAuditResult;
115
- scoreDocument(doc: ScrapedDocument, domain: TechnicalDomain, topic: string): ScoredEvidence;
116
- scoreDocumentWithLlm(doc: ScrapedDocument, domain: TechnicalDomain, topic: string, options?: {
117
- llm?: LlmTextFn;
118
- context?: CourseResearchContext;
119
- }): Promise<ScoredEvidence>;
120
- verifyClaimsDeterministic(claimsToVerify: string[], sourceCorpusText: string): ClaimSweepReport;
121
- verifyClaims(claimsToVerify: string[], sourceCorpusText: string, options?: {
122
- llm?: LlmTextFn;
123
- }): Promise<ClaimSweepReport>;
124
- buildProvenance(topic: string, records: ProvenanceRecord[]): ProvenanceSidecar;
125
- }
126
- /**
127
- * Service 5: Pedagogical Synthesis & Ground Truth Reference Pack Orchestration
128
- */
129
- declare class PedagogicalSynthesisService {
130
- private config;
131
- private planner;
132
- private pipeline;
133
- constructor(config: ResearchKitClientConfig);
134
- planCampaign(topic: string, options?: {
135
- domain?: TechnicalDomain;
136
- isDeep?: boolean;
137
- maxRounds?: number;
138
- context?: CourseResearchContext;
139
- }): Promise<ResearchPlan>;
140
- runFullHarvest(topic: string, overrides?: Partial<HarvestPipelineOptions>): Promise<HarvestPipelineResult>;
141
- }
142
- /**
143
- * Service 6: Empirical Factsheet & Hardware/Software Technical Grounding (v1.2.0)
144
- */
145
- declare class TechnicalGroundingService {
146
- private config;
147
- private engine;
148
- constructor(config: ResearchKitClientConfig);
149
- buildFactsheet(topic: string, options?: {
150
- domain?: TechnicalDomain;
151
- context?: CourseResearchContext;
152
- }): Promise<TechnicalFactsheet>;
153
- }
154
- /**
155
- * Unified facade exposing all 6 core services of `@thanh01.pmt/research-kit`
156
- * configured with host-application API keys and LLM callbacks.
157
- */
158
- declare class ResearchKitClient {
159
- private readonly config;
160
- /** Service 1: Multi-Engine Web Search, Scraper & YouTube Transcript Ingestion */
161
- readonly discovery: KnowledgeDiscoveryService;
162
- /** Service 2: Bilingual Pedagogical Term Extraction & Prerequisite Concept Graph (DAG) */
163
- readonly terminology: TerminologyGraphService;
164
- /** Service 3: Academic Literature Search, BibTeX Citations & CS2023/CSTA K-12 Alignment */
165
- readonly academic: AcademicStandardsService;
166
- /** Service 4: Health Audit, Evidence Scoring, Claim Verification & Provenance Tracking */
167
- readonly verification: EvidenceVerificationService;
168
- /** Service 5: Campaign Planning, Semantic Synthesis & Canonical Reference Pack Orchestration */
169
- readonly orchestrator: PedagogicalSynthesisService;
170
- /** Service 6: Technical Grounding, Hardware/Software Compatibility & Empirical Exemplars */
171
- readonly grounding: TechnicalGroundingService;
172
- constructor(config?: ResearchKitClientConfig);
173
- }
174
-
175
- export { AcademicPaper, AcademicStandardsService, ClaimSweepReport, CourseResearchContext, CustomAcademicSearchAdapter, CustomCrawlerAdapter, CustomSearchAdapter, CustomSynthesizerAdapter, EvidenceVerificationService, ExtractedConceptNode, HarvestPipelineOptions, HarvestPipelineResult, HealthAuditResult, KnowledgeDiscoveryService, LiteratureReviewReport, LlmTextFn, PedagogicalSynthesisService, ProvenanceRecord, ProvenanceSidecar, ResearchApiKeys, ResearchKitClient, type ResearchKitClientConfig, ResearchPlan, ScoredEvidence, ScrapedDocument, SearchHit, StemResearchOptions, StemResourceCatalog, TaxonomyMappingResult, TechnicalDomain, TechnicalFactsheet, TechnicalGroundingService, TermExtractionBundle, TerminologyGraphService, YouTubeTranscriptResult };
package/dist/index.js CHANGED
@@ -1,15 +1,22 @@
1
1
  export { DEFAULT_RESEARCH_CONFIG, ResearchConfigSchema } from './chunk-HESXWQEF.js';
2
- import './chunk-J3VCGH7Z.js';
3
- import { StemResourceResearcher } from './chunk-YICMTZS5.js';
4
- export { GitHubCurriculumClient, NasaMediaClient, OpenverseClient, StemResourceResearcher } from './chunk-YICMTZS5.js';
5
- import { ClaimVerifier } from './chunk-2XIEWCUE.js';
6
- export { ClaimVerifier } from './chunk-2XIEWCUE.js';
7
- import { HarvestPipeline, CampaignPlanner, TechnicalGroundingEngine } from './chunk-P6RHBJY2.js';
8
- export { CampaignPlanner, HarvestPipeline, ReferencePackBuilder, TechnicalGroundingEngine, normalizeUrlForDedup } from './chunk-P6RHBJY2.js';
2
+ import './chunk-2GBXVPOQ.js';
3
+ import './chunk-LDCZ33AC.js';
4
+ import './chunk-TYQEC24G.js';
5
+ import { HarvestPipeline, CampaignPlanner, TechnicalGroundingEngine } from './chunk-S3JUCDKD.js';
6
+ export { CampaignPlanner, HarvestPipeline, ReferencePackBuilder, TechnicalGroundingEngine, normalizeUrlForDedup } from './chunk-S3JUCDKD.js';
9
7
  import { LiteratureReviewSynthesizer, mapTopicToCS2023 } from './chunk-SDDZFFL6.js';
10
8
  export { CS2023_KNOWLEDGE_AREAS, CSTA_K12_STRANDS, CitationManager, LiteratureReviewSynthesizer, mapTopicToCS2023 } from './chunk-SDDZFFL6.js';
11
- import { MultiSourceSearchEngine, PedagogicalTermExtractor, classifyTechnicalDomain, HealthAuditor } from './chunk-SAHBBO3U.js';
12
- export { CatalogBuilder, ECOMMERCE_AND_COMMERCIAL_PATTERNS, ECOMMERCE_DOMAINS, HealthAuditor, MultiSourceSearchEngine, PedagogicalTermExtractor, classifyTechnicalDomain, evaluateTechnicalDensity, inferPrimaryCodeLanguage, isCommercialOrNoise, kahnTopologicalSort, transitiveReduction } from './chunk-SAHBBO3U.js';
9
+ import { PedagogicalTermExtractor } from './chunk-RYLZYZRF.js';
10
+ export { CatalogBuilder, PedagogicalTermExtractor, kahnTopologicalSort, transitiveReduction } from './chunk-RYLZYZRF.js';
11
+ import { ResearchSubAgent } from './chunk-WWQ45RQK.js';
12
+ export { EvidenceLedger, RESEARCH_PROFILE_PRESETS, ResearchAgentToolInputSchema, ResearchSubAgent, createResearchAgentTool, resolveResearchProfile, runResearchSubAgent } from './chunk-WWQ45RQK.js';
13
+ export { OpenAlexClient, cleanCrossrefAbstract } from './chunk-NSY6KU4G.js';
14
+ import { StemResourceResearcher, SocialPulseHarvester } from './chunk-ZNGU4ZYX.js';
15
+ export { GitHubCurriculumClient, NasaMediaClient, OpenverseClient, SocialPulseHarvester, StemResourceResearcher } from './chunk-ZNGU4ZYX.js';
16
+ import { ClaimVerifier } from './chunk-32B5PVTQ.js';
17
+ export { ClaimVerifier } from './chunk-32B5PVTQ.js';
18
+ import { MultiSourceSearchEngine, classifyTechnicalDomain, HealthAuditor } from './chunk-2RMBLKP5.js';
19
+ export { ECOMMERCE_AND_COMMERCIAL_PATTERNS, ECOMMERCE_DOMAINS, HealthAuditor, MultiSourceSearchEngine, classifyTechnicalDomain, evaluateTechnicalDensity, inferPrimaryCodeLanguage, isCommercialOrNoise } from './chunk-2RMBLKP5.js';
13
20
  import { AcademicSearchEngine } from './chunk-AKEI7H2C.js';
14
21
  export { AcademicPaperSchema, AcademicSearchEngine, ArXivSearchEngine, reconstructOpenAlexAbstract } from './chunk-AKEI7H2C.js';
15
22
  import { EvidenceScorer, ProvenanceTracker } from './chunk-KXJDQBSJ.js';
@@ -35,11 +42,13 @@ var KnowledgeDiscoveryService = class {
35
42
  });
36
43
  this.youtubeService = new YouTubeIngestionService();
37
44
  this.stemResearcher = new StemResourceResearcher();
45
+ this.socialPulseHarvester = new SocialPulseHarvester(this.searchEngine);
38
46
  }
39
47
  searchEngine;
40
48
  webScraper;
41
49
  youtubeService;
42
50
  stemResearcher;
51
+ socialPulseHarvester;
43
52
  async search(query, limit = 5) {
44
53
  return this.searchEngine.search(query, {
45
54
  limit,
@@ -59,6 +68,9 @@ var KnowledgeDiscoveryService = class {
59
68
  async findStemResources(query, options) {
60
69
  return this.stemResearcher.findResources(query, options);
61
70
  }
71
+ async searchSocialPulse(topic, options) {
72
+ return this.socialPulseHarvester.harvest(topic, options);
73
+ }
62
74
  };
63
75
  var TerminologyGraphService = class {
64
76
  constructor(config) {
@@ -254,8 +266,9 @@ var ResearchKitClient = class {
254
266
  this.verification = new EvidenceVerificationService(config);
255
267
  this.orchestrator = new PedagogicalSynthesisService(config);
256
268
  this.grounding = new TechnicalGroundingService(config);
269
+ this.agent = new ResearchSubAgent(config);
257
270
  }
258
- /** Service 1: Multi-Engine Web Search, Scraper & YouTube Transcript Ingestion */
271
+ /** Service 1: Multi-Engine Web Search, Scraper, YouTube Transcript & 30-Day Social Pulse */
259
272
  discovery;
260
273
  /** Service 2: Bilingual Pedagogical Term Extraction & Prerequisite Concept Graph (DAG) */
261
274
  terminology;
@@ -267,6 +280,8 @@ var ResearchKitClient = class {
267
280
  orchestrator;
268
281
  /** Service 6: Technical Grounding, Hardware/Software Compatibility & Empirical Exemplars */
269
282
  grounding;
283
+ /** Service 7: Autonomous Contract-Driven Plan-and-Execute Research Sub-Agent (v1.3.0) */
284
+ agent;
270
285
  };
271
286
 
272
287
  export { AcademicStandardsService, EvidenceVerificationService, KnowledgeDiscoveryService, PedagogicalSynthesisService, ResearchKitClient, TechnicalGroundingService, TerminologyGraphService };
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/services/researchKitClient.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import {\n CourseResearchContext,\n CustomAcademicSearchAdapter,\n CustomCrawlerAdapter,\n CustomSearchAdapter,\n CustomSynthesizerAdapter,\n ExtractedConceptNode,\n LlmTextFn,\n ResearchApiKeys,\n} from '../config/researchConfig';\nimport { classifyTechnicalDomain, TechnicalDomain } from '../harvester/domainClassifier';\nimport { MultiSourceSearchEngine, SearchHit } from '../harvester/multiSourceSearch';\nimport { ScrapedDocument, WebScraper } from '../harvester/webScraper';\nimport { YouTubeIngestionService, YouTubeTranscriptResult } from '../harvester/youtubeTranscript';\nimport { StemResourceResearcher, StemResourceCatalog, StemResearchOptions } from '../harvester/stemResources';\nimport { PedagogicalTermExtractor, TermExtractionBundle } from '../harvester/termExtractor';\nimport { HealthAuditor, HealthAuditResult } from '../harvester/healthAuditor';\nimport { AcademicPaper, AcademicSearchEngine } from '../academic/semanticScholar';\nimport { mapTopicToCS2023 } from '../academic/cs2023Taxonomy';\nimport { LiteratureReviewReport, LiteratureReviewSynthesizer } from '../academic/literatureReview';\nimport { EvidenceScorer, ScoredEvidence } from '../evidence/evidenceScorer';\nimport { ClaimSweepReport, ClaimVerifier } from '../evidence/claimVerifier';\nimport { ProvenanceRecord, ProvenanceSidecar, ProvenanceTracker } from '../evidence/provenanceTracker';\nimport { CampaignPlanner, ResearchPlan } from '../pipeline/campaignPlanner';\nimport { HarvestPipeline, HarvestPipelineOptions, HarvestPipelineResult } from '../pipeline/harvestPipeline';\nimport { TechnicalFactsheet, TechnicalGroundingEngine } from '../pipeline/groundingEngine';\n\nexport interface ResearchKitClientConfig {\n /**\n * API keys configured in the host application (e.g., Settings UI / DB / Vault).\n */\n apiKeys?: ResearchApiKeys;\n /**\n * Whether to fall back to `process.env.*` if a key is not provided in `apiKeys`.\n * Set to `false` in strict multi-tenant or desktop apps where only app-configured keys are allowed.\n * Defaults to `true`.\n */\n allowEnvFallback?: boolean;\n /**\n * Optional Crawl4AI self-hosted endpoint.\n */\n crawl4aiHost?: string;\n /**\n * Optional LLM text completion callback injected from the host application\n * (e.g., NineRouter / OpenRouter / AI SDK in smart-curriculum).\n */\n llm?: LlmTextFn;\n /**\n * Default course context (age band, hardware/software tools, language) applied across services.\n */\n defaultCourseContext?: CourseResearchContext;\n /**\n * Optional custom adapters.\n */\n customSearchAdapter?: CustomSearchAdapter;\n customCrawlerAdapter?: CustomCrawlerAdapter;\n customAcademicSearchAdapter?: CustomAcademicSearchAdapter;\n customSynthesizerAdapter?: CustomSynthesizerAdapter;\n}\n\n/**\n * Service 1: Crawl, Search & Multimodal Knowledge Discovery\n */\nexport class KnowledgeDiscoveryService {\n private searchEngine: MultiSourceSearchEngine;\n private webScraper: WebScraper;\n private youtubeService: YouTubeIngestionService;\n private stemResearcher: StemResourceResearcher;\n\n constructor(private config: ResearchKitClientConfig) {\n this.searchEngine = new MultiSourceSearchEngine({\n apiKeys: config.apiKeys,\n allowEnvFallback: config.allowEnvFallback,\n customAdapter: config.customSearchAdapter,\n });\n this.webScraper = new WebScraper({\n crawl4aiHost: config.crawl4aiHost,\n jinaKey: config.apiKeys?.jina,\n brightDataKey: config.apiKeys?.brightdata || config.apiKeys?.brightData,\n allowEnvFallback: config.allowEnvFallback,\n customAdapter: config.customCrawlerAdapter,\n });\n this.youtubeService = new YouTubeIngestionService();\n this.stemResearcher = new StemResourceResearcher();\n }\n\n async search(query: string, limit = 5): Promise<SearchHit[]> {\n return this.searchEngine.search(query, {\n limit,\n apiKeys: this.config.apiKeys,\n customAdapter: this.config.customSearchAdapter,\n });\n }\n\n async scrapeUrl(url: string): Promise<ScrapedDocument> {\n return this.webScraper.scrapeUrl(url, {\n customAdapter: this.config.customCrawlerAdapter,\n jinaKey: this.config.apiKeys?.jina,\n });\n }\n\n async ingestYouTube(urlOrVideoId: string, preferredLanguages: string[] = ['vi', 'en']): Promise<YouTubeTranscriptResult> {\n return this.youtubeService.fetchTranscript(urlOrVideoId, preferredLanguages);\n }\n\n async findStemResources(query: string, options?: StemResearchOptions): Promise<StemResourceCatalog> {\n return this.stemResearcher.findResources(query, options);\n }\n}\n\n/**\n * Service 2: Bilingual Term Extraction & Prerequisite Concept Graph (DAG)\n */\nexport class TerminologyGraphService {\n private extractor = new PedagogicalTermExtractor();\n\n constructor(private config: ResearchKitClientConfig) {}\n\n extractConceptsDeterministic(\n topic: string,\n docs: Array<{ resourceId: string; doc: ScrapedDocument }> | string,\n domain?: TechnicalDomain\n ): TermExtractionBundle {\n const resolvedDomain = domain ?? classifyTechnicalDomain(topic, undefined, this.config.defaultCourseContext).domain;\n const normalizedDocs =\n typeof docs === 'string'\n ? [\n {\n resourceId: 'RES-01',\n doc: {\n url: 'inline://corpus',\n title: topic,\n markdownContent: docs,\n byteSize: Buffer.byteLength(docs, 'utf-8'),\n extractedCodeSnippets: [],\n tablesCount: 0,\n fetchProvider: 'direct' as const,\n },\n },\n ]\n : docs;\n return this.extractor.extractDeterministic(topic, resolvedDomain, normalizedDocs);\n }\n\n async extractConcepts(\n topic: string,\n docs: Array<{ resourceId: string; doc: ScrapedDocument }> | string,\n options?: {\n domain?: TechnicalDomain;\n context?: CourseResearchContext;\n llm?: LlmTextFn;\n maxTerms?: number;\n }\n ): Promise<TermExtractionBundle> {\n const resolvedDomain =\n options?.domain ?? classifyTechnicalDomain(topic, undefined, options?.context ?? this.config.defaultCourseContext).domain;\n const normalizedDocs =\n typeof docs === 'string'\n ? [\n {\n resourceId: 'RES-01',\n doc: {\n url: 'inline://corpus',\n title: topic,\n markdownContent: docs,\n byteSize: Buffer.byteLength(docs, 'utf-8'),\n extractedCodeSnippets: [],\n keyExcerpts: [docs.slice(0, 600)],\n tablesCount: 0,\n fetchProvider: 'direct' as const,\n },\n },\n ]\n : docs;\n return this.extractor.extractWithOptionalLlm(topic, resolvedDomain, normalizedDocs, {\n context: options?.context ?? this.config.defaultCourseContext,\n llm: options?.llm ?? this.config.llm,\n maxTerms: options?.maxTerms,\n });\n }\n\n formatConceptDagTsv(concepts: ExtractedConceptNode[]): string {\n return this.extractor.formatConceptDagTsv(concepts);\n }\n}\n\n/**\n * Service 3: Academic Literature & Curricular Standards Alignment (ACM/IEEE CS2023 + CSTA K-12)\n */\nexport class AcademicStandardsService {\n private academicSearch: AcademicSearchEngine;\n private litSynthesizer = new LiteratureReviewSynthesizer();\n\n constructor(private config: ResearchKitClientConfig) {\n this.academicSearch = new AcademicSearchEngine({\n apiKey: config.apiKeys?.semanticScholar,\n allowEnvFallback: config.allowEnvFallback,\n customAdapter: config.customAcademicSearchAdapter,\n });\n }\n\n alignStandards(topic: string, context?: CourseResearchContext) {\n return mapTopicToCS2023(topic, context ?? this.config.defaultCourseContext);\n }\n\n async searchPapers(query: string, limit = 5): Promise<AcademicPaper[]> {\n return this.academicSearch.searchPapers(query, {\n limit,\n apiKey: this.config.apiKeys?.semanticScholar,\n customAdapter: this.config.customAcademicSearchAdapter,\n });\n }\n\n synthesizeLiteratureReview(\n topic: string,\n papers: AcademicPaper[],\n context?: CourseResearchContext\n ): LiteratureReviewReport {\n const alignment = this.alignStandards(topic, context);\n return this.litSynthesizer.synthesize(topic, papers, alignment.area, alignment.k12Strand);\n }\n\n async synthesizeLiteratureReviewWithLlm(\n topic: string,\n papers: AcademicPaper[],\n context?: CourseResearchContext,\n options?: { llm?: LlmTextFn }\n ): Promise<LiteratureReviewReport> {\n const alignment = this.alignStandards(topic, context);\n return this.litSynthesizer.synthesizeWithLlm(\n topic,\n papers,\n alignment.area,\n alignment.k12Strand,\n {\n llm: options?.llm ?? this.config.llm,\n context: context ?? this.config.defaultCourseContext,\n }\n );\n }\n}\n\n/**\n * Service 4: Document Health Audit, Evidence Scoring, Claim Verification & Provenance\n */\nexport class EvidenceVerificationService {\n private healthAuditor = new HealthAuditor();\n private evidenceScorer = new EvidenceScorer();\n private claimVerifier = new ClaimVerifier();\n private provenanceTracker = new ProvenanceTracker();\n\n constructor(private config: ResearchKitClientConfig = {}) {}\n\n auditDocument(doc: ScrapedDocument): HealthAuditResult {\n return this.healthAuditor.auditDocument(doc);\n }\n\n scoreDocument(doc: ScrapedDocument, domain: TechnicalDomain, topic: string): ScoredEvidence {\n return this.evidenceScorer.scoreDocument(doc, domain, topic);\n }\n\n async scoreDocumentWithLlm(\n doc: ScrapedDocument,\n domain: TechnicalDomain,\n topic: string,\n options?: { llm?: LlmTextFn; context?: CourseResearchContext }\n ): Promise<ScoredEvidence> {\n return this.evidenceScorer.scoreDocumentWithLlm(doc, domain, topic, {\n llm: options?.llm ?? this.config.llm,\n context: options?.context ?? this.config.defaultCourseContext,\n });\n }\n\n verifyClaimsDeterministic(claimsToVerify: string[], sourceCorpusText: string): ClaimSweepReport {\n return this.claimVerifier.verifyClaimsDeterministic(claimsToVerify, sourceCorpusText);\n }\n\n async verifyClaims(\n claimsToVerify: string[],\n sourceCorpusText: string,\n options?: { llm?: LlmTextFn }\n ): Promise<ClaimSweepReport> {\n return this.claimVerifier.verifyClaims(claimsToVerify, sourceCorpusText, {\n llm: options?.llm ?? this.config.llm,\n });\n }\n\n buildProvenance(topic: string, records: ProvenanceRecord[]): ProvenanceSidecar {\n return this.provenanceTracker.generateSidecar(topic, records);\n }\n}\n\n/**\n * Service 5: Pedagogical Synthesis & Ground Truth Reference Pack Orchestration\n */\nexport class PedagogicalSynthesisService {\n private planner = new CampaignPlanner();\n private pipeline: HarvestPipeline;\n\n constructor(private config: ResearchKitClientConfig) {\n this.pipeline = new HarvestPipeline({\n apiKeys: config.apiKeys,\n allowEnvFallback: config.allowEnvFallback,\n crawl4aiHost: config.crawl4aiHost,\n llm: config.llm,\n customSearchAdapter: config.customSearchAdapter,\n customCrawlerAdapter: config.customCrawlerAdapter,\n customAcademicSearchAdapter: config.customAcademicSearchAdapter,\n customSynthesizerAdapter: config.customSynthesizerAdapter,\n });\n }\n\n async planCampaign(\n topic: string,\n options?: {\n domain?: TechnicalDomain;\n isDeep?: boolean;\n maxRounds?: number;\n context?: CourseResearchContext;\n }\n ): Promise<ResearchPlan> {\n const ctx = options?.context ?? this.config.defaultCourseContext;\n const domain = options?.domain ?? classifyTechnicalDomain(topic, undefined, ctx).domain;\n return this.planner.createPlanWithLlm(topic, domain, {\n isDeep: options?.isDeep,\n maxRounds: options?.maxRounds,\n context: ctx,\n llm: this.config.llm,\n });\n }\n\n async runFullHarvest(\n topic: string,\n overrides?: Partial<HarvestPipelineOptions>\n ): Promise<HarvestPipelineResult> {\n return this.pipeline.run(topic, {\n apiKeys: this.config.apiKeys,\n allowEnvFallback: this.config.allowEnvFallback,\n crawl4aiHost: this.config.crawl4aiHost,\n llm: this.config.llm,\n context: this.config.defaultCourseContext,\n customSearchAdapter: this.config.customSearchAdapter,\n customCrawlerAdapter: this.config.customCrawlerAdapter,\n customAcademicSearchAdapter: this.config.customAcademicSearchAdapter,\n customSynthesizerAdapter: this.config.customSynthesizerAdapter,\n ...overrides,\n });\n }\n}\n\n/**\n * Service 6: Empirical Factsheet & Hardware/Software Technical Grounding (v1.2.0)\n */\nexport class TechnicalGroundingService {\n private engine: TechnicalGroundingEngine;\n\n constructor(private config: ResearchKitClientConfig) {\n const searchEngine = new MultiSourceSearchEngine({\n apiKeys: config.apiKeys,\n allowEnvFallback: config.allowEnvFallback,\n customAdapter: config.customSearchAdapter,\n });\n const scraper = new WebScraper({\n crawl4aiHost: config.crawl4aiHost,\n jinaKey: config.apiKeys?.jina,\n allowEnvFallback: config.allowEnvFallback,\n customAdapter: config.customCrawlerAdapter,\n });\n this.engine = new TechnicalGroundingEngine(searchEngine, scraper);\n }\n\n async buildFactsheet(\n topic: string,\n options?: {\n domain?: TechnicalDomain;\n context?: CourseResearchContext;\n }\n ): Promise<TechnicalFactsheet> {\n const ctx = options?.context ?? this.config.defaultCourseContext;\n const domain = options?.domain ?? classifyTechnicalDomain(topic, undefined, ctx).domain;\n return this.engine.buildFactsheet(topic, domain, ctx, this.config.llm);\n }\n}\n\n/**\n * Unified facade exposing all 6 core services of `@thanh01.pmt/research-kit`\n * configured with host-application API keys and LLM callbacks.\n */\nexport class ResearchKitClient {\n /** Service 1: Multi-Engine Web Search, Scraper & YouTube Transcript Ingestion */\n public readonly discovery: KnowledgeDiscoveryService;\n /** Service 2: Bilingual Pedagogical Term Extraction & Prerequisite Concept Graph (DAG) */\n public readonly terminology: TerminologyGraphService;\n /** Service 3: Academic Literature Search, BibTeX Citations & CS2023/CSTA K-12 Alignment */\n public readonly academic: AcademicStandardsService;\n /** Service 4: Health Audit, Evidence Scoring, Claim Verification & Provenance Tracking */\n public readonly verification: EvidenceVerificationService;\n /** Service 5: Campaign Planning, Semantic Synthesis & Canonical Reference Pack Orchestration */\n public readonly orchestrator: PedagogicalSynthesisService;\n /** Service 6: Technical Grounding, Hardware/Software Compatibility & Empirical Exemplars */\n public readonly grounding: TechnicalGroundingService;\n\n constructor(private readonly config: ResearchKitClientConfig = {}) {\n this.discovery = new KnowledgeDiscoveryService(config);\n this.terminology = new TerminologyGraphService(config);\n this.academic = new AcademicStandardsService(config);\n this.verification = new EvidenceVerificationService(config);\n this.orchestrator = new PedagogicalSynthesisService(config);\n this.grounding = new TechnicalGroundingService(config);\n }\n}\n"]}
1
+ {"version":3,"sources":["../src/services/researchKitClient.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import {\n CourseResearchContext,\n CustomAcademicSearchAdapter,\n CustomCrawlerAdapter,\n CustomSearchAdapter,\n CustomSynthesizerAdapter,\n ExtractedConceptNode,\n LlmTextFn,\n ResearchApiKeys,\n} from '../config/researchConfig';\nimport { classifyTechnicalDomain, TechnicalDomain } from '../harvester/domainClassifier';\nimport { MultiSourceSearchEngine, SearchHit } from '../harvester/multiSourceSearch';\nimport { ScrapedDocument, WebScraper } from '../harvester/webScraper';\nimport { YouTubeIngestionService, YouTubeTranscriptResult } from '../harvester/youtubeTranscript';\nimport { StemResourceResearcher, StemResourceCatalog, StemResearchOptions } from '../harvester/stemResources';\nimport { SocialPulseHarvester, SocialPulseOptions, SocialPulseReport } from '../harvester/socialPulseHarvester';\nimport { PedagogicalTermExtractor, TermExtractionBundle } from '../harvester/termExtractor';\nimport { HealthAuditor, HealthAuditResult } from '../harvester/healthAuditor';\nimport { AcademicPaper, AcademicSearchEngine } from '../academic/semanticScholar';\nimport { OpenAlexClient, OpenAlexSearchOptions } from '../academic/openAlexClient';\nimport { mapTopicToCS2023 } from '../academic/cs2023Taxonomy';\nimport { LiteratureReviewReport, LiteratureReviewSynthesizer } from '../academic/literatureReview';\nimport { EvidenceScorer, ScoredEvidence } from '../evidence/evidenceScorer';\nimport { ClaimSweepReport, ClaimVerifier } from '../evidence/claimVerifier';\nimport { ProvenanceRecord, ProvenanceSidecar, ProvenanceTracker } from '../evidence/provenanceTracker';\nimport { CampaignPlanner, ResearchPlan } from '../pipeline/campaignPlanner';\nimport { HarvestPipeline, HarvestPipelineOptions, HarvestPipelineResult } from '../pipeline/harvestPipeline';\nimport { TechnicalFactsheet, TechnicalGroundingEngine } from '../pipeline/groundingEngine';\nimport { ResearchSubAgent } from '../agent/researchSubAgent';\n\nexport interface ResearchKitClientConfig {\n /**\n * API keys configured in the host application (e.g., Settings UI / DB / Vault).\n */\n apiKeys?: ResearchApiKeys;\n /**\n * Whether to fall back to `process.env.*` if a key is not provided in `apiKeys`.\n * Set to `false` in strict multi-tenant or desktop apps where only app-configured keys are allowed.\n * Defaults to `true`.\n */\n allowEnvFallback?: boolean;\n /**\n * Optional Crawl4AI self-hosted endpoint.\n */\n crawl4aiHost?: string;\n /**\n * Optional LLM text completion callback injected from the host application\n * (e.g., NineRouter / OpenRouter / AI SDK in smart-curriculum).\n */\n llm?: LlmTextFn;\n /**\n * Default course context (age band, hardware/software tools, language) applied across services.\n */\n defaultCourseContext?: CourseResearchContext;\n /**\n * Optional custom adapters.\n */\n customSearchAdapter?: CustomSearchAdapter;\n customCrawlerAdapter?: CustomCrawlerAdapter;\n customAcademicSearchAdapter?: CustomAcademicSearchAdapter;\n customSynthesizerAdapter?: CustomSynthesizerAdapter;\n}\n\n/**\n * Service 1: Crawl, Search & Multimodal Knowledge Discovery\n */\nexport class KnowledgeDiscoveryService {\n private searchEngine: MultiSourceSearchEngine;\n private webScraper: WebScraper;\n private youtubeService: YouTubeIngestionService;\n private stemResearcher: StemResourceResearcher;\n private socialPulseHarvester: SocialPulseHarvester;\n\n constructor(private config: ResearchKitClientConfig) {\n this.searchEngine = new MultiSourceSearchEngine({\n apiKeys: config.apiKeys,\n allowEnvFallback: config.allowEnvFallback,\n customAdapter: config.customSearchAdapter,\n });\n this.webScraper = new WebScraper({\n crawl4aiHost: config.crawl4aiHost,\n jinaKey: config.apiKeys?.jina,\n brightDataKey: config.apiKeys?.brightdata || config.apiKeys?.brightData,\n allowEnvFallback: config.allowEnvFallback,\n customAdapter: config.customCrawlerAdapter,\n });\n this.youtubeService = new YouTubeIngestionService();\n this.stemResearcher = new StemResourceResearcher();\n this.socialPulseHarvester = new SocialPulseHarvester(this.searchEngine);\n }\n\n async search(query: string, limit = 5): Promise<SearchHit[]> {\n return this.searchEngine.search(query, {\n limit,\n apiKeys: this.config.apiKeys,\n customAdapter: this.config.customSearchAdapter,\n });\n }\n\n async scrapeUrl(url: string): Promise<ScrapedDocument> {\n return this.webScraper.scrapeUrl(url, {\n customAdapter: this.config.customCrawlerAdapter,\n jinaKey: this.config.apiKeys?.jina,\n });\n }\n\n async ingestYouTube(urlOrVideoId: string, preferredLanguages: string[] = ['vi', 'en']): Promise<YouTubeTranscriptResult> {\n return this.youtubeService.fetchTranscript(urlOrVideoId, preferredLanguages);\n }\n\n async findStemResources(query: string, options?: StemResearchOptions): Promise<StemResourceCatalog> {\n return this.stemResearcher.findResources(query, options);\n }\n\n async searchSocialPulse(topic: string, options?: SocialPulseOptions): Promise<SocialPulseReport> {\n return this.socialPulseHarvester.harvest(topic, options);\n }\n}\n\n/**\n * Service 2: Bilingual Term Extraction & Prerequisite Concept Graph (DAG)\n */\nexport class TerminologyGraphService {\n private extractor = new PedagogicalTermExtractor();\n\n constructor(private config: ResearchKitClientConfig) {}\n\n extractConceptsDeterministic(\n topic: string,\n docs: Array<{ resourceId: string; doc: ScrapedDocument }> | string,\n domain?: TechnicalDomain\n ): TermExtractionBundle {\n const resolvedDomain = domain ?? classifyTechnicalDomain(topic, undefined, this.config.defaultCourseContext).domain;\n const normalizedDocs =\n typeof docs === 'string'\n ? [\n {\n resourceId: 'RES-01',\n doc: {\n url: 'inline://corpus',\n title: topic,\n markdownContent: docs,\n byteSize: Buffer.byteLength(docs, 'utf-8'),\n extractedCodeSnippets: [],\n tablesCount: 0,\n fetchProvider: 'direct' as const,\n },\n },\n ]\n : docs;\n return this.extractor.extractDeterministic(topic, resolvedDomain, normalizedDocs);\n }\n\n async extractConcepts(\n topic: string,\n docs: Array<{ resourceId: string; doc: ScrapedDocument }> | string,\n options?: {\n domain?: TechnicalDomain;\n context?: CourseResearchContext;\n llm?: LlmTextFn;\n maxTerms?: number;\n }\n ): Promise<TermExtractionBundle> {\n const resolvedDomain =\n options?.domain ?? classifyTechnicalDomain(topic, undefined, options?.context ?? this.config.defaultCourseContext).domain;\n const normalizedDocs =\n typeof docs === 'string'\n ? [\n {\n resourceId: 'RES-01',\n doc: {\n url: 'inline://corpus',\n title: topic,\n markdownContent: docs,\n byteSize: Buffer.byteLength(docs, 'utf-8'),\n extractedCodeSnippets: [],\n keyExcerpts: [docs.slice(0, 600)],\n tablesCount: 0,\n fetchProvider: 'direct' as const,\n },\n },\n ]\n : docs;\n return this.extractor.extractWithOptionalLlm(topic, resolvedDomain, normalizedDocs, {\n context: options?.context ?? this.config.defaultCourseContext,\n llm: options?.llm ?? this.config.llm,\n maxTerms: options?.maxTerms,\n });\n }\n\n formatConceptDagTsv(concepts: ExtractedConceptNode[]): string {\n return this.extractor.formatConceptDagTsv(concepts);\n }\n}\n\n/**\n * Service 3: Academic Literature & Curricular Standards Alignment (ACM/IEEE CS2023 + CSTA K-12)\n */\nexport class AcademicStandardsService {\n private academicSearch: AcademicSearchEngine;\n private litSynthesizer = new LiteratureReviewSynthesizer();\n\n constructor(private config: ResearchKitClientConfig) {\n this.academicSearch = new AcademicSearchEngine({\n apiKey: config.apiKeys?.semanticScholar,\n allowEnvFallback: config.allowEnvFallback,\n customAdapter: config.customAcademicSearchAdapter,\n });\n }\n\n alignStandards(topic: string, context?: CourseResearchContext) {\n return mapTopicToCS2023(topic, context ?? this.config.defaultCourseContext);\n }\n\n async searchPapers(query: string, limit = 5): Promise<AcademicPaper[]> {\n return this.academicSearch.searchPapers(query, {\n limit,\n apiKey: this.config.apiKeys?.semanticScholar,\n customAdapter: this.config.customAcademicSearchAdapter,\n });\n }\n\n synthesizeLiteratureReview(\n topic: string,\n papers: AcademicPaper[],\n context?: CourseResearchContext\n ): LiteratureReviewReport {\n const alignment = this.alignStandards(topic, context);\n return this.litSynthesizer.synthesize(topic, papers, alignment.area, alignment.k12Strand);\n }\n\n async synthesizeLiteratureReviewWithLlm(\n topic: string,\n papers: AcademicPaper[],\n context?: CourseResearchContext,\n options?: { llm?: LlmTextFn }\n ): Promise<LiteratureReviewReport> {\n const alignment = this.alignStandards(topic, context);\n return this.litSynthesizer.synthesizeWithLlm(\n topic,\n papers,\n alignment.area,\n alignment.k12Strand,\n {\n llm: options?.llm ?? this.config.llm,\n context: context ?? this.config.defaultCourseContext,\n }\n );\n }\n}\n\n/**\n * Service 4: Document Health Audit, Evidence Scoring, Claim Verification & Provenance\n */\nexport class EvidenceVerificationService {\n private healthAuditor = new HealthAuditor();\n private evidenceScorer = new EvidenceScorer();\n private claimVerifier = new ClaimVerifier();\n private provenanceTracker = new ProvenanceTracker();\n\n constructor(private config: ResearchKitClientConfig = {}) {}\n\n auditDocument(doc: ScrapedDocument): HealthAuditResult {\n return this.healthAuditor.auditDocument(doc);\n }\n\n scoreDocument(doc: ScrapedDocument, domain: TechnicalDomain, topic: string): ScoredEvidence {\n return this.evidenceScorer.scoreDocument(doc, domain, topic);\n }\n\n async scoreDocumentWithLlm(\n doc: ScrapedDocument,\n domain: TechnicalDomain,\n topic: string,\n options?: { llm?: LlmTextFn; context?: CourseResearchContext }\n ): Promise<ScoredEvidence> {\n return this.evidenceScorer.scoreDocumentWithLlm(doc, domain, topic, {\n llm: options?.llm ?? this.config.llm,\n context: options?.context ?? this.config.defaultCourseContext,\n });\n }\n\n verifyClaimsDeterministic(claimsToVerify: string[], sourceCorpusText: string): ClaimSweepReport {\n return this.claimVerifier.verifyClaimsDeterministic(claimsToVerify, sourceCorpusText);\n }\n\n async verifyClaims(\n claimsToVerify: string[],\n sourceCorpusText: string,\n options?: { llm?: LlmTextFn }\n ): Promise<ClaimSweepReport> {\n return this.claimVerifier.verifyClaims(claimsToVerify, sourceCorpusText, {\n llm: options?.llm ?? this.config.llm,\n });\n }\n\n buildProvenance(topic: string, records: ProvenanceRecord[]): ProvenanceSidecar {\n return this.provenanceTracker.generateSidecar(topic, records);\n }\n}\n\n/**\n * Service 5: Pedagogical Synthesis & Ground Truth Reference Pack Orchestration\n */\nexport class PedagogicalSynthesisService {\n private planner = new CampaignPlanner();\n private pipeline: HarvestPipeline;\n\n constructor(private config: ResearchKitClientConfig) {\n this.pipeline = new HarvestPipeline({\n apiKeys: config.apiKeys,\n allowEnvFallback: config.allowEnvFallback,\n crawl4aiHost: config.crawl4aiHost,\n llm: config.llm,\n customSearchAdapter: config.customSearchAdapter,\n customCrawlerAdapter: config.customCrawlerAdapter,\n customAcademicSearchAdapter: config.customAcademicSearchAdapter,\n customSynthesizerAdapter: config.customSynthesizerAdapter,\n });\n }\n\n async planCampaign(\n topic: string,\n options?: {\n domain?: TechnicalDomain;\n isDeep?: boolean;\n maxRounds?: number;\n context?: CourseResearchContext;\n }\n ): Promise<ResearchPlan> {\n const ctx = options?.context ?? this.config.defaultCourseContext;\n const domain = options?.domain ?? classifyTechnicalDomain(topic, undefined, ctx).domain;\n return this.planner.createPlanWithLlm(topic, domain, {\n isDeep: options?.isDeep,\n maxRounds: options?.maxRounds,\n context: ctx,\n llm: this.config.llm,\n });\n }\n\n async runFullHarvest(\n topic: string,\n overrides?: Partial<HarvestPipelineOptions>\n ): Promise<HarvestPipelineResult> {\n return this.pipeline.run(topic, {\n apiKeys: this.config.apiKeys,\n allowEnvFallback: this.config.allowEnvFallback,\n crawl4aiHost: this.config.crawl4aiHost,\n llm: this.config.llm,\n context: this.config.defaultCourseContext,\n customSearchAdapter: this.config.customSearchAdapter,\n customCrawlerAdapter: this.config.customCrawlerAdapter,\n customAcademicSearchAdapter: this.config.customAcademicSearchAdapter,\n customSynthesizerAdapter: this.config.customSynthesizerAdapter,\n ...overrides,\n });\n }\n}\n\n/**\n * Service 6: Empirical Factsheet & Hardware/Software Technical Grounding (v1.2.0)\n */\nexport class TechnicalGroundingService {\n private engine: TechnicalGroundingEngine;\n\n constructor(private config: ResearchKitClientConfig) {\n const searchEngine = new MultiSourceSearchEngine({\n apiKeys: config.apiKeys,\n allowEnvFallback: config.allowEnvFallback,\n customAdapter: config.customSearchAdapter,\n });\n const scraper = new WebScraper({\n crawl4aiHost: config.crawl4aiHost,\n jinaKey: config.apiKeys?.jina,\n allowEnvFallback: config.allowEnvFallback,\n customAdapter: config.customCrawlerAdapter,\n });\n this.engine = new TechnicalGroundingEngine(searchEngine, scraper);\n }\n\n async buildFactsheet(\n topic: string,\n options?: {\n domain?: TechnicalDomain;\n context?: CourseResearchContext;\n }\n ): Promise<TechnicalFactsheet> {\n const ctx = options?.context ?? this.config.defaultCourseContext;\n const domain = options?.domain ?? classifyTechnicalDomain(topic, undefined, ctx).domain;\n return this.engine.buildFactsheet(topic, domain, ctx, this.config.llm);\n }\n}\n\n/**\n * Unified facade exposing all 7 core services of `@thanh01.pmt/research-kit`\n * configured with host-application API keys and LLM callbacks.\n */\nexport class ResearchKitClient {\n /** Service 1: Multi-Engine Web Search, Scraper, YouTube Transcript & 30-Day Social Pulse */\n public readonly discovery: KnowledgeDiscoveryService;\n /** Service 2: Bilingual Pedagogical Term Extraction & Prerequisite Concept Graph (DAG) */\n public readonly terminology: TerminologyGraphService;\n /** Service 3: Academic Literature Search, BibTeX Citations & CS2023/CSTA K-12 Alignment */\n public readonly academic: AcademicStandardsService;\n /** Service 4: Health Audit, Evidence Scoring, Claim Verification & Provenance Tracking */\n public readonly verification: EvidenceVerificationService;\n /** Service 5: Campaign Planning, Semantic Synthesis & Canonical Reference Pack Orchestration */\n public readonly orchestrator: PedagogicalSynthesisService;\n /** Service 6: Technical Grounding, Hardware/Software Compatibility & Empirical Exemplars */\n public readonly grounding: TechnicalGroundingService;\n /** Service 7: Autonomous Contract-Driven Plan-and-Execute Research Sub-Agent (v1.3.0) */\n public readonly agent: ResearchSubAgent;\n\n constructor(private readonly config: ResearchKitClientConfig = {}) {\n this.discovery = new KnowledgeDiscoveryService(config);\n this.terminology = new TerminologyGraphService(config);\n this.academic = new AcademicStandardsService(config);\n this.verification = new EvidenceVerificationService(config);\n this.orchestrator = new PedagogicalSynthesisService(config);\n this.grounding = new TechnicalGroundingService(config);\n this.agent = new ResearchSubAgent(config);\n }\n}\n"]}
@@ -1,4 +1,4 @@
1
- import { C as CourseResearchContext, A as AcademicPaper, L as LlmTextFn } from './index-9rDiFuR4.js';
1
+ import { a as CourseResearchContext, j as AcademicPaper, L as LlmTextFn } from './index-CxoD81QN.js';
2
2
 
3
3
  interface CS2023KnowledgeArea {
4
4
  code: string;
@@ -1,4 +1,4 @@
1
- import { C as CourseResearchContext, A as AcademicPaper, L as LlmTextFn } from './index-9rDiFuR4.cjs';
1
+ import { a as CourseResearchContext, j as AcademicPaper, L as LlmTextFn } from './index-CxoD81QN.cjs';
2
2
 
3
3
  interface CS2023KnowledgeArea {
4
4
  code: string;