@nahisaho/katashiro-collector 0.2.2 → 0.2.4

package/dist/research/WideResearchEngine.d.ts

@@ -0,0 +1,110 @@
+/**
+ * WideResearchEngine - 広域リサーチエンジン
+ *
+ * 複数の検索エージェントを並列実行し、多様なソースから情報を収集・統合する。
+ *
+ * @requirement REQ-COLLECT-008
+ * @design DES-COLLECT-008
+ * @task TASK-002
+ */
+import { type Result } from '@nahisaho/katashiro-core';
+import { EventEmitter } from 'events';
+import type { WideResearchQuery, WideResearchResult, ResearchError, SourceType, AgentConfig } from './types.js';
+import type { ISearchAgent } from './agents/types.js';
+/**
+ * Wide Research Engine
+ *
+ * 複数のソースから並列に情報を収集し、統合された結果を返す。
+ *
+ * @example
+ * ```typescript
+ * const engine = new WideResearchEngine();
+ *
+ * // 基本的な使用
+ * const result = await engine.research({
+ *   topic: 'AI ethics in healthcare',
+ *   depth: 'medium',
+ * });
+ *
+ * if (isOk(result)) {
+ *   console.log(`Found ${result.value.findings.length} results`);
+ *   console.log(`Coverage: ${result.value.coverage.coverageRate * 100}%`);
+ * }
+ *
+ * // 特定ソースのみ使用
+ * const newsResult = await engine.research({
+ *   topic: 'latest AI regulations',
+ *   depth: 'shallow',
+ *   sources: ['news'],
+ *   dateRange: { start: new Date('2025-01-01') },
+ * });
+ *
+ * // イベントリスナーで進捗を監視
+ * engine.on('agentStarted', (agent) => console.log(`Started: ${agent}`));
+ * engine.on('agentCompleted', (agent, count) => console.log(`Completed: ${agent} (${count} results)`));
+ * engine.on('agentFailed', (agent, error) => console.error(`Failed: ${agent}: ${error}`));
+ * ```
+ *
+ * @events
+ * - `agentStarted(type: SourceType)` - エージェント開始時
+ * - `agentCompleted(type: SourceType, count: number)` - エージェント完了時
+ * - `agentFailed(type: SourceType, error: string)` - エージェント失敗時
+ * - `totalTimeout()` - 全体タイムアウト発生時
+ */
+export declare class WideResearchEngine extends EventEmitter {
+    private agents;
+    private agentConfigs;
+    private queryPlanner;
+    private resultAggregator;
+    private coverageAnalyzer;
+    constructor(configs?: Partial<Record<SourceType, Partial<AgentConfig>>>);
+    /**
+     * デフォルトエージェントを登録
+     */
+    private registerDefaultAgents;
+    /**
+     * カスタムエージェントを登録
+     */
+    registerAgent(agent: ISearchAgent): void;
+    /**
+     * エージェント設定を更新
+     */
+    configure(configs: Partial<Record<SourceType, Partial<AgentConfig>>>): void;
+    /**
+     * 登録済みエージェント一覧を取得
+     */
+    getAvailableAgents(): SourceType[];
+    /**
+     * Wide Research を実行
+     */
+    research(query: WideResearchQuery): Promise<Result<WideResearchResult, ResearchError>>;
+    /**
+     * 設定をマージ
+     */
+    private mergeConfig;
+    /**
+     * 使用するエージェントを選択
+     */
+    private selectAgents;
+    /**
+     * 並列検索を実行
+     */
+    private executeParallelSearch;
+    /**
+     * バッチに分割
+     */
+    private createBatches;
+    /**
+     * ソース情報を生成
+     */
+    private buildSourceInfos;
+    /**
+     * 統計情報を計算
+     */
+    private calculateStatistics;
+    /**
+     * 完了ステータスを決定
+     */
+    private determineCompletionStatus;
+}
+//# sourceMappingURL=WideResearchEngine.d.ts.map

package/dist/research/WideResearchEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WideResearchEngine.d.ts","sourceRoot":"","sources":["../../src/research/WideResearchEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EAIb,UAAU,EACV,WAAW,EAEZ,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,YAAY,EAA2C,MAAM,mBAAmB,CAAC;AAS/F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,gBAAgB,CAAmB;gBAE/B,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IAevE;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAiB7B;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAIxC;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IAW3E;;OAEG;IACH,kBAAkB,IAAI,UAAU,EAAE;IAIlC;;OAEG;IACG,QAAQ,CACZ,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC;IAsFrD;;OAEG;IACH,OAAO,CAAC,WAAW;IAcnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;OAEG;YACW,qBAAqB;IA4EnC;;OAEG;IACH,OAAO,CAAC,aAAa;IAQrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAexB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA8B3B;;OAEG;IACH,OAAO,CAAC,yBAAyB;CAYlC"}

