@nahisaho/katashiro-collector 0.2.2 → 0.2.4

package/dist/research/agents/WebSearchAgent.js

@@ -0,0 +1,135 @@
+/**
+ * WebSearchAgent - Web検索エージェント
+ *
+ * 既存のWebSearchClientを使用して一般Web検索を実行する。
+ *
+ * @requirement REQ-COLLECT-008
+ * @design DES-COLLECT-008
+ * @task TASK-002
+ */
+import { WebSearchClient } from '../../web-search/index.js';
+/**
+ * Web検索エージェント
+ *
+ * @example
+ * ```typescript
+ * const agent = new WebSearchAgent();
+ * const result = await agent.search({
+ *   query: 'TypeScript best practices',
+ *   maxResults: 10,
+ *   timeout: 30000,
+ * });
+ * ```
+ */
+export class WebSearchAgent {
+    type = 'web';
+    name = 'Web Search';
+    searchClient;
+    constructor() {
+        this.searchClient = new WebSearchClient();
+    }
+    async search(query) {
+        const startTime = Date.now();
+        try {
+            const results = await this.searchClient.search({
+                query: query.query,
+                maxResults: query.maxResults,
+            });
+            const findings = results.map((result, index) => ({
+                id: `web-${Date.now()}-${index}`,
+                title: result.title,
+                summary: result.snippet || '',
+                url: result.url,
+                sourceType: 'web',
+                sourceName: this.extractDomain(result.url),
+                relevanceScore: this.calculateRelevance(result.title, result.snippet || '', query.query),
+                credibilityScore: this.assessCredibility(result.url),
+                metadata: {
+                    source: result.source,
+                    position: index,
+                },
+            }));
+            return {
+                findings,
+                status: 'success',
+                processingTime: Date.now() - startTime,
+            };
+        }
+        catch (error) {
+            return {
+                findings: [],
+                status: 'failed',
+                error: error.message,
+                processingTime: Date.now() - startTime,
+            };
+        }
+    }
+    async isAvailable() {
+        // WebSearchClientは常に利用可能（DuckDuckGo APIはキー不要）
+        return true;
+    }
+    /**
+     * URLからドメイン名を抽出
+     */
+    extractDomain(url) {
+        try {
+            return new URL(url).hostname;
+        }
+        catch {
+            return 'unknown';
+        }
+    }
+    /**
+     * 関連性スコアを計算
+     */
+    calculateRelevance(title, snippet, query) {
+        const queryLower = query.toLowerCase();
+        const titleLower = title.toLowerCase();
+        const snippetLower = snippet.toLowerCase();
+        // タイトルにクエリが含まれる場合
+        const titleMatch = titleLower.includes(queryLower) ? 0.35 : 0;
+        // スニペットにクエリが含まれる場合
+        const snippetMatch = snippetLower.includes(queryLower) ? 0.25 : 0;
+        // クエリの単語単位でマッチング
+        const queryWords = queryLower.split(/\s+/).filter((w) => w.length > 2);
+        const titleWordMatch = queryWords.filter((w) => titleLower.includes(w)).length / Math.max(queryWords.length, 1);
+        const snippetWordMatch = queryWords.filter((w) => snippetLower.includes(w)).length / Math.max(queryWords.length, 1);
+        const baseScore = 0.3;
+        return Math.min(titleMatch + snippetMatch + titleWordMatch * 0.2 + snippetWordMatch * 0.15 + baseScore, 1);
+    }
+    /**
+     * ドメインベースの信頼度スコアリング
+     */
+    assessCredibility(url) {
+        const domain = this.extractDomain(url).toLowerCase();
+        // 高信頼度ドメイン
+        const highCredibility = [
+            '.gov',
+            '.edu',
+            '.ac.jp',
+            '.ac.uk',
+            'wikipedia.org',
+            'reuters.com',
+            'bbc.com',
+            'bbc.co.uk',
+            'nature.com',
+            'science.org',
+            'arxiv.org',
+        ];
+        // 中信頼度ドメイン
+        const mediumCredibility = [
+            '.org',
+            'github.com',
+            'stackoverflow.com',
+            'medium.com',
+            'dev.to',
+            'mozilla.org',
+        ];
+        if (highCredibility.some((d) => domain.includes(d)))
+            return 0.9;
+        if (mediumCredibility.some((d) => domain.includes(d)))
+            return 0.7;
+        return 0.5;
+    }
+}
+//# sourceMappingURL=WebSearchAgent.js.map

