@thanh01.pmt/research-kit 1.1.1 → 1.2.1

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 (59) hide show
  1. package/README.md +27 -14
  2. package/dist/academic/index.d.cts +3 -3
  3. package/dist/academic/index.d.ts +3 -3
  4. package/dist/academic/index.js +2 -1
  5. package/dist/catalogBuilder-BaVRvg-9.d.cts +90 -0
  6. package/dist/catalogBuilder-DHV6y1gD.d.ts +90 -0
  7. package/dist/chunk-AKEI7H2C.js +223 -0
  8. package/dist/chunk-AKEI7H2C.js.map +1 -0
  9. package/dist/{chunk-XIF5YNI7.js → chunk-HZNSZDSM.js} +318 -8
  10. package/dist/chunk-HZNSZDSM.js.map +1 -0
  11. package/dist/chunk-LSMSIPTZ.js +3 -0
  12. package/dist/{chunk-2JEVBCIF.js.map → chunk-LSMSIPTZ.js.map} +1 -1
  13. package/dist/{chunk-KAFQVI2R.js → chunk-ON6VFCJO.js} +3 -3
  14. package/dist/{chunk-KAFQVI2R.js.map → chunk-ON6VFCJO.js.map} +1 -1
  15. package/dist/{chunk-GKF3NDEX.js → chunk-QFYM2NV4.js} +3 -3
  16. package/dist/{chunk-GKF3NDEX.js.map → chunk-QFYM2NV4.js.map} +1 -1
  17. package/dist/{chunk-AUGVVZTL.js → chunk-RW7VS7NI.js} +175 -7
  18. package/dist/chunk-RW7VS7NI.js.map +1 -0
  19. package/dist/{chunk-DOXSPRSP.js → chunk-UKGR45VZ.js} +3 -223
  20. package/dist/chunk-UKGR45VZ.js.map +1 -0
  21. package/dist/{chunk-J7XKDMGL.js → chunk-X3X26W2I.js} +2 -2
  22. package/dist/{chunk-J7XKDMGL.js.map → chunk-X3X26W2I.js.map} +1 -1
  23. package/dist/config/index.cjs.map +1 -1
  24. package/dist/config/index.d.cts +1 -1
  25. package/dist/config/index.d.ts +1 -1
  26. package/dist/config/index.js +1 -1
  27. package/dist/evidence/index.cjs.map +1 -1
  28. package/dist/evidence/index.d.cts +2 -2
  29. package/dist/evidence/index.d.ts +2 -2
  30. package/dist/evidence/index.js +2 -2
  31. package/dist/harvester/index.cjs +542 -6
  32. package/dist/harvester/index.cjs.map +1 -1
  33. package/dist/harvester/index.d.cts +63 -49
  34. package/dist/harvester/index.d.ts +63 -49
  35. package/dist/harvester/index.js +4 -3
  36. package/dist/{index-t8pahlJ4.d.ts → index-DlngvZBr.d.cts} +15 -1
  37. package/dist/{index-t8pahlJ4.d.cts → index-DlngvZBr.d.ts} +15 -1
  38. package/dist/index.cjs +515 -6
  39. package/dist/index.cjs.map +1 -1
  40. package/dist/index.d.cts +28 -13
  41. package/dist/index.d.ts +28 -13
  42. package/dist/index.js +41 -13
  43. package/dist/index.js.map +1 -1
  44. package/dist/{literatureReview-BTPFe7eb.d.cts → literatureReview-C7hsjrn4.d.cts} +1 -1
  45. package/dist/{literatureReview-hGbfrBmw.d.ts → literatureReview-DWl13r_3.d.ts} +1 -1
  46. package/dist/pipeline/index.cjs +658 -231
  47. package/dist/pipeline/index.cjs.map +1 -1
  48. package/dist/pipeline/index.d.cts +49 -5
  49. package/dist/pipeline/index.d.ts +49 -5
  50. package/dist/pipeline/index.js +6 -5
  51. package/dist/{webScraper-BhiQ8s9x.d.ts → webScraper-DBFUIqoO.d.ts} +1 -1
  52. package/dist/{webScraper-D9Ldus9p.d.cts → webScraper-yO9P-oLb.d.cts} +1 -1
  53. package/package.json +1 -1
  54. package/dist/catalogBuilder-CmmQzUnf.d.ts +0 -38
  55. package/dist/catalogBuilder-DgXYxL2F.d.cts +0 -38
  56. package/dist/chunk-2JEVBCIF.js +0 -3
  57. package/dist/chunk-AUGVVZTL.js.map +0 -1
  58. package/dist/chunk-DOXSPRSP.js.map +0 -1
  59. package/dist/chunk-XIF5YNI7.js.map +0 -1
