@nahisaho/katashiro-orchestrator 1.2.0 → 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 nahisaho
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/agent/AgentStateManager.d.ts

@@ -0,0 +1,133 @@
+/**
+ * AgentStateManager - エージェント状態管理
+ *
+ * @requirement REQ-AGENT-002
+ * @description エージェントの状態を管理するクラス
+ */
+import type { AgentState, AgentAction, AddActionInput, CreateAgentStateOptions, AgentStateManagerConfig, AgentStateStatus } from './types.js';
+/**
+ * エージェント状態マネージャー
+ *
+ * エージェントの状態（会話履歴、コンテキスト、中間結果）を管理します。
+ *
+ * @example
+ * ```typescript
+ * const manager = new AgentStateManager();
+ *
+ * // 状態を作成
+ * const state = manager.create({ maxSteps: 10 });
+ *
+ * // アクションを追加
+ * const updatedState = manager.addAction(state, {
+ *   type: 'thought',
+ *   content: { thought: 'ユーザーの質問を分析中...' }
+ * });
+ *
+ * // ツール呼び出しを追加
+ * const withToolCall = manager.addAction(updatedState, {
+ *   type: 'tool_call',
+ *   content: { tool: 'web_search', params: { query: 'AI news' } }
+ * });
+ *
+ * // シリアライズ
+ * const json = manager.serialize(withToolCall);
+ *
+ * // デシリアライズ
+ * const restored = manager.deserialize(json);
+ * ```
+ */
+export declare class AgentStateManager {
+    private config;
+    constructor(config?: AgentStateManagerConfig);
+    /**
+     * 新しいエージェント状態を作成
+     */
+    create(options?: CreateAgentStateOptions): AgentState;
+    /**
+     * アクションを追加
+     *
+     * @returns 新しい状態（イミュータブル）
+     */
+    addAction(state: AgentState, action: AddActionInput): AgentState;
+    /**
+     * 中間結果を追加
+     */
+    addIntermediateResult(state: AgentState, result: unknown): AgentState;
+    /**
+     * コンテキストを更新
+     */
+    updateContext(state: AgentState, updates: Record<string, unknown>): AgentState;
+    /**
+     * ステータスを更新
+     */
+    updateStatus(state: AgentState, status: AgentStateStatus): AgentState;
+    /**
+     * 状態をリセット（履歴をクリア）
+     */
+    reset(state: AgentState): AgentState;
+    /**
+     * 状態をシリアライズ（JSON文字列に変換）
+     */
+    serialize(state: AgentState): string;
+    /**
+     * JSON文字列から状態をデシリアライズ
+     */
+    deserialize(json: string): AgentState;
+    /**
+     * 最大ステップに達したかどうか
+     */
+    isMaxStepsReached(state: AgentState): boolean;
+    /**
+     * 完了したかどうか
+     */
+    isCompleted(state: AgentState): boolean;
+    /**
+     * 実行中かどうか
+     */
+    isRunning(state: AgentState): boolean;
+    /**
+     * 最後のアクションを取得
+     */
+    getLastAction(state: AgentState): AgentAction | undefined;
+    /**
+     * 特定タイプのアクションを取得
+     */
+    getActionsByType(state: AgentState, type: AgentAction['type']): AgentAction[];
+    /**
+     * ツール呼び出し履歴を取得
+     */
+    getToolCalls(state: AgentState): AgentAction[];
+    /**
+     * 思考履歴を取得
+     */
+    getThoughts(state: AgentState): AgentAction[];
+    /**
+     * 状態のサマリーを取得
+     */
+    getSummary(state: AgentState): AgentStateSummary;
+    /**
+     * 状態からステータスを判定
+     */
+    private determineStatus;
+}
+/**
+ * 状態サマリー
+ */
+export interface AgentStateSummary {
+    conversationId: string;
+    status: AgentStateStatus;
+    currentStep: number;
+    maxSteps: number;
+    totalActions: number;
+    toolCallCount: number;
+    thoughtCount: number;
+    observationCount: number;
+    hasIntermediateResults: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * デフォルトのAgentStateManagerインスタンス
+ */
+export declare const defaultAgentStateManager: AgentStateManager;
+//# sourceMappingURL=AgentStateManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentStateManager.d.ts","sourceRoot":"","sources":["../../src/agent/AgentStateManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,uBAAuB,EAEvB,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAWpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAoC;gBAEtC,MAAM,GAAE,uBAA4B;IAIhD;;OAEG;IACH,MAAM,CAAC,OAAO,GAAE,uBAA4B,GAAG,UAAU;IAgBzD;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,GAAG,UAAU;IAmBhE;;OAEG;IACH,qBAAqB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,GAAG,UAAU;IAQrE;;OAEG;IACH,aAAa,CACX,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,UAAU;IAQb;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,GAAG,UAAU;IAQrE;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU;IAapC;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;IAQpC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAiBrC;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO;IAI7C;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO;IAIvC;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO;IAIrC;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS;IAIzD;;OAEG;IACH,gBAAgB,CACd,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GACxB,WAAW,EAAE;IAIhB;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,EAAE;IAI9C;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,EAAE;IAI7C;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,iBAAiB;IAoBhD;;OAEG;IACH,OAAO,CAAC,eAAe;CAiBxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,OAAO,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,mBAA0B,CAAC"}

package/dist/agent/AgentStateManager.js

@@ -0,0 +1,243 @@
+"use strict";
+/**
+ * AgentStateManager - エージェント状態管理
+ *
+ * @requirement REQ-AGENT-002
+ * @description エージェントの状態を管理するクラス
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultAgentStateManager = exports.AgentStateManager = void 0;
+/** シリアライズバージョン */
+const SERIALIZATION_VERSION = '1.0.0';
+/** デフォルト設定 */
+const DEFAULT_CONFIG = {
+    defaultMaxSteps: 10,
+    idGenerator: () => `agent-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`,
+};
+/**
+ * エージェント状態マネージャー
+ *
+ * エージェントの状態（会話履歴、コンテキスト、中間結果）を管理します。
+ *
+ * @example
+ * ```typescript
+ * const manager = new AgentStateManager();
+ *
+ * // 状態を作成
+ * const state = manager.create({ maxSteps: 10 });
+ *
+ * // アクションを追加
+ * const updatedState = manager.addAction(state, {
+ *   type: 'thought',
+ *   content: { thought: 'ユーザーの質問を分析中...' }
+ * });
+ *
+ * // ツール呼び出しを追加
+ * const withToolCall = manager.addAction(updatedState, {
+ *   type: 'tool_call',
+ *   content: { tool: 'web_search', params: { query: 'AI news' } }
+ * });
+ *
+ * // シリアライズ
+ * const json = manager.serialize(withToolCall);
+ *
+ * // デシリアライズ
+ * const restored = manager.deserialize(json);
+ * ```
+ */
+class AgentStateManager {
+    config;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * 新しいエージェント状態を作成
+     */
+    create(options = {}) {
+        const now = new Date().toISOString();
+        return {
+            conversationId: options.conversationId ?? this.config.idGenerator(),
+            currentStep: 0,
+            maxSteps: options.maxSteps ?? this.config.defaultMaxSteps,
+            history: [],
+            context: options.context ?? {},
+            intermediateResults: [],
+            createdAt: now,
+            updatedAt: now,
+            status: 'idle',
+        };
+    }
+    /**
+     * アクションを追加
+     *
+     * @returns 新しい状態（イミュータブル）
+     */
+    addAction(state, action) {
+        const now = new Date().toISOString();
+        const newStep = state.currentStep + 1;
+        const newAction = {
+            ...action,
+            step: newStep,
+            timestamp: now,
+        };
+        return {
+            ...state,
+            currentStep: newStep,
+            history: [...state.history, newAction],
+            updatedAt: now,
+            status: this.determineStatus(state, newAction),
+        };
+    }
+    /**
+     * 中間結果を追加
+     */
+    addIntermediateResult(state, result) {
+        return {
+            ...state,
+            intermediateResults: [...state.intermediateResults, result],
+            updatedAt: new Date().toISOString(),
+        };
+    }
+    /**
+     * コンテキストを更新
+     */
+    updateContext(state, updates) {
+        return {
+            ...state,
+            context: { ...state.context, ...updates },
+            updatedAt: new Date().toISOString(),
+        };
+    }
+    /**
+     * ステータスを更新
+     */
+    updateStatus(state, status) {
+        return {
+            ...state,
+            status,
+            updatedAt: new Date().toISOString(),
+        };
+    }
+    /**
+     * 状態をリセット（履歴をクリア）
+     */
+    reset(state) {
+        const now = new Date().toISOString();
+        return {
+            ...state,
+            currentStep: 0,
+            history: [],
+            intermediateResults: [],
+            updatedAt: now,
+            status: 'idle',
+        };
+    }
+    /**
+     * 状態をシリアライズ（JSON文字列に変換）
+     */
+    serialize(state) {
+        const serialized = {
+            version: SERIALIZATION_VERSION,
+            data: state,
+        };
+        return JSON.stringify(serialized, null, 2);
+    }
+    /**
+     * JSON文字列から状態をデシリアライズ
+     */
+    deserialize(json) {
+        const parsed = JSON.parse(json);
+        if (!parsed.version || !parsed.data) {
+            throw new Error('Invalid serialized agent state format');
+        }
+        // バージョンチェック（将来的なマイグレーション用）
+        if (parsed.version !== SERIALIZATION_VERSION) {
+            console.warn(`Agent state version mismatch: expected ${SERIALIZATION_VERSION}, got ${parsed.version}`);
+        }
+        return parsed.data;
+    }
+    /**
+     * 最大ステップに達したかどうか
+     */
+    isMaxStepsReached(state) {
+        return state.currentStep >= state.maxSteps;
+    }
+    /**
+     * 完了したかどうか
+     */
+    isCompleted(state) {
+        return state.status === 'completed';
+    }
+    /**
+     * 実行中かどうか
+     */
+    isRunning(state) {
+        return state.status === 'running';
+    }
+    /**
+     * 最後のアクションを取得
+     */
+    getLastAction(state) {
+        return state.history.at(-1);
+    }
+    /**
+     * 特定タイプのアクションを取得
+     */
+    getActionsByType(state, type) {
+        return state.history.filter((action) => action.type === type);
+    }
+    /**
+     * ツール呼び出し履歴を取得
+     */
+    getToolCalls(state) {
+        return this.getActionsByType(state, 'tool_call');
+    }
+    /**
+     * 思考履歴を取得
+     */
+    getThoughts(state) {
+        return this.getActionsByType(state, 'thought');
+    }
+    /**
+     * 状態のサマリーを取得
+     */
+    getSummary(state) {
+        const toolCalls = this.getToolCalls(state);
+        const observations = this.getActionsByType(state, 'observation');
+        const thoughts = this.getThoughts(state);
+        return {
+            conversationId: state.conversationId,
+            status: state.status,
+            currentStep: state.currentStep,
+            maxSteps: state.maxSteps,
+            totalActions: state.history.length,
+            toolCallCount: toolCalls.length,
+            thoughtCount: thoughts.length,
+            observationCount: observations.length,
+            hasIntermediateResults: state.intermediateResults.length > 0,
+            createdAt: state.createdAt,
+            updatedAt: state.updatedAt,
+        };
+    }
+    /**
+     * 状態からステータスを判定
+     */
+    determineStatus(state, newAction) {
+        // 最終回答があれば完了
+        if (newAction.type === 'final_answer') {
+            return 'completed';
+        }
+        // 最大ステップに達したら失敗
+        if (state.currentStep + 1 >= state.maxSteps) {
+            return 'failed';
+        }
+        // それ以外は実行中
+        return 'running';
+    }
+}
+exports.AgentStateManager = AgentStateManager;
+/**
+ * デフォルトのAgentStateManagerインスタンス
+ */
+exports.defaultAgentStateManager = new AgentStateManager();
+//# sourceMappingURL=AgentStateManager.js.map

package/dist/agent/AgentStateManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentStateManager.js","sourceRoot":"","sources":["../../src/agent/AgentStateManager.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAYH,kBAAkB;AAClB,MAAM,qBAAqB,GAAG,OAAO,CAAC;AAEtC,cAAc;AACd,MAAM,cAAc,GAAsC;IACxD,eAAe,EAAE,EAAE;IACnB,WAAW,EAAE,GAAG,EAAE,CAAC,SAAS,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;CACpF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAa,iBAAiB;IACpB,MAAM,CAAoC;IAElD,YAAY,SAAkC,EAAE;QAC9C,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAmC,EAAE;QAC1C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAErC,OAAO;YACL,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE;YACnE,WAAW,EAAE,CAAC;YACd,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,eAAe;YACzD,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,mBAAmB,EAAE,EAAE;YACvB,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;YACd,MAAM,EAAE,MAAM;SACf,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAC,KAAiB,EAAE,MAAsB;QACjD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC;QAEtC,MAAM,SAAS,GAAgB;YAC7B,GAAG,MAAM;YACT,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,GAAG;SACf,CAAC;QAEF,OAAO;YACL,GAAG,KAAK;YACR,WAAW,EAAE,OAAO;YACpB,OAAO,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC;YACtC,SAAS,EAAE,GAAG;YACd,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,SAAS,CAAC;SAC/C,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,qBAAqB,CAAC,KAAiB,EAAE,MAAe;QACtD,OAAO;YACL,GAAG,KAAK;YACR,mBAAmB,EAAE,CAAC,GAAG,KAAK,CAAC,mBAAmB,EAAE,MAAM,CAAC;YAC3D,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,aAAa,CACX,KAAiB,EACjB,OAAgC;QAEhC,OAAO;YACL,GAAG,KAAK;YACR,OAAO,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE;YACzC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,KAAiB,EAAE,MAAwB;QACtD,OAAO;YACL,GAAG,KAAK;YACR,MAAM;YACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAiB;QACrB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAErC,OAAO;YACL,GAAG,KAAK;YACR,WAAW,EAAE,CAAC;YACd,OAAO,EAAE,EAAE;YACX,mBAAmB,EAAE,EAAE;YACvB,SAAS,EAAE,GAAG;YACd,MAAM,EAAE,MAAM;SACf,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,KAAiB;QACzB,MAAM,UAAU,GAAyB;YACvC,OAAO,EAAE,qBAAqB;YAC9B,IAAI,EAAE,KAAK;SACZ,CAAC;QACF,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,IAAY;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAyB,CAAC;QAExD,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QAED,2BAA2B;QAC3B,IAAI,MAAM,CAAC,OAAO,KAAK,qBAAqB,EAAE,CAAC;YAC7C,OAAO,CAAC,IAAI,CACV,0CAA0C,qBAAqB,SAAS,MAAM,CAAC,OAAO,EAAE,CACzF,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,KAAiB;QACjC,OAAO,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,QAAQ,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,KAAiB;QAC3B,OAAO,KAAK,CAAC,MAAM,KAAK,WAAW,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,KAAiB;QACzB,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,KAAiB;QAC7B,OAAO,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,gBAAgB,CACd,KAAiB,EACjB,IAAyB;QAEzB,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAChE,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,KAAiB;QAC5B,OAAO,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,KAAiB;QAC3B,OAAO,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,KAAiB;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAEzC,OAAO;YACL,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM;YAClC,aAAa,EAAE,SAAS,CAAC,MAAM;YAC/B,YAAY,EAAE,QAAQ,CAAC,MAAM;YAC7B,gBAAgB,EAAE,YAAY,CAAC,MAAM;YACrC,sBAAsB,EAAE,KAAK,CAAC,mBAAmB,CAAC,MAAM,GAAG,CAAC;YAC5D,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,eAAe,CACrB,KAAiB,EACjB,SAAsB;QAEtB,aAAa;QACb,IAAI,SAAS,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACtC,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,gBAAgB;QAChB,IAAI,KAAK,CAAC,WAAW,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC5C,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,WAAW;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AApOD,8CAoOC;AAmBD;;GAEG;AACU,QAAA,wBAAwB,GAAG,IAAI,iBAAiB,EAAE,CAAC"}

package/dist/agent/ReActHelper.d.ts

@@ -0,0 +1,139 @@
+/**
+ * ReAct Helper
+ *
+ * ReAct（Reasoning + Acting）パターンの出力をパースするヘルパー
+ *
+ * @requirement REQ-AGENT-004
+ */
+import type { AgentAction } from './types.js';
+/**
+ * ReAct出力のパース結果
+ */
+export interface ReActParseResult {
+    /** パース成功したか */
+    success: boolean;
+    /** 抽出されたアクション */
+    actions: ReActStep[];
+    /** 最終回答（存在する場合） */
+    finalAnswer?: string;
+    /** パースエラー */
+    errors: string[];
+    /** 生のテキスト */
+    rawText: string;
+}
+/**
+ * ReActステップ
+ */
+export interface ReActStep {
+    /** ステップ番号 */
+    step: number;
+    /** 思考（Thought） */
+    thought?: string;
+    /** アクション（Action） */
+    action?: {
+        tool: string;
+        input: string | Record<string, unknown>;
+    };
+    /** 観察（Observation） */
+    observation?: string;
+    /** 最終回答 */
+    finalAnswer?: string;
+}
+/**
+ * ReActフォーマット設定
+ */
+export interface ReActFormatConfig {
+    /** 思考のプレフィックス */
+    thoughtPrefix?: string;
+    /** アクションのプレフィックス */
+    actionPrefix?: string;
+    /** アクション入力のプレフィックス */
+    actionInputPrefix?: string;
+    /** 観察のプレフィックス */
+    observationPrefix?: string;
+    /** 最終回答のプレフィックス */
+    finalAnswerPrefix?: string;
+    /** 大文字小文字を区別しない */
+    caseInsensitive?: boolean;
+}
+/**
+ * デフォルトのReActフォーマット
+ */
+export declare const DEFAULT_REACT_FORMAT: Required<ReActFormatConfig>;
+/**
+ * ReActプロンプトテンプレート
+ */
+export declare const REACT_SYSTEM_PROMPT = "You are an AI assistant that uses the ReAct (Reasoning and Acting) pattern.\n\nFor each step, you should:\n1. **Thought**: Think about what you need to do next\n2. **Action**: Choose a tool to use\n3. **Action Input**: Provide the input for the tool\n4. **Observation**: (This will be filled in with the tool's output)\n\nContinue this process until you can provide a final answer.\n\nWhen you have enough information to answer the question, respond with:\nFinal Answer: [your answer]\n\nFormat your response as:\nThought: [your reasoning]\nAction: [tool name]\nAction Input: [tool input]\n\nAvailable tools:\n{tools}\n";
+/**
+ * ReActヘルパー
+ */
+export declare class ReActHelper {
+    private config;
+    constructor(config?: ReActFormatConfig);
+    /**
+     * ReAct形式のテキストをパース
+     */
+    parse(text: string): ReActParseResult;
+    /**
+     * ReActステップをAgentActionに変換
+     */
+    toAgentActions(steps: ReActStep[]): AgentAction[];
+    /**
+     * AgentActionからReAct形式のテキストを生成
+     */
+    format(actions: AgentAction[]): string;
+    /**
+     * ツール呼び出しを抽出（次のアクションを取得）
+     */
+    extractNextAction(text: string): {
+        tool: string;
+        input: string | Record<string, unknown>;
+    } | null;
+    /**
+     * 最終回答かどうかを判定
+     */
+    isFinalAnswer(text: string): boolean;
+    /**
+     * 最終回答を抽出
+     */
+    extractFinalAnswer(text: string): string | null;
+    /**
+     * プロンプトにObservationを追加
+     */
+    appendObservation(prompt: string, observation: string): string;
+    /**
+     * システムプロンプトを生成
+     */
+    generateSystemPrompt(tools: Array<{
+        name: string;
+        description: string;
+    }>): string;
+    /**
+     * プレフィックスマッチ
+     */
+    private matchesPrefix;
+    /**
+     * プレフィックス後の値を抽出
+     */
+    private extractValue;
+    /**
+     * アクション入力をパース
+     */
+    private parseActionInput;
+    /**
+     * 設定を取得
+     */
+    getConfig(): Required<ReActFormatConfig>;
+}
+/**
+ * シンプルなパースヘルパー
+ */
+export declare function parseReActOutput(text: string): ReActParseResult;
+/**
+ * シンプルな次アクション抽出ヘルパー
+ */
+export declare function extractNextReActAction(text: string): {
+    tool: string;
+    input: string | Record<string, unknown>;
+} | null;
+//# sourceMappingURL=ReActHelper.d.ts.map

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

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