package/dist/research/agents/WebSearchAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSearchAgent.js","sourceRoot":"","sources":["../../../src/research/agents/WebSearchAgent.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,13 @@
+/**
+ * Search Agents - エクスポート
+ *
+ * @requirement REQ-COLLECT-008
+ * @design DES-COLLECT-008
+ * @task TASK-002
+ */
+export type { ISearchAgent, AgentSearchQuery, AgentSearchResult, AgentExecutionResult, } from './types.js';
+export { WebSearchAgent } from './WebSearchAgent.js';
+export { NewsSearchAgent } from './NewsSearchAgent.js';
+export { AcademicSearchAgent } from './AcademicSearchAgent.js';
+export { EncyclopediaAgent } from './EncyclopediaAgent.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/research/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/research/agents/index.js

@@ -0,0 +1,12 @@
+/**
+ * Search Agents - エクスポート
+ *
+ * @requirement REQ-COLLECT-008
+ * @design DES-COLLECT-008
+ * @task TASK-002
+ */
+export { WebSearchAgent } from './WebSearchAgent.js';
+export { NewsSearchAgent } from './NewsSearchAgent.js';
+export { AcademicSearchAgent } from './AcademicSearchAgent.js';
+export { EncyclopediaAgent } from './EncyclopediaAgent.js';
+//# sourceMappingURL=index.js.map

package/dist/research/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/research/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

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