package/dist/research/WideResearchEngine.js

@@ -0,0 +1,330 @@
+/**
+ * WideResearchEngine - 広域リサーチエンジン
+ *
+ * 複数の検索エージェントを並列実行し、多様なソースから情報を収集・統合する。
+ *
+ * @requirement REQ-COLLECT-008
+ * @design DES-COLLECT-008
+ * @task TASK-002
+ */
+import { ok, err } from '@nahisaho/katashiro-core';
+import { EventEmitter } from 'events';
+import { DEFAULT_RESEARCH_CONFIG } from './types.js';
+import { WebSearchAgent } from './agents/WebSearchAgent.js';
+import { NewsSearchAgent } from './agents/NewsSearchAgent.js';
+import { AcademicSearchAgent } from './agents/AcademicSearchAgent.js';
+import { EncyclopediaAgent } from './agents/EncyclopediaAgent.js';
+import { ResultAggregator } from './ResultAggregator.js';
+import { CoverageAnalyzer } from './CoverageAnalyzer.js';
+import { QueryPlanner } from './QueryPlanner.js';
+/**
+ * Wide Research Engine
+ *
+ * 複数のソースから並列に情報を収集し、統合された結果を返す。
+ *
+ * @example
+ * ```typescript
+ * const engine = new WideResearchEngine();
+ *
+ * // 基本的な使用
+ * const result = await engine.research({
+ *   topic: 'AI ethics in healthcare',
+ *   depth: 'medium',
+ * });
+ *
+ * if (isOk(result)) {
+ *   console.log(`Found ${result.value.findings.length} results`);
+ *   console.log(`Coverage: ${result.value.coverage.coverageRate * 100}%`);
+ * }
+ *
+ * // 特定ソースのみ使用
+ * const newsResult = await engine.research({
+ *   topic: 'latest AI regulations',
+ *   depth: 'shallow',
+ *   sources: ['news'],
+ *   dateRange: { start: new Date('2025-01-01') },
+ * });
+ *
+ * // イベントリスナーで進捗を監視
+ * engine.on('agentStarted', (agent) => console.log(`Started: ${agent}`));
+ * engine.on('agentCompleted', (agent, count) => console.log(`Completed: ${agent} (${count} results)`));
+ * engine.on('agentFailed', (agent, error) => console.error(`Failed: ${agent}: ${error}`));
+ * ```
+ *
+ * @events
+ * - `agentStarted(type: SourceType)` - エージェント開始時
+ * - `agentCompleted(type: SourceType, count: number)` - エージェント完了時
+ * - `agentFailed(type: SourceType, error: string)` - エージェント失敗時
+ * - `totalTimeout()` - 全体タイムアウト発生時
+ */
+export class WideResearchEngine extends EventEmitter {
+    agents;
+    agentConfigs;
+    queryPlanner;
+    resultAggregator;
+    coverageAnalyzer;
+    constructor(configs) {
+        super();
+        this.agents = new Map();
+        this.agentConfigs = new Map();
+        this.queryPlanner = new QueryPlanner();
+        this.resultAggregator = new ResultAggregator();
+        this.coverageAnalyzer = new CoverageAnalyzer();
+        this.registerDefaultAgents();
+        if (configs) {
+            this.configure(configs);
+        }
+    }
+    /**
+     * デフォルトエージェントを登録
+     */
+    registerDefaultAgents() {
+        this.registerAgent(new WebSearchAgent());
+        this.registerAgent(new NewsSearchAgent());
+        this.registerAgent(new AcademicSearchAgent());
+        this.registerAgent(new EncyclopediaAgent());
+        // デフォルト設定
+        const defaultTypes = ['web', 'news', 'academic', 'encyclopedia'];
+        defaultTypes.forEach((type, index) => {
+            this.agentConfigs.set(type, {
+                type,
+                enabled: true,
+                priority: index + 1,
+            });
+        });
+    }
+    /**
+     * カスタムエージェントを登録
+     */
+    registerAgent(agent) {
+        this.agents.set(agent.type, agent);
+    }
+    /**
+     * エージェント設定を更新
+     */
+    configure(configs) {
+        for (const [type, config] of Object.entries(configs)) {
+            const existing = this.agentConfigs.get(type) || {
+                type: type,
+                enabled: true,
+                priority: 99,
+            };
+            this.agentConfigs.set(type, { ...existing, ...config });
+        }
+    }
+    /**
+     * 登録済みエージェント一覧を取得
+     */
+    getAvailableAgents() {
+        return Array.from(this.agents.keys());
+    }
+    /**
+     * Wide Research を実行
+     */
+    async research(query) {
+        const startTime = Date.now();
+        // クエリ検証
+        if (!query.topic || query.topic.trim().length === 0) {
+            return err({
+                code: 'INVALID_QUERY',
+                message: 'Topic is required',
+            });
+        }
+        // 設定のマージ
+        const config = this.mergeConfig(query);
+        // 使用するエージェントを決定
+        const selectedAgents = this.selectAgents(config);
+        if (selectedAgents.length === 0) {
+            return err({
+                code: 'CONFIGURATION_ERROR',
+                message: 'No agents available for the specified sources',
+            });
+        }
+        // クエリ計画を作成
+        const queryPlan = this.queryPlanner.plan(query, selectedAgents, {
+            agentTimeout: config.agentTimeout,
+            maxResultsPerSource: config.maxResultsPerSource,
+        });
+        // 並列検索を実行
+        const agentResults = await this.executeParallelSearch(queryPlan, config.maxParallelAgents, config.totalTimeout);
+        // 全エージェント失敗チェック
+        const successfulResults = agentResults.filter((r) => r.result.status !== 'failed' && r.result.status !== 'timeout');
+        if (successfulResults.length === 0) {
+            return err({
+                code: 'ALL_SOURCES_FAILED',
+                message: 'All search agents failed',
+                details: agentResults.map((r) => ({
+                    agent: r.agent.type,
+                    error: r.result.error,
+                })),
+            });
+        }
+        // 結果を集約
+        const aggregated = this.resultAggregator.aggregate(agentResults.map((r) => r.result), query.topic);
+        // ソース情報を生成
+        const sourceInfos = this.buildSourceInfos(agentResults, queryPlan);
+        // カバレッジ分析
+        const coverage = this.coverageAnalyzer.analyze(agentResults, selectedAgents.map((a) => a.type));
+        // 統計情報を計算
+        const statistics = this.calculateStatistics(aggregated, agentResults);
+        // 完了ステータスを決定
+        const completionStatus = this.determineCompletionStatus(agentResults, selectedAgents.length);
+        return ok({
+            findings: aggregated,
+            sources: sourceInfos,
+            coverage,
+            completionStatus,
+            statistics,
+            processingTime: Date.now() - startTime,
+        });
+    }
+    /**
+     * 設定をマージ
+     */
+    mergeConfig(query) {
+        const depthConfig = DEFAULT_RESEARCH_CONFIG.depthConfig[query.depth];
+        return {
+            maxParallelAgents: query.maxParallelAgents ?? DEFAULT_RESEARCH_CONFIG.maxParallelAgents,
+            agentTimeout: query.agentTimeout ?? DEFAULT_RESEARCH_CONFIG.agentTimeout,
+            totalTimeout: query.totalTimeout ?? DEFAULT_RESEARCH_CONFIG.totalTimeout,
+            maxResultsPerSource: query.maxResultsPerSource ?? depthConfig.maxResults,
+            sources: query.sources ?? depthConfig.sources,
+        };
+    }
+    /**
+     * 使用するエージェントを選択
+     */
+    selectAgents(config) {
+        return config.sources
+            .map((type) => {
+            const agentConfig = this.agentConfigs.get(type);
+            if (!agentConfig?.enabled)
+                return null;
+            return this.agents.get(type) ?? null;
+        })
+            .filter((agent) => agent !== null)
+            .sort((a, b) => {
+            const aConfig = this.agentConfigs.get(a.type);
+            const bConfig = this.agentConfigs.get(b.type);
+            return (aConfig?.priority ?? 99) - (bConfig?.priority ?? 99);
+        });
+    }
+    /**
+     * 並列検索を実行
+     */
+    async executeParallelSearch(queryPlan, maxParallel, totalTimeout) {
+        const results = [];
+        const agents = queryPlan.agents;
+        // 並列実行（バッチ処理）
+        const batches = this.createBatches(agents, maxParallel);
+        const timeoutPromise = new Promise((resolve) => {
+            setTimeout(() => resolve('timeout'), totalTimeout);
+        });
+        for (const batch of batches) {
+            const batchPromises = batch.map(async (agent) => {
+                this.emit('agentStarted', agent.type);
+                const startTime = Date.now();
+                const agentQuery = queryPlan.queries.get(agent.type);
+                if (!agentQuery) {
+                    return {
+                        agent,
+                        result: {
+                            findings: [],
+                            status: 'failed',
+                            error: 'No query found for agent',
+                            processingTime: 0,
+                        },
+                    };
+                }
+                try {
+                    const result = await Promise.race([
+                        agent.search(agentQuery),
+                        new Promise((_, reject) => {
+                            setTimeout(() => reject(new Error('Agent timeout')), queryPlan.timeout);
+                        }),
+                    ]);
+                    this.emit('agentCompleted', agent.type, result.findings.length);
+                    return { agent, result };
+                }
+                catch (error) {
+                    const errorResult = {
+                        findings: [],
+                        status: 'timeout',
+                        error: error.message,
+                        processingTime: Date.now() - startTime,
+                    };
+                    this.emit('agentFailed', agent.type, error.message);
+                    return { agent, result: errorResult };
+                }
+            });
+            const raceResult = await Promise.race([
+                Promise.all(batchPromises),
+                timeoutPromise,
+            ]);
+            if (raceResult === 'timeout') {
+                // タイムアウト時は収集済み結果を返す
+                this.emit('totalTimeout');
+                break;
+            }
+            results.push(...raceResult);
+        }
+        return results;
+    }
+    /**
+     * バッチに分割
+     */
+    createBatches(items, batchSize) {
+        const batches = [];
+        for (let i = 0; i < items.length; i += batchSize) {
+            batches.push(items.slice(i, i + batchSize));
+        }
+        return batches;
+    }
+    /**
+     * ソース情報を生成
+     */
+    buildSourceInfos(results, queryPlan) {
+        return results.map(({ agent, result }) => ({
+            type: agent.type,
+            name: agent.name,
+            query: queryPlan.queries.get(agent.type)?.query ?? '',
+            resultCount: result.findings.length,
+            status: result.status,
+            error: result.error,
+            processingTime: result.processingTime,
+        }));
+    }
+    /**
+     * 統計情報を計算
+     */
+    calculateStatistics(findings, results) {
+        const resultsBySource = {};
+        for (const { agent, result } of results) {
+            resultsBySource[agent.type] = result.findings.length;
+        }
+        const totalResults = results.reduce((sum, r) => sum + r.result.findings.length, 0);
+        return {
+            totalResults,
+            uniqueResults: findings.length,
+            resultsBySource,
+            averageRelevance: findings.length > 0
+                ? findings.reduce((sum, f) => sum + f.relevanceScore, 0) / findings.length
+                : 0,
+            averageCredibility: findings.length > 0
+                ? findings.reduce((sum, f) => sum + f.credibilityScore, 0) / findings.length
+                : 0,
+        };
+    }
+    /**
+     * 完了ステータスを決定
+     */
+    determineCompletionStatus(results, expectedCount) {
+        const successCount = results.filter((r) => r.result.status === 'success').length;
+        if (successCount === expectedCount)
+            return 'full';
+        if (successCount > 0)
+            return 'partial';
+        return 'failed';
+    }
+}
+//# sourceMappingURL=WideResearchEngine.js.map