package/dist/index.d.cts CHANGED
@@ -1,19 +1,20 @@
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-t8pahlJ4.cjs';
2
- export { i as AcademicPaperSchema, k as AcademicSearchEngine, j as AcademicSearchOptions, e as CrawlerProviderType, D as DEFAULT_RESEARCH_CONFIG, h as ResearchConfig, g as ResearchConfigSchema, S as SearchProviderType, f as SynthesizedResearchInsights, r as reconstructOpenAlexAbstract } from './index-t8pahlJ4.cjs';
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-DlngvZBr.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-DlngvZBr.cjs';
3
3
  export { ArXivSearchEngine, CitationItem, CitationManager } from './academic/index.cjs';
4
- import { T as TaxonomyMappingResult, L as LiteratureReviewReport } from './literatureReview-BTPFe7eb.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-BTPFe7eb.cjs';
6
- import { S as ScrapedDocument, T as TechnicalDomain } from './webScraper-D9Ldus9p.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-D9Ldus9p.cjs';
8
- import { SearchHit, YouTubeTranscriptResult, TermExtractionBundle, HealthAuditResult } from './harvester/index.cjs';
9
- export { HealthAuditor, MultiSearchOptions, MultiSourceSearchEngine, PedagogicalTermExtractor, TranscriptSegment, YouTubeIngestionService, extractYouTubeVideoId, formatTimestamp, isYouTubeUrl, stitchCaptionSegments } from './harvester/index.cjs';
10
- export { C as CatalogBuilder, H as HarvestedResourceItem, R as ResourceCatalogBundle } from './catalogBuilder-DgXYxL2F.cjs';
4
+ import { T as TaxonomyMappingResult, L as LiteratureReviewReport } from './literatureReview-C7hsjrn4.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-C7hsjrn4.cjs';
6
+ import { S as ScrapedDocument, T as TechnicalDomain } from './webScraper-yO9P-oLb.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-yO9P-oLb.cjs';
8
+ import { S as SearchHit } from './catalogBuilder-BaVRvg-9.cjs';
9
+ export { C as CatalogBuilder, H as HarvestedResourceItem, M as MultiSearchOptions, a as MultiSourceSearchEngine, R as ResourceCatalogBundle } from './catalogBuilder-BaVRvg-9.cjs';
10
+ import { YouTubeTranscriptResult, TermExtractionBundle, HealthAuditResult } from './harvester/index.cjs';
11
+ export { ContentQualityScore, ECOMMERCE_AND_COMMERCIAL_PATTERNS, ECOMMERCE_DOMAINS, GraphEdge, HealthAuditor, PedagogicalTermExtractor, ReducedGraphResult, TopoSortResult, TranscriptSegment, YouTubeIngestionService, evaluateTechnicalDensity, extractYouTubeVideoId, formatTimestamp, isCommercialOrNoise, isYouTubeUrl, kahnTopologicalSort, stitchCaptionSegments, transitiveReduction } from './harvester/index.cjs';
11
12
  import { ScoredEvidence, ClaimSweepReport } from './evidence/index.cjs';
12
13
  export { ClaimVerdict, ClaimVerifier, EvidenceScorer, VerifiedClaim, extractTopSentences } from './evidence/index.cjs';
13
14
  import { P as ProvenanceRecord, a as ProvenanceSidecar } from './provenanceTracker-ct4s5lJV.cjs';
14
15
  export { b as ProvenanceTracker } from './provenanceTracker-ct4s5lJV.cjs';
