@thanh01.pmt/research-kit 1.2.4 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (69) hide show
  1. package/dist/academic/index.cjs +122 -0
  2. package/dist/academic/index.cjs.map +1 -1
  3. package/dist/academic/index.d.cts +27 -4
  4. package/dist/academic/index.d.ts +27 -4
  5. package/dist/academic/index.js +2 -1
  6. package/dist/agent/index.cjs +3441 -0
  7. package/dist/agent/index.cjs.map +1 -0
  8. package/dist/agent/index.d.cts +10 -0
  9. package/dist/agent/index.d.ts +10 -0
  10. package/dist/agent/index.js +10 -0
  11. package/dist/agent/index.js.map +1 -0
  12. package/dist/{catalogBuilder-B4eiLS_S.d.cts → catalogBuilder-BBCa9jqI.d.cts} +2 -2
  13. package/dist/{catalogBuilder-BNB_gaWP.d.ts → catalogBuilder-D-UiM37y.d.ts} +2 -2
  14. package/dist/chunk-2GBXVPOQ.js +3 -0
  15. package/dist/{chunk-J3VCGH7Z.js.map → chunk-2GBXVPOQ.js.map} +1 -1
  16. package/dist/chunk-2RMBLKP5.js +581 -0
  17. package/dist/chunk-2RMBLKP5.js.map +1 -0
  18. package/dist/{chunk-2XIEWCUE.js → chunk-32B5PVTQ.js} +2 -2
  19. package/dist/{chunk-2XIEWCUE.js.map → chunk-32B5PVTQ.js.map} +1 -1
  20. package/dist/chunk-LDCZ33AC.js +3 -0
  21. package/dist/chunk-LDCZ33AC.js.map +1 -0
  22. package/dist/chunk-NSY6KU4G.js +125 -0
  23. package/dist/chunk-NSY6KU4G.js.map +1 -0
  24. package/dist/{chunk-SAHBBO3U.js → chunk-RYLZYZRF.js} +4 -580
  25. package/dist/chunk-RYLZYZRF.js.map +1 -0
  26. package/dist/{chunk-GK5KI5PB.js → chunk-S3JUCDKD.js} +62 -43
  27. package/dist/chunk-S3JUCDKD.js.map +1 -0
  28. package/dist/chunk-TYQEC24G.js +3 -0
  29. package/dist/chunk-TYQEC24G.js.map +1 -0
  30. package/dist/chunk-WWQ45RQK.js +1114 -0
  31. package/dist/chunk-WWQ45RQK.js.map +1 -0
  32. package/dist/{chunk-YICMTZS5.js → chunk-ZNGU4ZYX.js} +171 -3
  33. package/dist/chunk-ZNGU4ZYX.js.map +1 -0
  34. package/dist/config/index.d.cts +1 -1
  35. package/dist/config/index.d.ts +1 -1
  36. package/dist/evidence/index.d.cts +2 -2
  37. package/dist/evidence/index.d.ts +2 -2
  38. package/dist/evidence/index.js +2 -1
  39. package/dist/harvester/index.cjs +168 -1
  40. package/dist/harvester/index.cjs.map +1 -1
  41. package/dist/harvester/index.d.cts +5 -161
  42. package/dist/harvester/index.d.ts +5 -161
  43. package/dist/harvester/index.js +4 -2
  44. package/dist/index-CN8gei7k.d.ts +518 -0
  45. package/dist/{index-9rDiFuR4.d.ts → index-CxoD81QN.d.cts} +1 -1
  46. package/dist/{index-9rDiFuR4.d.cts → index-CxoD81QN.d.ts} +1 -1
  47. package/dist/index-onQDKDNo.d.cts +518 -0
  48. package/dist/index.cjs +1463 -39
  49. package/dist/index.cjs.map +1 -1
  50. package/dist/index.d.cts +11 -174
  51. package/dist/index.d.ts +11 -174
  52. package/dist/index.js +25 -10
  53. package/dist/index.js.map +1 -1
  54. package/dist/{literatureReview-DOzgm9Q2.d.ts → literatureReview-Bn2iEGRO.d.ts} +1 -1
  55. package/dist/{literatureReview-BwidpYJo.d.cts → literatureReview-Bvlqk4DB.d.cts} +1 -1
  56. package/dist/pipeline/index.cjs +59 -41
  57. package/dist/pipeline/index.cjs.map +1 -1
  58. package/dist/pipeline/index.d.cts +5 -4
  59. package/dist/pipeline/index.d.ts +5 -4
  60. package/dist/pipeline/index.js +3 -2
  61. package/dist/socialPulseHarvester-CN4MwrpY.d.cts +204 -0
  62. package/dist/socialPulseHarvester-IbdT3zD1.d.ts +204 -0
  63. package/dist/{webScraper-CAQjE46m.d.cts → webScraper-BVvNW4yj.d.cts} +1 -1
  64. package/dist/{webScraper-CXIpvyA6.d.ts → webScraper-C9pB5Rgd.d.ts} +1 -1
  65. package/package.json +6 -1
  66. package/dist/chunk-GK5KI5PB.js.map +0 -1
  67. package/dist/chunk-J3VCGH7Z.js +0 -3
  68. package/dist/chunk-SAHBBO3U.js.map +0 -1
  69. 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-CAQjE46m.cjs';
