@thanh01.pmt/research-kit 1.2.4 → 1.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/academic/index.cjs +122 -0
- package/dist/academic/index.cjs.map +1 -1
- package/dist/academic/index.d.cts +27 -4
- package/dist/academic/index.d.ts +27 -4
- package/dist/academic/index.js +2 -1
- package/dist/agent/index.cjs +4277 -0
- package/dist/agent/index.cjs.map +1 -0
- package/dist/agent/index.d.cts +10 -0
- package/dist/agent/index.d.ts +10 -0
- package/dist/agent/index.js +10 -0
- package/dist/agent/index.js.map +1 -0
- package/dist/{catalogBuilder-B4eiLS_S.d.cts → catalogBuilder-BBCa9jqI.d.cts} +2 -2
- package/dist/{catalogBuilder-BNB_gaWP.d.ts → catalogBuilder-D-UiM37y.d.ts} +2 -2
- package/dist/chunk-2GBXVPOQ.js +3 -0
- package/dist/{chunk-J3VCGH7Z.js.map → chunk-2GBXVPOQ.js.map} +1 -1
- package/dist/chunk-2RMBLKP5.js +581 -0
- package/dist/chunk-2RMBLKP5.js.map +1 -0
- package/dist/{chunk-2XIEWCUE.js → chunk-32B5PVTQ.js} +2 -2
- package/dist/{chunk-2XIEWCUE.js.map → chunk-32B5PVTQ.js.map} +1 -1
- package/dist/{chunk-YICMTZS5.js → chunk-4O3FXMXO.js} +171 -3
- package/dist/chunk-4O3FXMXO.js.map +1 -0
- package/dist/chunk-LDCZ33AC.js +3 -0
- package/dist/chunk-LDCZ33AC.js.map +1 -0
- package/dist/{chunk-GK5KI5PB.js → chunk-MFRQ2VJZ.js} +63 -44
- package/dist/chunk-MFRQ2VJZ.js.map +1 -0
- package/dist/chunk-RAMDHDRJ.js +1931 -0
- package/dist/chunk-RAMDHDRJ.js.map +1 -0
- package/dist/{chunk-SAHBBO3U.js → chunk-RYLZYZRF.js} +4 -580
- package/dist/chunk-RYLZYZRF.js.map +1 -0
- package/dist/chunk-SHBDLP64.js +125 -0
- package/dist/chunk-SHBDLP64.js.map +1 -0
- package/dist/chunk-TYQEC24G.js +3 -0
- package/dist/chunk-TYQEC24G.js.map +1 -0
- package/dist/{chunk-KXJDQBSJ.js → chunk-UHKDJZNL.js} +11 -4
- package/dist/chunk-UHKDJZNL.js.map +1 -0
- package/dist/config/index.d.cts +1 -1
- package/dist/config/index.d.ts +1 -1
- package/dist/evidence/index.cjs +9 -2
- 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 +3 -2
- package/dist/harvester/index.cjs +168 -1
- package/dist/harvester/index.cjs.map +1 -1
- package/dist/harvester/index.d.cts +5 -161
- package/dist/harvester/index.d.ts +5 -161
- package/dist/harvester/index.js +4 -2
- package/dist/index-CGa7lf3L.d.ts +764 -0
- package/dist/{index-9rDiFuR4.d.cts → index-CxoD81QN.d.cts} +1 -1
- package/dist/{index-9rDiFuR4.d.ts → index-CxoD81QN.d.ts} +1 -1
- package/dist/index-DrjfrbGw.d.cts +764 -0
- package/dist/index.cjs +2411 -144
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +11 -174
- package/dist/index.d.ts +11 -174
- package/dist/index.js +34 -12
- package/dist/index.js.map +1 -1
- package/dist/{literatureReview-DOzgm9Q2.d.ts → literatureReview-Bn2iEGRO.d.ts} +1 -1
- package/dist/{literatureReview-BwidpYJo.d.cts → literatureReview-Bvlqk4DB.d.cts} +1 -1
- package/dist/pipeline/index.cjs +68 -43
- package/dist/pipeline/index.cjs.map +1 -1
- package/dist/pipeline/index.d.cts +5 -4
- package/dist/pipeline/index.d.ts +5 -4
- package/dist/pipeline/index.js +4 -3
- package/dist/socialPulseHarvester-CN4MwrpY.d.cts +204 -0
- package/dist/socialPulseHarvester-IbdT3zD1.d.ts +204 -0
- package/dist/{webScraper-CAQjE46m.d.cts → webScraper-BVvNW4yj.d.cts} +1 -1
- package/dist/{webScraper-CXIpvyA6.d.ts → webScraper-C9pB5Rgd.d.ts} +1 -1
- package/package.json +6 -1
- package/dist/chunk-GK5KI5PB.js.map +0 -1
- package/dist/chunk-J3VCGH7Z.js +0 -3
- package/dist/chunk-KXJDQBSJ.js.map +0 -1
- package/dist/chunk-SAHBBO3U.js.map +0 -1
- package/dist/chunk-YICMTZS5.js.map +0 -1
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import { T as TechnicalDomain, S as ScrapedDocument, a as WebScraper } from '../webScraper-
|
|
2
|
-
import {
|
|
3
|
-
import { C as CS2023KnowledgeArea, a as CSTAK12Strand, L as LiteratureReviewReport } from '../literatureReview-
|
|
4
|
-
import { R as ResourceCatalogBundle, b as MultiSourceSearchEngine } from '../catalogBuilder-
|
|
1
|
+
import { T as TechnicalDomain, S as ScrapedDocument, a as WebScraper } from '../webScraper-BVvNW4yj.cjs';
|
|
2
|
+
import { a as CourseResearchContext, L as LlmTextFn, j as AcademicPaper, E as ExtractedConceptNode, f as SynthesizedResearchInsights, R as ResearchApiKeys, i as ResearchConfig, b as CustomSearchAdapter, c as CustomCrawlerAdapter, d as CustomAcademicSearchAdapter, g as CustomSynthesizerAdapter } from '../index-CxoD81QN.cjs';
|
|
3
|
+
import { C as CS2023KnowledgeArea, a as CSTAK12Strand, L as LiteratureReviewReport } from '../literatureReview-Bvlqk4DB.cjs';
|
|
4
|
+
import { R as ResourceCatalogBundle, b as MultiSourceSearchEngine } from '../catalogBuilder-BBCa9jqI.cjs';
|
|
5
5
|
import { a as ProvenanceSidecar } from '../provenanceTracker-ct4s5lJV.cjs';
|
|
6
6
|
import 'zod';
|
|
7
7
|
|
|
@@ -150,6 +150,7 @@ interface ExemplarProject {
|
|
|
150
150
|
interface TechnicalFactsheet {
|
|
151
151
|
topic: string;
|
|
152
152
|
domain: TechnicalDomain;
|
|
153
|
+
evidenceBacked: boolean;
|
|
153
154
|
compatibilityMatrix: {
|
|
154
155
|
hardwarePlatform?: string;
|
|
155
156
|
softwareEnv?: string;
|
package/dist/pipeline/index.d.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import { T as TechnicalDomain, S as ScrapedDocument, a as WebScraper } from '../webScraper-
|
|
2
|
-
import {
|
|
3
|
-
import { C as CS2023KnowledgeArea, a as CSTAK12Strand, L as LiteratureReviewReport } from '../literatureReview-
|
|
4
|
-
import { R as ResourceCatalogBundle, b as MultiSourceSearchEngine } from '../catalogBuilder-
|
|
1
|
+
import { T as TechnicalDomain, S as ScrapedDocument, a as WebScraper } from '../webScraper-C9pB5Rgd.js';
|
|
2
|
+
import { a as CourseResearchContext, L as LlmTextFn, j as AcademicPaper, E as ExtractedConceptNode, f as SynthesizedResearchInsights, R as ResearchApiKeys, i as ResearchConfig, b as CustomSearchAdapter, c as CustomCrawlerAdapter, d as CustomAcademicSearchAdapter, g as CustomSynthesizerAdapter } from '../index-CxoD81QN.js';
|
|
3
|
+
import { C as CS2023KnowledgeArea, a as CSTAK12Strand, L as LiteratureReviewReport } from '../literatureReview-Bn2iEGRO.js';
|
|
4
|
+
import { R as ResourceCatalogBundle, b as MultiSourceSearchEngine } from '../catalogBuilder-D-UiM37y.js';
|
|
5
5
|
import { a as ProvenanceSidecar } from '../provenanceTracker-ct4s5lJV.js';
|
|
6
6
|
import 'zod';
|
|
7
7
|
|
|
@@ -150,6 +150,7 @@ interface ExemplarProject {
|
|
|
150
150
|
interface TechnicalFactsheet {
|
|
151
151
|
topic: string;
|
|
152
152
|
domain: TechnicalDomain;
|
|
153
|
+
evidenceBacked: boolean;
|
|
153
154
|
compatibilityMatrix: {
|
|
154
155
|
hardwarePlatform?: string;
|
|
155
156
|
softwareEnv?: string;
|
package/dist/pipeline/index.js
CHANGED
|
@@ -1,8 +1,9 @@
|
|
|
1
|
-
export { CampaignPlanner, HarvestPipeline, ReferencePackBuilder, TechnicalGroundingEngine, normalizeUrlForDedup } from '../chunk-
|
|
1
|
+
export { CampaignPlanner, HarvestPipeline, ReferencePackBuilder, TechnicalGroundingEngine, normalizeUrlForDedup } from '../chunk-MFRQ2VJZ.js';
|
|
2
2
|
import '../chunk-SDDZFFL6.js';
|
|
3
|
-
import '../chunk-
|
|
3
|
+
import '../chunk-RYLZYZRF.js';
|
|
4
|
+
import '../chunk-2RMBLKP5.js';
|
|
4
5
|
import '../chunk-AKEI7H2C.js';
|
|
5
|
-
import '../chunk-
|
|
6
|
+
import '../chunk-UHKDJZNL.js';
|
|
6
7
|
import '../chunk-QQZQNBJC.js';
|
|
7
8
|
//# sourceMappingURL=index.js.map
|
|
8
9
|
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1,204 @@
|
|
|
1
|
+
import { E as ExtractedConceptNode, a as CourseResearchContext, L as LlmTextFn } from './index-CxoD81QN.cjs';
|
|
2
|
+
import { T as TechnicalDomain, S as ScrapedDocument } from './webScraper-BVvNW4yj.cjs';
|
|
3
|
+
import { b as MultiSourceSearchEngine } from './catalogBuilder-BBCa9jqI.cjs';
|
|
4
|
+
|
|
5
|
+
interface TranscriptSegment {
|
|
6
|
+
startSec: number;
|
|
7
|
+
durationSec: number;
|
|
8
|
+
timestamp: string;
|
|
9
|
+
text: string;
|
|
10
|
+
}
|
|
11
|
+
interface YouTubeTranscriptResult {
|
|
12
|
+
videoId: string;
|
|
13
|
+
url: string;
|
|
14
|
+
title: string;
|
|
15
|
+
author?: string;
|
|
16
|
+
language: string;
|
|
17
|
+
isAutoGenerated: boolean;
|
|
18
|
+
segments: TranscriptSegment[];
|
|
19
|
+
stitchedMarkdown: string;
|
|
20
|
+
}
|
|
21
|
+
declare function extractYouTubeVideoId(urlOrId: string): string | null;
|
|
22
|
+
declare function isYouTubeUrl(url: string): boolean;
|
|
23
|
+
declare function formatTimestamp(seconds: number): string;
|
|
24
|
+
/**
|
|
25
|
+
* Stitches short caption fragments into coherent timestamped paragraphs (every ~30-45 seconds or sentence boundary)
|
|
26
|
+
* and strips sponsor/subscribe filler noise.
|
|
27
|
+
*/
|
|
28
|
+
declare function stitchCaptionSegments(segments: Array<{
|
|
29
|
+
startSec: number;
|
|
30
|
+
durationSec: number;
|
|
31
|
+
text: string;
|
|
32
|
+
}>): TranscriptSegment[];
|
|
33
|
+
/**
|
|
34
|
+
* YouTube Transcript Ingestion Service (Idea §3.1)
|
|
35
|
+
*/
|
|
36
|
+
declare class YouTubeIngestionService {
|
|
37
|
+
fetchTranscript(urlOrId: string, preferredLanguages?: string[]): Promise<YouTubeTranscriptResult>;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
interface TermExtractionBundle {
|
|
41
|
+
concepts: ExtractedConceptNode[];
|
|
42
|
+
conceptDagTsv: string;
|
|
43
|
+
isLlmRefined: boolean;
|
|
44
|
+
unrefinedCandidatesCount?: number;
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* Bilingual (Vietnamese + English) Automated Term Extractor & Prerequisite Concept DAG Builder (Idea §4).
|
|
48
|
+
* Combines deterministic YAKE/TF-IDF multi-signal extraction with optional host LLM semantic refinement.
|
|
49
|
+
*/
|
|
50
|
+
declare class PedagogicalTermExtractor {
|
|
51
|
+
extractDeterministic(topic: string, domain: TechnicalDomain, docs: Array<{
|
|
52
|
+
resourceId: string;
|
|
53
|
+
doc: ScrapedDocument;
|
|
54
|
+
}>, maxTerms?: number): TermExtractionBundle;
|
|
55
|
+
extractWithOptionalLlm(topic: string, domain: TechnicalDomain, docs: Array<{
|
|
56
|
+
resourceId: string;
|
|
57
|
+
doc: ScrapedDocument;
|
|
58
|
+
}>, options?: {
|
|
59
|
+
context?: CourseResearchContext;
|
|
60
|
+
llm?: LlmTextFn;
|
|
61
|
+
maxTerms?: number;
|
|
62
|
+
}): Promise<TermExtractionBundle>;
|
|
63
|
+
formatConceptDagTsv(concepts: ExtractedConceptNode[]): string;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
interface HealthAuditResult {
|
|
67
|
+
passed: boolean;
|
|
68
|
+
score: number;
|
|
69
|
+
issues: string[];
|
|
70
|
+
warnings: string[];
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* Health Auditor & Noise Filter for Harvested Resources (English Canonical)
|
|
74
|
+
*/
|
|
75
|
+
declare class HealthAuditor {
|
|
76
|
+
auditDocument(doc: ScrapedDocument): HealthAuditResult;
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
/**
|
|
80
|
+
* STEM & Coding Resource Researcher (v1.2.2).
|
|
81
|
+
* Tự động tìm kiếm, đối chiếu và đề xuất tài nguyên giáo dục mở (OER):
|
|
82
|
+
* - Mô phỏng tương tác (PhET Simulations, Open Source Physics)
|
|
83
|
+
* - Khóa học & Lộ trình mở (freeCodeCamp, The Odin Project, Code.org, GitHub Curricula)
|
|
84
|
+
* - Hình ảnh khoa học & media mở bản quyền CC/Public Domain (Openverse, NASA Media Library)
|
|
85
|
+
* - Sách & giáo trình mở (OpenStax, MIT OCW)
|
|
86
|
+
* - Lập trình & Thử thách thực hành (CS Unplugged, Scratch, Exercism)
|
|
87
|
+
*/
|
|
88
|
+
type StemResourceType = 'simulation' | 'curriculum' | 'media_image' | 'media_video' | 'hands_on_lab' | 'textbook' | 'problem_set';
|
|
89
|
+
type StemResourceQueryType = StemResourceType | 'interactive' | 'open_media';
|
|
90
|
+
type StemResourceProvider = 'openverse' | 'nasa' | 'github' | 'phet' | 'openstax' | 'cs_unplugged' | 'scratch' | 'exercism' | 'web';
|
|
91
|
+
interface StemResourceLicense {
|
|
92
|
+
type: string;
|
|
93
|
+
attributionText: string;
|
|
94
|
+
url?: string;
|
|
95
|
+
commercialUseAllowed: boolean;
|
|
96
|
+
}
|
|
97
|
+
interface StemResourceItem {
|
|
98
|
+
id: string;
|
|
99
|
+
title: string;
|
|
100
|
+
url: string;
|
|
101
|
+
description: string;
|
|
102
|
+
type: StemResourceType;
|
|
103
|
+
provider: StemResourceProvider;
|
|
104
|
+
thumbnailUrl?: string;
|
|
105
|
+
embedUrl?: string;
|
|
106
|
+
mediaType: 'interactive' | 'image' | 'video' | 'text' | 'code';
|
|
107
|
+
license: StemResourceLicense;
|
|
108
|
+
subject: 'computer_science' | 'physics' | 'robotics' | 'math' | 'electronics' | 'general_stem';
|
|
109
|
+
targetLevel: 'primary' | 'lower_secondary' | 'upper_secondary' | 'higher_ed' | 'developer' | 'all';
|
|
110
|
+
tags: string[];
|
|
111
|
+
relevanceScore: number;
|
|
112
|
+
}
|
|
113
|
+
interface StemResearchOptions {
|
|
114
|
+
types?: StemResourceQueryType[];
|
|
115
|
+
limit?: number;
|
|
116
|
+
licenseFilter?: 'creative_commons' | 'public_domain' | 'all';
|
|
117
|
+
level?: 'primary' | 'lower_secondary' | 'upper_secondary' | 'higher_ed' | 'developer' | 'all';
|
|
118
|
+
githubToken?: string;
|
|
119
|
+
timeoutMs?: number;
|
|
120
|
+
}
|
|
121
|
+
interface StemResourceCatalog {
|
|
122
|
+
query: string;
|
|
123
|
+
totalFound: number;
|
|
124
|
+
categoryCounts: Record<StemResourceType, number>;
|
|
125
|
+
resources: StemResourceItem[];
|
|
126
|
+
items: StemResourceItem[];
|
|
127
|
+
markdownSummary: string;
|
|
128
|
+
markdownReport: string;
|
|
129
|
+
}
|
|
130
|
+
declare class OpenverseClient {
|
|
131
|
+
private baseUrl;
|
|
132
|
+
searchImages(query: string, options?: {
|
|
133
|
+
limit?: number;
|
|
134
|
+
license?: string;
|
|
135
|
+
}): Promise<StemResourceItem[]>;
|
|
136
|
+
}
|
|
137
|
+
declare class NasaMediaClient {
|
|
138
|
+
private baseUrl;
|
|
139
|
+
search(query: string, options?: {
|
|
140
|
+
limit?: number;
|
|
141
|
+
mediaType?: 'image' | 'video' | 'audio';
|
|
142
|
+
}): Promise<StemResourceItem[]>;
|
|
143
|
+
}
|
|
144
|
+
declare class GitHubCurriculumClient {
|
|
145
|
+
private baseUrl;
|
|
146
|
+
searchCurricula(query: string, options?: {
|
|
147
|
+
limit?: number;
|
|
148
|
+
token?: string;
|
|
149
|
+
}): Promise<StemResourceItem[]>;
|
|
150
|
+
}
|
|
151
|
+
declare class StemResourceResearcher {
|
|
152
|
+
private openverse;
|
|
153
|
+
private nasa;
|
|
154
|
+
private github;
|
|
155
|
+
findResources(query: string, options?: StemResearchOptions): Promise<StemResourceCatalog>;
|
|
156
|
+
searchAndCatalog(query: string, options?: StemResearchOptions): Promise<StemResourceCatalog>;
|
|
157
|
+
generateMarkdown(catalog: StemResourceCatalog): string;
|
|
158
|
+
private generateMarkdownSummary;
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
type SocialPulsePlatform = 'hackernews' | 'github' | 'reddit' | 'web';
|
|
162
|
+
interface SocialPulseItem {
|
|
163
|
+
id: string;
|
|
164
|
+
platform: SocialPulsePlatform;
|
|
165
|
+
title: string;
|
|
166
|
+
url: string;
|
|
167
|
+
snippet: string;
|
|
168
|
+
author?: string;
|
|
169
|
+
createdAt?: string;
|
|
170
|
+
engagementScore: number;
|
|
171
|
+
rawMetrics?: {
|
|
172
|
+
points?: number;
|
|
173
|
+
comments?: number;
|
|
174
|
+
stars?: number;
|
|
175
|
+
};
|
|
176
|
+
}
|
|
177
|
+
interface SocialPulseOptions {
|
|
178
|
+
recencyDays?: number;
|
|
179
|
+
limitPerPlatform?: number;
|
|
180
|
+
includeHackerNews?: boolean;
|
|
181
|
+
includeGitHub?: boolean;
|
|
182
|
+
includeRedditWeb?: boolean;
|
|
183
|
+
}
|
|
184
|
+
interface SocialPulseReport {
|
|
185
|
+
topic: string;
|
|
186
|
+
recencyDays: number;
|
|
187
|
+
harvestedAt: string;
|
|
188
|
+
items: SocialPulseItem[];
|
|
189
|
+
trendingReposAndTools: string[];
|
|
190
|
+
communityHighlights: string[];
|
|
191
|
+
markdownReport: string;
|
|
192
|
+
}
|
|
193
|
+
/**
|
|
194
|
+
* 30-Day Social & Developer Pulse Harvester (`last30days-skill` pattern).
|
|
195
|
+
* Harvests real-time community discussions, pain points, and active repositories
|
|
196
|
+
* across HackerNews (Algolia API), GitHub Search API, and recency-filtered Reddit/Web.
|
|
197
|
+
*/
|
|
198
|
+
declare class SocialPulseHarvester {
|
|
199
|
+
private searchEngine;
|
|
200
|
+
constructor(searchEngine?: MultiSourceSearchEngine);
|
|
201
|
+
harvest(topic: string, options?: SocialPulseOptions): Promise<SocialPulseReport>;
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
export { GitHubCurriculumClient as G, type HealthAuditResult as H, NasaMediaClient as N, OpenverseClient as O, PedagogicalTermExtractor as P, type StemResourceType as S, type TranscriptSegment as T, type YouTubeTranscriptResult as Y, YouTubeIngestionService as a, type TermExtractionBundle as b, HealthAuditor as c, type StemResourceQueryType as d, extractYouTubeVideoId as e, formatTimestamp as f, type StemResourceProvider as g, type StemResourceLicense as h, isYouTubeUrl as i, type StemResourceItem as j, type StemResearchOptions as k, type StemResourceCatalog as l, StemResourceResearcher as m, type SocialPulsePlatform as n, type SocialPulseItem as o, type SocialPulseOptions as p, type SocialPulseReport as q, SocialPulseHarvester as r, stitchCaptionSegments as s };
|
|
@@ -0,0 +1,204 @@
|
|
|
1
|
+
import { E as ExtractedConceptNode, a as CourseResearchContext, L as LlmTextFn } from './index-CxoD81QN.js';
|
|
2
|
+
import { T as TechnicalDomain, S as ScrapedDocument } from './webScraper-C9pB5Rgd.js';
|
|
3
|
+
import { b as MultiSourceSearchEngine } from './catalogBuilder-D-UiM37y.js';
|
|
4
|
+
|
|
5
|
+
interface TranscriptSegment {
|
|
6
|
+
startSec: number;
|
|
7
|
+
durationSec: number;
|
|
8
|
+
timestamp: string;
|
|
9
|
+
text: string;
|
|
10
|
+
}
|
|
11
|
+
interface YouTubeTranscriptResult {
|
|
12
|
+
videoId: string;
|
|
13
|
+
url: string;
|
|
14
|
+
title: string;
|
|
15
|
+
author?: string;
|
|
16
|
+
language: string;
|
|
17
|
+
isAutoGenerated: boolean;
|
|
18
|
+
segments: TranscriptSegment[];
|
|
19
|
+
stitchedMarkdown: string;
|
|
20
|
+
}
|
|
21
|
+
declare function extractYouTubeVideoId(urlOrId: string): string | null;
|
|
22
|
+
declare function isYouTubeUrl(url: string): boolean;
|
|
23
|
+
declare function formatTimestamp(seconds: number): string;
|
|
24
|
+
/**
|
|
25
|
+
* Stitches short caption fragments into coherent timestamped paragraphs (every ~30-45 seconds or sentence boundary)
|
|
26
|
+
* and strips sponsor/subscribe filler noise.
|
|
27
|
+
*/
|
|
28
|
+
declare function stitchCaptionSegments(segments: Array<{
|
|
29
|
+
startSec: number;
|
|
30
|
+
durationSec: number;
|
|
31
|
+
text: string;
|
|
32
|
+
}>): TranscriptSegment[];
|
|
33
|
+
/**
|
|
34
|
+
* YouTube Transcript Ingestion Service (Idea §3.1)
|
|
35
|
+
*/
|
|
36
|
+
declare class YouTubeIngestionService {
|
|
37
|
+
fetchTranscript(urlOrId: string, preferredLanguages?: string[]): Promise<YouTubeTranscriptResult>;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
interface TermExtractionBundle {
|
|
41
|
+
concepts: ExtractedConceptNode[];
|
|
42
|
+
conceptDagTsv: string;
|
|
43
|
+
isLlmRefined: boolean;
|
|
44
|
+
unrefinedCandidatesCount?: number;
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* Bilingual (Vietnamese + English) Automated Term Extractor & Prerequisite Concept DAG Builder (Idea §4).
|
|
48
|
+
* Combines deterministic YAKE/TF-IDF multi-signal extraction with optional host LLM semantic refinement.
|
|
49
|
+
*/
|
|
50
|
+
declare class PedagogicalTermExtractor {
|
|
51
|
+
extractDeterministic(topic: string, domain: TechnicalDomain, docs: Array<{
|
|
52
|
+
resourceId: string;
|
|
53
|
+
doc: ScrapedDocument;
|
|
54
|
+
}>, maxTerms?: number): TermExtractionBundle;
|
|
55
|
+
extractWithOptionalLlm(topic: string, domain: TechnicalDomain, docs: Array<{
|
|
56
|
+
resourceId: string;
|
|
57
|
+
doc: ScrapedDocument;
|
|
58
|
+
}>, options?: {
|
|
59
|
+
context?: CourseResearchContext;
|
|
60
|
+
llm?: LlmTextFn;
|
|
61
|
+
maxTerms?: number;
|
|
62
|
+
}): Promise<TermExtractionBundle>;
|
|
63
|
+
formatConceptDagTsv(concepts: ExtractedConceptNode[]): string;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
interface HealthAuditResult {
|
|
67
|
+
passed: boolean;
|
|
68
|
+
score: number;
|
|
69
|
+
issues: string[];
|
|
70
|
+
warnings: string[];
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* Health Auditor & Noise Filter for Harvested Resources (English Canonical)
|
|
74
|
+
*/
|
|
75
|
+
declare class HealthAuditor {
|
|
76
|
+
auditDocument(doc: ScrapedDocument): HealthAuditResult;
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
/**
|
|
80
|
+
* STEM & Coding Resource Researcher (v1.2.2).
|
|
81
|
+
* Tự động tìm kiếm, đối chiếu và đề xuất tài nguyên giáo dục mở (OER):
|
|
82
|
+
* - Mô phỏng tương tác (PhET Simulations, Open Source Physics)
|
|
83
|
+
* - Khóa học & Lộ trình mở (freeCodeCamp, The Odin Project, Code.org, GitHub Curricula)
|
|
84
|
+
* - Hình ảnh khoa học & media mở bản quyền CC/Public Domain (Openverse, NASA Media Library)
|
|
85
|
+
* - Sách & giáo trình mở (OpenStax, MIT OCW)
|
|
86
|
+
* - Lập trình & Thử thách thực hành (CS Unplugged, Scratch, Exercism)
|
|
87
|
+
*/
|
|
88
|
+
type StemResourceType = 'simulation' | 'curriculum' | 'media_image' | 'media_video' | 'hands_on_lab' | 'textbook' | 'problem_set';
|
|
89
|
+
type StemResourceQueryType = StemResourceType | 'interactive' | 'open_media';
|
|
90
|
+
type StemResourceProvider = 'openverse' | 'nasa' | 'github' | 'phet' | 'openstax' | 'cs_unplugged' | 'scratch' | 'exercism' | 'web';
|
|
91
|
+
interface StemResourceLicense {
|
|
92
|
+
type: string;
|
|
93
|
+
attributionText: string;
|
|
94
|
+
url?: string;
|
|
95
|
+
commercialUseAllowed: boolean;
|
|
96
|
+
}
|
|
97
|
+
interface StemResourceItem {
|
|
98
|
+
id: string;
|
|
99
|
+
title: string;
|
|
100
|
+
url: string;
|
|
101
|
+
description: string;
|
|
102
|
+
type: StemResourceType;
|
|
103
|
+
provider: StemResourceProvider;
|
|
104
|
+
thumbnailUrl?: string;
|
|
105
|
+
embedUrl?: string;
|
|
106
|
+
mediaType: 'interactive' | 'image' | 'video' | 'text' | 'code';
|
|
107
|
+
license: StemResourceLicense;
|
|
108
|
+
subject: 'computer_science' | 'physics' | 'robotics' | 'math' | 'electronics' | 'general_stem';
|
|
109
|
+
targetLevel: 'primary' | 'lower_secondary' | 'upper_secondary' | 'higher_ed' | 'developer' | 'all';
|
|
110
|
+
tags: string[];
|
|
111
|
+
relevanceScore: number;
|
|
112
|
+
}
|
|
113
|
+
interface StemResearchOptions {
|
|
114
|
+
types?: StemResourceQueryType[];
|
|
115
|
+
limit?: number;
|
|
116
|
+
licenseFilter?: 'creative_commons' | 'public_domain' | 'all';
|
|
117
|
+
level?: 'primary' | 'lower_secondary' | 'upper_secondary' | 'higher_ed' | 'developer' | 'all';
|
|
118
|
+
githubToken?: string;
|
|
119
|
+
timeoutMs?: number;
|
|
120
|
+
}
|
|
121
|
+
interface StemResourceCatalog {
|
|
122
|
+
query: string;
|
|
123
|
+
totalFound: number;
|
|
124
|
+
categoryCounts: Record<StemResourceType, number>;
|
|
125
|
+
resources: StemResourceItem[];
|
|
126
|
+
items: StemResourceItem[];
|
|
127
|
+
markdownSummary: string;
|
|
128
|
+
markdownReport: string;
|
|
129
|
+
}
|
|
130
|
+
declare class OpenverseClient {
|
|
131
|
+
private baseUrl;
|
|
132
|
+
searchImages(query: string, options?: {
|
|
133
|
+
limit?: number;
|
|
134
|
+
license?: string;
|
|
135
|
+
}): Promise<StemResourceItem[]>;
|
|
136
|
+
}
|
|
137
|
+
declare class NasaMediaClient {
|
|
138
|
+
private baseUrl;
|
|
139
|
+
search(query: string, options?: {
|
|
140
|
+
limit?: number;
|
|
141
|
+
mediaType?: 'image' | 'video' | 'audio';
|
|
142
|
+
}): Promise<StemResourceItem[]>;
|
|
143
|
+
}
|
|
144
|
+
declare class GitHubCurriculumClient {
|
|
145
|
+
private baseUrl;
|
|
146
|
+
searchCurricula(query: string, options?: {
|
|
147
|
+
limit?: number;
|
|
148
|
+
token?: string;
|
|
149
|
+
}): Promise<StemResourceItem[]>;
|
|
150
|
+
}
|
|
151
|
+
declare class StemResourceResearcher {
|
|
152
|
+
private openverse;
|
|
153
|
+
private nasa;
|
|
154
|
+
private github;
|
|
155
|
+
findResources(query: string, options?: StemResearchOptions): Promise<StemResourceCatalog>;
|
|
156
|
+
searchAndCatalog(query: string, options?: StemResearchOptions): Promise<StemResourceCatalog>;
|
|
157
|
+
generateMarkdown(catalog: StemResourceCatalog): string;
|
|
158
|
+
private generateMarkdownSummary;
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
type SocialPulsePlatform = 'hackernews' | 'github' | 'reddit' | 'web';
|
|
162
|
+
interface SocialPulseItem {
|
|
163
|
+
id: string;
|
|
164
|
+
platform: SocialPulsePlatform;
|
|
165
|
+
title: string;
|
|
166
|
+
url: string;
|
|
167
|
+
snippet: string;
|
|
168
|
+
author?: string;
|
|
169
|
+
createdAt?: string;
|
|
170
|
+
engagementScore: number;
|
|
171
|
+
rawMetrics?: {
|
|
172
|
+
points?: number;
|
|
173
|
+
comments?: number;
|
|
174
|
+
stars?: number;
|
|
175
|
+
};
|
|
176
|
+
}
|
|
177
|
+
interface SocialPulseOptions {
|
|
178
|
+
recencyDays?: number;
|
|
179
|
+
limitPerPlatform?: number;
|
|
180
|
+
includeHackerNews?: boolean;
|
|
181
|
+
includeGitHub?: boolean;
|
|
182
|
+
includeRedditWeb?: boolean;
|
|
183
|
+
}
|
|
184
|
+
interface SocialPulseReport {
|
|
185
|
+
topic: string;
|
|
186
|
+
recencyDays: number;
|
|
187
|
+
harvestedAt: string;
|
|
188
|
+
items: SocialPulseItem[];
|
|
189
|
+
trendingReposAndTools: string[];
|
|
190
|
+
communityHighlights: string[];
|
|
191
|
+
markdownReport: string;
|
|
192
|
+
}
|
|
193
|
+
/**
|
|
194
|
+
* 30-Day Social & Developer Pulse Harvester (`last30days-skill` pattern).
|
|
195
|
+
* Harvests real-time community discussions, pain points, and active repositories
|
|
196
|
+
* across HackerNews (Algolia API), GitHub Search API, and recency-filtered Reddit/Web.
|
|
197
|
+
*/
|
|
198
|
+
declare class SocialPulseHarvester {
|
|
199
|
+
private searchEngine;
|
|
200
|
+
constructor(searchEngine?: MultiSourceSearchEngine);
|
|
201
|
+
harvest(topic: string, options?: SocialPulseOptions): Promise<SocialPulseReport>;
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
export { GitHubCurriculumClient as G, type HealthAuditResult as H, NasaMediaClient as N, OpenverseClient as O, PedagogicalTermExtractor as P, type StemResourceType as S, type TranscriptSegment as T, type YouTubeTranscriptResult as Y, YouTubeIngestionService as a, type TermExtractionBundle as b, HealthAuditor as c, type StemResourceQueryType as d, extractYouTubeVideoId as e, formatTimestamp as f, type StemResourceProvider as g, type StemResourceLicense as h, isYouTubeUrl as i, type StemResourceItem as j, type StemResearchOptions as k, type StemResourceCatalog as l, StemResourceResearcher as m, type SocialPulsePlatform as n, type SocialPulseItem as o, type SocialPulseOptions as p, type SocialPulseReport as q, SocialPulseHarvester as r, stitchCaptionSegments as s };
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { a as CourseResearchContext, c as CustomCrawlerAdapter } from './index-CxoD81QN.cjs';
|
|
2
2
|
|
|
3
3
|
type TechnicalDomain = 'hardware' | 'software' | 'platform' | 'academic';
|
|
4
4
|
interface DomainClassificationResult {
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { a as CourseResearchContext, c as CustomCrawlerAdapter } from './index-CxoD81QN.js';
|
|
2
2
|
|
|
3
3
|
type TechnicalDomain = 'hardware' | 'software' | 'platform' | 'academic';
|
|
4
4
|
interface DomainClassificationResult {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@thanh01.pmt/research-kit",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.4.0",
|
|
4
4
|
"description": "An autonomous Deep Research, Academic Harvest & Evidence Verification Engine for Curriculum OS & AI Agents.",
|
|
5
5
|
"author": "Thanh Pham <https://github.com/thanh01pmt>",
|
|
6
6
|
"license": "MIT",
|
|
@@ -38,6 +38,11 @@
|
|
|
38
38
|
"types": "./dist/pipeline/index.d.ts",
|
|
39
39
|
"import": "./dist/pipeline/index.js",
|
|
40
40
|
"require": "./dist/pipeline/index.cjs"
|
|
41
|
+
},
|
|
42
|
+
"./agent": {
|
|
43
|
+
"types": "./dist/agent/index.d.ts",
|
|
44
|
+
"import": "./dist/agent/index.js",
|
|
45
|
+
"require": "./dist/agent/index.cjs"
|
|
41
46
|
}
|
|
42
47
|
},
|
|
43
48
|
"files": [
|