package/dist/research/WideResearchEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WideResearchEngine.js","sourceRoot":"","sources":["../../src/research/WideResearchEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,EAAE,EAAE,GAAG,EAAe,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAYtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAkB,MAAM,mBAAmB,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAC1C,MAAM,CAAgC;IACtC,YAAY,CAA+B;IAC3C,YAAY,CAAe;IAC3B,gBAAgB,CAAmB;IACnC,gBAAgB,CAAmB;IAE3C,YAAY,OAA2D;QACrE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,YAAY,GAAG,IAAI,GAAG,EAAE,CAAC;QAC9B,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;QACvC,IAAI,CAAC,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC;QAC/C,IAAI,CAAC,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC;QAE/C,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAE7B,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;OAEG;IACK,qBAAqB;QAC3B,IAAI,CAAC,aAAa,CAAC,IAAI,cAAc,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,aAAa,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,aAAa,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,aAAa,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC;QAE5C,UAAU;QACV,MAAM,YAAY,GAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;QAC/E,YAAY,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YACnC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE;gBAC1B,IAAI;gBACJ,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,KAAK,GAAG,CAAC;aACpB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,KAAmB;QAC/B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,OAA0D;QAClE,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAkB,CAAC,IAAI;gBAC5D,IAAI,EAAE,IAAkB;gBACxB,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,EAAE;aACb,CAAC;YACF,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAkB,EAAE,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CACZ,KAAwB;QAExB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,QAAQ;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,OAAO,GAAG,CAAC;gBACT,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,mBAAmB;aAC7B,CAAC,CAAC;QACL,CAAC;QAED,SAAS;QACT,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAEvC,gBAAgB;QAChB,MAAM,cAAc,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAEjD,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO,GAAG,CAAC;gBACT,IAAI,EAAE,qBAAqB;gBAC3B,OAAO,EAAE,+CAA+C;aACzD,CAAC,CAAC;QACL,CAAC;QAED,WAAW;QACX,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,cAAc,EAAE;YAC9D,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;SAChD,CAAC,CAAC;QAEH,UAAU;QACV,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,qBAAqB,CACnD,SAAS,EACT,MAAM,CAAC,iBAAiB,EACxB,MAAM,CAAC,YAAY,CACpB,CAAC;QAEF,gBAAgB;QAChB,MAAM,iBAAiB,GAAG,YAAY,CAAC,MAAM,CAC3C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CACrE,CAAC;QACF,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnC,OAAO,GAAG,CAAC;gBACT,IAAI,EAAE,oBAAoB;gBAC1B,OAAO,EAAE,0BAA0B;gBACnC,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAChC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI;oBACnB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK;iBACtB,CAAC,CAAC;aACJ,CAAC,CAAC;QACL,CAAC;QAED,QAAQ;QACR,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAChD,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EACjC,KAAK,CAAC,KAAK,CACZ,CAAC;QAEF,WAAW;QACX,MAAM,WAAW,GAAG,IAAI,CAAC,gBAAgB,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;QAEnE,UAAU;QACV,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAC5C,YAAY,EACZ,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAClC,CAAC;QAEF,UAAU;QACV,MAAM,UAAU,GAAG,IAAI,CAAC,mBAAmB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAEtE,aAAa;QACb,MAAM,gBAAgB,GAAG,IAAI,CAAC,yBAAyB,CACrD,YAAY,EACZ,cAAc,CAAC,MAAM,CACtB,CAAC;QAEF,OAAO,EAAE,CAAC;YACR,QAAQ,EAAE,UAAU;YACpB,OAAO,EAAE,WAAW;YACpB,QAAQ;YACR,gBAAgB;YAChB,UAAU;YACV,cAAc,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACvC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,KAAwB;QAC1C,MAAM,WAAW,GAAG,uBAAuB,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAErE,OAAO;YACL,iBAAiB,EACf,KAAK,CAAC,iBAAiB,IAAI,uBAAuB,CAAC,iBAAiB;YACtE,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,uBAAuB,CAAC,YAAY;YACxE,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,uBAAuB,CAAC,YAAY;YACxE,mBAAmB,EACjB,KAAK,CAAC,mBAAmB,IAAI,WAAW,CAAC,UAAU;YACrD,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,WAAW,CAAC,OAAO;SAC9C,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,MAAiC;QACpD,OAAO,MAAM,CAAC,OAAO;aAClB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACZ,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAChD,IAAI,CAAC,WAAW,EAAE,OAAO;gBAAE,OAAO,IAAI,CAAC;YACvC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;QACvC,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,KAAK,EAAyB,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC;aACxD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACb,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC9C,OAAO,CAAC,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,qBAAqB,CACjC,SAAoB,EACpB,WAAmB,EACnB,YAAoB;QAEpB,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;QAEhC,cAAc;QACd,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAExD,MAAM,cAAc,GAAG,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,EAAE;YACxD,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QAEH,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,aAAa,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;gBAC9C,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBACtC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC7B,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAErD,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChB,OAAO;wBACL,KAAK;wBACL,MAAM,EAAE;4BACN,QAAQ,EAAE,EAAE;4BACZ,MAAM,EAAE,QAAiB;4BACzB,KAAK,EAAE,0BAA0B;4BACjC,cAAc,EAAE,CAAC;yBAClB;qBACF,CAAC;gBACJ,CAAC;gBAED,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;wBAChC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC;wBACxB,IAAI,OAAO,CAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;4BAC3C,UAAU,CACR,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,EACxC,SAAS,CAAC,OAAO,CAClB,CAAC;wBACJ,CAAC,CAAC;qBACH,CAAC,CAAC;oBAEH,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;oBAChE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;gBAC3B,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,WAAW,GAAsB;wBACrC,QAAQ,EAAE,EAAE;wBACZ,MAAM,EAAE,SAAS;wBACjB,KAAK,EAAG,KAAe,CAAC,OAAO;wBAC/B,cAAc,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;qBACvC,CAAC;oBAEF,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;oBAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;gBACxC,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;gBACpC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;gBAC1B,cAAc;aACf,CAAC,CAAC;YAEH,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7B,oBAAoB;gBACpB,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;gBAC1B,MAAM;YACR,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,aAAa,CAAI,KAAU,EAAE,SAAiB;QACpD,MAAM,OAAO,GAAU,EAAE,CAAC;QAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;YACjD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,gBAAgB,CACtB,OAA+B,EAC/B,SAAoB;QAEpB,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;YACzC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,EAAE;YACrD,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;YACnC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,cAAc,EAAE,MAAM,CAAC,cAAc;SACtC,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;OAEG;IACK,mBAAmB,CACzB,QAAmB,EACnB,OAA+B;QAE/B,MAAM,eAAe,GAAwC,EAAE,CAAC;QAEhE,KAAK,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;YACxC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QACvD,CAAC;QAED,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CACjC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAC1C,CAAC,CACF,CAAC;QAEF,OAAO;YACL,YAAY;YACZ,aAAa,EAAE,QAAQ,CAAC,MAAM;YAC9B,eAAe;YACf,gBAAgB,EACd,QAAQ,CAAC,MAAM,GAAG,CAAC;gBACjB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM;gBAC1E,CAAC,CAAC,CAAC;YACP,kBAAkB,EAChB,QAAQ,CAAC,MAAM,GAAG,CAAC;gBACjB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM;gBAC5E,CAAC,CAAC,CAAC;SACR,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,yBAAyB,CAC/B,OAA+B,EAC/B,aAAqB;QAErB,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CACjC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CACrC,CAAC,MAAM,CAAC;QAET,IAAI,YAAY,KAAK,aAAa;YAAE,OAAO,MAAM,CAAC;QAClD,IAAI,YAAY,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QACvC,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/research/agents/AcademicSearchAgent.d.ts

