@nahisaho/katashiro-analyzer 2.0.13 → 2.1.1

package/dist/research/agent/TokenTracker.d.ts

@@ -0,0 +1,100 @@
+/**
+ * TokenTracker - トークン使用量追跡
+ *
+ * @requirement REQ-DR-007
+ * @design DES-v2.1.0-DeepResearchAgent
+ */
+import type { TokenUsage } from './types.js';
+/**
+ * TokenTrackerオプション
+ */
+export interface TokenTrackerOptions {
+    /** トークン予算 */
+    budget: number;
+}
+/**
+ * トークン使用量を追跡するクラス
+ *
+ * @example
+ * ```typescript
+ * const tracker = new TokenTracker({ budget: 1_000_000 });
+ *
+ * tracker.trackUsage(100, 50); // promptTokens, completionTokens
+ *
+ * console.log(`Remaining: ${tracker.getRemainingBudget()}`);
+ * console.log(`Usage: ${(tracker.getUsageRatio() * 100).toFixed(1)}%`);
+ * ```
+ */
+export declare class TokenTracker {
+    private budget;
+    private promptTokens;
+    private completionTokens;
+    private usage;
+    private history;
+    constructor(options: TokenTrackerOptions | number);
+    /**
+     * トークン使用量を記録（prompt/completionトークン）
+     */
+    trackUsage(promptTokens: number, completionTokens: number): void;
+    /**
+     * トークン使用量を記録（ツール名付き）
+     */
+    trackUsage(tool: string, usage: TokenUsage): void;
+    /**
+     * 総使用量を取得
+     */
+    getTotalUsage(): number;
+    /**
+     * トークン使用量を取得
+     */
+    getUsage(): TokenUsage;
+    /**
+     * 残り予算を取得
+     */
+    getRemainingBudget(): number;
+    /**
+     * ツール別の使用量を取得
+     */
+    getBreakdown(): Record<string, number>;
+    /**
+     * 予算を超過しているか
+     */
+    isExceeded(): boolean;
+    /**
+     * 使用率を取得（0-1）
+     */
+    getUsageRatio(): number;
+    /**
+     * 残り予算の比率を取得（0-1）
+     */
+    getRemainingRatio(): number;
+    /**
+     * 履歴を取得
+     */
+    getHistory(): Array<{
+        tool: string;
+        usage: TokenUsage;
+        timestamp: string;
+    }>;
+    /**
+     * 予算を更新
+     */
+    setBudget(budget: number): void;
+    /**
+     * リセット
+     */
+    reset(): void;
+    /**
+     * 現在の状態をサマリーとして取得
+     */
+    getSummary(): {
+        budget: number;
+        used: number;
+        remaining: number;
+        usageRatio: number;
+        isExceeded: boolean;
+        breakdown: Record<string, number>;
+    };
+}
+export type { TokenUsage };
+//# sourceMappingURL=TokenTracker.d.ts.map

package/dist/research/agent/TokenTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenTracker.d.ts","sourceRoot":"","sources":["../../../src/research/agent/TokenTracker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,aAAa;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,OAAO,CAAgE;gBAEnE,OAAO,EAAE,mBAAmB,GAAG,MAAM;IAUjD;;OAEG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI;IAChE;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IA8BjD;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,QAAQ,IAAI,UAAU;IAQtB;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACH,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAQtC;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;IACH,UAAU,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAI3E;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,UAAU,IAAI;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,OAAO,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACnC;CAUF;AAGD,YAAY,EAAE,UAAU,EAAE,CAAC"}

package/dist/research/agent/TokenTracker.js

