@thanh01.pmt/research-kit 1.3.0 → 1.4.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.
- package/dist/academic/index.cjs +4 -4
- package/dist/academic/index.cjs.map +1 -1
- package/dist/academic/index.js +2 -2
- package/dist/agent/index.cjs +1137 -301
- package/dist/agent/index.cjs.map +1 -1
- package/dist/agent/index.d.cts +1 -1
- package/dist/agent/index.d.ts +1 -1
- package/dist/agent/index.js +7 -7
- package/dist/chunk-4S6UMYBA.js +1931 -0
- package/dist/chunk-4S6UMYBA.js.map +1 -0
- package/dist/{chunk-S3JUCDKD.js → chunk-6U2H2DMQ.js} +7 -7
- package/dist/{chunk-S3JUCDKD.js.map → chunk-6U2H2DMQ.js.map} +1 -1
- package/dist/{chunk-ZNGU4ZYX.js → chunk-7BGR4E37.js} +5 -5
- package/dist/{chunk-ZNGU4ZYX.js.map → chunk-7BGR4E37.js.map} +1 -1
- package/dist/{chunk-AKEI7H2C.js → chunk-EWIAA2CC.js} +4 -4
- package/dist/{chunk-AKEI7H2C.js.map → chunk-EWIAA2CC.js.map} +1 -1
- package/dist/{chunk-QQZQNBJC.js → chunk-JV6Z6WUQ.js} +4 -4
- package/dist/{chunk-QQZQNBJC.js.map → chunk-JV6Z6WUQ.js.map} +1 -1
- package/dist/{chunk-2RMBLKP5.js → chunk-MJIREPKJ.js} +3 -3
- package/dist/{chunk-2RMBLKP5.js.map → chunk-MJIREPKJ.js.map} +1 -1
- package/dist/{chunk-KXJDQBSJ.js → chunk-PFECHAAR.js} +12 -5
- package/dist/chunk-PFECHAAR.js.map +1 -0
- package/dist/{chunk-NSY6KU4G.js → chunk-SEHHDO7X.js} +5 -5
- package/dist/{chunk-NSY6KU4G.js.map → chunk-SEHHDO7X.js.map} +1 -1
- package/dist/{chunk-RYLZYZRF.js → chunk-UCPWBRZ2.js} +3 -3
- package/dist/{chunk-RYLZYZRF.js.map → chunk-UCPWBRZ2.js.map} +1 -1
- package/dist/evidence/index.cjs +9 -2
- package/dist/evidence/index.cjs.map +1 -1
- package/dist/evidence/index.js +2 -2
- package/dist/harvester/index.cjs +6 -6
- package/dist/harvester/index.cjs.map +1 -1
- package/dist/harvester/index.js +5 -5
- package/dist/{index-onQDKDNo.d.cts → index-BOwJ1jON.d.cts} +317 -71
- package/dist/{index-CN8gei7k.d.ts → index-_aiOh8jX.d.ts} +317 -71
- package/dist/index.cjs +1145 -302
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.js +25 -18
- package/dist/index.js.map +1 -1
- package/dist/pipeline/index.cjs +13 -6
- package/dist/pipeline/index.cjs.map +1 -1
- package/dist/pipeline/index.js +6 -6
- package/package.json +1 -1
- package/dist/chunk-KXJDQBSJ.js.map +0 -1
- package/dist/chunk-WWQ45RQK.js +0 -1114
- package/dist/chunk-WWQ45RQK.js.map +0 -1
package/dist/index.d.cts
CHANGED
|
@@ -8,5 +8,5 @@ export { ContentQualityScore, ECOMMERCE_AND_COMMERCIAL_PATTERNS, ECOMMERCE_DOMAI
|
|
|
8
8
|
export { ClaimSweepReport, ClaimVerdict, ClaimVerifier, EvidenceScorer, ScoredEvidence, VerifiedClaim, extractTopSentences } from './evidence/index.cjs';
|
|
9
9
|
export { P as ProvenanceRecord, a as ProvenanceSidecar, b as ProvenanceTracker } from './provenanceTracker-ct4s5lJV.cjs';
|
|
10
10
|
export { CampaignPlanner, ExemplarProject, HarvestPipeline, HarvestPipelineOptions, HarvestPipelineResult, ReferencePackBuilder, ReferencePackOutput, ReferenceRegistryItem, ResearchPlan, TechnicalFactsheet, TechnicalGroundingEngine, normalizeUrlForDedup } from './pipeline/index.cjs';
|
|
11
|
-
export {
|
|
11
|
+
export { $ as AcademicStandardsService, m as ChannelExecutionTrace, C as ChannelStatus, q as CitationReceipt, I as ConcurrentRefillSchedulerParams, J as ConcurrentRefillSchedulerResult, E as EvidenceLedger, a0 as EvidenceVerificationService, Z as KnowledgeDiscoveryService, L as LedgerItem, M as ModeClassificationTrace, u as ModePreset, z as PRIOR_MATRIX, a1 as PedagogicalSynthesisService, P as ProfilePreset, x as QUESTION_FACETS, Q as QuestionFacet, v as RESEARCH_MODE_PRESETS, w as RESEARCH_PROFILE_PRESETS, n as ResearchAcceptanceCriteria, t as ResearchAgentResult, r as ResearchAgentStatus, V as ResearchAgentToolInput, U as ResearchAgentToolInputSchema, o as ResearchBudget, g as ResearchChoiceAnswer, c as ResearchChoiceQuestion, p as ResearchContract, i as ResearchDecisionAnswer, l as ResearchDecisionFn, e as ResearchDecisionQuestion, j as ResearchDecisionRequest, k as ResearchDecisionResult, a3 as ResearchKitClient, Y as ResearchKitClientConfig, R as ResearchMode, h as ResearchNoulAnswer, d as ResearchNoulQuestion, a as ResearchProfile, s as ResearchRoundTrace, f as ResearchScoreAnswer, b as ResearchScoreQuestion, T as ResearchSubAgent, y as SOURCE_CHANNELS, S as SourceChannel, a2 as TechnicalGroundingService, _ as TerminologyGraphService, H as classifyChannelStatus, F as classifyModeAndPrior, A as computeContractComplexityScore, X as createResearchAgentTool, G as evaluateAttributeCoverageWithDecision, B as inferFallbackFacetProbabilities, O as isSemanticRankedHit, D as rankChannelsByExpectedPrior, N as resolveResearchProfile, K as runConcurrentRefillScheduler, W as runResearchSubAgent } from './index-BOwJ1jON.cjs';
|
|
12
12
|
import 'zod';
|
package/dist/index.d.ts
CHANGED
|
@@ -8,5 +8,5 @@ export { ContentQualityScore, ECOMMERCE_AND_COMMERCIAL_PATTERNS, ECOMMERCE_DOMAI
|
|
|
8
8
|
export { ClaimSweepReport, ClaimVerdict, ClaimVerifier, EvidenceScorer, ScoredEvidence, VerifiedClaim, extractTopSentences } from './evidence/index.js';
|
|
9
9
|
export { P as ProvenanceRecord, a as ProvenanceSidecar, b as ProvenanceTracker } from './provenanceTracker-ct4s5lJV.js';
|
|
10
10
|
export { CampaignPlanner, ExemplarProject, HarvestPipeline, HarvestPipelineOptions, HarvestPipelineResult, ReferencePackBuilder, ReferencePackOutput, ReferenceRegistryItem, ResearchPlan, TechnicalFactsheet, TechnicalGroundingEngine, normalizeUrlForDedup } from './pipeline/index.js';
|
|
11
|
-
export {
|
|
11
|
+
export { $ as AcademicStandardsService, m as ChannelExecutionTrace, C as ChannelStatus, q as CitationReceipt, I as ConcurrentRefillSchedulerParams, J as ConcurrentRefillSchedulerResult, E as EvidenceLedger, a0 as EvidenceVerificationService, Z as KnowledgeDiscoveryService, L as LedgerItem, M as ModeClassificationTrace, u as ModePreset, z as PRIOR_MATRIX, a1 as PedagogicalSynthesisService, P as ProfilePreset, x as QUESTION_FACETS, Q as QuestionFacet, v as RESEARCH_MODE_PRESETS, w as RESEARCH_PROFILE_PRESETS, n as ResearchAcceptanceCriteria, t as ResearchAgentResult, r as ResearchAgentStatus, V as ResearchAgentToolInput, U as ResearchAgentToolInputSchema, o as ResearchBudget, g as ResearchChoiceAnswer, c as ResearchChoiceQuestion, p as ResearchContract, i as ResearchDecisionAnswer, l as ResearchDecisionFn, e as ResearchDecisionQuestion, j as ResearchDecisionRequest, k as ResearchDecisionResult, a3 as ResearchKitClient, Y as ResearchKitClientConfig, R as ResearchMode, h as ResearchNoulAnswer, d as ResearchNoulQuestion, a as ResearchProfile, s as ResearchRoundTrace, f as ResearchScoreAnswer, b as ResearchScoreQuestion, T as ResearchSubAgent, y as SOURCE_CHANNELS, S as SourceChannel, a2 as TechnicalGroundingService, _ as TerminologyGraphService, H as classifyChannelStatus, F as classifyModeAndPrior, A as computeContractComplexityScore, X as createResearchAgentTool, G as evaluateAttributeCoverageWithDecision, B as inferFallbackFacetProbabilities, O as isSemanticRankedHit, D as rankChannelsByExpectedPrior, N as resolveResearchProfile, K as runConcurrentRefillScheduler, W as runResearchSubAgent } from './index-_aiOh8jX.js';
|
|
12
12
|
import 'zod';
|
package/dist/index.js
CHANGED
|
@@ -2,27 +2,27 @@ export { DEFAULT_RESEARCH_CONFIG, ResearchConfigSchema } from './chunk-HESXWQEF.
|
|
|
2
2
|
import './chunk-2GBXVPOQ.js';
|
|
3
3
|
import './chunk-LDCZ33AC.js';
|
|
4
4
|
import './chunk-TYQEC24G.js';
|
|
5
|
-
import { HarvestPipeline, CampaignPlanner, TechnicalGroundingEngine } from './chunk-
|
|
6
|
-
export { CampaignPlanner, HarvestPipeline, ReferencePackBuilder, TechnicalGroundingEngine, normalizeUrlForDedup } from './chunk-
|
|
5
|
+
import { HarvestPipeline, CampaignPlanner, TechnicalGroundingEngine } from './chunk-6U2H2DMQ.js';
|
|
6
|
+
export { CampaignPlanner, HarvestPipeline, ReferencePackBuilder, TechnicalGroundingEngine, normalizeUrlForDedup } from './chunk-6U2H2DMQ.js';
|
|
7
7
|
import { LiteratureReviewSynthesizer, mapTopicToCS2023 } from './chunk-SDDZFFL6.js';
|
|
8
8
|
export { CS2023_KNOWLEDGE_AREAS, CSTA_K12_STRANDS, CitationManager, LiteratureReviewSynthesizer, mapTopicToCS2023 } from './chunk-SDDZFFL6.js';
|
|
9
|
-
import { PedagogicalTermExtractor } from './chunk-
|
|
10
|
-
export { CatalogBuilder, PedagogicalTermExtractor, kahnTopologicalSort, transitiveReduction } from './chunk-
|
|
11
|
-
import { ResearchSubAgent } from './chunk-
|
|
12
|
-
export { EvidenceLedger, RESEARCH_PROFILE_PRESETS, ResearchAgentToolInputSchema, ResearchSubAgent, createResearchAgentTool, resolveResearchProfile, runResearchSubAgent } from './chunk-
|
|
13
|
-
export { OpenAlexClient, cleanCrossrefAbstract } from './chunk-
|
|
14
|
-
import { StemResourceResearcher, SocialPulseHarvester } from './chunk-
|
|
15
|
-
export { GitHubCurriculumClient, NasaMediaClient, OpenverseClient, SocialPulseHarvester, StemResourceResearcher } from './chunk-
|
|
9
|
+
import { PedagogicalTermExtractor } from './chunk-UCPWBRZ2.js';
|
|
10
|
+
export { CatalogBuilder, PedagogicalTermExtractor, kahnTopologicalSort, transitiveReduction } from './chunk-UCPWBRZ2.js';
|
|
11
|
+
import { ResearchSubAgent } from './chunk-4S6UMYBA.js';
|
|
12
|
+
export { EvidenceLedger, PRIOR_MATRIX, QUESTION_FACETS, RESEARCH_MODE_PRESETS, RESEARCH_PROFILE_PRESETS, ResearchAgentToolInputSchema, ResearchSubAgent, SOURCE_CHANNELS, classifyChannelStatus, classifyModeAndPrior, computeContractComplexityScore, createResearchAgentTool, evaluateAttributeCoverageWithDecision, inferFallbackFacetProbabilities, isSemanticRankedHit, rankChannelsByExpectedPrior, resolveResearchProfile, runConcurrentRefillScheduler, runResearchSubAgent } from './chunk-4S6UMYBA.js';
|
|
13
|
+
export { OpenAlexClient, cleanCrossrefAbstract } from './chunk-SEHHDO7X.js';
|
|
14
|
+
import { StemResourceResearcher, SocialPulseHarvester } from './chunk-7BGR4E37.js';
|
|
15
|
+
export { GitHubCurriculumClient, NasaMediaClient, OpenverseClient, SocialPulseHarvester, StemResourceResearcher } from './chunk-7BGR4E37.js';
|
|
16
16
|
import { ClaimVerifier } from './chunk-32B5PVTQ.js';
|
|
17
17
|
export { ClaimVerifier } from './chunk-32B5PVTQ.js';
|
|
18
|
-
import { MultiSourceSearchEngine, classifyTechnicalDomain, HealthAuditor } from './chunk-
|
|
19
|
-
export { ECOMMERCE_AND_COMMERCIAL_PATTERNS, ECOMMERCE_DOMAINS, HealthAuditor, MultiSourceSearchEngine, classifyTechnicalDomain, evaluateTechnicalDensity, inferPrimaryCodeLanguage, isCommercialOrNoise } from './chunk-
|
|
20
|
-
import { AcademicSearchEngine } from './chunk-
|
|
21
|
-
export { AcademicPaperSchema, AcademicSearchEngine, ArXivSearchEngine, reconstructOpenAlexAbstract } from './chunk-
|
|
22
|
-
import { EvidenceScorer, ProvenanceTracker } from './chunk-
|
|
23
|
-
export { EvidenceScorer, ProvenanceTracker, extractTopSentences } from './chunk-
|
|
24
|
-
import { WebScraper, YouTubeIngestionService } from './chunk-
|
|
25
|
-
export { WebScraper, YouTubeIngestionService, extractSubstantiveExcerpts, extractYouTubeVideoId, formatTimestamp, isYouTubeUrl, stitchCaptionSegments } from './chunk-
|
|
18
|
+
import { MultiSourceSearchEngine, classifyTechnicalDomain, HealthAuditor } from './chunk-MJIREPKJ.js';
|
|
19
|
+
export { ECOMMERCE_AND_COMMERCIAL_PATTERNS, ECOMMERCE_DOMAINS, HealthAuditor, MultiSourceSearchEngine, classifyTechnicalDomain, evaluateTechnicalDensity, inferPrimaryCodeLanguage, isCommercialOrNoise } from './chunk-MJIREPKJ.js';
|
|
20
|
+
import { AcademicSearchEngine } from './chunk-EWIAA2CC.js';
|
|
21
|
+
export { AcademicPaperSchema, AcademicSearchEngine, ArXivSearchEngine, reconstructOpenAlexAbstract } from './chunk-EWIAA2CC.js';
|
|
22
|
+
import { EvidenceScorer, ProvenanceTracker } from './chunk-PFECHAAR.js';
|
|
23
|
+
export { EvidenceScorer, ProvenanceTracker, extractTopSentences } from './chunk-PFECHAAR.js';
|
|
24
|
+
import { WebScraper, YouTubeIngestionService } from './chunk-JV6Z6WUQ.js';
|
|
25
|
+
export { WebScraper, YouTubeIngestionService, extractSubstantiveExcerpts, extractYouTubeVideoId, formatTimestamp, isYouTubeUrl, stitchCaptionSegments } from './chunk-JV6Z6WUQ.js';
|
|
26
26
|
|
|
27
27
|
// src/services/researchKitClient.ts
|
|
28
28
|
var KnowledgeDiscoveryService = class {
|
|
@@ -280,8 +280,15 @@ var ResearchKitClient = class {
|
|
|
280
280
|
orchestrator;
|
|
281
281
|
/** Service 6: Technical Grounding, Hardware/Software Compatibility & Empirical Exemplars */
|
|
282
282
|
grounding;
|
|
283
|
-
/** Service 7: Autonomous Contract-Driven Plan-and-Execute Research Sub-Agent (v1.
|
|
283
|
+
/** Service 7: Autonomous Contract-Driven Plan-and-Execute Research Sub-Agent (v1.4.0) */
|
|
284
284
|
agent;
|
|
285
|
+
/**
|
|
286
|
+
* Unified Tri-Mode entrypoint (`'auto' | 'search' | 'research' | 'deep-research'`).
|
|
287
|
+
*/
|
|
288
|
+
async execute(mode, input) {
|
|
289
|
+
const contract = typeof input === "string" ? { objective: input, mode } : { ...input, mode };
|
|
290
|
+
return this.agent.run(contract);
|
|
291
|
+
}
|
|
285
292
|
};
|
|
286
293
|
|
|
287
294
|
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 { 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
|
+
{"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';\nimport {\n ResearchAgentResult,\n ResearchContract,\n ResearchDecisionFn,\n ResearchMode,\n} from '../agent/types';\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 * Optional Decision Model callback (System One — ADR-0001 / ADR-0016 / ADR-0019)\n * injected from the host application for English rubric mode classification,\n * expected channel prior routing, and `noul` attribute coverage checks.\n */\n decision?: ResearchDecisionFn;\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.4.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 /**\n * Unified Tri-Mode entrypoint (`'auto' | 'search' | 'research' | 'deep-research'`).\n */\n async execute<T = Record<string, unknown>>(\n mode: ResearchMode,\n input: ResearchContract<T> | string\n ): Promise<ResearchAgentResult<T>> {\n const contract: ResearchContract<T> =\n typeof input === 'string'\n ? { objective: input, mode }\n : { ...input, mode };\n return this.agent.run(contract);\n }\n}\n"]}
|
package/dist/pipeline/index.cjs
CHANGED
|
@@ -476,7 +476,7 @@ var AcademicSearchEngine = class {
|
|
|
476
476
|
}
|
|
477
477
|
const res = await fetch(`https://api.semanticscholar.org/graph/v1/paper/search?${params.toString()}`, {
|
|
478
478
|
headers,
|
|
479
|
-
signal: AbortSignal.timeout(
|
|
479
|
+
signal: AbortSignal.timeout(12e3)
|
|
480
480
|
});
|
|
481
481
|
if (res.ok) {
|
|
482
482
|
const data = await res.json();
|
|
@@ -507,7 +507,7 @@ var AcademicSearchEngine = class {
|
|
|
507
507
|
try {
|
|
508
508
|
const res = await fetch(`https://api.openalex.org/works?search=${encodeURIComponent(query)}&per-page=${limit}`, {
|
|
509
509
|
headers: { "User-Agent": "OrchableComposer/1.0 (mailto:team@orchable.app)" },
|
|
510
|
-
signal: AbortSignal.timeout(
|
|
510
|
+
signal: AbortSignal.timeout(12e3)
|
|
511
511
|
});
|
|
512
512
|
if (res.ok) {
|
|
513
513
|
const data = await res.json();
|
|
@@ -1173,7 +1173,7 @@ var WebScraper = class {
|
|
|
1173
1173
|
}
|
|
1174
1174
|
const res = await fetch(jinaUrl, {
|
|
1175
1175
|
headers,
|
|
1176
|
-
signal: AbortSignal.timeout(
|
|
1176
|
+
signal: AbortSignal.timeout(15e3)
|
|
1177
1177
|
});
|
|
1178
1178
|
if (res.ok) {
|
|
1179
1179
|
const markdown = await res.text();
|
|
@@ -1215,7 +1215,7 @@ var WebScraper = class {
|
|
|
1215
1215
|
try {
|
|
1216
1216
|
const res = await fetch(targetUrl, {
|
|
1217
1217
|
headers: { "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)" },
|
|
1218
|
-
signal: AbortSignal.timeout(
|
|
1218
|
+
signal: AbortSignal.timeout(15e3)
|
|
1219
1219
|
});
|
|
1220
1220
|
if (res.ok) {
|
|
1221
1221
|
const rawHtml = await res.text();
|
|
@@ -1969,6 +1969,13 @@ Return ONLY a valid JSON array of 6 to 12 atomic pedagogical concepts ordered fr
|
|
|
1969
1969
|
function tokenizeBilingualKeywords(text) {
|
|
1970
1970
|
return text.normalize("NFC").toLowerCase().replace(/[.,;:!?()[\]{}"“”‘’/\\|`*_~#-]+/g, " ").split(/\s+/).filter((w) => w.length >= 2 && !/^(and|the|for|with|from|into|của|trong|được|những|các|cho|với|khi|và|hoặc|để|từ|đến|về)$/.test(w));
|
|
1971
1971
|
}
|
|
1972
|
+
function keywordMatchesText(keyword, lowerText) {
|
|
1973
|
+
if (keyword.length <= 3) {
|
|
1974
|
+
const escaped = keyword.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
|
|
1975
|
+
return new RegExp(`(?:^|[^a-z0-9\\u00C0-\\u1EF9])${escaped}(?:$|[^a-z0-9\\u00C0-\\u1EF9])`, "i").test(lowerText);
|
|
1976
|
+
}
|
|
1977
|
+
return lowerText.includes(keyword);
|
|
1978
|
+
}
|
|
1972
1979
|
function extractTopSentences(markdown, targetTopic, maxSentences = 3) {
|
|
1973
1980
|
const keywords = tokenizeBilingualKeywords(targetTopic);
|
|
1974
1981
|
const withoutCode = markdown.replace(/```[\s\S]*?```/g, " ");
|
|
@@ -1981,7 +1988,7 @@ function extractTopSentences(markdown, targetTopic, maxSentences = 3) {
|
|
|
1981
1988
|
if (rawSentences.length === 0) return [];
|
|
1982
1989
|
const scored = rawSentences.map((sentence, idx) => {
|
|
1983
1990
|
const lower = sentence.normalize("NFC").toLowerCase();
|
|
1984
|
-
const matchedCount = keywords.filter((k) =>
|
|
1991
|
+
const matchedCount = keywords.filter((k) => keywordMatchesText(k, lower)).length;
|
|
1985
1992
|
const positionBonus = idx < 8 ? 1.5 : idx < 20 ? 0.5 : 0;
|
|
1986
1993
|
const technicalBonus = /(`[^`]+`|\b(?:api|function|class|actor|async|sensor|pin|loop|state|biến|hàm|cảm biến|vòng lặp|mạch)\b)/i.test(
|
|
1987
1994
|
sentence
|
|
@@ -2002,7 +2009,7 @@ var EvidenceScorer = class {
|
|
|
2002
2009
|
let noiseScore = 2;
|
|
2003
2010
|
const lowerContent = doc.markdownContent.normalize("NFC").toLowerCase();
|
|
2004
2011
|
const targetKeywords = tokenizeBilingualKeywords(targetTopic);
|
|
2005
|
-
const keywordMatches = targetKeywords.filter((k) =>
|
|
2012
|
+
const keywordMatches = targetKeywords.filter((k) => keywordMatchesText(k, lowerContent)).length;
|
|
2006
2013
|
const matchRatio = targetKeywords.length > 0 ? keywordMatches / targetKeywords.length : 1;
|
|
2007
2014
|
if (matchRatio >= 0.75) depthScore += 3;
|
|
2008
2015
|
else if (matchRatio >= 0.4) depthScore += 2;
|