@@ -0,0 +1,57 @@
+/**
+ * AcademicSearchAgent - 学術論文検索エージェント
+ *
+ * arXiv、CrossRef、Semantic Scholarなどの学術APIを使用。
+ * 現在はarXiv APIを実装。
+ *
+ * @requirement REQ-COLLECT-008
+ * @design DES-COLLECT-008
+ * @task TASK-002
+ */
+import type { ISearchAgent, AgentSearchQuery, AgentSearchResult } from './types.js';
+import type { SourceType } from '../types.js';
+/**
+ * 学術論文検索エージェント
+ *
+ * @example
+ * ```typescript
+ * const agent = new AcademicSearchAgent();
+ * const result = await agent.search({
+ *   query: 'machine learning',
+ *   maxResults: 10,
+ *   timeout: 30000,
+ * });
+ * ```
+ */
+export declare class AcademicSearchAgent implements ISearchAgent {
+    readonly type: SourceType;
+    readonly name = "Academic Search (arXiv)";
+    private readonly arxivApiUrl;
+    search(query: AgentSearchQuery): Promise<AgentSearchResult>;
+    isAvailable(): Promise<boolean>;
+    /**
+     * arXiv APIで検索
+     */
+    private searchArxiv;
+    /**
+     * arXiv XMLレスポンスをパース
+     */
+    private parseArxivResponse;
+    /**
+     * XMLタグの内容を抽出
+     */
+    private extractXmlTag;
+    /**
+     * 著者を抽出
+     */
+    private extractAuthors;
+    /**
+     * カテゴリを抽出
+     */
+    private extractCategory;
+    /**
+     * 関連性スコアを計算
+     */
+    private calculateRelevance;
+}
+//# sourceMappingURL=AcademicSearchAgent.d.ts.map

package/dist/research/agents/AcademicSearchAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcademicSearchAgent.d.ts","sourceRoot":"","sources":["../../../src/research/agents/AcademicSearchAgent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,KAAK,EAAW,UAAU,EAAE,MAAM,aAAa,CAAC;AAEvD;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACtD,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAc;IACvC,QAAQ,CAAC,IAAI,6BAA6B;IAE1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuC;IAE7D,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAyB3D,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAKrC;;OAEG;YACW,WAAW;IAgCzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuD1B;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;IACH,OAAO,CAAC,cAAc;IActB;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAkB3B"}