15
- import { ResearchPlan, HarvestPipelineOptions, HarvestPipelineResult } from './pipeline/index.cjs';
16
- export { CampaignPlanner, HarvestPipeline, ReferencePackBuilder, ReferencePackOutput, ReferenceRegistryItem, normalizeUrlForDedup } from './pipeline/index.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';
17
18
  import 'zod';
18
19
 
19
20
  interface ResearchKitClientConfig {
@@ -137,7 +138,19 @@ declare class PedagogicalSynthesisService {
137
138
  runFullHarvest(topic: string, overrides?: Partial<HarvestPipelineOptions>): Promise<HarvestPipelineResult>;
138
139
  }
139
140
  /**
140
- * Unified facade exposing all 5 core services of `@thanh01.pmt/research-kit`
141
+ * Service 6: Empirical Factsheet & Hardware/Software Technical Grounding (v1.2.0)
142
+ */
143
+ declare class TechnicalGroundingService {
144
+ private config;
145
+ private engine;
146
+ constructor(config: ResearchKitClientConfig);
147
+ buildFactsheet(topic: string, options?: {
148
+ domain?: TechnicalDomain;
149
+ context?: CourseResearchContext;
150
+ }): Promise<TechnicalFactsheet>;
151
+ }
152
+ /**
153
+ * Unified facade exposing all 6 core services of `@thanh01.pmt/research-kit`
141
154
  * configured with host-application API keys and LLM callbacks.
142
155
  */
143
156
  declare class ResearchKitClient {
@@ -152,7 +165,9 @@ declare class ResearchKitClient {
152
165
  readonly verification: EvidenceVerificationService;
153
166
  /** Service 5: Campaign Planning, Semantic Synthesis & Canonical Reference Pack Orchestration */
154
167
  readonly orchestrator: PedagogicalSynthesisService;
168
+ /** Service 6: Technical Grounding, Hardware/Software Compatibility & Empirical Exemplars */
169
+ readonly grounding: TechnicalGroundingService;
155
170
  constructor(config?: ResearchKitClientConfig);
156
171
  }
157
172
 
158
- 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, TaxonomyMappingResult, TechnicalDomain, TermExtractionBundle, TerminologyGraphService, YouTubeTranscriptResult };
173
+ 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, TaxonomyMappingResult, TechnicalDomain, TechnicalFactsheet, TechnicalGroundingService, TermExtractionBundle, TerminologyGraphService, YouTubeTranscriptResult };
package/dist/index.d.ts CHANGED
@@ -1,19 +1,20 @@
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-t8pahlJ4.js';
2
- export { i as AcademicPaperSchema, k as AcademicSearchEngine, j as AcademicSearchOptions, e as CrawlerProviderType, D as DEFAULT_RESEARCH_CONFIG, h as ResearchConfig, g as ResearchConfigSchema, S as SearchProviderType, f as SynthesizedResearchInsights, r as reconstructOpenAlexAbstract } from './index-t8pahlJ4.js';
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-DlngvZBr.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-DlngvZBr.js';
3
3
  export { ArXivSearchEngine, CitationItem, CitationManager } from './academic/index.js';
4
- import { T as TaxonomyMappingResult, L as LiteratureReviewReport } from './literatureReview-hGbfrBmw.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-hGbfrBmw.js';
6
- import { S as ScrapedDocument, T as TechnicalDomain } from './webScraper-BhiQ8s9x.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-BhiQ8s9x.js';
8
- import { SearchHit, YouTubeTranscriptResult, TermExtractionBundle, HealthAuditResult } from './harvester/index.js';
9
- export { HealthAuditor, MultiSearchOptions, MultiSourceSearchEngine, PedagogicalTermExtractor, TranscriptSegment, YouTubeIngestionService, extractYouTubeVideoId, formatTimestamp, isYouTubeUrl, stitchCaptionSegments } from './harvester/index.js';
10
- export { C as CatalogBuilder, H as HarvestedResourceItem, R as ResourceCatalogBundle } from './catalogBuilder-CmmQzUnf.js';
4
+ import { T as TaxonomyMappingResult, L as LiteratureReviewReport } from './literatureReview-DWl13r_3.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-DWl13r_3.js';
6
+ import { S as ScrapedDocument, T as TechnicalDomain } from './webScraper-DBFUIqoO.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-DBFUIqoO.js';
8
+ import { S as SearchHit } from './catalogBuilder-DHV6y1gD.js';
9
+ export { C as CatalogBuilder, H as HarvestedResourceItem, M as MultiSearchOptions, a as MultiSourceSearchEngine, R as ResourceCatalogBundle } from './catalogBuilder-DHV6y1gD.js';
10
+ import { YouTubeTranscriptResult, TermExtractionBundle, HealthAuditResult } from './harvester/index.js';
11
+ export { ContentQualityScore, ECOMMERCE_AND_COMMERCIAL_PATTERNS, ECOMMERCE_DOMAINS, GraphEdge, HealthAuditor, PedagogicalTermExtractor, ReducedGraphResult, TopoSortResult, TranscriptSegment, YouTubeIngestionService, evaluateTechnicalDensity, extractYouTubeVideoId, formatTimestamp, isCommercialOrNoise, isYouTubeUrl, kahnTopologicalSort, stitchCaptionSegments, transitiveReduction } from './harvester/index.js';
11
12
  import { ScoredEvidence, ClaimSweepReport } from './evidence/index.js';