@@ -0,0 +1,150 @@
+/**
+ * TokenTracker - トークン使用量追跡
+ *
+ * @requirement REQ-DR-007
+ * @design DES-v2.1.0-DeepResearchAgent
+ */
+/**
+ * トークン使用量を追跡するクラス
+ *
+ * @example
+ * ```typescript
+ * const tracker = new TokenTracker({ budget: 1_000_000 });
+ *
+ * tracker.trackUsage(100, 50); // promptTokens, completionTokens
+ *
+ * console.log(`Remaining: ${tracker.getRemainingBudget()}`);
+ * console.log(`Usage: ${(tracker.getUsageRatio() * 100).toFixed(1)}%`);
+ * ```
+ */
+export class TokenTracker {
+    budget;
+    promptTokens = 0;
+    completionTokens = 0;
+    usage;
+    history;
+    constructor(options) {
+        if (typeof options === 'number') {
+            this.budget = options;
+        }
+        else {
+            this.budget = options.budget;
+        }
+        this.usage = new Map();
+        this.history = [];
+    }
+    trackUsage(arg1, arg2) {
+        if (typeof arg1 === 'number' && typeof arg2 === 'number') {
+            // trackUsage(promptTokens, completionTokens)
+            this.promptTokens += arg1;
+            this.completionTokens += arg2;
+            const total = arg1 + arg2;
+            const current = this.usage.get('llm') || 0;
+            this.usage.set('llm', current + total);
+            this.history.push({
+                tool: 'llm',
+                usage: { promptTokens: arg1, completionTokens: arg2, totalTokens: total },
+                timestamp: new Date().toISOString(),
+            });
+        }
+        else if (typeof arg1 === 'string' && typeof arg2 === 'object') {
+            // trackUsage(tool, usage)
+            const tool = arg1;
+            const usage = arg2;
+            this.promptTokens += usage.promptTokens;
+            this.completionTokens += usage.completionTokens;
+            const current = this.usage.get(tool) || 0;
+            this.usage.set(tool, current + usage.totalTokens);
+            this.history.push({
+                tool,
+                usage,
+                timestamp: new Date().toISOString(),
+            });
+        }
+    }
+    /**
+     * 総使用量を取得
+     */
+    getTotalUsage() {
+        return this.promptTokens + this.completionTokens;
+    }
+    /**
+     * トークン使用量を取得
+     */
+    getUsage() {
+        return {
+            promptTokens: this.promptTokens,
+            completionTokens: this.completionTokens,
+            totalTokens: this.promptTokens + this.completionTokens,
+        };
+    }
+    /**
+     * 残り予算を取得
+     */
+    getRemainingBudget() {
+        return Math.max(0, this.budget - this.getTotalUsage());
+    }
+    /**
+     * ツール別の使用量を取得
+     */
+    getBreakdown() {
+        const result = {};
+        for (const [tool, count] of this.usage.entries()) {
+            result[tool] = count;
+        }
+        return result;
+    }
+    /**
+     * 予算を超過しているか
+     */
+    isExceeded() {
+        return this.getTotalUsage() >= this.budget;
+    }
+    /**
+     * 使用率を取得（0-1）
+     */
+    getUsageRatio() {
+        return this.getTotalUsage() / this.budget;
+    }
+    /**
+     * 残り予算の比率を取得（0-1）
+     */
+    getRemainingRatio() {
+        return this.getRemainingBudget() / this.budget;
+    }
+    /**
+     * 履歴を取得
+     */
+    getHistory() {
+        return [...this.history];
+    }
+    /**
+     * 予算を更新
+     */
+    setBudget(budget) {
+        this.budget = budget;
+    }
+    /**
+     * リセット
+     */
+    reset() {
+        this.promptTokens = 0;
+        this.completionTokens = 0;
+        this.usage.clear();
+        this.history = [];
+    }
+    /**
+     * 現在の状態をサマリーとして取得
+     */
+    getSummary() {
+        return {
+            budget: this.budget,
+            used: this.getTotalUsage(),
+            remaining: this.getRemainingBudget(),
+            usageRatio: this.getUsageRatio(),
+            isExceeded: this.isExceeded(),
+            breakdown: this.getBreakdown(),
+        };
+    }
+}
+//# sourceMappingURL=TokenTracker.js.map

