@thanh01.pmt/research-kit 1.2.0 → 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.
@@ -1,223 +1,3 @@
1
- import { z } from 'zod';
2
-
3
- // src/academic/arxivClient.ts
4
- var ArXivSearchEngine = class {
5
- /**
6
- * Search ArXiv repository using the public atom XML API
7
- */
8
- async search(query, maxResults = 5) {
9
- const papers = [];
10
- try {
11
- const url = `https://export.arxiv.org/api/query?search_query=all:${encodeURIComponent(query)}&start=0&max_results=${maxResults}&sortBy=relevance&sortOrder=descending`;
12
- const res = await fetch(url, { signal: AbortSignal.timeout(1e4) });
13
- if (res.ok) {
14
- const xmlText = await res.text();
15
- const entryMatches = xmlText.match(/<entry>[\s\S]*?<\/entry>/g) || [];
16
- for (const entry of entryMatches) {
17
- const idMatch = entry.match(/<id>([\s\S]*?)<\/id>/);
18
- const titleMatch = entry.match(/<title>([\s\S]*?)<\/title>/);
19
- const summaryMatch = entry.match(/<summary>([\s\S]*?)<\/summary>/);
20
- const publishedMatch = entry.match(/<published>(\d{4})/);
21
- const authorMatches = [...entry.matchAll(/<author>\s*<name>([\s\S]*?)<\/name>/g)].map((m) => m[1]?.trim()).filter(Boolean);
22
- const arxivUrl = idMatch ? idMatch[1]?.trim() : "";
23
- const pdfUrl = arxivUrl ? arxivUrl.replace("/abs/", "/pdf/") + ".pdf" : void 0;
24
- if (titleMatch) {
25
- papers.push({
26
- id: arxivUrl || `arxiv-${Math.random().toString(36).substring(7)}`,
27
- title: titleMatch[1]?.trim().replace(/\s+/g, " ") || "Untitled ArXiv Paper",
28
- abstract: summaryMatch ? summaryMatch[1]?.trim().replace(/\s+/g, " ") : "",
29
- authors: authorMatches,
30
- year: publishedMatch ? parseInt(publishedMatch[1], 10) : (/* @__PURE__ */ new Date()).getFullYear(),
31
- citationCount: 0,
32
- venue: "arXiv preprint",
33
- url: arxivUrl,
34
- pdfUrl,
35
- fieldsOfStudy: ["Computer Science", "AI & Machine Learning"]
36
- });
37
- }
38
- }
39
- }
40
- } catch (e) {
41
- console.warn("[ArXivSearchEngine] ArXiv search failed:", e?.message || e);
42
- }
43
- return papers;
44
- }
45
- };
46
- var AcademicPaperSchema = z.object({
47
- id: z.string(),
48
- title: z.string(),
49
- abstract: z.string().optional(),
50
- authors: z.array(z.string()).default([]),
51
- year: z.number().optional(),
52
- citationCount: z.number().default(0),
53
- venue: z.string().optional(),
54
- doi: z.string().optional(),
55
- url: z.string().optional(),
56
- pdfUrl: z.string().optional(),
57
- tldr: z.string().optional(),
58
- fieldsOfStudy: z.array(z.string()).default([])
59
- });
60
- function reconstructOpenAlexAbstract(invertedIndex) {
61
- if (!invertedIndex || typeof invertedIndex !== "object") return void 0;
62
- const entries = Object.entries(invertedIndex);
63
- if (entries.length === 0) return void 0;
64
- let maxIndex = 0;
65
- for (const [, positions] of entries) {
66
- if (Array.isArray(positions)) {
67
- for (const p of positions) {
68
- if (typeof p === "number" && p > maxIndex) maxIndex = p;
69
- }
70
- }
71
- }
72
- if (maxIndex > 5e3) maxIndex = 5e3;
73
- const words = new Array(maxIndex + 1);
74
- for (const [word, positions] of entries) {
75
- if (Array.isArray(positions)) {
76
- for (const p of positions) {
77
- if (typeof p === "number" && p >= 0 && p <= maxIndex) {
78
- words[p] = word;
79
- }
80
- }
81
- }
82
- }
83
- const reconstructed = words.filter(Boolean).join(" ").trim();
84
- return reconstructed.length > 0 ? reconstructed : void 0;
85
- }
86
- var AcademicSearchEngine = class {
87
- apiKey;
88
- allowEnvFallback;
89
- customAdapter;
90
- arxivEngine;
91
- constructor(options = {}) {
92
- this.arxivEngine = new ArXivSearchEngine();
93
- if (typeof options === "string") {
94
- this.apiKey = options;
95
- this.allowEnvFallback = true;
96
- } else {
97
- this.allowEnvFallback = options.allowEnvFallback ?? true;
98
- this.apiKey = options.apiKey || (this.allowEnvFallback ? process.env.SEMANTIC_SCHOLAR_API_KEY : void 0);
99
- this.customAdapter = options.customAdapter;
100
- }
101
- }
102
- setCustomAdapter(adapter) {
103
- this.customAdapter = adapter;
104
- }
105
- setApiKey(apiKey) {
106
- this.apiKey = apiKey;
107
- }
108
- /**
109
- * Search academic papers across Semantic Scholar with OpenAlex and ArXiv fallback or Custom Adapter
110
- */
111
- async searchPapers(query, options = {}) {
112
- const adapter = options.customAdapter || this.customAdapter;
113
- if (adapter) {
114
- try {
115
- const customPapers = await adapter.searchPapers(query, { limit: options.limit, yearRange: options.yearRange });
116
- if (Array.isArray(customPapers) && customPapers.length > 0) {
117
- return customPapers;
118
- }
119
- } catch (e) {
120
- console.warn("[AcademicSearchEngine] Custom academic adapter failed:", e?.message || e);
121
- }
122
- }
123
- const limit = options.limit ?? 5;
124
- const papers = [];
125
- const seenTitles = /* @__PURE__ */ new Set();
126
- const pushUnique = (p) => {
127
- const normTitle = p.title.toLowerCase().replace(/[^a-z0-9\u00C0-\u1EF9]+/g, "");
128
- if (!normTitle || seenTitles.has(normTitle)) return;
129
- seenTitles.add(normTitle);
130
- papers.push(p);
131
- };
132
- try {
133
- const apiKey = options.apiKey || this.apiKey;
134
- const headers = { "Content-Type": "application/json" };
135
- if (apiKey) {
136
- headers["x-api-key"] = apiKey;
137
- }
138
- const params = new URLSearchParams({
139
- query,
140
- limit: limit.toString(),
141
- fields: "paperId,title,abstract,authors,year,citationCount,venue,externalIds,url,openAccessPdf,tldr,fieldsOfStudy"
142
- });
143
- if (options.yearRange) {
144
- params.append("year", options.yearRange);
145
- }
146
- const res = await fetch(`https://api.semanticscholar.org/graph/v1/paper/search?${params.toString()}`, {
147
- headers,
148
- signal: AbortSignal.timeout(6e3)
149
- });
150
- if (res.ok) {
151
- const data = await res.json();
152
- if (Array.isArray(data?.data)) {
153
- for (const item of data.data) {
154
- pushUnique({
155
- id: item.paperId || `s2-${Math.random().toString(36).slice(2, 8)}`,
156
- title: item.title || "Untitled",
157
- abstract: item.abstract || void 0,
158
- authors: Array.isArray(item.authors) ? item.authors.map((a) => a.name).filter(Boolean) : [],
159
- year: item.year,
160
- citationCount: item.citationCount || 0,
161
- venue: item.venue || void 0,
162
- doi: item.externalIds?.DOI,
163
- url: item.url || (item.externalIds?.DOI ? `https://doi.org/${item.externalIds.DOI}` : void 0),
164
- pdfUrl: item.openAccessPdf?.url,
165
- tldr: item.tldr?.text,
166
- fieldsOfStudy: Array.isArray(item.fieldsOfStudy) && item.fieldsOfStudy.length > 0 ? item.fieldsOfStudy : ["Computer Science"]
167
- });
168
- }
169
- if (papers.length >= limit) return papers.slice(0, limit);
170
- }
171
- }
172
- } catch (e) {
173
- console.warn("[AcademicSearchEngine] Semantic Scholar failed:", e?.message || e);
174
- }
175
- if (papers.length < limit) {
176
- try {
177
- const res = await fetch(`https://api.openalex.org/works?search=${encodeURIComponent(query)}&per-page=${limit}`, {
178
- headers: { "User-Agent": "OrchableComposer/1.0 (mailto:team@orchable.app)" },
179
- signal: AbortSignal.timeout(6e3)
180
- });
181
- if (res.ok) {
182
- const data = await res.json();
183
- if (Array.isArray(data?.results)) {
184
- for (const item of data.results) {
185
- const abstractText = reconstructOpenAlexAbstract(item.abstract_inverted_index);
186
- const concepts = Array.isArray(item.concepts) ? item.concepts.slice(0, 3).map((c) => c.display_name).filter(Boolean) : ["Computer Science"];
187
- pushUnique({
188
- id: item.id || `oa-${Math.random().toString(36).slice(2, 8)}`,
189
- title: item.title || "Untitled",
190
- abstract: abstractText,
191
- authors: Array.isArray(item.authorships) ? item.authorships.map((a) => a.author?.display_name).filter(Boolean) : [],
192
- year: item.publication_year,
193
- citationCount: item.cited_by_count || 0,
194
- venue: item.primary_location?.source?.display_name,
195
- doi: item.doi ? String(item.doi).replace(/^https?:\/\/doi\.org\//i, "") : void 0,
196
- url: item.doi || item.id,
197
- pdfUrl: item.open_access?.oa_url,
198
- fieldsOfStudy: concepts.length > 0 ? concepts : ["Computer Science"]
199
- });
200
- }
201
- }
202
- }
203
- } catch (e) {
204
- console.warn("[AcademicSearchEngine] OpenAlex failed:", e?.message || e);
205
- }
206
- }
207
- if (papers.length < limit && options.includeArxivFallback !== false) {
208
- try {
209
- const arxivPapers = await this.arxivEngine.search(query, limit - papers.length);
210
- for (const p of arxivPapers) {
211
- pushUnique(p);
212
- }
213
- } catch (e) {
214
- console.warn("[AcademicSearchEngine] ArXiv fallback failed:", e?.message || e);
215
- }
216
- }
217
- return papers.slice(0, limit);
218
- }
219
- };
220
-
221
1
  // src/academic/cs2023Taxonomy.ts
222
2
  var CSTA_K12_STRANDS = {
223
3
  CS: {
@@ -554,6 +334,6 @@ ${dynamicQuestions.map((q) => `- ${q}`).join("\n")}`
554
334
  }
555
335
  };
556
336
 
557
- export { AcademicPaperSchema, AcademicSearchEngine, ArXivSearchEngine, CS2023_KNOWLEDGE_AREAS, CSTA_K12_STRANDS, CitationManager, LiteratureReviewSynthesizer, mapTopicToCS2023, reconstructOpenAlexAbstract };
558
- //# sourceMappingURL=chunk-DOXSPRSP.js.map
559
- //# sourceMappingURL=chunk-DOXSPRSP.js.map
337
+ export { CS2023_KNOWLEDGE_AREAS, CSTA_K12_STRANDS, CitationManager, LiteratureReviewSynthesizer, mapTopicToCS2023 };
338
+ //# sourceMappingURL=chunk-UKGR45VZ.js.map
339
+ //# sourceMappingURL=chunk-UKGR45VZ.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/academic/cs2023Taxonomy.ts","../src/academic/citationManager.ts","../src/academic/literatureReview.ts"],"names":[],"mappings":"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","file":"chunk-UKGR45VZ.js","sourcesContent":["import { CourseResearchContext } from '../config/researchConfig';\n\nexport interface CS2023KnowledgeArea {\n code: string;\n name: string;\n description: string;\n coreTopics: string[];\n}\n\nexport interface CSTAK12Strand {\n code: 'CS' | 'NI' | 'DA' | 'AP' | 'IC';\n name: string;\n nameVi: string;\n description: string;\n subconcepts: string[];\n}\n\nexport const CSTA_K12_STRANDS: Record<string, CSTAK12Strand> = {\n CS: {\n code: 'CS',\n name: 'Computing Systems',\n nameVi: 'Hệ thống Máy tính & Phần cứng',\n description: 'Devices, hardware and software integration, sensors, actuators, and troubleshooting.',\n subconcepts: ['Devices', 'Hardware & Software', 'Troubleshooting'],\n },\n NI: {\n code: 'NI',\n name: 'Networks and the Internet',\n nameVi: 'Mạng máy tính & An toàn thông tin',\n description: 'Network communication, protocols, IoT connectivity, and cybersecurity.',\n subconcepts: ['Network Communication & Organization', 'Cybersecurity'],\n },\n DA: {\n code: 'DA',\n name: 'Data and Analysis',\n nameVi: 'Dữ liệu & Phân tích',\n description: 'Storage, collection, visualization, and transformation of sensor or application data.',\n subconcepts: ['Storage', 'Collection, Visualization & Transformation', 'Inference & Models'],\n },\n AP: {\n code: 'AP',\n name: 'Algorithms and Programming',\n nameVi: 'Thuật toán & Lập trình',\n description: 'Algorithms, variables, control structures, modularity, and iterative program development.',\n subconcepts: ['Algorithms', 'Variables', 'Control', 'Modularity', 'Program Development'],\n },\n IC: {\n code: 'IC',\n name: 'Impacts of Computing',\n nameVi: 'Tác động của Tin học & AI',\n description: 'Culture, social interactions, safety, law, and ethics of computing and AI systems.',\n subconcepts: ['Culture', 'Social Interactions', 'Safety, Law, & Ethics'],\n },\n};\n\nexport const CS2023_KNOWLEDGE_AREAS: Record<string, CS2023KnowledgeArea> = {\n AL: {\n code: 'AL',\n name: 'Algorithmic Foundations',\n description: 'Design and analysis of algorithms, computational complexity, and problem solving.',\n coreTopics: ['Asymptotic Analysis', 'Divide-and-Conquer', 'Dynamic Programming', 'Graph Algorithms', 'NP-Completeness'],\n },\n AR: {\n code: 'AR',\n name: 'Architecture and Organization',\n description: 'Hardware architecture, microcontrollers, sensors, memory hierarchy, and interfacing.',\n coreTopics: ['Digital Logic', 'Memory Hierarchy & Cache', 'Microcontrollers & Embedded I/O', 'Sensor & Actuator Interfacing'],\n },\n AI: {\n code: 'AI',\n name: 'Artificial Intelligence & Machine Learning',\n description: 'Neural networks, search algorithms, knowledge representation, reinforcement learning, and LLMs.',\n coreTopics: ['Supervised Learning', 'Deep Learning & Transformers', 'Search & Optimization', 'AI Ethics & Alignment'],\n },\n DM: {\n code: 'DM',\n name: 'Data Management',\n description: 'Relational databases, NoSQL, query optimization, data modeling, and transactions.',\n coreTopics: ['Relational & SQL Modeling', 'Indexing & Query Optimization', 'Transactions & ACID', 'Distributed Data Stores'],\n },\n FPL: {\n code: 'FPL',\n name: 'Foundations of Programming Languages',\n description: 'Language paradigms, type systems, event-driven programming, memory safety, and compilers.',\n coreTopics: ['Event-Driven & Reactive Programming', 'Functional & OOP Paradigms', 'Static & Dynamic Typing', 'Memory Safety & Ownership'],\n },\n GIT: {\n code: 'GIT',\n name: 'Graphics and Interactive Techniques',\n description: 'Game engines, 2D/3D rendering, physics simulation, collision detection, and interactive media.',\n coreTopics: ['Game Loop & Frame Timing', '2D/3D Coordinate Systems & Physics', 'Collision Detection & State Machines', 'Shader & Rendering Pipelines'],\n },\n HCI: {\n code: 'HCI',\n name: 'Human-Computer Interaction',\n description: 'User interface design, usability, accessibility, state-driven UI frameworks, and interaction loops.',\n coreTopics: ['Declarative & State-Driven UI', 'Usability & Cognitive Ergonomics', 'Accessibility Standards', 'Interactive Prototyping'],\n },\n OS: {\n code: 'OS',\n name: 'Operating Systems',\n description: 'Process management, concurrency, virtual memory, file systems, and device drivers.',\n coreTopics: ['Concurrency & Synchronization', 'Scheduling & Virtual Memory', 'File Systems & Storage', 'Security & Protection'],\n },\n PDC: {\n code: 'PDC',\n name: 'Parallel and Distributed Computing',\n description: 'Multi-threading, actor model, async programming, distributed consensus, and cloud scaling.',\n coreTopics: ['Async/Await & Futures', 'Actor Model & Message Passing', 'Shared Memory vs Message Passing', 'Distributed Systems & Consistency'],\n },\n PL: {\n code: 'PL',\n name: 'Programming Languages',\n description: 'Language paradigms, type systems, memory safety, compilers, and runtime environments.',\n coreTopics: ['Functional & OOP Paradigms', 'Static & Dynamic Typing', 'Memory Safety & Ownership', 'Language Runtimes'],\n },\n SDF: {\n code: 'SDF',\n name: 'Software Development Fundamentals',\n description: 'Core programming constructs, variables, control flow, data structures, debugging, and modularization.',\n coreTopics: ['Variables, Loops & Control Flow', 'Data Structures (Arrays, Lists, Maps)', 'Systematic Debugging & Testing', 'Modular & Procedural Design'],\n },\n SE: {\n code: 'SE',\n name: 'Software Engineering',\n description: 'Software lifecycle, architecture, design patterns, testing, CI/CD, and agile methodologies.',\n coreTopics: ['Design Patterns', 'Refactoring & Clean Code', 'Automated Testing (TDD/E2E)', 'DevOps & CI/CD'],\n },\n SEC: {\n code: 'SEC',\n name: 'Security & Cryptography',\n description: 'Authentication, cryptography, secure coding, threat modeling, and network defense.',\n coreTopics: ['Symmetric & Asymmetric Encryption', 'OAuth & JWT Auth', 'Secure Coding & Vulnerabilities', 'Identity & Access Management'],\n },\n SPD: {\n code: 'SPD',\n name: 'Specialized Platform Development',\n description: 'Web, mobile, cloud, IoT, and robotics platform engineering.',\n coreTopics: ['Mobile & Desktop App Lifecycle', 'Web Full-Stack Architecture', 'IoT & Edge Device Connectivity', 'Platform SDK Integration'],\n },\n};\n\nexport interface TaxonomyMappingResult {\n area: CS2023KnowledgeArea;\n k12Strand: CSTAK12Strand;\n matchConfidence: number;\n}\n\n/**\n * Maps a course topic or syllabus keyword (English or Vietnamese) to both IEEE/ACM CS2023 Knowledge Areas\n * and CSTA K-12 CS Strands.\n */\nexport function mapTopicToCS2023(topic: string, context?: CourseResearchContext): TaxonomyMappingResult {\n const combined = [\n topic,\n context?.courseTitle,\n context?.positioning,\n context?.hardwarePlatform,\n context?.softwareEnv,\n ...(context?.inScopeTopics || []),\n ]\n .filter(Boolean)\n .join(' ')\n .toLowerCase();\n\n if (/\\b(concurren|async|actor|thread|distributed|parallel|đồng thời|bất đồng bộ|đa luồng)\\b/.test(combined)) {\n return { area: CS2023_KNOWLEDGE_AREAS.PDC!, k12Strand: CSTA_K12_STRANDS.AP!, matchConfidence: 0.95 };\n }\n if (/\\b(ai|machine learning|deep learning|neural|llm|computer vision|trí tuệ nhân tạo|học máy|mạng nơ-ron)\\b/.test(combined)) {\n return { area: CS2023_KNOWLEDGE_AREAS.AI!, k12Strand: CSTA_K12_STRANDS.DA!, matchConfidence: 0.95 };\n }\n if (/\\b(arduino|esp32|raspberry|micro:?bit|mblock|makecode|lego|sensor|circuit|gpio|iot|hardware|robotics|cảm biến|vi điều khiển|mạch điện|điện tử)\\b/.test(combined)) {\n return { area: CS2023_KNOWLEDGE_AREAS.AR!, k12Strand: CSTA_K12_STRANDS.CS!, matchConfidence: 0.92 };\n }\n if (/\\b(roblox|unity|godot|pygame|game|2d|3d|sprite|collision|physics|shader|trò chơi|làm game)\\b/.test(combined)) {\n return { area: CS2023_KNOWLEDGE_AREAS.GIT!, k12Strand: CSTA_K12_STRANDS.AP!, matchConfidence: 0.92 };\n }\n if (/\\b(swiftui|ui|ux|interface|frontend|accessibility|figma|giao diện|tương tác người-máy)\\b/.test(combined)) {\n return { area: CS2023_KNOWLEDGE_AREAS.HCI!, k12Strand: CSTA_K12_STRANDS.AP!, matchConfidence: 0.9 };\n }\n if (/\\b(os|operating system|kernel|virtual memory|linux|hệ điều hành)\\b/.test(combined)) {\n return { area: CS2023_KNOWLEDGE_AREAS.OS!, k12Strand: CSTA_K12_STRANDS.CS!, matchConfidence: 0.9 };\n }\n if (/\\b(security|auth|crypto|cyber|jwt|oauth|bảo mật|an toàn thông tin|mã hóa)\\b/.test(combined)) {\n return { area: CS2023_KNOWLEDGE_AREAS.SEC!, k12Strand: CSTA_K12_STRANDS.NI!, matchConfidence: 0.9 };\n }\n if (/\\b(sql|database|postgres|supabase|mongodb|data model|cơ sở dữ liệu|truy vấn)\\b/.test(combined)) {\n return { area: CS2023_KNOWLEDGE_AREAS.DM!, k12Strand: CSTA_K12_STRANDS.DA!, matchConfidence: 0.9 };\n }\n if (/\\b(architecture|design pattern|software engineer|clean code|testing|tdd|ci\\/cd|kiến trúc phần mềm|kiểm thử)\\b/.test(combined)) {\n return { area: CS2023_KNOWLEDGE_AREAS.SE!, k12Strand: CSTA_K12_STRANDS.AP!, matchConfidence: 0.88 };\n }\n if (/\\b(algorithm|data structure|tree|graph|dynamic programming|sorting|thuật toán|cấu trúc dữ liệu|đồ thị|quy hoạch động)\\b/.test(combined)) {\n return { area: CS2023_KNOWLEDGE_AREAS.AL!, k12Strand: CSTA_K12_STRANDS.AP!, matchConfidence: 0.9 };\n }\n\n return { area: CS2023_KNOWLEDGE_AREAS.SDF!, k12Strand: CSTA_K12_STRANDS.AP!, matchConfidence: 0.8 };\n}\n","import { AcademicPaper } from './semanticScholar';\n\nexport interface CitationItem {\n key: string;\n title: string;\n authors: string[];\n year?: number;\n url?: string;\n doi?: string;\n venue?: string;\n}\n\n/**\n * Manages academic citations, BibTeX generation, and Markdown inline footnotes\n */\nexport class CitationManager {\n private citations: Map<string, CitationItem> = new Map();\n\n addPaper(paper: AcademicPaper): string {\n const firstAuthor = paper.authors[0]?.split(' ').pop()?.toLowerCase() || 'ref';\n const year = paper.year || new Date().getFullYear();\n const key = `${firstAuthor}${year}${Math.random().toString(36).substring(2, 5)}`;\n\n this.citations.set(key, {\n key,\n title: paper.title,\n authors: paper.authors,\n year: paper.year,\n url: paper.url,\n doi: paper.doi,\n venue: paper.venue,\n });\n\n return key;\n }\n\n getBibTeX(): string {\n const entries: string[] = [];\n\n for (const [key, item] of this.citations.entries()) {\n const authorsStr = item.authors.length > 0 ? item.authors.join(' and ') : 'Unknown';\n entries.push(`@article{${key},\n title = {${item.title}},\n author = {${authorsStr}},\n year = {${item.year || 'nodate'}},\n journal = {${item.venue || 'Technical Reference'}},\n ${item.doi ? `doi = {${item.doi}},` : ''}\n ${item.url ? `url = {${item.url}},` : ''}\n}`);\n }\n\n return entries.join('\\n\\n');\n }\n\n getMarkdownFootnotes(): string {\n const lines: string[] = ['## References & Academic Citations\\n'];\n let idx = 1;\n\n for (const [, item] of this.citations.entries()) {\n const authorsStr = item.authors.length > 0 ? item.authors.join(', ') : 'Unknown Authors';\n const linkStr = item.url ? ` [Link](${item.url})` : '';\n const doiStr = item.doi ? ` (DOI: ${item.doi})` : '';\n lines.push(`[^${idx}]: **${item.title}**. ${authorsStr} (${item.year || 'n.d.'}). *${item.venue || 'Technical Ground Truth'}*${doiStr}.${linkStr}`);\n idx++;\n }\n\n return lines.join('\\n');\n }\n}\n","import { AcademicPaper } from './semanticScholar';\nimport { CitationManager } from './citationManager';\nimport { CS2023KnowledgeArea, CSTAK12Strand } from './cs2023Taxonomy';\nimport { CourseResearchContext, LlmTextFn } from '../config/researchConfig';\n\nexport interface SotaComparisonRow {\n approach: string;\n sourcePaper: string;\n keyStrengths: string;\n limitations: string;\n relevanceToCourse: string;\n}\n\nexport interface LiteratureReviewReport {\n topic: string;\n cs2023Area?: CS2023KnowledgeArea;\n k12Strand?: CSTAK12Strand;\n totalPapersFound: number;\n papers: AcademicPaper[];\n sotaMatrix: SotaComparisonRow[];\n keyTheoreticalFoundations: string[];\n openResearchQuestions: string[];\n markdownReport: string;\n bibtex: string;\n}\n\n/**\n * Synthesizes academic literature, SOTA matrices, and course theoretical foundations from real retrieved papers\n * and matched CS2023 / CSTA K-12 areas (Zero hardcoded concurrency strings).\n */\nexport class LiteratureReviewSynthesizer {\n synthesize(\n topic: string,\n papers: AcademicPaper[],\n cs2023Area?: CS2023KnowledgeArea,\n k12Strand?: CSTAK12Strand\n ): LiteratureReviewReport {\n const citationManager = new CitationManager();\n const sotaMatrix: SotaComparisonRow[] = [];\n const foundations: string[] = [];\n\n for (const paper of papers) {\n citationManager.addPaper(paper);\n const summaryText =\n paper.tldr?.trim() ||\n (paper.abstract ? paper.abstract.trim().split(/(?<=[.!?])\\s+/)[0] || paper.abstract.slice(0, 160) : '');\n\n sotaMatrix.push({\n approach: paper.title.split(':')[0]?.trim() || paper.title.slice(0, 45),\n sourcePaper: `${paper.authors[0] || 'Unknown'} (${paper.year || 'n.d.'})${paper.venue ? ` — ${paper.venue}` : ''}`,\n keyStrengths: summaryText ? summaryText.slice(0, 180) : `Peer-reviewed study (${paper.citationCount} citations)`,\n limitations: paper.year && paper.year < 2020 ? `Published in ${paper.year}; verify against modern tooling` : 'Requires pedagogical scaffolding for target learners',\n relevanceToCourse: `Grounds \"${topic}\" in peer-reviewed evidence (${paper.fieldsOfStudy.slice(0, 2).join(', ') || 'CS'}).`,\n });\n\n if (summaryText && foundations.length < 4) {\n foundations.push(`[${paper.authors[0] || 'Ref'} ${paper.year || ''}] ${summaryText}`);\n }\n }\n\n if (cs2023Area) {\n foundations.push(\n `IEEE/ACM CS2023 (${cs2023Area.code} - ${cs2023Area.name}): ${cs2023Area.coreTopics.join(', ')}`\n );\n }\n if (k12Strand) {\n foundations.push(\n `CSTA K-12 (${k12Strand.code} - ${k12Strand.name} / ${k12Strand.nameVi}): ${k12Strand.subconcepts.join(', ')}`\n );\n }\n\n const openQuestions: string[] = [\n `How to scaffold core concepts of \"${topic}\" (${cs2023Area?.code || 'CS'}) so learners master mental models before syntax memorization?`,\n `What observable debugging and verification tasks best diagnose learner misconceptions in \"${topic}\"?`,\n ];\n\n const mdLines: string[] = [\n `# 🎓 Academic Literature Review & Theoretical Ground Truth`,\n `> **Topic:** ${topic}`,\n cs2023Area ? `> **IEEE/ACM CS2023 Standard Area:** \\`${cs2023Area.code}\\` — *${cs2023Area.name}*` : '',\n k12Strand ? `> **CSTA K-12 Strand:** \\`${k12Strand.code}\\` — *${k12Strand.name} (${k12Strand.nameVi})*\\n` : '',\n `## 1. Executive Summary`,\n papers.length > 0\n ? `Synthesized from **${papers.length} peer-reviewed works** and curricular standards directly relevant to \\`${topic}\\`.`\n : `No peer-reviewed papers matched directly; aligned to curricular taxonomy standards for \\`${topic}\\`.`,\n `\\n## 2. State-of-the-Art (SOTA) Comparison Matrix`,\n ...(sotaMatrix.length > 0\n ? [\n `| Paradigm / Approach | Source Reference | Core Findings / Abstract | Pedagogical Note | Course Application |`,\n `|---|---|---|---|---|`,\n ...sotaMatrix.map(\n (r) =>\n `| **${r.approach.replace(/\\|/g, '/')}** | ${r.sourcePaper.replace(/\\|/g, '/')} | ${r.keyStrengths.replace(/\\|/g, '/')} | ${r.limitations.replace(/\\|/g, '/')} | ${r.relevanceToCourse.replace(/\\|/g, '/')} |`\n ),\n ]\n : ['*No peer-reviewed papers returned from academic engines for this query.*']),\n `\\n## 3. Core Theoretical & Curricular Foundations`,\n ...foundations.map((f) => `- ${f}`),\n `\\n## 4. Open Pedagogical & Curriculum Design Questions`,\n ...openQuestions.map((q) => `- ${q}`),\n `\\n${citationManager.getMarkdownFootnotes()}`,\n ].filter((line) => line !== '');\n\n return {\n topic,\n cs2023Area,\n k12Strand,\n totalPapersFound: papers.length,\n papers,\n sotaMatrix,\n keyTheoreticalFoundations: foundations,\n openResearchQuestions: openQuestions,\n markdownReport: mdLines.join('\\n'),\n bibtex: citationManager.getBibTeX(),\n };\n }\n\n /**\n * Optional LLM semantic synthesis of dynamic open research questions and pedagogical takeaways\n * based on the retrieved academic literature.\n */\n async synthesizeWithLlm(\n topic: string,\n papers: AcademicPaper[],\n cs2023Area?: CS2023KnowledgeArea,\n k12Strand?: CSTAK12Strand,\n options: { llm?: LlmTextFn; context?: CourseResearchContext } = {}\n ): Promise<LiteratureReviewReport> {\n const base = this.synthesize(topic, papers, cs2023Area, k12Strand);\n if (!options.llm || papers.length === 0) {\n return base;\n }\n\n try {\n const abstractsSummary = papers\n .map((p, i) => `[Paper ${i + 1}] ${p.title} (${p.authors[0]} ${p.year}): ${p.tldr || p.abstract?.slice(0, 300) || 'No abstract'}`)\n .join('\\n\\n');\n\n const prompt = [\n `You are a Professor of Computing Education. Review these academic research papers retrieved for the course topic \"${topic}\".`,\n cs2023Area ? `IEEE/ACM CS2023 Area: ${cs2023Area.code} - ${cs2023Area.name}` : '',\n k12Strand ? `CSTA K-12 Strand: ${k12Strand.code} - ${k12Strand.name}` : '',\n options.context?.ageBand ? `Target Age: ${options.context.ageBand[0]}-${options.context.ageBand[1]}` : '',\n `\\nRetrieved Academic Papers:\\n${abstractsSummary}`,\n `\\nGenerate 2-3 deep, actionable pedagogical research & curriculum design questions directly inspired by these papers.`,\n `Return ONLY a JSON array of strings: [\"Question 1\", \"Question 2\"]`,\n ]\n .filter(Boolean)\n .join('\\n');\n\n const raw = await options.llm(prompt, {\n system: 'You are an educational research synthesis specialist. Output strictly a JSON array of strings.',\n temperature: 0.2,\n jsonMode: true,\n });\n\n const match = raw.match(/\\[[\\s\\S]*\\]/);\n if (match) {\n const parsed = JSON.parse(match[0]);\n if (Array.isArray(parsed) && parsed.length > 0) {\n const dynamicQuestions = parsed.map(String).filter((q) => q.length > 10);\n if (dynamicQuestions.length > 0) {\n base.openResearchQuestions = dynamicQuestions;\n // Update markdown report with the dynamic questions\n base.markdownReport = base.markdownReport.replace(\n /## 4\\. Open Pedagogical & Curriculum Design Questions[\\s\\S]*?(?=\\n\\n\\[\\^|\\n\\n$|$)/,\n `## 4. Open Pedagogical & Curriculum Design Questions\\n${dynamicQuestions.map((q) => `- ${q}`).join('\\n')}`\n );\n }\n }\n }\n } catch (e: any) {\n console.warn('[LiteratureReviewSynthesizer] LLM question synthesis failed, using baseline:', e?.message || e);\n }\n\n return base;\n }\n}\n"]}
@@ -1,5 +1,7 @@
1
1
  'use strict';
2
2
 
3
+ var zod = require('zod');
4
+
3
5
  // src/harvester/domainClassifier.ts
4
6
  var HARDWARE_PATTERNS = [
5
7
  /\b(esp32|esp8266|arduino|raspberry\s*pi|stm32|micro:?bit|mblock|makecode|lego|spike\s*prime|mindstorms|ev3|wedo|vex)\b/i,
@@ -106,19 +108,250 @@ function getExtractorsForDomain(domain) {
106
108
  }
107
109
  }
108
110
 
111
+ // src/academic/arxivClient.ts
112
+ var ArXivSearchEngine = class {
113
+ /**
114
+ * Search ArXiv repository using the public atom XML API
115
+ */
116
+ async search(query, maxResults = 5) {
117
+ const papers = [];
118
+ try {
119
+ const url = `https://export.arxiv.org/api/query?search_query=all:${encodeURIComponent(query)}&start=0&max_results=${maxResults}&sortBy=relevance&sortOrder=descending`;
120
+ const res = await fetch(url, { signal: AbortSignal.timeout(1e4) });
121
+ if (res.ok) {
122
+ const xmlText = await res.text();
123
+ const entryMatches = xmlText.match(/<entry>[\s\S]*?<\/entry>/g) || [];
124
+ for (const entry of entryMatches) {
125
+ const idMatch = entry.match(/<id>([\s\S]*?)<\/id>/);
126
+ const titleMatch = entry.match(/<title>([\s\S]*?)<\/title>/);
127
+ const summaryMatch = entry.match(/<summary>([\s\S]*?)<\/summary>/);
128
+ const publishedMatch = entry.match(/<published>(\d{4})/);
129
+ const authorMatches = [...entry.matchAll(/<author>\s*<name>([\s\S]*?)<\/name>/g)].map((m) => m[1]?.trim()).filter(Boolean);
130
+ const arxivUrl = idMatch ? idMatch[1]?.trim() : "";
131
+ const pdfUrl = arxivUrl ? arxivUrl.replace("/abs/", "/pdf/") + ".pdf" : void 0;
132
+ if (titleMatch) {
133
+ papers.push({
134
+ id: arxivUrl || `arxiv-${Math.random().toString(36).substring(7)}`,
135
+ title: titleMatch[1]?.trim().replace(/\s+/g, " ") || "Untitled ArXiv Paper",
136
+ abstract: summaryMatch ? summaryMatch[1]?.trim().replace(/\s+/g, " ") : "",
137
+ authors: authorMatches,
138
+ year: publishedMatch ? parseInt(publishedMatch[1], 10) : (/* @__PURE__ */ new Date()).getFullYear(),
139
+ citationCount: 0,
140
+ venue: "arXiv preprint",
141
+ url: arxivUrl,
142
+ pdfUrl,
143
+ fieldsOfStudy: ["Computer Science", "AI & Machine Learning"]
144
+ });
145
+ }
146
+ }
147
+ }
148
+ } catch (e) {
149
+ console.warn("[ArXivSearchEngine] ArXiv search failed:", e?.message || e);
150
+ }
151
+ return papers;
152
+ }
153
+ };
154
+
155
+ // src/academic/semanticScholar.ts
156
+ zod.z.object({
157
+ id: zod.z.string(),
158
+ title: zod.z.string(),
159
+ abstract: zod.z.string().optional(),
160
+ authors: zod.z.array(zod.z.string()).default([]),
161
+ year: zod.z.number().optional(),
162
+ citationCount: zod.z.number().default(0),
163
+ venue: zod.z.string().optional(),
164
+ doi: zod.z.string().optional(),
165
+ url: zod.z.string().optional(),
166
+ pdfUrl: zod.z.string().optional(),
167
+ tldr: zod.z.string().optional(),
168
+ fieldsOfStudy: zod.z.array(zod.z.string()).default([])
169
+ });
170
+ function reconstructOpenAlexAbstract(invertedIndex) {
171
+ if (!invertedIndex || typeof invertedIndex !== "object") return void 0;
172
+ const entries = Object.entries(invertedIndex);
173
+ if (entries.length === 0) return void 0;
174
+ let maxIndex = 0;
175
+ for (const [, positions] of entries) {
176
+ if (Array.isArray(positions)) {
177
+ for (const p of positions) {
178
+ if (typeof p === "number" && p > maxIndex) maxIndex = p;
179
+ }
180
+ }
181
+ }
182
+ if (maxIndex > 5e3) maxIndex = 5e3;
183
+ const words = new Array(maxIndex + 1);
184
+ for (const [word, positions] of entries) {
185
+ if (Array.isArray(positions)) {
186
+ for (const p of positions) {
187
+ if (typeof p === "number" && p >= 0 && p <= maxIndex) {
188
+ words[p] = word;
189
+ }
190
+ }
191
+ }
192
+ }
193
+ const reconstructed = words.filter(Boolean).join(" ").trim();
194
+ return reconstructed.length > 0 ? reconstructed : void 0;
195
+ }
196
+ var AcademicSearchEngine = class {
197
+ apiKey;
198
+ allowEnvFallback;
199
+ customAdapter;
200
+ arxivEngine;
201
+ constructor(options = {}) {
202
+ this.arxivEngine = new ArXivSearchEngine();
203
+ if (typeof options === "string") {
204
+ this.apiKey = options;
205
+ this.allowEnvFallback = true;
206
+ } else {
207
+ this.allowEnvFallback = options.allowEnvFallback ?? true;
208
+ this.apiKey = options.apiKey || (this.allowEnvFallback ? process.env.SEMANTIC_SCHOLAR_API_KEY : void 0);
209
+ this.customAdapter = options.customAdapter;
210
+ }
211
+ }
212
+ setCustomAdapter(adapter) {
213
+ this.customAdapter = adapter;
214
+ }
215
+ setApiKey(apiKey) {
216
+ this.apiKey = apiKey;
217
+ }
218
+ /**
219
+ * Search academic papers across Semantic Scholar with OpenAlex and ArXiv fallback or Custom Adapter
220
+ */
221
+ async searchPapers(query, options = {}) {
222
+ const adapter = options.customAdapter || this.customAdapter;
223
+ if (adapter) {
224
+ try {
225
+ const customPapers = await adapter.searchPapers(query, { limit: options.limit, yearRange: options.yearRange });
226
+ if (Array.isArray(customPapers) && customPapers.length > 0) {
227
+ return customPapers;
228
+ }
229
+ } catch (e) {
230
+ console.warn("[AcademicSearchEngine] Custom academic adapter failed:", e?.message || e);
231
+ }
232
+ }
233
+ const limit = options.limit ?? 5;
234
+ const papers = [];
235
+ const seenTitles = /* @__PURE__ */ new Set();
236
+ const pushUnique = (p) => {
237
+ const normTitle = p.title.toLowerCase().replace(/[^a-z0-9\u00C0-\u1EF9]+/g, "");
238
+ if (!normTitle || seenTitles.has(normTitle)) return;
239
+ seenTitles.add(normTitle);
240
+ papers.push(p);
241
+ };
242
+ try {
243
+ const apiKey = options.apiKey || this.apiKey;
244
+ const headers = { "Content-Type": "application/json" };
245
+ if (apiKey) {
246
+ headers["x-api-key"] = apiKey;
247
+ }
248
+ const params = new URLSearchParams({
249
+ query,
250
+ limit: limit.toString(),
251
+ fields: "paperId,title,abstract,authors,year,citationCount,venue,externalIds,url,openAccessPdf,tldr,fieldsOfStudy"
252
+ });
253
+ if (options.yearRange) {
254
+ params.append("year", options.yearRange);
255
+ }
256
+ const res = await fetch(`https://api.semanticscholar.org/graph/v1/paper/search?${params.toString()}`, {
257
+ headers,
258
+ signal: AbortSignal.timeout(6e3)
259
+ });
260
+ if (res.ok) {
261
+ const data = await res.json();
262
+ if (Array.isArray(data?.data)) {
263
+ for (const item of data.data) {
264
+ pushUnique({
265
+ id: item.paperId || `s2-${Math.random().toString(36).slice(2, 8)}`,
266
+ title: item.title || "Untitled",
267
+ abstract: item.abstract || void 0,
268
+ authors: Array.isArray(item.authors) ? item.authors.map((a) => a.name).filter(Boolean) : [],
269
+ year: item.year,
270
+ citationCount: item.citationCount || 0,
271
+ venue: item.venue || void 0,
272
+ doi: item.externalIds?.DOI,
273
+ url: item.url || (item.externalIds?.DOI ? `https://doi.org/${item.externalIds.DOI}` : void 0),
274
+ pdfUrl: item.openAccessPdf?.url,
275
+ tldr: item.tldr?.text,
276
+ fieldsOfStudy: Array.isArray(item.fieldsOfStudy) && item.fieldsOfStudy.length > 0 ? item.fieldsOfStudy : ["Computer Science"]
277
+ });
278
+ }
279
+ if (papers.length >= limit) return papers.slice(0, limit);
280
+ }
281
+ }
282
+ } catch (e) {
283
+ console.warn("[AcademicSearchEngine] Semantic Scholar failed:", e?.message || e);
284
+ }
285
+ if (papers.length < limit) {
286
+ try {
287
+ const res = await fetch(`https://api.openalex.org/works?search=${encodeURIComponent(query)}&per-page=${limit}`, {
288
+ headers: { "User-Agent": "OrchableComposer/1.0 (mailto:team@orchable.app)" },
289
+ signal: AbortSignal.timeout(6e3)
290
+ });
291
+ if (res.ok) {
292
+ const data = await res.json();
293
+ if (Array.isArray(data?.results)) {
294
+ for (const item of data.results) {
295
+ const abstractText = reconstructOpenAlexAbstract(item.abstract_inverted_index);
296
+ const concepts = Array.isArray(item.concepts) ? item.concepts.slice(0, 3).map((c) => c.display_name).filter(Boolean) : ["Computer Science"];
297
+ pushUnique({
298
+ id: item.id || `oa-${Math.random().toString(36).slice(2, 8)}`,
299
+ title: item.title || "Untitled",
300
+ abstract: abstractText,
301
+ authors: Array.isArray(item.authorships) ? item.authorships.map((a) => a.author?.display_name).filter(Boolean) : [],
302
+ year: item.publication_year,
303
+ citationCount: item.cited_by_count || 0,
304
+ venue: item.primary_location?.source?.display_name,
305
+ doi: item.doi ? String(item.doi).replace(/^https?:\/\/doi\.org\//i, "") : void 0,
306
+ url: item.doi || item.id,
307
+ pdfUrl: item.open_access?.oa_url,
308
+ fieldsOfStudy: concepts.length > 0 ? concepts : ["Computer Science"]
309
+ });
310
+ }
311
+ }
312
+ }
313
+ } catch (e) {
314
+ console.warn("[AcademicSearchEngine] OpenAlex failed:", e?.message || e);
315
+ }
316
+ }
317
+ if (papers.length < limit && options.includeArxivFallback !== false) {
318
+ try {
319
+ const arxivPapers = await this.arxivEngine.search(query, limit - papers.length);
320
+ for (const p of arxivPapers) {
321
+ pushUnique(p);
322
+ }
323
+ } catch (e) {
324
+ console.warn("[AcademicSearchEngine] ArXiv fallback failed:", e?.message || e);
325
+ }
326
+ }
327
+ return papers.slice(0, limit);
328
+ }
329
+ };
330
+
109
331
  // src/harvester/multiSourceSearch.ts
110
332
  var MultiSourceSearchEngine = class {
111
333
  tavilyKey;
112
334
  exaKey;
113
335
  serperKey;
336
+ searxngHost;
337
+ searxngHeaders;
114
338
  allowEnvFallback;
115
339
  customAdapter;
340
+ academicEngine;
116
341
  constructor(options = {}) {
117
342
  this.allowEnvFallback = options.allowEnvFallback ?? true;
118
343
  this.tavilyKey = options.apiKeys?.tavily || options.tavilyKey || (this.allowEnvFallback ? process.env.TAVILY_API_KEY : void 0);
119
344
  this.exaKey = options.apiKeys?.exa || options.exaKey || (this.allowEnvFallback ? process.env.EXA_API_KEY : void 0);
120
345
  this.serperKey = options.apiKeys?.serper || options.serperKey || (this.allowEnvFallback ? process.env.SERPER_API_KEY : void 0);
346
+ this.searxngHost = options.searxngHost || (this.allowEnvFallback ? process.env.SEARXNG_URL || process.env.SEARXNG_HOST : void 0);
347
+ const cfId = process.env.CF_ACCESS_CLIENT_ID;
348
+ const cfSecret = process.env.CF_ACCESS_CLIENT_SECRET;
349
+ this.searxngHeaders = {
350
+ ...options.searxngHeaders || {},
351
+ ...cfId && cfSecret ? { "CF-Access-Client-Id": cfId, "CF-Access-Client-Secret": cfSecret } : {}
352
+ };
121
353
  this.customAdapter = options.customAdapter;
354
+ this.academicEngine = new AcademicSearchEngine({ allowEnvFallback: this.allowEnvFallback });
122
355
  }
123
356
  setCustomAdapter(adapter) {
124
357
  this.customAdapter = adapter;
@@ -128,6 +361,12 @@ var MultiSourceSearchEngine = class {
128
361
  if (keys.exa !== void 0) this.exaKey = keys.exa;
129
362
  if (keys.serper !== void 0) this.serperKey = keys.serper;
130
363
  }
364
+ setSearxng(host, headers) {
365
+ this.searxngHost = host;
366
+ if (headers) {
367
+ this.searxngHeaders = { ...this.searxngHeaders, ...headers };
368
+ }
369
+ }
131
370
  async search(query, options = {}) {
132
371
  const limit = options.limit ?? 5;
133
372
  const adapter = options.customAdapter || this.customAdapter;
@@ -148,9 +387,30 @@ var MultiSourceSearchEngine = class {
148
387
  console.warn("[MultiSourceSearchEngine] Custom search adapter failed:", e?.message || e);
149
388
  }
150
389
  }
390
+ if (preferred === "academic") {
391
+ try {
392
+ const papers = await this.academicEngine.searchPapers(query, { limit });
393
+ if (papers.length > 0) {
394
+ return papers.map((p) => ({
395
+ title: p.title,
396
+ url: p.url || p.pdfUrl || (p.doi ? `https://doi.org/${p.doi}` : `https://openalex.org/${p.id}`),
397
+ content: p.tldr || p.abstract || "",
398
+ score: p.citationCount,
399
+ engine: "academic"
400
+ }));
401
+ }
402
+ } catch (e) {
403
+ console.warn("[MultiSourceSearchEngine] Academic search failed:", e?.message || e);
404
+ }
405
+ }
151
406
  const tavilyKey = options.apiKeys?.tavily || options.tavilyKey || this.tavilyKey;
152
407
  const exaKey = options.apiKeys?.exa || options.exaKey || this.exaKey;
153
408
  const serperKey = options.apiKeys?.serper || options.serperKey || this.serperKey;
409
+ const searxngHost = options.searxngHost || this.searxngHost;
410
+ if (preferred === "searxng" && searxngHost) {
411
+ const searxHits = await this.querySearxng(query, searxngHost, limit, options.searxngHeaders);
412
+ if (searxHits.length > 0) return searxHits;
413
+ }
154
414
  if (preferred === "exa" && exaKey) {
155
415
  const exaHits = await this.queryExa(query, exaKey, limit, options.domainFilter);
156
416
  if (exaHits.length > 0) return exaHits;
@@ -205,10 +465,44 @@ var MultiSourceSearchEngine = class {
205
465
  const serperHits = await this.querySerper(query, serperKey, limit);
206
466
  if (serperHits.length > 0) return serperHits;
207
467
  }
468
+ if (searxngHost) {
469
+ const searxHits = await this.querySearxng(query, searxngHost, limit, options.searxngHeaders);
470
+ if (searxHits.length > 0) return searxHits;
471
+ }
208
472
  const ddgHits = await this.queryDuckDuckGo(query, limit);
209
473
  if (ddgHits.length > 0) return ddgHits;
210
474
  return [];
211
475
  }
476
+ async querySearxng(query, searxngHost, limit, customHeaders) {
477
+ try {
478
+ const cleanHost = searxngHost.replace(/\/$/, "");
479
+ const searchUrl = `${cleanHost}/search?q=${encodeURIComponent(query)}&format=json`;
480
+ const headers = {
481
+ "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)",
482
+ ...this.searxngHeaders || {},
483
+ ...customHeaders || {}
484
+ };
485
+ const res = await fetch(searchUrl, {
486
+ headers,
487
+ signal: AbortSignal.timeout(1e4)
488
+ });
489
+ if (res.ok) {
490
+ const data = await res.json();
491
+ if (Array.isArray(data?.results) && data.results.length > 0) {
492
+ return data.results.slice(0, limit).map((r) => ({
493
+ title: r.title || "Untitled",
494
+ url: r.url,
495
+ content: r.content || r.snippet || "",
496
+ score: r.score,
497
+ engine: "searxng"
498
+ }));
499
+ }
500
+ }
501
+ } catch (e) {
502
+ console.warn("[MultiSourceSearchEngine] SearXNG attempt failed:", e?.message || e);
503
+ }
504
+ return [];
505
+ }
212
506
  async queryExa(query, exaKey, limit, domainFilter) {
213
507
  try {
214
508
  const body = {