12
13
  export { ClaimVerdict, ClaimVerifier, EvidenceScorer, VerifiedClaim, extractTopSentences } from './evidence/index.js';
13
14
  import { P as ProvenanceRecord, a as ProvenanceSidecar } from './provenanceTracker-ct4s5lJV.js';
14
15
  export { b as ProvenanceTracker } from './provenanceTracker-ct4s5lJV.js';
15
- import { ResearchPlan, HarvestPipelineOptions, HarvestPipelineResult } from './pipeline/index.js';
16
- export { CampaignPlanner, HarvestPipeline, ReferencePackBuilder, ReferencePackOutput, ReferenceRegistryItem, normalizeUrlForDedup } from './pipeline/index.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';
17
18
  import 'zod';
18
19
 
19
20
  interface ResearchKitClientConfig {
@@ -137,7 +138,19 @@ declare class PedagogicalSynthesisService {
137
138
  runFullHarvest(topic: string, overrides?: Partial<HarvestPipelineOptions>): Promise<HarvestPipelineResult>;
138
139
  }
139
140
  /**
140
- * Unified facade exposing all 5 core services of `@thanh01.pmt/research-kit`
141
+ * Service 6: Empirical Factsheet & Hardware/Software Technical Grounding (v1.2.0)
142
+ */
143
+ declare class TechnicalGroundingService {
144
+ private config;
145
+ private engine;
146
+ constructor(config: ResearchKitClientConfig);
147
+ buildFactsheet(topic: string, options?: {
148
+ domain?: TechnicalDomain;
149
+ context?: CourseResearchContext;
150
+ }): Promise<TechnicalFactsheet>;
151
+ }
152
+ /**
153
+ * Unified facade exposing all 6 core services of `@thanh01.pmt/research-kit`
141
154
  * configured with host-application API keys and LLM callbacks.
142
155
  */
143
156
  declare class ResearchKitClient {
@@ -152,7 +165,9 @@ declare class ResearchKitClient {
152
165
  readonly verification: EvidenceVerificationService;
153
166
  /** Service 5: Campaign Planning, Semantic Synthesis & Canonical Reference Pack Orchestration */
154
167
  readonly orchestrator: PedagogicalSynthesisService;
168
+ /** Service 6: Technical Grounding, Hardware/Software Compatibility & Empirical Exemplars */
169
+ readonly grounding: TechnicalGroundingService;
155
170
  constructor(config?: ResearchKitClientConfig);
156
171
  }
157
172
 
158
- 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, TaxonomyMappingResult, TechnicalDomain, TermExtractionBundle, TerminologyGraphService, YouTubeTranscriptResult };
173
+ 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, TaxonomyMappingResult, TechnicalDomain, TechnicalFactsheet, TechnicalGroundingService, TermExtractionBundle, TerminologyGraphService, YouTubeTranscriptResult };
package/dist/index.js CHANGED
@@ -1,18 +1,20 @@
1
- export { DEFAULT_RESEARCH_CONFIG, ResearchConfigSchema } from './chunk-J7XKDMGL.js';
1
+ export { DEFAULT_RESEARCH_CONFIG, ResearchConfigSchema } from './chunk-X3X26W2I.js';
2
2
  import './chunk-J3VCGH7Z.js';