package/dist/research/agent/TokenTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenTracker.js","sourceRoot":"","sources":["../../../src/research/agent/TokenTracker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,YAAY;IACf,MAAM,CAAS;IACf,YAAY,GAAW,CAAC,CAAC;IACzB,gBAAgB,GAAW,CAAC,CAAC;IAC7B,KAAK,CAAsB;IAC3B,OAAO,CAAgE;IAE/E,YAAY,OAAqC;QAC/C,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;IAUD,UAAU,CAAC,IAAqB,EAAE,IAAyB;QACzD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACzD,6CAA6C;YAC7C,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC;YAC1B,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC;YAC9B,MAAM,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC;YAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAAC,CAAC;YACvC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;gBAChB,IAAI,EAAE,KAAK;gBACX,KAAK,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE;gBACzE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChE,0BAA0B;YAC1B,MAAM,IAAI,GAAG,IAAI,CAAC;YAClB,MAAM,KAAK,GAAG,IAAkB,CAAC;YACjC,IAAI,CAAC,YAAY,IAAI,KAAK,CAAC,YAAY,CAAC;YACxC,IAAI,CAAC,gBAAgB,IAAI,KAAK,CAAC,gBAAgB,CAAC;YAChD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;YAClD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;gBAChB,IAAI;gBACJ,KAAK;gBACL,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO;YACL,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,WAAW,EAAE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,gBAAgB;SACvD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,YAAY;QACV,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YACjD,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACvB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,aAAa,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,aAAa,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,kBAAkB,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAc;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,UAAU;QAQR,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE;YAC1B,SAAS,EAAE,IAAI,CAAC,kBAAkB,EAAE;YACpC,UAAU,EAAE,IAAI,CAAC,aAAa,EAAE;YAChC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE;YAC7B,SAAS,EAAE,IAAI,CAAC,YAAY,EAAE;SAC/B,CAAC;IACJ,CAAC;CACF"}

package/dist/research/agent/actions/AnswerActionHandler.d.ts

@@ -0,0 +1,44 @@
+/**
+ * AnswerActionHandler - 回答生成アクション
+ *
+ * @requirement REQ-DR-001
+ * @requirement REQ-DR-004
+ * @design DES-v2.1.0-DeepResearchAgent
+ */
+import type { LLMClientInterface, AnswerParams, KnowledgeItem } from '../types.js';
+import type { AnswerEvaluator } from '../AnswerEvaluator.js';
+import { BaseActionHandler, type ExecutionContext, type ActionResult, type ActionHandlerOptions } from './BaseActionHandler.js';
+/**
+ * 回答アクションハンドラのオプション
+ */
+export interface AnswerActionHandlerOptions extends ActionHandlerOptions {
+    /** LLMクライアント */
+    llmClient: LLMClientInterface;
+    /** 回答評価器 */
+    evaluator: AnswerEvaluator;
+}
+/**
+ * 回答を生成するアクションハンドラ
+ */
+export declare class AnswerActionHandler extends BaseActionHandler<AnswerParams> {
+    readonly actionType: "answer";
+    private llmClient;
+    private evaluator;
+    constructor(options: AnswerActionHandlerOptions);
+    /**
+     * 回答を生成
+     */
+    execute(params: AnswerParams, context: ExecutionContext): Promise<ActionResult>;
+    /**
+     * ナレッジから回答を生成
+     */
+    private generateAnswer;
+    /**
+     * Beastモード用の強制回答生成
+     */
+    generateForcedAnswer(question: string, knowledge: KnowledgeItem[]): Promise<{
+        answer: string;
+        references: string[];
+    }>;
+}
+//# sourceMappingURL=AnswerActionHandler.d.ts.map

package/dist/research/agent/actions/AnswerActionHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnswerActionHandler.d.ts","sourceRoot":"","sources":["../../../../src/research/agent/actions/AnswerActionHandler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,KAAK,YAAY,EAAE,KAAK,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEhI;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,oBAAoB;IACtE,gBAAgB;IAChB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,YAAY;IACZ,SAAS,EAAE,eAAe,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,iBAAiB,CAAC,YAAY,CAAC;IACtE,QAAQ,CAAC,UAAU,EAAG,QAAQ,CAAU;IAExC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,SAAS,CAAkB;gBAEvB,OAAO,EAAE,0BAA0B;IAM/C;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IA6CrF;;OAEG;YACW,cAAc;IA+D5B;;OAEG;IACG,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,aAAa,EAAE,GACzB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAyDrD"}

package/dist/research/agent/actions/AnswerActionHandler.js

