@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.
- package/README.md +27 -14
- package/dist/academic/index.d.cts +3 -3
- package/dist/academic/index.d.ts +3 -3
- package/dist/academic/index.js +2 -1
- package/dist/catalogBuilder-BaVRvg-9.d.cts +90 -0
- package/dist/catalogBuilder-DHV6y1gD.d.ts +90 -0
- package/dist/chunk-AKEI7H2C.js +223 -0
- package/dist/chunk-AKEI7H2C.js.map +1 -0
- package/dist/{chunk-XIF5YNI7.js → chunk-HZNSZDSM.js} +318 -8
- package/dist/chunk-HZNSZDSM.js.map +1 -0
- package/dist/chunk-LSMSIPTZ.js +3 -0
- package/dist/{chunk-2JEVBCIF.js.map → chunk-LSMSIPTZ.js.map} +1 -1
- package/dist/{chunk-KAFQVI2R.js → chunk-ON6VFCJO.js} +3 -3
- package/dist/{chunk-KAFQVI2R.js.map → chunk-ON6VFCJO.js.map} +1 -1
- package/dist/{chunk-GKF3NDEX.js → chunk-QFYM2NV4.js} +3 -3
- package/dist/{chunk-GKF3NDEX.js.map → chunk-QFYM2NV4.js.map} +1 -1
- package/dist/{chunk-AUGVVZTL.js → chunk-RW7VS7NI.js} +175 -7
- package/dist/chunk-RW7VS7NI.js.map +1 -0
- package/dist/{chunk-DOXSPRSP.js → chunk-UKGR45VZ.js} +3 -223
- package/dist/chunk-UKGR45VZ.js.map +1 -0
- package/dist/{chunk-J7XKDMGL.js → chunk-X3X26W2I.js} +2 -2
- package/dist/{chunk-J7XKDMGL.js.map → chunk-X3X26W2I.js.map} +1 -1
- package/dist/config/index.cjs.map +1 -1
- package/dist/config/index.d.cts +1 -1
- package/dist/config/index.d.ts +1 -1
- package/dist/config/index.js +1 -1
- package/dist/evidence/index.cjs.map +1 -1
- package/dist/evidence/index.d.cts +2 -2
- package/dist/evidence/index.d.ts +2 -2
- package/dist/evidence/index.js +2 -2
- package/dist/harvester/index.cjs +542 -6
- package/dist/harvester/index.cjs.map +1 -1
- package/dist/harvester/index.d.cts +63 -49
- package/dist/harvester/index.d.ts +63 -49
- package/dist/harvester/index.js +4 -3
- package/dist/{index-t8pahlJ4.d.ts → index-DlngvZBr.d.cts} +15 -1
- package/dist/{index-t8pahlJ4.d.cts → index-DlngvZBr.d.ts} +15 -1
- package/dist/index.cjs +515 -6
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +28 -13
- package/dist/index.d.ts +28 -13
- package/dist/index.js +41 -13
- package/dist/index.js.map +1 -1
- package/dist/{literatureReview-BTPFe7eb.d.cts → literatureReview-C7hsjrn4.d.cts} +1 -1
- package/dist/{literatureReview-hGbfrBmw.d.ts → literatureReview-DWl13r_3.d.ts} +1 -1
- package/dist/pipeline/index.cjs +658 -231
- package/dist/pipeline/index.cjs.map +1 -1
- package/dist/pipeline/index.d.cts +49 -5
- package/dist/pipeline/index.d.ts +49 -5
- package/dist/pipeline/index.js +6 -5
- package/dist/{webScraper-BhiQ8s9x.d.ts → webScraper-DBFUIqoO.d.ts} +1 -1
- package/dist/{webScraper-D9Ldus9p.d.cts → webScraper-yO9P-oLb.d.cts} +1 -1
- package/package.json +1 -1
- package/dist/catalogBuilder-CmmQzUnf.d.ts +0 -38
- package/dist/catalogBuilder-DgXYxL2F.d.cts +0 -38
- package/dist/chunk-2JEVBCIF.js +0 -3
- package/dist/chunk-AUGVVZTL.js.map +0 -1
- package/dist/chunk-DOXSPRSP.js.map +0 -1
- package/dist/chunk-XIF5YNI7.js.map +0 -1
|
@@ -1,53 +1,9 @@
|
|
|
1
|
-
import { T as TechnicalDomain, S as ScrapedDocument } from '../webScraper-
|
|
2
|
-
export { D as DomainClassificationResult, E as ExtractedCodeBlock, a as WebScraper, W as WebScraperOptions, c as classifyTechnicalDomain, e as extractSubstantiveExcerpts, i as inferPrimaryCodeLanguage } from '../webScraper-
|
|
3
|
-
|
|
4
|
-
|
|
1
|
+
import { T as TechnicalDomain, S as ScrapedDocument } from '../webScraper-yO9P-oLb.cjs';
|
|
2
|
+
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';
|
|
3
|
+
export { C as CatalogBuilder, H as HarvestedResourceItem, M as MultiSearchOptions, a as MultiSourceSearchEngine, R as ResourceCatalogBundle, S as SearchHit } from '../catalogBuilder-BaVRvg-9.cjs';
|
|
4
|
+
import { E as ExtractedConceptNode, C as CourseResearchContext, L as LlmTextFn } from '../index-DlngvZBr.cjs';
|
|
5
5
|
import 'zod';
|
|
6
6
|
|
|
7
|
-
interface SearchHit {
|
|
8
|
-
title: string;
|
|
9
|
-
url: string;
|
|
10
|
-
content: string;
|
|
11
|
-
score?: number;
|
|
12
|
-
engine: 'tavily' | 'exa' | 'serper' | 'duckduckgo' | 'searxng' | 'academic' | 'custom';
|
|
13
|
-
}
|
|
14
|
-
interface MultiSearchOptions {
|
|
15
|
-
limit?: number;
|
|
16
|
-
tavilyKey?: string;
|
|
17
|
-
exaKey?: string;
|
|
18
|
-
serperKey?: string;
|
|
19
|
-
apiKeys?: ResearchApiKeys;
|
|
20
|
-
allowEnvFallback?: boolean;
|
|
21
|
-
searxngHost?: string;
|
|
22
|
-
domainFilter?: string[];
|
|
23
|
-
preferredEngine?: 'tavily' | 'exa' | 'serper' | 'duckduckgo' | 'searxng' | 'academic' | 'custom';
|
|
24
|
-
customAdapter?: CustomSearchAdapter;
|
|
25
|
-
}
|
|
26
|
-
/**
|
|
27
|
-
* Unified multi-engine search engine with host-injected API keys, automatic provider failover, and custom adapter support
|
|
28
|
-
*/
|
|
29
|
-
declare class MultiSourceSearchEngine {
|
|
30
|
-
private tavilyKey?;
|
|
31
|
-
private exaKey?;
|
|
32
|
-
private serperKey?;
|
|
33
|
-
private allowEnvFallback;
|
|
34
|
-
private customAdapter?;
|
|
35
|
-
constructor(options?: {
|
|
36
|
-
tavilyKey?: string;
|
|
37
|
-
exaKey?: string;
|
|
38
|
-
serperKey?: string;
|
|
39
|
-
apiKeys?: ResearchApiKeys;
|
|
40
|
-
allowEnvFallback?: boolean;
|
|
41
|
-
customAdapter?: CustomSearchAdapter;
|
|
42
|
-
});
|
|
43
|
-
setCustomAdapter(adapter: CustomSearchAdapter): void;
|
|
44
|
-
setApiKeys(keys: ResearchApiKeys): void;
|
|
45
|
-
search(query: string, options?: MultiSearchOptions): Promise<SearchHit[]>;
|
|
46
|
-
private queryExa;
|
|
47
|
-
private querySerper;
|
|
48
|
-
private queryDuckDuckGo;
|
|
49
|
-
}
|
|
50
|
-
|
|
51
7
|
interface TranscriptSegment {
|
|
52
8
|
startSec: number;
|
|
53
9
|
durationSec: number;
|
|
@@ -122,4 +78,62 @@ declare class HealthAuditor {
|
|
|
122
78
|
auditDocument(doc: ScrapedDocument): HealthAuditResult;
|
|
123
79
|
}
|
|
124
80
|
|
|
125
|
-
|
|
81
|
+
interface GraphEdge {
|
|
82
|
+
source: string;
|
|
83
|
+
target: string;
|
|
84
|
+
weight?: number;
|
|
85
|
+
}
|
|
86
|
+
interface ReducedGraphResult {
|
|
87
|
+
reducedEdges: GraphEdge[];
|
|
88
|
+
removedTransitiveEdges: GraphEdge[];
|
|
89
|
+
}
|
|
90
|
+
interface TopoSortResult {
|
|
91
|
+
isDag: boolean;
|
|
92
|
+
order: string[];
|
|
93
|
+
cyclesBroken: string[];
|
|
94
|
+
droppedEdges: GraphEdge[];
|
|
95
|
+
}
|
|
96
|
+
/**
|
|
97
|
+
* Removes redundant transitive edges from a directed graph.
|
|
98
|
+
* If A -> B and B -> C exist, then a direct edge A -> C is redundant and will be pruned.
|
|
99
|
+
* This guarantees a clean, minimal prerequisite DAG without cognitive edge clutter.
|
|
100
|
+
*/
|
|
101
|
+
declare function transitiveReduction(edges: GraphEdge[]): ReducedGraphResult;
|
|
102
|
+
/**
|
|
103
|
+
* Kahn's Algorithm for Topological Sort & Cycle Breaking.
|
|
104
|
+
* Guarantees that the resulting sequence is a valid DAG.
|
|
105
|
+
* If cycles exist, breaks cycle edges gracefully and logs them.
|
|
106
|
+
*/
|
|
107
|
+
declare function kahnTopologicalSort(nodes: string[], edges: GraphEdge[]): TopoSortResult;
|
|
108
|
+
|
|
109
|
+
/**
|
|
110
|
+
* Noise filtering and technical content quality auditor.
|
|
111
|
+
* Strips out commercial e-commerce clutter (Shopee, Lazada, AliExpress, sales listings)
|
|
112
|
+
* and evaluates technical knowledge density.
|
|
113
|
+
*/
|
|
114
|
+
declare const ECOMMERCE_DOMAINS: Set<string>;
|
|
115
|
+
declare const ECOMMERCE_AND_COMMERCIAL_PATTERNS: RegExp[];
|
|
116
|
+
/**
|
|
117
|
+
* Checks whether a URL, title, or snippet is commercial noise / e-commerce listing
|
|
118
|
+
* rather than primary technical or pedagogical documentation.
|
|
119
|
+
*/
|
|
120
|
+
declare function isCommercialOrNoise(input: {
|
|
121
|
+
url?: string;
|
|
122
|
+
title?: string;
|
|
123
|
+
snippet?: string;
|
|
124
|
+
}): boolean;
|
|
125
|
+
interface ContentQualityScore {
|
|
126
|
+
score: number;
|
|
127
|
+
isSufficientQuality: boolean;
|
|
128
|
+
codeDensity: number;
|
|
129
|
+
technicalTermDensity: number;
|
|
130
|
+
hasStructure: boolean;
|
|
131
|
+
reasons: string[];
|
|
132
|
+
}
|
|
133
|
+
/**
|
|
134
|
+
* Evaluates the technical knowledge density of a scraped markdown document.
|
|
135
|
+
* Documents with high code-to-text ratio, structured headings, and low fluff score higher.
|
|
136
|
+
*/
|
|
137
|
+
declare function evaluateTechnicalDensity(markdown: string): ContentQualityScore;
|
|
138
|
+
|
|
139
|
+
export { type ContentQualityScore, ECOMMERCE_AND_COMMERCIAL_PATTERNS, ECOMMERCE_DOMAINS, type GraphEdge, type HealthAuditResult, HealthAuditor, PedagogicalTermExtractor, type ReducedGraphResult, ScrapedDocument, TechnicalDomain, type TermExtractionBundle, type TopoSortResult, type TranscriptSegment, YouTubeIngestionService, type YouTubeTranscriptResult, evaluateTechnicalDensity, extractYouTubeVideoId, formatTimestamp, isCommercialOrNoise, isYouTubeUrl, kahnTopologicalSort, stitchCaptionSegments, transitiveReduction };
|
|
@@ -1,53 +1,9 @@
|
|
|
1
|
-
import { T as TechnicalDomain, S as ScrapedDocument } from '../webScraper-
|
|
2
|
-
export { D as DomainClassificationResult, E as ExtractedCodeBlock, a as WebScraper, W as WebScraperOptions, c as classifyTechnicalDomain, e as extractSubstantiveExcerpts, i as inferPrimaryCodeLanguage } from '../webScraper-
|
|
3
|
-
|
|
4
|
-
|
|
1
|
+
import { T as TechnicalDomain, S as ScrapedDocument } from '../webScraper-DBFUIqoO.js';
|
|
2
|
+
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';
|
|
3
|
+
export { C as CatalogBuilder, H as HarvestedResourceItem, M as MultiSearchOptions, a as MultiSourceSearchEngine, R as ResourceCatalogBundle, S as SearchHit } from '../catalogBuilder-DHV6y1gD.js';
|
|
4
|
+
import { E as ExtractedConceptNode, C as CourseResearchContext, L as LlmTextFn } from '../index-DlngvZBr.js';
|
|
5
5
|
import 'zod';
|
|
6
6
|
|
|
7
|
-
interface SearchHit {
|
|
8
|
-
title: string;
|
|
9
|
-
url: string;
|
|
10
|
-
content: string;
|
|
11
|
-
score?: number;
|
|
12
|
-
engine: 'tavily' | 'exa' | 'serper' | 'duckduckgo' | 'searxng' | 'academic' | 'custom';
|
|
13
|
-
}
|
|
14
|
-
interface MultiSearchOptions {
|
|
15
|
-
limit?: number;
|
|
16
|
-
tavilyKey?: string;
|
|
17
|
-
exaKey?: string;
|
|
18
|
-
serperKey?: string;
|
|
19
|
-
apiKeys?: ResearchApiKeys;
|
|
20
|
-
allowEnvFallback?: boolean;
|
|
21
|
-
searxngHost?: string;
|
|
22
|
-
domainFilter?: string[];
|
|
23
|
-
preferredEngine?: 'tavily' | 'exa' | 'serper' | 'duckduckgo' | 'searxng' | 'academic' | 'custom';
|
|
24
|
-
customAdapter?: CustomSearchAdapter;
|
|
25
|
-
}
|
|
26
|
-
/**
|
|
27
|
-
* Unified multi-engine search engine with host-injected API keys, automatic provider failover, and custom adapter support
|
|
28
|
-
*/
|
|
29
|
-
declare class MultiSourceSearchEngine {
|
|
30
|
-
private tavilyKey?;
|
|
31
|
-
private exaKey?;
|
|
32
|
-
private serperKey?;
|
|
33
|
-
private allowEnvFallback;
|
|
34
|
-
private customAdapter?;
|
|
35
|
-
constructor(options?: {
|
|
36
|
-
tavilyKey?: string;
|
|
37
|
-
exaKey?: string;
|
|
38
|
-
serperKey?: string;
|
|
39
|
-
apiKeys?: ResearchApiKeys;
|
|
40
|
-
allowEnvFallback?: boolean;
|
|
41
|
-
customAdapter?: CustomSearchAdapter;
|
|
42
|
-
});
|
|
43
|
-
setCustomAdapter(adapter: CustomSearchAdapter): void;
|
|
44
|
-
setApiKeys(keys: ResearchApiKeys): void;
|
|
45
|
-
search(query: string, options?: MultiSearchOptions): Promise<SearchHit[]>;
|
|
46
|
-
private queryExa;
|
|
47
|
-
private querySerper;
|
|
48
|
-
private queryDuckDuckGo;
|
|
49
|
-
}
|
|
50
|
-
|
|
51
7
|
interface TranscriptSegment {
|
|
52
8
|
startSec: number;
|
|
53
9
|
durationSec: number;
|
|
@@ -122,4 +78,62 @@ declare class HealthAuditor {
|
|
|
122
78
|
auditDocument(doc: ScrapedDocument): HealthAuditResult;
|
|
123
79
|
}
|
|
124
80
|
|
|
125
|
-
|
|
81
|
+
interface GraphEdge {
|
|
82
|
+
source: string;
|
|
83
|
+
target: string;
|
|
84
|
+
weight?: number;
|
|
85
|
+
}
|
|
86
|
+
interface ReducedGraphResult {
|
|
87
|
+
reducedEdges: GraphEdge[];
|
|
88
|
+
removedTransitiveEdges: GraphEdge[];
|
|
89
|
+
}
|
|
90
|
+
interface TopoSortResult {
|
|
91
|
+
isDag: boolean;
|
|
92
|
+
order: string[];
|
|
93
|
+
cyclesBroken: string[];
|
|
94
|
+
droppedEdges: GraphEdge[];
|
|
95
|
+
}
|
|
96
|
+
/**
|
|
97
|
+
* Removes redundant transitive edges from a directed graph.
|
|
98
|
+
* If A -> B and B -> C exist, then a direct edge A -> C is redundant and will be pruned.
|
|
99
|
+
* This guarantees a clean, minimal prerequisite DAG without cognitive edge clutter.
|
|
100
|
+
*/
|
|
101
|
+
declare function transitiveReduction(edges: GraphEdge[]): ReducedGraphResult;
|
|
102
|
+
/**
|
|
103
|
+
* Kahn's Algorithm for Topological Sort & Cycle Breaking.
|
|
104
|
+
* Guarantees that the resulting sequence is a valid DAG.
|
|
105
|
+
* If cycles exist, breaks cycle edges gracefully and logs them.
|
|
106
|
+
*/
|
|
107
|
+
declare function kahnTopologicalSort(nodes: string[], edges: GraphEdge[]): TopoSortResult;
|
|
108
|
+
|
|
109
|
+
/**
|
|
110
|
+
* Noise filtering and technical content quality auditor.
|
|
111
|
+
* Strips out commercial e-commerce clutter (Shopee, Lazada, AliExpress, sales listings)
|
|
112
|
+
* and evaluates technical knowledge density.
|
|
113
|
+
*/
|
|
114
|
+
declare const ECOMMERCE_DOMAINS: Set<string>;
|
|
115
|
+
declare const ECOMMERCE_AND_COMMERCIAL_PATTERNS: RegExp[];
|
|
116
|
+
/**
|
|
117
|
+
* Checks whether a URL, title, or snippet is commercial noise / e-commerce listing
|
|
118
|
+
* rather than primary technical or pedagogical documentation.
|
|
119
|
+
*/
|
|
120
|
+
declare function isCommercialOrNoise(input: {
|
|
121
|
+
url?: string;
|
|
122
|
+
title?: string;
|
|
123
|
+
snippet?: string;
|
|
124
|
+
}): boolean;
|
|
125
|
+
interface ContentQualityScore {
|
|
126
|
+
score: number;
|
|
127
|
+
isSufficientQuality: boolean;
|
|
128
|
+
codeDensity: number;
|
|
129
|
+
technicalTermDensity: number;
|
|
130
|
+
hasStructure: boolean;
|
|
131
|
+
reasons: string[];
|
|
132
|
+
}
|
|
133
|
+
/**
|
|
134
|
+
* Evaluates the technical knowledge density of a scraped markdown document.
|
|
135
|
+
* Documents with high code-to-text ratio, structured headings, and low fluff score higher.
|
|
136
|
+
*/
|
|
137
|
+
declare function evaluateTechnicalDensity(markdown: string): ContentQualityScore;
|
|
138
|
+
|
|
139
|
+
export { type ContentQualityScore, ECOMMERCE_AND_COMMERCIAL_PATTERNS, ECOMMERCE_DOMAINS, type GraphEdge, type HealthAuditResult, HealthAuditor, PedagogicalTermExtractor, type ReducedGraphResult, ScrapedDocument, TechnicalDomain, type TermExtractionBundle, type TopoSortResult, type TranscriptSegment, YouTubeIngestionService, type YouTubeTranscriptResult, evaluateTechnicalDensity, extractYouTubeVideoId, formatTimestamp, isCommercialOrNoise, isYouTubeUrl, kahnTopologicalSort, stitchCaptionSegments, transitiveReduction };
|
package/dist/harvester/index.js
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
|
-
import '../chunk-
|
|
2
|
-
export { CatalogBuilder, HealthAuditor, MultiSourceSearchEngine, PedagogicalTermExtractor, classifyTechnicalDomain, inferPrimaryCodeLanguage } from '../chunk-
|
|
3
|
-
|
|
1
|
+
import '../chunk-LSMSIPTZ.js';
|
|
2
|
+
export { CatalogBuilder, ECOMMERCE_AND_COMMERCIAL_PATTERNS, ECOMMERCE_DOMAINS, HealthAuditor, MultiSourceSearchEngine, PedagogicalTermExtractor, classifyTechnicalDomain, evaluateTechnicalDensity, inferPrimaryCodeLanguage, isCommercialOrNoise, kahnTopologicalSort, transitiveReduction } from '../chunk-HZNSZDSM.js';
|
|
3
|
+
import '../chunk-AKEI7H2C.js';
|
|
4
|
+
export { WebScraper, YouTubeIngestionService, extractSubstantiveExcerpts, extractYouTubeVideoId, formatTimestamp, isYouTubeUrl, stitchCaptionSegments } from '../chunk-ON6VFCJO.js';
|
|
4
5
|
//# sourceMappingURL=index.js.map
|
|
5
6
|
//# sourceMappingURL=index.js.map
|
|
@@ -133,6 +133,14 @@ interface CustomAcademicSearchAdapter {
|
|
|
133
133
|
yearRange?: string;
|
|
134
134
|
}): Promise<AcademicPaper[]>;
|
|
135
135
|
}
|
|
136
|
+
interface ConceptFacets {
|
|
137
|
+
/** Universal / Computational Level (Why does it exist, language-invariant problem statement) */
|
|
138
|
+
computationalPrinciple?: string;
|
|
139
|
+
/** Contextual / Algorithmic Level (Mental model, design pattern, workflow) */
|
|
140
|
+
mentalModel?: string;
|
|
141
|
+
/** Specific / Implementational Level (Specific syntax, hardware pinout, library API) */
|
|
142
|
+
syntaxAndTools?: string[];
|
|
143
|
+
}
|
|
136
144
|
interface ExtractedConceptNode {
|
|
137
145
|
id: string;
|
|
138
146
|
term: string;
|
|
@@ -145,6 +153,12 @@ interface ExtractedConceptNode {
|
|
|
145
153
|
definition: string;
|
|
146
154
|
prerequisites: string[];
|
|
147
155
|
sourceIds: string[];
|
|
156
|
+
/** Multi-dimensional cognitive facets across Marr's Tri-Level hypothesis (v1.2.0) */
|
|
157
|
+
facets?: ConceptFacets;
|
|
158
|
+
/** Common novice misconceptions, antipatterns or bugs observed in documentation/forums */
|
|
159
|
+
commonMisconceptions?: string[];
|
|
160
|
+
/** Quick troubleshooting or remediation tips */
|
|
161
|
+
troubleshootingHints?: string[];
|
|
148
162
|
}
|
|
149
163
|
interface SynthesizedResearchInsights {
|
|
150
164
|
executiveSummary: string;
|
|
@@ -310,4 +324,4 @@ declare const ResearchConfigSchema: z.ZodObject<{
|
|
|
310
324
|
type ResearchConfig = z.infer<typeof ResearchConfigSchema>;
|
|
311
325
|
declare const DEFAULT_RESEARCH_CONFIG: ResearchConfig;
|
|
312
326
|
|
|
313
|
-
export { type AcademicPaper as A, type CourseResearchContext as C, DEFAULT_RESEARCH_CONFIG as D, type ExtractedConceptNode as E, type LlmTextFn as L, type ResearchApiKeys as R, type SearchProviderType as S, type CustomSearchAdapter as a, type CustomCrawlerAdapter as b, type CustomAcademicSearchAdapter as c, type CustomSynthesizerAdapter as d, type CrawlerProviderType as e, type
|
|
327
|
+
export { type AcademicPaper as A, type CourseResearchContext as C, DEFAULT_RESEARCH_CONFIG as D, type ExtractedConceptNode as E, type LlmTextFn as L, type ResearchApiKeys as R, type SearchProviderType as S, type CustomSearchAdapter as a, type CustomCrawlerAdapter as b, type CustomAcademicSearchAdapter as c, type CustomSynthesizerAdapter as d, type CrawlerProviderType as e, type ConceptFacets as f, type SynthesizedResearchInsights as g, ResearchConfigSchema as h, type ResearchConfig as i, AcademicPaperSchema as j, type AcademicSearchOptions as k, AcademicSearchEngine as l, reconstructOpenAlexAbstract as r };
|
|
@@ -133,6 +133,14 @@ interface CustomAcademicSearchAdapter {
|
|
|
133
133
|
yearRange?: string;
|
|
134
134
|
}): Promise<AcademicPaper[]>;
|
|
135
135
|
}
|
|
136
|
+
interface ConceptFacets {
|
|
137
|
+
/** Universal / Computational Level (Why does it exist, language-invariant problem statement) */
|
|
138
|
+
computationalPrinciple?: string;
|
|
139
|
+
/** Contextual / Algorithmic Level (Mental model, design pattern, workflow) */
|
|
140
|
+
mentalModel?: string;
|
|
141
|
+
/** Specific / Implementational Level (Specific syntax, hardware pinout, library API) */
|
|
142
|
+
syntaxAndTools?: string[];
|
|
143
|
+
}
|
|
136
144
|
interface ExtractedConceptNode {
|
|
137
145
|
id: string;
|
|
138
146
|
term: string;
|
|
@@ -145,6 +153,12 @@ interface ExtractedConceptNode {
|
|
|
145
153
|
definition: string;
|
|
146
154
|
prerequisites: string[];
|
|
147
155
|
sourceIds: string[];
|
|
156
|
+
/** Multi-dimensional cognitive facets across Marr's Tri-Level hypothesis (v1.2.0) */
|
|
157
|
+
facets?: ConceptFacets;
|
|
158
|
+
/** Common novice misconceptions, antipatterns or bugs observed in documentation/forums */
|
|
159
|
+
commonMisconceptions?: string[];
|
|
160
|
+
/** Quick troubleshooting or remediation tips */
|
|
161
|
+
troubleshootingHints?: string[];
|
|
148
162
|
}
|
|
149
163
|
interface SynthesizedResearchInsights {
|
|
150
164
|
executiveSummary: string;
|
|
@@ -310,4 +324,4 @@ declare const ResearchConfigSchema: z.ZodObject<{
|
|
|
310
324
|
type ResearchConfig = z.infer<typeof ResearchConfigSchema>;
|
|
311
325
|
declare const DEFAULT_RESEARCH_CONFIG: ResearchConfig;
|
|
312
326
|
|
|
313
|
-
export { type AcademicPaper as A, type CourseResearchContext as C, DEFAULT_RESEARCH_CONFIG as D, type ExtractedConceptNode as E, type LlmTextFn as L, type ResearchApiKeys as R, type SearchProviderType as S, type CustomSearchAdapter as a, type CustomCrawlerAdapter as b, type CustomAcademicSearchAdapter as c, type CustomSynthesizerAdapter as d, type CrawlerProviderType as e, type
|
|
327
|
+
export { type AcademicPaper as A, type CourseResearchContext as C, DEFAULT_RESEARCH_CONFIG as D, type ExtractedConceptNode as E, type LlmTextFn as L, type ResearchApiKeys as R, type SearchProviderType as S, type CustomSearchAdapter as a, type CustomCrawlerAdapter as b, type CustomAcademicSearchAdapter as c, type CustomSynthesizerAdapter as d, type CrawlerProviderType as e, type ConceptFacets as f, type SynthesizedResearchInsights as g, ResearchConfigSchema as h, type ResearchConfig as i, AcademicPaperSchema as j, type AcademicSearchOptions as k, AcademicSearchEngine as l, reconstructOpenAlexAbstract as r };
|