2
- import { C as CourseResearchContext, L as LlmTextFn, A as AcademicPaper, E as ExtractedConceptNode, g as SynthesizedResearchInsights, R as ResearchApiKeys, i as ResearchConfig, a as CustomSearchAdapter, b as CustomCrawlerAdapter, c as CustomAcademicSearchAdapter, d as CustomSynthesizerAdapter } from '../index-9rDiFuR4.cjs';
3
- import { C as CS2023KnowledgeArea, a as CSTAK12Strand, L as LiteratureReviewReport } from '../literatureReview-BwidpYJo.cjs';
4
- import { R as ResourceCatalogBundle, b as MultiSourceSearchEngine } from '../catalogBuilder-B4eiLS_S.cjs';
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;
@@ -1,7 +1,7 @@
1
- import { T as TechnicalDomain, S as ScrapedDocument, a as WebScraper } from '../webScraper-CXIpvyA6.js';
2
- import { C as CourseResearchContext, L as LlmTextFn, A as AcademicPaper, E as ExtractedConceptNode, g as SynthesizedResearchInsights, R as ResearchApiKeys, i as ResearchConfig, a as CustomSearchAdapter, b as CustomCrawlerAdapter, c as CustomAcademicSearchAdapter, d as CustomSynthesizerAdapter } from '../index-9rDiFuR4.js';
3
- import { C as CS2023KnowledgeArea, a as CSTAK12Strand, L as LiteratureReviewReport } from '../literatureReview-DOzgm9Q2.js';
4
- import { R as ResourceCatalogBundle, b as MultiSourceSearchEngine } from '../catalogBuilder-BNB_gaWP.js';
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;
@@ -1,6 +1,7 @@
1
- export { CampaignPlanner, HarvestPipeline, ReferencePackBuilder, TechnicalGroundingEngine, normalizeUrlForDedup } from '../chunk-GK5KI5PB.js';
1
+ export { CampaignPlanner, HarvestPipeline, ReferencePackBuilder, TechnicalGroundingEngine, normalizeUrlForDedup } from '../chunk-S3JUCDKD.js';
2
2
  import '../chunk-SDDZFFL6.js';
3
- import '../chunk-SAHBBO3U.js';
3
+ import '../chunk-RYLZYZRF.js';
4
+ import '../chunk-2RMBLKP5.js';
4
5
  import '../chunk-AKEI7H2C.js';
5
6
  import '../chunk-KXJDQBSJ.js';
6
7
  import '../chunk-QQZQNBJC.js';
@@ -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 { C as CourseResearchContext, b as CustomCrawlerAdapter } from './index-9rDiFuR4.cjs';
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 { C as CourseResearchContext, b as CustomCrawlerAdapter } from './index-9rDiFuR4.js';
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.2.4",
3
+ "version": "1.3.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": [