@@ -0,0 +1,158 @@
+/**
+ * AnswerActionHandler - 回答生成アクション
+ *
+ * @requirement REQ-DR-001
+ * @requirement REQ-DR-004
+ * @design DES-v2.1.0-DeepResearchAgent
+ */
+import { BaseActionHandler } from './BaseActionHandler.js';
+/**
+ * 回答を生成するアクションハンドラ
+ */
+export class AnswerActionHandler extends BaseActionHandler {
+    actionType = 'answer';
+    llmClient;
+    evaluator;
+    constructor(options) {
+        super(options);
+        this.llmClient = options.llmClient;
+        this.evaluator = options.evaluator;
+    }
+    /**
+     * 回答を生成
+     */
+    async execute(params, context) {
+        const { isFinal } = params;
+        try {
+            // ナレッジから回答を生成
+            const generatedAnswer = await this.generateAnswer(context.question, context.currentKnowledge);
+            // 回答を評価
+            const evaluation = await this.evaluator.evaluate(context.question, generatedAnswer.answer, context.currentKnowledge);
+            // 評価結果をナレッジアイテムとして保存
+            const item = this.createKnowledgeItem(`Answer Attempt:\n\n${generatedAnswer.answer}\n\nEvaluation: ${evaluation.pass ? 'PASS' : 'FAIL'}\nDetails: ${evaluation.think}`, {
+                type: 'reflection',
+                title: isFinal ? 'Final Answer' : 'Answer Attempt',
+            });
+            return {
+                success: evaluation.pass || isFinal === true,
+                knowledgeItems: [item],
+                metadata: {
+                    answer: generatedAnswer.answer,
+                    references: generatedAnswer.references,
+                    evaluation,
+                    isFinal: isFinal === true,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                knowledgeItems: [],
+                error: error instanceof Error ? error.message : 'Answer generation failed',
+            };
+        }
+    }
+    /**
+     * ナレッジから回答を生成
+     */
+    async generateAnswer(question, knowledge) {
+        // ナレッジをコンテキストとして構築
+        const knowledgeContext = knowledge
+            .map((k) => `[${k.id}] ${k.summary}\nSource: ${k.sourceId}`)
+            .join('\n\n');
+        const prompt = `Based on the gathered knowledge, provide a comprehensive answer to the question.
+
+Question: "${question}"
+
+Available Knowledge:
+${knowledgeContext || 'No knowledge available.'}
+
+Instructions:
+1. Synthesize information from multiple sources
+2. Provide a well-structured answer
+3. Cite sources using [source-id] format
+4. Acknowledge any gaps in the available information
+5. Be factual and avoid speculation
+
+Respond in JSON format:
+{
+  "answer": "Your comprehensive answer here...",
+  "references": ["source-id-1", "source-id-2"]
+}`;
+        const response = await this.llmClient.chat({
+            messages: [{ role: 'user', content: prompt }],
+            temperature: 0.7,
+            maxTokens: 2000,
+        });
+        // トークン追跡
+        if (response.usage) {
+            this.tokenTracker.trackUsage(response.usage.promptTokens ?? 0, response.usage.completionTokens ?? 0);
+        }
+        try {
+            const jsonMatch = response.content.match(/\{[\s\S]*\}/);
+            if (jsonMatch) {
+                const parsed = JSON.parse(jsonMatch[0]);
+                return parsed;
+            }
+        }
+        catch {
+            // パース失敗
+        }
+        // デフォルト
+        return {
+            answer: response.content,
+            references: knowledge.map((k) => k.sourceId),
+        };
+    }
+    /**
+     * Beastモード用の強制回答生成
+     */
+    async generateForcedAnswer(question, knowledge) {
+        const knowledgeContext = knowledge
+            .map((k) => k.summary)
+            .join('\n')
+            .slice(0, 5000);
+        const prompt = `You MUST provide an answer now, even if incomplete.
+
+Question: "${question}"
+
+Available Information:
+${knowledgeContext || 'Limited information available.'}
+
+Instructions:
+1. Provide the best possible answer with available information
+2. Clearly indicate what is known vs. unknown
+3. Suggest areas for further research if needed
+
+Respond in JSON format:
+{
+  "answer": "Your answer here...",
+  "references": [],
+  "limitations": "What is not covered..."
+}`;
+        const response = await this.llmClient.chat({
+            messages: [{ role: 'user', content: prompt }],
+            temperature: 0.5,
+            maxTokens: 2000,
+        });
+        // トークン追跡
+        if (response.usage) {
+            this.tokenTracker.trackUsage(response.usage.promptTokens ?? 0, response.usage.completionTokens ?? 0);
+        }
+        try {
+            const jsonMatch = response.content.match(/\{[\s\S]*\}/);
+            if (jsonMatch) {
+                const parsed = JSON.parse(jsonMatch[0]);
+                return parsed;
+            }
+        }
+        catch {
+            // パース失敗
+        }
+        return {
+            answer: response.content,
+            references: [],
+        };
+    }
+}
+//# sourceMappingURL=AnswerActionHandler.js.map

package/dist/research/agent/actions/AnswerActionHandler.js.map

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

package/dist/research/agent/actions/BaseActionHandler.d.ts

@@ -0,0 +1,87 @@
+/**
+ * アクションハンドラの基底クラスとインターフェース
+ *
+ * @requirement REQ-DR-001
+ * @design DES-v2.1.0-DeepResearchAgent
+ */
+import type { ActionType, KnowledgeItem, AgentConfig } from '../types.js';
+import type { TokenTracker } from '../TokenTracker.js';
+/**
+ * アクション実行結果
+ */
+export interface ActionResult {
+    /** 成功したか */
+    success: boolean;
+    /** 取得したナレッジアイテム */
+    knowledgeItems: KnowledgeItem[];
+    /** エラーメッセージ（失敗時） */
+    error?: string;
+    /** 追加のメタデータ */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * アクションハンドラのオプション
+ */
+export interface ActionHandlerOptions {
+    /** エージェント設定 */
+    config: AgentConfig;
+    /** トークントラッカー */
+    tokenTracker: TokenTracker;
+}
+/**
+ * アクションハンドラの基底インターフェース
+ */
+export interface IActionHandler<TParams = unknown> {
+    /** アクションタイプ */
+    readonly actionType: ActionType;
+    /**
+     * アクションを実行
+     */
+    execute(params: TParams, context: ExecutionContext): Promise<ActionResult>;
+}
+/**
+ * アクション実行コンテキスト（簡易版）
+ */
+export interface ExecutionContext {
+    /** 元の質問 */
+    question: string;
+    /** 現在のステップ番号 */
+    stepNumber: number;
+    /** 訪問済みURL */
+    visitedUrls: string[];
+    /** 検索結果からのURL候補 */
+    searchResultUrls: {
+        index: number;
+        url: string;
+        title: string;
+    }[];
+    /** 現在のナレッジ */
+    currentKnowledge: KnowledgeItem[];
+}
+/**
+ * アクションハンドラの基底抽象クラス
+ */
+export declare abstract class BaseActionHandler<TParams = unknown> implements IActionHandler<TParams> {
+    abstract readonly actionType: ActionType;
+    protected config: AgentConfig;
+    protected tokenTracker: TokenTracker;
+    constructor(options: ActionHandlerOptions);
+    abstract execute(params: TParams, context: ExecutionContext): Promise<ActionResult>;
+    /**
+     * ナレッジアイテムを生成
+     */
+    protected createKnowledgeItem(content: string, source: {
+        url?: string;
+        title?: string;
+        type: 'web' | 'code' | 'reflection';
+    }): KnowledgeItem;
+    /**
+     * コンテンツから要約を生成
+     */
+    private createSummary;
+    /**
+     * コンテンツからキーワードを抽出
+     */
+    private extractKeywords;
+}
+//# sourceMappingURL=BaseActionHandler.d.ts.map

package/dist/research/agent/actions/BaseActionHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseActionHandler.d.ts","sourceRoot":"","sources":["../../../../src/research/agent/actions/BaseActionHandler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB;IACnB,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,eAAe;IACf,MAAM,EAAE,WAAW,CAAC;IACpB,gBAAgB;IAChB,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,OAAO,GAAG,OAAO;IAC/C,eAAe;IACf,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAEhC;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC5E;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc;IACd,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,mBAAmB;IACnB,gBAAgB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClE,cAAc;IACd,gBAAgB,EAAE,aAAa,EAAE,CAAC;CACnC;AAED;;GAEG;AACH,8BAAsB,iBAAiB,CAAC,OAAO,GAAG,OAAO,CAAE,YAAW,cAAc,CAAC,OAAO,CAAC;IAC3F,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAEzC,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC;IAC9B,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC;gBAEzB,OAAO,EAAE,oBAAoB;IAKzC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IAEnF;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAC3B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,YAAY,CAAA;KAAE,GAC5E,aAAa;IAmBhB;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACH,OAAO,CAAC,eAAe;CAiBxB"}

package/dist/research/agent/actions/BaseActionHandler.js

@@ -0,0 +1,67 @@
+/**
+ * アクションハンドラの基底クラスとインターフェース
+ *
+ * @requirement REQ-DR-001
+ * @design DES-v2.1.0-DeepResearchAgent
+ */
+/**
+ * アクションハンドラの基底抽象クラス
+ */
+export class BaseActionHandler {
+    config;
+    tokenTracker;
+    constructor(options) {
+        this.config = options.config;
+        this.tokenTracker = options.tokenTracker;
+    }
+    /**
+     * ナレッジアイテムを生成
+     */
+    createKnowledgeItem(content, source) {
+        const now = new Date();
+        const id = `ki-${now.getTime()}-${Math.random().toString(36).slice(2, 8)}`;
+        return {
+            id,
+            sourceId: source.url || `internal-${id}`,
+            sourceType: source.type,
+            summary: this.createSummary(content),
+            content,
+            keywords: this.extractKeywords(content),
+            timestamp: now.toISOString(),
+            metadata: {
+                title: source.title,
+                url: source.url,
+            },
+        };
+    }
+    /**
+     * コンテンツから要約を生成
+     */
+    createSummary(content) {
+        // 最初の300文字を要約として使用
+        const cleaned = content.replace(/\s+/g, ' ').trim();
+        if (cleaned.length <= 300) {
+            return cleaned;
+        }
+        return cleaned.slice(0, 297) + '...';
+    }
+    /**
+     * コンテンツからキーワードを抽出
+     */
+    extractKeywords(content) {
+        // 簡易的なキーワード抽出
+        const words = content
+            .toLowerCase()
+            .replace(/[^\w\s]/g, ' ')
+            .split(/\s+/)
+            .filter((w) => w.length > 3);
+        // 頻度でソート
+        const freq = new Map();
+        for (const word of words) {
+            freq.set(word, (freq.get(word) || 0) + 1);
+        }
+        const sorted = [...freq.entries()].sort((a, b) => b[1] - a[1]);
+        return sorted.slice(0, 10).map(([word]) => word);
+    }
+}
+//# sourceMappingURL=BaseActionHandler.js.map

package/dist/research/agent/actions/BaseActionHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseActionHandler.js","sourceRoot":"","sources":["../../../../src/research/agent/actions/BaseActionHandler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0DH;;GAEG;AACH,MAAM,OAAgB,iBAAiB;IAG3B,MAAM,CAAc;IACpB,YAAY,CAAe;IAErC,YAAY,OAA6B;QACvC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC3C,CAAC;IAID;;OAEG;IACO,mBAAmB,CAC3B,OAAe,EACf,MAA6E;QAE7E,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAE3E,OAAO;YACL,EAAE;YACF,QAAQ,EAAE,MAAM,CAAC,GAAG,IAAI,YAAY,EAAE,EAAE;YACxC,UAAU,EAAE,MAAM,CAAC,IAAI;YACvB,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;YACpC,OAAO;YACP,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;YACvC,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE;YAC5B,QAAQ,EAAE;gBACR,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,GAAG,EAAE,MAAM,CAAC,GAAG;aAChB;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,OAAe;QACnC,mBAAmB;QACnB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACpD,IAAI,OAAO,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;YAC1B,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC;IACvC,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,OAAe;QACrC,cAAc;QACd,MAAM,KAAK,GAAG,OAAO;aAClB,WAAW,EAAE;aACb,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;aACxB,KAAK,CAAC,KAAK,CAAC;aACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAE/B,SAAS;QACT,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;QACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5C,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;CACF"}