@nahisaho/katashiro-orchestrator 1.2.0 → 2.0.0

package/dist/cascading/CascadingResearchEngine.js

@@ -0,0 +1,329 @@
+"use strict";
+/**
+ * KATASHIRO v1.4.0 - Cascading Research Engine
+ *
+ * カスケード型リサーチのメインエンジン
+ * 5ステップ × 5エージェントのワークフローを実行
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CascadingResearchEngine = void 0;
+exports.createCascadingResearchEngine = createCascadingResearchEngine;
+exports.validateConfig = validateConfig;
+const types_js_1 = require("./types.js");
+const CascadingAgent_js_1 = require("./CascadingAgent.js");
+const StepExecutor_js_1 = require("./StepExecutor.js");
+const StepResultIntegrator_js_1 = require("./StepResultIntegrator.js");
+/**
+ * カスケード型リサーチエンジン
+ */
+class CascadingResearchEngine {
+    config;
+    deps;
+    eventListeners = [];
+    state = 'idle';
+    abortRequested = false;
+    constructor(deps, config = {}) {
+        this.deps = deps;
+        this.config = { ...types_js_1.DEFAULT_CASCADING_CONFIG, ...config };
+    }
+    /**
+     * イベントリスナーを登録
+     */
+    on(listener) {
+        this.eventListeners.push(listener);
+        return () => {
+            const index = this.eventListeners.indexOf(listener);
+            if (index >= 0) {
+                this.eventListeners.splice(index, 1);
+            }
+        };
+    }
+    /**
+     * イベントを発行
+     */
+    emit(event) {
+        for (const listener of this.eventListeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                // イベントリスナーのエラーは無視
+            }
+        }
+    }
+    /**
+     * 現在の状態を取得
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * リサーチを中断
+     */
+    abort() {
+        if (this.state === 'running') {
+            this.abortRequested = true;
+        }
+    }
+    /**
+     * カスケード型リサーチを実行
+     */
+    async research(topic, customConfig) {
+        const config = { ...this.config, ...customConfig };
+        const startTime = Date.now();
+        this.state = 'running';
+        this.abortRequested = false;
+        this.emit({
+            type: 'researchStarted',
+            topic,
+            timestamp: new Date().toISOString(),
+        });
+        try {
+            // 1. エージェントを作成
+            const agents = this.createAgents(config);
+            // 2. ステップ実行器を作成
+            const stepExecutor = new StepExecutor_js_1.StepExecutor({
+                concurrency: config.agentCount,
+                agentTimeoutMs: config.agentTimeoutMs,
+                stepTimeoutMs: config.agentTimeoutMs * config.agentCount,
+                skipOnFailure: true,
+            });
+            // イベントを転送
+            stepExecutor.on(event => this.emit(event));
+            // 3. 全ステップを順次実行
+            const stepResults = [];
+            const stepStrategies = config.stepStrategies || types_js_1.DEFAULT_STEP_STRATEGIES;
+            for (let stepNumber = 1; stepNumber <= config.stepCount; stepNumber++) {
+                // 中断チェック
+                if (this.abortRequested) {
+                    this.state = 'aborted';
+                    break;
+                }
+                // ステップ戦略を取得
+                const strategy = stepStrategies[stepNumber - 1];
+                if (!strategy) {
+                    throw new Error(`Step strategy not found for step ${stepNumber}`);
+                }
+                // コンテキストを構築
+                const context = this.buildStepContext(topic, stepNumber, strategy, stepResults);
+                // ステップを実行
+                const result = await stepExecutor.execute(stepNumber, agents, context, strategy);
+                stepResults.push(result);
+                // 早期終了判定
+                if (this.shouldTerminateEarly(stepResults, config)) {
+                    this.emit({
+                        type: 'earlyTermination',
+                        stepNumber,
+                        reason: '収束条件を満たしたため早期終了',
+                        timestamp: new Date().toISOString(),
+                    });
+                    break;
+                }
+            }
+            // 4. 結果を統合
+            const integrator = new StepResultIntegrator_js_1.StepResultIntegrator({
+                contradictionThreshold: config.contradictionThreshold ?? 0.7,
+            });
+            const integrationResult = integrator.integrate(topic, stepResults);
+            // 5. 最終レポートをポストプロセス
+            let finalReport = integrationResult.finalReport;
+            if (this.deps.postProcessor && config.postProcess?.enabled) {
+                const processed = this.deps.postProcessor.process(finalReport);
+                finalReport = processed.processedReport;
+            }
+            // 6. 結果を構築
+            const result = {
+                topic,
+                stepResults,
+                findings: integrationResult.findings,
+                sources: integrationResult.sources,
+                contradictions: integrationResult.contradictions,
+                finalReport,
+                overallConfidence: integrationResult.overallConfidence,
+                totalDurationMs: Date.now() - startTime,
+                totalAgentRuns: stepResults.reduce((sum, sr) => sum + sr.agentReports.length, 0),
+                metadata: {
+                    config: {
+                        agentCount: config.agentCount,
+                        stepCount: config.stepCount,
+                    },
+                    startedAt: new Date(startTime).toISOString(),
+                    completedAt: new Date().toISOString(),
+                },
+            };
+            this.state = this.abortRequested ? 'aborted' : 'completed';
+            this.emit({
+                type: 'researchCompleted',
+                result,
+                timestamp: new Date().toISOString(),
+            });
+            return result;
+        }
+        catch (error) {
+            this.state = 'error';
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.emit({
+                type: 'researchFailed',
+                error: errorMessage,
+                timestamp: new Date().toISOString(),
+            });
+            // エラー時の結果
+            return {
+                topic,
+                stepResults: [],
+                findings: [],
+                sources: [],
+                contradictions: [],
+                finalReport: `# Error\n\nリサーチ中にエラーが発生しました: ${errorMessage}`,
+                overallConfidence: 0,
+                totalDurationMs: Date.now() - startTime,
+                totalAgentRuns: 0,
+                metadata: {
+                    config: {
+                        agentCount: config.agentCount,
+                        stepCount: config.stepCount,
+                    },
+                    startedAt: new Date(startTime).toISOString(),
+                    completedAt: new Date().toISOString(),
+                    error: errorMessage,
+                },
+            };
+        }
+    }
+    /**
+     * エージェントを作成
+     */
+    createAgents(config) {
+        const strategies = config.agentStrategies || types_js_1.DEFAULT_AGENT_STRATEGIES;
+        return (0, CascadingAgent_js_1.createCascadingAgents)(strategies, this.deps, {
+            timeoutMs: config.agentTimeoutMs,
+            maxRetries: 2,
+            maxResults: config.maxResultsPerAgent ?? config.searchConfig.maxResultsPerAgent,
+        });
+    }
+    /**
+     * ステップコンテキストを構築
+     */
+    buildStepContext(topic, stepNumber, strategy, previousResults) {
+        const builder = new StepExecutor_js_1.StepContextBuilder()
+            .setTopic(topic)
+            .setStepNumber(stepNumber)
+            .setStepFocus(strategy.focus)
+            .setQueryModifiers(strategy.queryModifiers)
+            .setAllPreviousResults(previousResults);
+        // 前ステップの結果がある場合
+        if (previousResults.length > 0) {
+            const lastResult = previousResults[previousResults.length - 1];
+            if (lastResult) {
+                builder.setPreviousStepResult(lastResult);
+                // 全発見事項からキーエンティティを抽出
+                const allFindings = previousResults.flatMap(r => r.findings);
+                const keyEntities = this.extractKeyEntities(allFindings);
+                builder.setKeyEntities(keyEntities);
+                // 特定されたギャップを集約
+                const allGaps = [...new Set(previousResults.flatMap(r => r.gaps))];
+                builder.setIdentifiedGaps(allGaps);
+                // 未解決の疑問を収集（questionカテゴリの発見事項）
+                const unresolvedQuestions = allFindings
+                    .filter(f => f.category === 'question')
+                    .map(f => f.content.slice(0, 100));
+                builder.setUnresolvedQuestions(unresolvedQuestions);
+            }
+        }
+        return builder.build();
+    }
+    /**
+     * キーエンティティを抽出
+     */
+    extractKeyEntities(findings) {
+        // 発見事項から頻出するキーワードを抽出
+        const wordCounts = new Map();
+        for (const finding of findings) {
+            const words = this.tokenize(finding.content);
+            for (const word of words) {
+                if (word.length >= 2) {
+                    wordCounts.set(word, (wordCounts.get(word) || 0) + 1);
+                }
+            }
+        }
+        // 頻出順にソートして上位10件を返す
+        return [...wordCounts.entries()]
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 10)
+            .map(([word]) => word);
+    }
+    /**
+     * テキストをトークン化
+     */
+    tokenize(text) {
+        return text
+            .replace(/[^\p{L}\p{N}\s]/gu, '')
+            .split(/\s+/)
+            .filter(w => w.length > 1);
+    }
+    /**
+     * 早期終了判定
+     */
+    shouldTerminateEarly(stepResults, config) {
+        if (stepResults.length < 2) {
+            return false;
+        }
+        // 最後の2ステップを比較
+        const lastResult = stepResults[stepResults.length - 1];
+        const prevResult = stepResults[stepResults.length - 2];
+        if (!lastResult || !prevResult) {
+            return false;
+        }
+        // 新規発見事項の割合を計算
+        const prevFindingContents = new Set(prevResult.findings.map(f => f.content.slice(0, 100)));
+        const newFindings = lastResult.findings.filter((f) => !prevFindingContents.has(f.content.slice(0, 100)));
+        const newInfoRate = lastResult.findings.length > 0
+            ? newFindings.length / lastResult.findings.length
+            : 0;
+        // 新規情報率が閾値以下なら早期終了
+        return newInfoRate < (config.earlyTerminationThreshold ?? 0.1);
+    }
+}
+exports.CascadingResearchEngine = CascadingResearchEngine;
+/**
+ * シンプルな依存性を使用してエンジンを作成するヘルパー
+ */
+function createCascadingResearchEngine(searchClient, scraper, config) {
+    return new CascadingResearchEngine({ searchClient, scraper }, config);
+}
+/**
+ * 設定のバリデーション
+ */
+function validateConfig(config) {
+    const errors = [];
+    if (config.agentCount !== undefined) {
+        if (config.agentCount < 1 || config.agentCount > 10) {
+            errors.push('agentCount must be between 1 and 10');
+        }
+    }
+    if (config.stepCount !== undefined) {
+        if (config.stepCount < 1 || config.stepCount > 10) {
+            errors.push('stepCount must be between 1 and 10');
+        }
+    }
+    if (config.agentTimeoutMs !== undefined) {
+        if (config.agentTimeoutMs < 1000) {
+            errors.push('agentTimeoutMs must be at least 1000ms');
+        }
+    }
+    if (config.contradictionThreshold !== undefined) {
+        if (config.contradictionThreshold < 0 || config.contradictionThreshold > 1) {
+            errors.push('contradictionThreshold must be between 0 and 1');
+        }
+    }
+    if (config.earlyTerminationThreshold !== undefined) {
+        if (config.earlyTerminationThreshold < 0 || config.earlyTerminationThreshold > 1) {
+            errors.push('earlyTerminationThreshold must be between 0 and 1');
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+//# sourceMappingURL=CascadingResearchEngine.js.map

package/dist/cascading/CascadingResearchEngine.js.map

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

package/dist/cascading/StepExecutor.d.ts

@@ -0,0 +1,94 @@
+/**
+ * KATASHIRO v1.4.0 - Step Executor
+ *
+ * カスケード型リサーチの1ステップを実行するオーケストレーター
+ * 5つのエージェントを並列実行し、結果を収集する
+ */
+import type { StepContext, StepResult, StepStrategyConfig, CascadingResearchEventListener } from './types.js';
+import type { CascadingAgent } from './CascadingAgent.js';
+/**
+ * StepExecutorの設定
+ */
+export interface StepExecutorConfig {
+    /** 並列実行数 */
+    concurrency: number;
+    /** エージェントタイムアウト (ms) */
+    agentTimeoutMs: number;
+    /** ステップタイムアウト (ms) */
+    stepTimeoutMs: number;
+    /** 失敗時にスキップするか */
+    skipOnFailure: boolean;
+}
+/**
+ * デフォルト設定
+ */
+export declare const DEFAULT_STEP_EXECUTOR_CONFIG: StepExecutorConfig;
+/**
+ * ステップ実行クラス
+ */
+export declare class StepExecutor {
+    private readonly config;
+    private readonly eventListeners;
+    constructor(config?: Partial<StepExecutorConfig>);
+    /**
+     * イベントリスナーを登録
+     */
+    on(listener: CascadingResearchEventListener): void;
+    /**
+     * イベントを発行
+     */
+    private emit;
+    /**
+     * ステップを実行
+     */
+    execute(stepNumber: number, agents: CascadingAgent[], context: StepContext, strategy: StepStrategyConfig): Promise<StepResult>;
+    /**
+     * 単一エージェントを実行
+     */
+    private executeAgent;
+    /**
+     * タイムアウト付き実行
+     */
+    private executeWithTimeout;
+    /**
+     * ソースの重複除去
+     */
+    private deduplicateSources;
+    /**
+     * 統合レポートを生成
+     */
+    private generateIntegratedReport;
+    /**
+     * フォーカスラベルを取得
+     */
+    private getFocusLabel;
+    /**
+     * 役割ラベルを取得
+     */
+    private getRoleLabel;
+}
+/**
+ * ステップコンテキストビルダー
+ */
+export declare class StepContextBuilder {
+    private topic;
+    private stepNumber;
+    private stepFocus;
+    private queryModifiers;
+    private previousStepResult?;
+    private allPreviousResults;
+    private keyEntities;
+    private identifiedGaps;
+    private unresolvedQuestions;
+    setTopic(topic: string): this;
+    setStepNumber(stepNumber: number): this;
+    setStepFocus(focus: string): this;
+    setQueryModifiers(modifiers: string[]): this;
+    setPreviousStepResult(result: StepResult): this;
+    setAllPreviousResults(results: StepResult[]): this;
+    setKeyEntities(entities: string[]): this;
+    setIdentifiedGaps(gaps: string[]): this;
+    setUnresolvedQuestions(questions: string[]): this;
+    build(): StepContext;
+}
+//# sourceMappingURL=StepExecutor.d.ts.map

package/dist/cascading/StepExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepExecutor.d.ts","sourceRoot":"","sources":["../../src/cascading/StepExecutor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAEV,WAAW,EACX,UAAU,EACV,kBAAkB,EAElB,8BAA8B,EAC/B,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,YAAY;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB;IAClB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,kBAK1C,CAAC;AAaF;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwC;gBAE3D,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM;IAIpD;;OAEG;IACH,EAAE,CAAC,QAAQ,EAAE,8BAA8B,GAAG,IAAI;IAIlD;;OAEG;IACH,OAAO,CAAC,IAAI;IAUZ;;OAEG;IACG,OAAO,CACX,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc,EAAE,EACxB,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAAC,UAAU,CAAC;IA0GtB;;OAEG;YACW,YAAY;IAoD1B;;OAEG;YACW,kBAAkB;IAShC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAsChC;;OAEG;IACH,OAAO,CAAC,aAAa;IAWrB;;OAEG;IACH,OAAO,CAAC,YAAY;CAUrB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,kBAAkB,CAAC,CAAa;IACxC,OAAO,CAAC,kBAAkB,CAAoB;IAC9C,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,mBAAmB,CAAgB;IAE3C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK7B,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKvC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKjC,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAK5C,qBAAqB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAK/C,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI;IAKlD,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAKxC,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAKvC,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAKjD,KAAK,IAAI,WAAW;CAarB"}