3
- import './chunk-2JEVBCIF.js';
3
+ import './chunk-LSMSIPTZ.js';
4
4
  import { ClaimVerifier } from './chunk-2XIEWCUE.js';
5
5
  export { ClaimVerifier } from './chunk-2XIEWCUE.js';
6
- import { HarvestPipeline, CampaignPlanner } from './chunk-AUGVVZTL.js';
7
- export { CampaignPlanner, HarvestPipeline, ReferencePackBuilder, normalizeUrlForDedup } from './chunk-AUGVVZTL.js';
8
- import { AcademicSearchEngine, LiteratureReviewSynthesizer, mapTopicToCS2023 } from './chunk-DOXSPRSP.js';
9
- export { AcademicPaperSchema, AcademicSearchEngine, ArXivSearchEngine, CS2023_KNOWLEDGE_AREAS, CSTA_K12_STRANDS, CitationManager, LiteratureReviewSynthesizer, mapTopicToCS2023, reconstructOpenAlexAbstract } from './chunk-DOXSPRSP.js';
10
- import { MultiSourceSearchEngine, PedagogicalTermExtractor, classifyTechnicalDomain, HealthAuditor } from './chunk-XIF5YNI7.js';
11
- export { CatalogBuilder, HealthAuditor, MultiSourceSearchEngine, PedagogicalTermExtractor, classifyTechnicalDomain, inferPrimaryCodeLanguage } from './chunk-XIF5YNI7.js';
12
- import { EvidenceScorer, ProvenanceTracker } from './chunk-GKF3NDEX.js';
13
- export { EvidenceScorer, ProvenanceTracker, extractTopSentences } from './chunk-GKF3NDEX.js';
14
- import { WebScraper, YouTubeIngestionService } from './chunk-KAFQVI2R.js';
15
- export { WebScraper, YouTubeIngestionService, extractSubstantiveExcerpts, extractYouTubeVideoId, formatTimestamp, isYouTubeUrl, stitchCaptionSegments } from './chunk-KAFQVI2R.js';
6
+ import { HarvestPipeline, CampaignPlanner, TechnicalGroundingEngine } from './chunk-RW7VS7NI.js';
7
+ export { CampaignPlanner, HarvestPipeline, ReferencePackBuilder, TechnicalGroundingEngine, normalizeUrlForDedup } from './chunk-RW7VS7NI.js';
8
+ import { LiteratureReviewSynthesizer, mapTopicToCS2023 } from './chunk-UKGR45VZ.js';
9
+ export { CS2023_KNOWLEDGE_AREAS, CSTA_K12_STRANDS, CitationManager, LiteratureReviewSynthesizer, mapTopicToCS2023 } from './chunk-UKGR45VZ.js';
10
+ import { MultiSourceSearchEngine, PedagogicalTermExtractor, classifyTechnicalDomain, HealthAuditor } from './chunk-HZNSZDSM.js';
11
+ export { CatalogBuilder, ECOMMERCE_AND_COMMERCIAL_PATTERNS, ECOMMERCE_DOMAINS, HealthAuditor, MultiSourceSearchEngine, PedagogicalTermExtractor, classifyTechnicalDomain, evaluateTechnicalDensity, inferPrimaryCodeLanguage, isCommercialOrNoise, kahnTopologicalSort, transitiveReduction } from './chunk-HZNSZDSM.js';
12
+ import { AcademicSearchEngine } from './chunk-AKEI7H2C.js';
13
+ export { AcademicPaperSchema, AcademicSearchEngine, ArXivSearchEngine, reconstructOpenAlexAbstract } from './chunk-AKEI7H2C.js';
14
+ import { EvidenceScorer, ProvenanceTracker } from './chunk-QFYM2NV4.js';
15
+ export { EvidenceScorer, ProvenanceTracker, extractTopSentences } from './chunk-QFYM2NV4.js';
16
+ import { WebScraper, YouTubeIngestionService } from './chunk-ON6VFCJO.js';
17
+ export { WebScraper, YouTubeIngestionService, extractSubstantiveExcerpts, extractYouTubeVideoId, formatTimestamp, isYouTubeUrl, stitchCaptionSegments } from './chunk-ON6VFCJO.js';
16
18
 
