@nahisaho/katashiro-orchestrator 1.3.0 → 2.0.0

package/dist/agent/ReActHelper.js

@@ -0,0 +1,342 @@
+"use strict";
+/**
+ * ReAct Helper
+ *
+ * ReAct（Reasoning + Acting）パターンの出力をパースするヘルパー
+ *
+ * @requirement REQ-AGENT-004
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReActHelper = exports.REACT_SYSTEM_PROMPT = exports.DEFAULT_REACT_FORMAT = void 0;
+exports.parseReActOutput = parseReActOutput;
+exports.extractNextReActAction = extractNextReActAction;
+/**
+ * デフォルトのReActフォーマット
+ */
+exports.DEFAULT_REACT_FORMAT = {
+    thoughtPrefix: 'Thought:',
+    actionPrefix: 'Action:',
+    actionInputPrefix: 'Action Input:',
+    observationPrefix: 'Observation:',
+    finalAnswerPrefix: 'Final Answer:',
+    caseInsensitive: true,
+};
+/**
+ * ReActプロンプトテンプレート
+ */
+exports.REACT_SYSTEM_PROMPT = `You are an AI assistant that uses the ReAct (Reasoning and Acting) pattern.
+
+For each step, you should:
+1. **Thought**: Think about what you need to do next
+2. **Action**: Choose a tool to use
+3. **Action Input**: Provide the input for the tool
+4. **Observation**: (This will be filled in with the tool's output)
+
+Continue this process until you can provide a final answer.
+
+When you have enough information to answer the question, respond with:
+Final Answer: [your answer]
+
+Format your response as:
+Thought: [your reasoning]
+Action: [tool name]
+Action Input: [tool input]
+
+Available tools:
+{tools}
+`;
+/**
+ * ReActヘルパー
+ */
+class ReActHelper {
+    config;
+    constructor(config = {}) {
+        this.config = { ...exports.DEFAULT_REACT_FORMAT, ...config };
+    }
+    /**
+     * ReAct形式のテキストをパース
+     */
+    parse(text) {
+        const errors = [];
+        const actions = [];
+        let finalAnswer;
+        const lines = text.split('\n');
+        let currentStep = {};
+        let stepNumber = 1;
+        let inActionInput = false;
+        let actionInputBuffer = '';
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            if (line === undefined)
+                continue;
+            const trimmedLine = line.trim();
+            // 空行はスキップ
+            if (!trimmedLine) {
+                if (inActionInput) {
+                    actionInputBuffer += '\n';
+                }
+                continue;
+            }
+            // 各プレフィックスをチェック
+            if (this.matchesPrefix(trimmedLine, this.config.thoughtPrefix)) {
+                // 前のステップを保存
+                if (Object.keys(currentStep).length > 0) {
+                    if (inActionInput && currentStep.action) {
+                        currentStep.action.input = this.parseActionInput(actionInputBuffer.trim());
+                        inActionInput = false;
+                        actionInputBuffer = '';
+                    }
+                    actions.push({ step: stepNumber++, ...currentStep });
+                    currentStep = {};
+                }
+                currentStep.thought = this.extractValue(trimmedLine, this.config.thoughtPrefix);
+            }
+            else if (this.matchesPrefix(trimmedLine, this.config.actionPrefix)) {
+                if (inActionInput && currentStep.action) {
+                    currentStep.action.input = this.parseActionInput(actionInputBuffer.trim());
+                    inActionInput = false;
+                    actionInputBuffer = '';
+                }
+                const toolName = this.extractValue(trimmedLine, this.config.actionPrefix);
+                currentStep.action = { tool: toolName, input: '' };
+            }
+            else if (this.matchesPrefix(trimmedLine, this.config.actionInputPrefix)) {
+                const inputValue = this.extractValue(trimmedLine, this.config.actionInputPrefix);
+                if (currentStep.action) {
+                    // 複数行の入力をサポート
+                    actionInputBuffer = inputValue;
+                    inActionInput = true;
+                }
+            }
+            else if (this.matchesPrefix(trimmedLine, this.config.observationPrefix)) {
+                if (inActionInput && currentStep.action) {
+                    currentStep.action.input = this.parseActionInput(actionInputBuffer.trim());
+                    inActionInput = false;
+                    actionInputBuffer = '';
+                }
+                currentStep.observation = this.extractValue(trimmedLine, this.config.observationPrefix);
+            }
+            else if (this.matchesPrefix(trimmedLine, this.config.finalAnswerPrefix)) {
+                if (inActionInput && currentStep.action) {
+                    currentStep.action.input = this.parseActionInput(actionInputBuffer.trim());
+                    inActionInput = false;
+                    actionInputBuffer = '';
+                }
+                finalAnswer = this.extractValue(trimmedLine, this.config.finalAnswerPrefix);
+                currentStep.finalAnswer = finalAnswer;
+            }
+            else if (inActionInput) {
+                // Action Inputの継続行
+                actionInputBuffer += '\n' + line;
+            }
+        }
+        // 最後のステップを保存
+        if (Object.keys(currentStep).length > 0) {
+            if (inActionInput && currentStep.action) {
+                currentStep.action.input = this.parseActionInput(actionInputBuffer.trim());
+            }
+            actions.push({ step: stepNumber, ...currentStep });
+        }
+        return {
+            success: actions.length > 0 || finalAnswer !== undefined,
+            actions,
+            finalAnswer,
+            errors,
+            rawText: text,
+        };
+    }
+    /**
+     * ReActステップをAgentActionに変換
+     */
+    toAgentActions(steps) {
+        const actions = [];
+        const now = new Date().toISOString();
+        for (const step of steps) {
+            // Thoughtアクション
+            if (step.thought) {
+                actions.push({
+                    step: step.step,
+                    timestamp: now,
+                    type: 'thought',
+                    content: { thought: step.thought },
+                });
+            }
+            // ツール呼び出しアクション
+            if (step.action) {
+                actions.push({
+                    step: step.step,
+                    timestamp: now,
+                    type: 'tool_call',
+                    content: {
+                        tool: step.action.tool,
+                        params: typeof step.action.input === 'object'
+                            ? step.action.input
+                            : { input: step.action.input },
+                    },
+                });
+            }
+            // 観察アクション
+            if (step.observation) {
+                actions.push({
+                    step: step.step,
+                    timestamp: now,
+                    type: 'observation',
+                    content: {
+                        result: {
+                            toolName: step.action?.tool ?? 'unknown',
+                            success: true,
+                            data: step.observation,
+                        },
+                    },
+                });
+            }
+            // 最終回答
+            if (step.finalAnswer) {
+                actions.push({
+                    step: step.step,
+                    timestamp: now,
+                    type: 'final_answer',
+                    content: { answer: step.finalAnswer },
+                });
+            }
+        }
+        return actions;
+    }
+    /**
+     * AgentActionからReAct形式のテキストを生成
+     */
+    format(actions) {
+        const lines = [];
+        for (const action of actions) {
+            switch (action.type) {
+                case 'thought':
+                    if (action.content.thought) {
+                        lines.push(`${this.config.thoughtPrefix} ${action.content.thought}`);
+                    }
+                    break;
+                case 'tool_call':
+                    if (action.content.tool) {
+                        lines.push(`${this.config.actionPrefix} ${action.content.tool}`);
+                        if (action.content.params) {
+                            const inputStr = Object.keys(action.content.params).length === 1 &&
+                                'input' in action.content.params
+                                ? String(action.content.params.input)
+                                : JSON.stringify(action.content.params);
+                            lines.push(`${this.config.actionInputPrefix} ${inputStr}`);
+                        }
+                    }
+                    break;
+                case 'observation':
+                    if (action.content.result) {
+                        const obsValue = typeof action.content.result.data === 'string'
+                            ? action.content.result.data
+                            : JSON.stringify(action.content.result.data);
+                        lines.push(`${this.config.observationPrefix} ${obsValue}`);
+                    }
+                    break;
+                case 'final_answer':
+                    if (action.content.answer) {
+                        lines.push(`${this.config.finalAnswerPrefix} ${action.content.answer}`);
+                    }
+                    break;
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * ツール呼び出しを抽出（次のアクションを取得）
+     */
+    extractNextAction(text) {
+        const result = this.parse(text);
+        // 最後のアクションを取得
+        for (let i = result.actions.length - 1; i >= 0; i--) {
+            const action = result.actions[i];
+            if (action?.action) {
+                return action.action;
+            }
+        }
+        return null;
+    }
+    /**
+     * 最終回答かどうかを判定
+     */
+    isFinalAnswer(text) {
+        return this.matchesPrefix(text.trim(), this.config.finalAnswerPrefix);
+    }
+    /**
+     * 最終回答を抽出
+     */
+    extractFinalAnswer(text) {
+        const result = this.parse(text);
+        return result.finalAnswer ?? null;
+    }
+    /**
+     * プロンプトにObservationを追加
+     */
+    appendObservation(prompt, observation) {
+        return `${prompt}\n${this.config.observationPrefix} ${observation}`;
+    }
+    /**
+     * システムプロンプトを生成
+     */
+    generateSystemPrompt(tools) {
+        const toolsDescription = tools
+            .map((t) => `- ${t.name}: ${t.description}`)
+            .join('\n');
+        return exports.REACT_SYSTEM_PROMPT.replace('{tools}', toolsDescription);
+    }
+    /**
+     * プレフィックスマッチ
+     */
+    matchesPrefix(text, prefix) {
+        if (this.config.caseInsensitive) {
+            return text.toLowerCase().startsWith(prefix.toLowerCase());
+        }
+        return text.startsWith(prefix);
+    }
+    /**
+     * プレフィックス後の値を抽出
+     */
+    extractValue(text, prefix) {
+        const prefixLen = prefix.length;
+        return text.slice(prefixLen).trim();
+    }
+    /**
+     * アクション入力をパース
+     */
+    parseActionInput(input) {
+        // JSONとしてパースを試みる
+        try {
+            const parsed = JSON.parse(input);
+            if (typeof parsed === 'object' && parsed !== null) {
+                return parsed;
+            }
+            return input;
+        }
+        catch {
+            return input;
+        }
+    }
+    /**
+     * 設定を取得
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+exports.ReActHelper = ReActHelper;
+/**
+ * シンプルなパースヘルパー
+ */
+function parseReActOutput(text) {
+    const helper = new ReActHelper();
+    return helper.parse(text);
+}
+/**
+ * シンプルな次アクション抽出ヘルパー
+ */
+function extractNextReActAction(text) {
+    const helper = new ReActHelper();
+    return helper.extractNextAction(text);
+}
+//# sourceMappingURL=ReActHelper.js.map

package/dist/agent/ReActHelper.js.map

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

package/dist/agent/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Agent module exports
+ *
+ * @module @nahisaho/katashiro-orchestrator/agent
+ */
+export type { AgentActionType, ToolResult, AgentAction, AgentState, AgentStateStatus, CreateAgentStateOptions, AddActionInput, SerializedAgentState, AgentStateManagerConfig, } from './types.js';
+export { AgentStateManager, defaultAgentStateManager, type AgentStateSummary, } from './AgentStateManager.js';
+export { ReActHelper, parseReActOutput, extractNextReActAction, DEFAULT_REACT_FORMAT, REACT_SYSTEM_PROMPT, type ReActParseResult, type ReActStep, type ReActFormatConfig, } from './ReActHelper.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,eAAe,EACf,UAAU,EACV,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,EACd,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,KAAK,iBAAiB,GACvB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC"}

package/dist/agent/index.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * Agent module exports
+ *
+ * @module @nahisaho/katashiro-orchestrator/agent
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REACT_SYSTEM_PROMPT = exports.DEFAULT_REACT_FORMAT = exports.extractNextReActAction = exports.parseReActOutput = exports.ReActHelper = exports.defaultAgentStateManager = exports.AgentStateManager = void 0;
+// Classes
+var AgentStateManager_js_1 = require("./AgentStateManager.js");
+Object.defineProperty(exports, "AgentStateManager", { enumerable: true, get: function () { return AgentStateManager_js_1.AgentStateManager; } });
+Object.defineProperty(exports, "defaultAgentStateManager", { enumerable: true, get: function () { return AgentStateManager_js_1.defaultAgentStateManager; } });
+// ReAct Helper (REQ-AGENT-004)
+var ReActHelper_js_1 = require("./ReActHelper.js");
+Object.defineProperty(exports, "ReActHelper", { enumerable: true, get: function () { return ReActHelper_js_1.ReActHelper; } });
+Object.defineProperty(exports, "parseReActOutput", { enumerable: true, get: function () { return ReActHelper_js_1.parseReActOutput; } });
+Object.defineProperty(exports, "extractNextReActAction", { enumerable: true, get: function () { return ReActHelper_js_1.extractNextReActAction; } });
+Object.defineProperty(exports, "DEFAULT_REACT_FORMAT", { enumerable: true, get: function () { return ReActHelper_js_1.DEFAULT_REACT_FORMAT; } });
+Object.defineProperty(exports, "REACT_SYSTEM_PROMPT", { enumerable: true, get: function () { return ReActHelper_js_1.REACT_SYSTEM_PROMPT; } });
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAeH,UAAU;AACV,+DAIgC;AAH9B,yHAAA,iBAAiB,OAAA;AACjB,gIAAA,wBAAwB,OAAA;AAG1B,+BAA+B;AAC/B,mDAS0B;AARxB,6GAAA,WAAW,OAAA;AACX,kHAAA,gBAAgB,OAAA;AAChB,wHAAA,sBAAsB,OAAA;AACtB,sHAAA,oBAAoB,OAAA;AACpB,qHAAA,mBAAmB,OAAA"}

package/dist/agent/types.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Agent Types - エージェント状態管理の型定義
+ *
+ * @requirement REQ-AGENT-002
+ * @description エージェントの状態管理のための型定義
+ */
+/**
+ * エージェントアクションの種類
+ */
+export type AgentActionType = 'tool_call' | 'thought' | 'observation' | 'final_answer';
+/**
+ * ツール実行結果
+ */
+export interface ToolResult {
+    /** ツール名 */
+    toolName: string;
+    /** 成功したか */
+    success: boolean;
+    /** 結果データ */
+    data?: unknown;
+    /** エラーメッセージ */
+    error?: string;
+    /** 実行時間（ミリ秒） */
+    executionTimeMs?: number;
+}
+/**
+ * エージェントアクション
+ */
+export interface AgentAction {
+    /** ステップ番号 */
+    step: number;
+    /** タイムスタンプ */
+    timestamp: string;
+    /** アクション種類 */
+    type: AgentActionType;
+    /** アクション内容 */
+    content: {
+        /** ツール名（type=tool_callの場合） */
+        tool?: string;
+        /** パラメータ（type=tool_callの場合） */
+        params?: Record<string, unknown>;
+        /** ツール実行結果（type=observationの場合） */
+        result?: ToolResult;
+        /** 思考内容（type=thoughtの場合） */
+        thought?: string;
+        /** 最終回答（type=final_answerの場合） */
+        answer?: string;
+    };
+}
+/**
+ * エージェント状態
+ */
+export interface AgentState {
+    /** 会話ID */
+    conversationId: string;
+    /** 現在のステップ */
+    currentStep: number;
+    /** 最大ステップ */
+    maxSteps: number;
+    /** 実行履歴 */
+    history: AgentAction[];
+    /** コンテキスト（任意のデータ） */
+    context: Record<string, unknown>;
+    /** 中間結果 */
+    intermediateResults: unknown[];
+    /** 作成日時 */
+    createdAt: string;
+    /** 更新日時 */
+    updatedAt: string;
+    /** 状態 */
+    status: AgentStateStatus;
+}
+/**
+ * エージェント状態のステータス
+ */
+export type AgentStateStatus = 'idle' | 'running' | 'completed' | 'failed' | 'cancelled';
+/**
+ * エージェント状態作成オプション
+ */
+export interface CreateAgentStateOptions {
+    /** 会話ID（未指定時は自動生成） */
+    conversationId?: string;
+    /** 最大ステップ */
+    maxSteps?: number;
+    /** 初期コンテキスト */
+    context?: Record<string, unknown>;
+}
+/**
+ * アクション追加オプション
+ */
+export type AddActionInput = Omit<AgentAction, 'step' | 'timestamp'>;
+/**
+ * シリアライズされた状態
+ */
+export interface SerializedAgentState {
+    version: string;
+    data: AgentState;
+}
+/**
+ * エージェント状態マネージャー設定
+ */
+export interface AgentStateManagerConfig {
+    /** デフォルト最大ステップ */
+    defaultMaxSteps?: number;
+    /** ID生成関数 */
+    idGenerator?: () => string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,SAAS,GAAG,aAAa,GAAG,cAAc,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,eAAe;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,aAAa;IACb,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc;IACd,IAAI,EAAE,eAAe,CAAC;IACtB,cAAc;IACd,OAAO,EAAE;QACP,8BAA8B;QAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,+BAA+B;QAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,mCAAmC;QACnC,MAAM,CAAC,EAAE,UAAU,CAAC;QACpB,4BAA4B;QAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,iCAAiC;QACjC,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,WAAW;IACX,mBAAmB,EAAE,OAAO,EAAE,CAAC;IAC/B,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS;IACT,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEzF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,sBAAsB;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,kBAAkB;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa;IACb,WAAW,CAAC,EAAE,MAAM,MAAM,CAAC;CAC5B"}

package/dist/agent/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Agent Types - エージェント状態管理の型定義
+ *
+ * @requirement REQ-AGENT-002
+ * @description エージェントの状態管理のための型定義
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/agent/types.js.map

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

package/dist/cascading/CascadingAgent.d.ts

@@ -0,0 +1,156 @@
+/**
+ * KATASHIRO v1.4.0 - Cascading Agent
+ *
+ * カスケード型リサーチのエージェント
+ * 各エージェントは特定の役割（official/news/analysis/academic/community）を持ち、
+ * 前ステップの結果を参照しながら調査を実行する
+ */
+import type { AgentRole, CascadingAgentReport, CascadingAgentStrategy, StepContext } from './types.js';
+/**
+ * 依存性注入用インターフェース: 検索クライアント
+ */
+export interface ISearchClient {
+    search(query: string, options?: {
+        maxResults?: number;
+    }): Promise<Array<{
+        url: string;
+        title: string;
+        snippet?: string;
+    }>>;
+}
+/**
+ * 依存性注入用インターフェース: Webスクレイパー
+ */
+export interface IScraper {
+    scrape(url: string): Promise<{
+        ok: true;
+        value: {
+            content: string;
+            title: string;
+        };
+    } | {
+        ok: false;
+        error: Error;
+    }>;
+}
+/**
+ * 依存性注入用インターフェース: テキスト分析
+ */
+export interface ITextAnalyzer {
+    analyze(text: string): Promise<{
+        keywords: string[];
+        sentiment?: string;
+    }>;
+}
+/**
+ * 依存性注入用インターフェース: エンティティ抽出
+ */
+export interface IEntityExtractor {
+    extract(text: string): Promise<{
+        persons: string[];
+        organizations: string[];
+        all: Array<{
+            text: string;
+            type: string;
+        }>;
+    }>;
+}
+/**
+ * CascadingAgentの依存性
+ */
+export interface CascadingAgentDependencies {
+    searchClient: ISearchClient;
+    scraper: IScraper;
+    textAnalyzer?: ITextAnalyzer;
+    entityExtractor?: IEntityExtractor;
+}
+/**
+ * CascadingAgentの設定
+ */
+export interface CascadingAgentConfig {
+    /** エージェントID */
+    id: string;
+    /** エージェントの役割 */
+    role: AgentRole;
+    /** エージェント戦略 */
+    strategy: CascadingAgentStrategy;
+    /** タイムアウト (ms) */
+    timeoutMs: number;
+    /** 最大リトライ回数 */
+    maxRetries: number;
+    /** 最大検索結果数 */
+    maxResults: number;
+}
+/**
+ * カスケードエージェント
+ */
+export declare class CascadingAgent {
+    private readonly config;
+    private readonly deps;
+    constructor(config: CascadingAgentConfig, deps: CascadingAgentDependencies);
+    /**
+     * エージェントIDを取得
+     */
+    get id(): string;
+    /**
+     * エージェントの役割を取得
+     */
+    get role(): AgentRole;
+    /**
+     * リサーチを実行
+     */
+    research(context: StepContext): Promise<CascadingAgentReport>;
+    /**
+     * 検索クエリを構築
+     */
+    private buildQuery;
+    /**
+     * 検索を実行
+     */
+    private executeSearch;
+    /**
+     * コンテンツをスクレイピング
+     */
+    private scrapeContents;
+    /**
+     * URLから信頼度を推定
+     */
+    private estimateCredibility;
+    /**
+     * 発見事項を抽出
+     */
+    private extractFindings;
+    /**
+     * コンテンツから発見事項を抽出
+     */
+    private extractFindingsFromContent;
+    /**
+     * コンテンツがトピックに関連しているか判定
+     */
+    private isRelevant;
+    /**
+     * コンテンツをカテゴリ分類
+     */
+    private categorizeContent;
+    /**
+     * URLからドメインを抽出
+     */
+    private extractDomain;
+    /**
+     * ギャップを分析
+     */
+    private analyzeGaps;
+    /**
+     * レポートを生成
+     */
+    private generateReport;
+}
+/**
+ * エージェントファクトリー
+ */
+export declare function createCascadingAgents(strategies: CascadingAgentStrategy[], deps: CascadingAgentDependencies, options: {
+    timeoutMs: number;
+    maxRetries: number;
+    maxResults: number;
+}): CascadingAgent[];
+//# sourceMappingURL=CascadingAgent.d.ts.map