@@ -0,0 +1,60 @@
+/**
+ * Search Agent - 型定義
+ *
+ * @requirement REQ-COLLECT-008
+ * @design DES-COLLECT-008
+ * @task TASK-002
+ */
+import type { Finding, SourceType, SourceStatus } from '../types.js';
+/**
+ * 検索エージェントの抽象インターフェース
+ */
+export interface ISearchAgent {
+    /** エージェントタイプ */
+    readonly type: SourceType;
+    /** エージェント名 */
+    readonly name: string;
+    /**
+     * 検索を実行
+     */
+    search(query: AgentSearchQuery): Promise<AgentSearchResult>;
+    /**
+     * エージェントが利用可能か確認
+     */
+    isAvailable(): Promise<boolean>;
+}
+export interface AgentSearchQuery {
+    /** 検索クエリ */
+    query: string;
+    /** 最大結果数 */
+    maxResults: number;
+    /** 言語フィルター */
+    languages?: string[];
+    /** 日付範囲 */
+    dateRange?: {
+        start?: Date;
+        end?: Date;
+    };
+    /** タイムアウト（ミリ秒） */
+    timeout: number;
+}
+export interface AgentSearchResult {
+    /** 検索結果 */
+    findings: Finding[];
+    /** ステータス */
+    status: SourceStatus;
+    /** エラーメッセージ */
+    error?: string;
+    /** 処理時間 */
+    processingTime: number;
+    /** 追加メタデータ */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * エージェント実行結果（内部用）
+ */
+export interface AgentExecutionResult {
+    agent: ISearchAgent;
+    result: AgentSearchResult;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/research/agents/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gBAAgB;IAChB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B,cAAc;IACd,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE5D;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IAEd,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC;IAEnB,cAAc;IACd,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,WAAW;IACX,SAAS,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,IAAI,CAAC;QAAC,GAAG,CAAC,EAAE,IAAI,CAAA;KAAE,CAAC;IAEzC,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW;IACX,QAAQ,EAAE,OAAO,EAAE,CAAC;IAEpB,YAAY;IACZ,MAAM,EAAE,YAAY,CAAC;IAErB,eAAe;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,WAAW;IACX,cAAc,EAAE,MAAM,CAAC;IAEvB,cAAc;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,iBAAiB,CAAC;CAC3B"}

package/dist/research/agents/types.js

@@ -0,0 +1,9 @@
+/**
+ * Search Agent - 型定義
+ *
+ * @requirement REQ-COLLECT-008
+ * @design DES-COLLECT-008
+ * @task TASK-002
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/research/agents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/research/agents/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/research/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Wide Research Module - エクスポート
+ *
+ * @requirement REQ-COLLECT-008
+ * @design DES-COLLECT-008
+ * @task TASK-002
+ */
+export { WideResearchEngine } from './WideResearchEngine.js';
+export { QueryPlanner, type QueryPlan } from './QueryPlanner.js';
+export { ResultAggregator } from './ResultAggregator.js';
+export { CoverageAnalyzer } from './CoverageAnalyzer.js';
+export type { WideResearchQuery, WideResearchResult, ResearchError, ResearchErrorCode, ResearchDepth, SourceType, Finding, SourceInfo, SourceStatus, CoverageReport, CoverageGap, TemporalCoverage, TimeDistribution, ResearchStatistics, CompletionStatus, AgentConfig, DateRange, DepthConfig, } from './types.js';
+export { DEFAULT_RESEARCH_CONFIG } from './types.js';
+export { WebSearchAgent, NewsSearchAgent, AcademicSearchAgent, EncyclopediaAgent, } from './agents/index.js';
+export type { ISearchAgent, AgentSearchQuery, AgentSearchResult, AgentExecutionResult, } from './agents/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/research/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,OAAO,EACP,UAAU,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAGrD,OAAO,EACL,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC"}

package/dist/research/index.js

@@ -0,0 +1,17 @@
+/**
+ * Wide Research Module - エクスポート
+ *
+ * @requirement REQ-COLLECT-008
+ * @design DES-COLLECT-008
+ * @task TASK-002
+ */
+// メインクラス
+export { WideResearchEngine } from './WideResearchEngine.js';
+// サポートクラス
+export { QueryPlanner } from './QueryPlanner.js';
+export { ResultAggregator } from './ResultAggregator.js';
+export { CoverageAnalyzer } from './CoverageAnalyzer.js';
+export { DEFAULT_RESEARCH_CONFIG } from './types.js';
+// エージェント
+export { WebSearchAgent, NewsSearchAgent, AcademicSearchAgent, EncyclopediaAgent, } from './agents/index.js';
+//# sourceMappingURL=index.js.map

package/dist/research/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/research/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,SAAS;AACT,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,UAAU;AACV,OAAO,EAAE,YAAY,EAAkB,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAwBzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,SAAS;AACT,OAAO,EACL,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC"}

package/dist/research/types.d.ts

@@ -0,0 +1,206 @@
+/**
+ * Wide Research Engine - 型定義
+ *
+ * @requirement REQ-COLLECT-008
+ * @design DES-COLLECT-008
+ * @task TASK-002
+ */
+/**
+ * Wide Research クエリ
+ */
+export interface WideResearchQuery {
+    /** 検索トピック/クエリ */
+    topic: string;
+    /** 検索の深さ */
+    depth: ResearchDepth;
+    /** 使用するソースタイプ（指定しない場合は深さに応じて決定） */
+    sources?: SourceType[];
+    /** 最大並列エージェント数 */
+    maxParallelAgents?: number;
+    /** 各エージェントのタイムアウト（ミリ秒） */
+    agentTimeout?: number;
+    /** 全体のタイムアウト（ミリ秒） */
+    totalTimeout?: number;
+    /** 言語フィルター */
+    languages?: string[];
+    /** 日付範囲フィルター */
+    dateRange?: DateRange;
+    /** 除外キーワード */
+    excludeKeywords?: string[];
+    /** 各ソースからの最大結果数 */
+    maxResultsPerSource?: number;
+}
+export type ResearchDepth = 'shallow' | 'medium' | 'deep';
+export type SourceType = 'web' | 'news' | 'academic' | 'encyclopedia' | 'social' | 'government' | 'custom';
+export interface DateRange {
+    start?: Date;
+    end?: Date;
+}
+/**
+ * Wide Research 結果
+ */
+export interface WideResearchResult {
+    /** 検索結果 */
+    findings: Finding[];
+    /** ソース情報 */
+    sources: SourceInfo[];
+    /** カバレッジレポート */
+    coverage: CoverageReport;
+    /** 完了ステータス */
+    completionStatus: CompletionStatus;
+    /** 統計情報 */
+    statistics: ResearchStatistics;
+    /** 処理時間（ミリ秒） */
+    processingTime: number;
+}
+export type CompletionStatus = 'full' | 'partial' | 'failed';
+/**
+ * 検索結果
+ */
+export interface Finding {
+    /** 一意識別子 */
+    id: string;
+    /** タイトル */
+    title: string;
+    /** 要約/スニペット */
+    summary: string;
+    /** 元コンテンツ（取得できた場合） */
+    content?: string;
+    /** ソースURL */
+    url: string;
+    /** ソースタイプ */
+    sourceType: SourceType;
+    /** ソース名 */
+    sourceName: string;
+    /** 関連性スコア (0-1) */
+    relevanceScore: number;
+    /** 信頼度スコア (0-1) */
+    credibilityScore: number;
+    /** 公開日時 */
+    publishedAt?: Date;
+    /** 著者 */
+    author?: string;
+    /** メタデータ */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * ソース情報
+ */
+export interface SourceInfo {
+    /** ソースタイプ */
+    type: SourceType;
+    /** ソース名 */
+    name: string;
+    /** 検索に使用したクエリ */
+    query: string;
+    /** 取得結果数 */
+    resultCount: number;
+    /** 処理ステータス */
+    status: SourceStatus;
+    /** エラー詳細（失敗時） */
+    error?: string;
+    /** 処理時間（ミリ秒） */
+    processingTime: number;
+}
+export type SourceStatus = 'success' | 'partial' | 'failed' | 'timeout';
+/**
+ * カバレッジレポート
+ */
+export interface CoverageReport {
+    /** カバーしたソースタイプ */
+    coveredSources: SourceType[];
+    /** 失敗したソースタイプ */
+    failedSources: SourceType[];
+    /** カバレッジ率 (0-1) */
+    coverageRate: number;
+    /** 観点の多様性スコア (0-1) */
+    perspectiveDiversity: number;
+    /** 時間的カバレッジ */
+    temporalCoverage?: TemporalCoverage;
+    /** 推奨追加ソース */
+    suggestedSources?: SourceType[];
+    /** 識別されたギャップ */
+    gaps?: CoverageGap[];
+}
+export interface TemporalCoverage {
+    oldestResult?: Date;
+    newestResult?: Date;
+    distribution: TimeDistribution[];
+}
+export interface TimeDistribution {
+    period: string;
+    count: number;
+}
+export interface CoverageGap {
+    type: 'source' | 'temporal' | 'perspective';
+    description: string;
+    suggestion: string;
+}
+/**
+ * 統計情報
+ */
+export interface ResearchStatistics {
+    /** 総検索結果数 */
+    totalResults: number;
+    /** 重複排除後の結果数 */
+    uniqueResults: number;
+    /** ソース別結果数 */
+    resultsBySource: Partial<Record<SourceType, number>>;
+    /** 平均関連性スコア */
+    averageRelevance: number;
+    /** 平均信頼度スコア */
+    averageCredibility: number;
+}
+/**
+ * エージェント設定
+ */
+export interface AgentConfig {
+    /** エージェントタイプ */
+    type: SourceType;
+    /** 有効/無効 */
+    enabled: boolean;
+    /** 優先度 (数字が小さいほど優先) */
+    priority: number;
+    /** エージェント固有設定 */
+    options?: Record<string, unknown>;
+}
+/**
+ * エラー型
+ */
+export interface ResearchError {
+    code: ResearchErrorCode;
+    message: string;
+    details?: unknown;
+}
+export type ResearchErrorCode = 'INVALID_QUERY' | 'ALL_SOURCES_FAILED' | 'TIMEOUT' | 'CONFIGURATION_ERROR' | 'UNKNOWN_ERROR';
+/**
+ * 深さ別設定
+ */
+export interface DepthConfig {
+    sources: SourceType[];
+    maxResults: number;
+}
+/**
+ * デフォルト設定
+ */
+export declare const DEFAULT_RESEARCH_CONFIG: {
+    readonly maxParallelAgents: 5;
+    readonly agentTimeout: 30000;
+    readonly totalTimeout: 120000;
+    readonly maxResultsPerSource: 20;
+    readonly depthConfig: {
+        readonly shallow: {
+            readonly sources: SourceType[];
+            readonly maxResults: 10;
+        };
+        readonly medium: {
+            readonly sources: SourceType[];
+            readonly maxResults: 20;
+        };
+        readonly deep: {
+            readonly sources: SourceType[];
+            readonly maxResults: 50;
+        };
+    };
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/research/types.ts"],"names":[],"mappings":"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"}

package/dist/research/types.js

@@ -0,0 +1,33 @@
+/**
+ * Wide Research Engine - 型定義
+ *
+ * @requirement REQ-COLLECT-008
+ * @design DES-COLLECT-008
+ * @task TASK-002
+ */
+/**
+ * デフォルト設定
+ */
+export const DEFAULT_RESEARCH_CONFIG = {
+    maxParallelAgents: 5,
+    agentTimeout: 30000, // 30秒
+    totalTimeout: 120000, // 2分
+    maxResultsPerSource: 20,
+    depthConfig: {
+        shallow: { sources: ['web'], maxResults: 10 },
+        medium: {
+            sources: ['web', 'news', 'encyclopedia'],
+            maxResults: 20,
+        },
+        deep: {
+            sources: [
+                'web',
+                'news',
+                'academic',
+                'encyclopedia',
+            ],
+            maxResults: 50,
+        },
+    },
+};
+//# sourceMappingURL=types.js.map

package/dist/research/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/research/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2PH;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,iBAAiB,EAAE,CAAC;IACpB,YAAY,EAAE,KAAK,EAAE,MAAM;IAC3B,YAAY,EAAE,MAAM,EAAE,KAAK;IAC3B,mBAAmB,EAAE,EAAE;IACvB,WAAW,EAAE;QACX,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,KAAK,CAAiB,EAAE,UAAU,EAAE,EAAE,EAAE;QAC7D,MAAM,EAAE;YACN,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,CAAiB;YACxD,UAAU,EAAE,EAAE;SACf;QACD,IAAI,EAAE;YACJ,OAAO,EAAE;gBACP,KAAK;gBACL,MAAM;gBACN,UAAU;gBACV,cAAc;aACC;YACjB,UAAU,EAAE,EAAE;SACf;KACF;CACO,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nahisaho/katashiro-collector",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "KATASHIRO Collector - 情報収集パッケージ",
   "type": "module",
   "main": "./dist/index.js",