17
19
  // src/services/researchKitClient.ts
18
20
  var KnowledgeDiscoveryService = class {
@@ -213,6 +215,29 @@ var PedagogicalSynthesisService = class {
213
215
  });
214
216
  }
215
217
  };
218
+ var TechnicalGroundingService = class {
219
+ constructor(config) {
220
+ this.config = config;
221
+ const searchEngine = new MultiSourceSearchEngine({
222
+ apiKeys: config.apiKeys,
223
+ allowEnvFallback: config.allowEnvFallback,
224
+ customAdapter: config.customSearchAdapter
225
+ });
226
+ const scraper = new WebScraper({
227
+ crawl4aiHost: config.crawl4aiHost,
228
+ jinaKey: config.apiKeys?.jina,
229
+ allowEnvFallback: config.allowEnvFallback,
230
+ customAdapter: config.customCrawlerAdapter
231
+ });
232
+ this.engine = new TechnicalGroundingEngine(searchEngine, scraper);
233
+ }
234
+ engine;
235
+ async buildFactsheet(topic, options) {
236
+ const ctx = options?.context ?? this.config.defaultCourseContext;
237
+ const domain = options?.domain ?? classifyTechnicalDomain(topic, void 0, ctx).domain;
238
+ return this.engine.buildFactsheet(topic, domain, ctx, this.config.llm);
239
+ }
240
+ };
216
241
  var ResearchKitClient = class {
217
242
  constructor(config = {}) {
218
243
  this.config = config;
@@ -221,6 +246,7 @@ var ResearchKitClient = class {
221
246
  this.academic = new AcademicStandardsService(config);
222
247
  this.verification = new EvidenceVerificationService(config);
223
248
  this.orchestrator = new PedagogicalSynthesisService(config);
249
+ this.grounding = new TechnicalGroundingService(config);
224
250
  }
225
251
  /** Service 1: Multi-Engine Web Search, Scraper & YouTube Transcript Ingestion */
226
252
  discovery;
@@ -232,8 +258,10 @@ var ResearchKitClient = class {
232
258
  verification;
233
259
  /** Service 5: Campaign Planning, Semantic Synthesis & Canonical Reference Pack Orchestration */
234
260
  orchestrator;
261
+ /** Service 6: Technical Grounding, Hardware/Software Compatibility & Empirical Exemplars */
262
+ grounding;
235
263
  };
236
264
 
237
- export { AcademicStandardsService, EvidenceVerificationService, KnowledgeDiscoveryService, PedagogicalSynthesisService, ResearchKitClient, TerminologyGraphService };
265
+ export { AcademicStandardsService, EvidenceVerificationService, KnowledgeDiscoveryService, PedagogicalSynthesisService, ResearchKitClient, TechnicalGroundingService, TerminologyGraphService };
238
266
  //# sourceMappingURL=index.js.map
239
267
  //# sourceMappingURL=index.js.map
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 { 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';\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\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 allowEnvFallback: config.allowEnvFallback,\n customAdapter: config.customCrawlerAdapter,\n });\n this.youtubeService = new YouTubeIngestionService();\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\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 * Unified facade exposing all 5 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\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 }\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 { 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\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 allowEnvFallback: config.allowEnvFallback,\n customAdapter: config.customCrawlerAdapter,\n });\n this.youtubeService = new YouTubeIngestionService();\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\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,4 +1,4 @@
1
- import { C as CourseResearchContext, A as AcademicPaper, L as LlmTextFn } from './index-t8pahlJ4.cjs';
1
+ import { C as CourseResearchContext, A as AcademicPaper, L as LlmTextFn } from './index-DlngvZBr.cjs';
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-t8pahlJ4.js';
1
+ import { C as CourseResearchContext, A as AcademicPaper, L as LlmTextFn } from './index-DlngvZBr.js';
2
2
 
3
3
  interface CS2023KnowledgeArea {
4
4
  code: string;