@nahisaho/katashiro-rag 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/RAGEngine.d.ts

@@ -0,0 +1,58 @@
+/**
+ * RAG Engine - RAGシステムのファサード
+ *
+ * @requirement REQ-RAG-005
+ * @design DES-KATASHIRO-003-RAG §3.5
+ */
+import type { Chunk, ChunkingConfig, Document, EmbeddingProvider, RAGEngineConfig, RetrieverConfig, SearchResult, VectorStore } from './types.js';
+/**
+ * RAGエンジン
+ * ドキュメント処理、インデックス作成、検索を統合したファサード
+ */
+export declare class RAGEngine {
+    private chunker;
+    private retriever;
+    constructor(embeddingProvider: EmbeddingProvider, vectorStore: VectorStore, config?: RAGEngineConfig);
+    /**
+     * ドキュメントをインデックスに追加
+     * チャンキング、埋め込み生成、インデックス追加を一括実行
+     */
+    ingest(document: Document): Promise<Chunk[]>;
+    /**
+     * 複数ドキュメントをバッチでインデックスに追加
+     */
+    ingestBatch(documents: Document[]): Promise<Chunk[]>;
+    /**
+     * クエリで関連チャンクを検索
+     */
+    query(query: string): Promise<SearchResult[]>;
+    /**
+     * 複数クエリで検索
+     */
+    queryMultiple(queries: string[]): Promise<SearchResult[]>;
+    /**
+     * チャンクを削除
+     */
+    deleteChunk(chunkId: string): Promise<boolean>;
+    /**
+     * ドキュメントの全チャンクを削除
+     */
+    deleteDocument(documentId: string, chunkCount: number): Promise<number>;
+    /**
+     * チャンキング設定を更新して新しいチャンカーを作成
+     */
+    updateChunkingConfig(config: ChunkingConfig): void;
+    /**
+     * 検索設定を更新
+     */
+    updateRetrieverConfig(config: Partial<RetrieverConfig>): void;
+    /**
+     * ドキュメントをチャンキングのみ実行（インデックス追加なし）
+     */
+    chunk(document: Document): Chunk[];
+    /**
+     * 複数ドキュメントをチャンキングのみ実行
+     */
+    chunkBatch(documents: Document[]): Chunk[];
+}
+//# sourceMappingURL=RAGEngine.d.ts.map

package/dist/RAGEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RAGEngine.d.ts","sourceRoot":"","sources":["../src/RAGEngine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,KAAK,EACL,cAAc,EACd,QAAQ,EACR,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,SAAS,CAAY;gBAG3B,iBAAiB,EAAE,iBAAiB,EACpC,WAAW,EAAE,WAAW,EACxB,MAAM,GAAE,eAAoB;IAM9B;;;OAGG;IACG,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAMlD;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAY1D;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAInD;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAI/D;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpD;;OAEG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAa7E;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAIlD;;OAEG;IACH,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAI7D;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,KAAK,EAAE;IAIlC;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE;CAG3C"}

package/dist/RAGEngine.js

@@ -0,0 +1,97 @@
+/**
+ * RAG Engine - RAGシステムのファサード
+ *
+ * @requirement REQ-RAG-005
+ * @design DES-KATASHIRO-003-RAG §3.5
+ */
+import { DocumentChunker } from './chunking/DocumentChunker.js';
+import { Retriever } from './Retriever.js';
+/**
+ * RAGエンジン
+ * ドキュメント処理、インデックス作成、検索を統合したファサード
+ */
+export class RAGEngine {
+    chunker;
+    retriever;
+    constructor(embeddingProvider, vectorStore, config = {}) {
+        this.chunker = new DocumentChunker(config.chunking);
+        this.retriever = new Retriever(embeddingProvider, vectorStore, config.retriever);
+    }
+    /**
+     * ドキュメントをインデックスに追加
+     * チャンキング、埋め込み生成、インデックス追加を一括実行
+     */
+    async ingest(document) {
+        const chunks = this.chunker.chunk(document);
+        await this.retriever.addDocument(document, chunks);
+        return chunks;
+    }
+    /**
+     * 複数ドキュメントをバッチでインデックスに追加
+     */
+    async ingestBatch(documents) {
+        const allChunks = [];
+        for (const document of documents) {
+            const chunks = this.chunker.chunk(document);
+            allChunks.push(...chunks);
+            await this.retriever.addDocument(document, chunks);
+        }
+        return allChunks;
+    }
+    /**
+     * クエリで関連チャンクを検索
+     */
+    async query(query) {
+        return this.retriever.search(query);
+    }
+    /**
+     * 複数クエリで検索
+     */
+    async queryMultiple(queries) {
+        return this.retriever.searchMultiple(queries);
+    }
+    /**
+     * チャンクを削除
+     */
+    async deleteChunk(chunkId) {
+        return this.retriever.deleteChunk(chunkId);
+    }
+    /**
+     * ドキュメントの全チャンクを削除
+     */
+    async deleteDocument(documentId, chunkCount) {
+        let deleted = 0;
+        for (let i = 0; i < chunkCount; i++) {
+            const chunkId = `${documentId}_chunk_${i}`;
+            if (await this.retriever.deleteChunk(chunkId)) {
+                deleted++;
+            }
+        }
+        return deleted;
+    }
+    /**
+     * チャンキング設定を更新して新しいチャンカーを作成
+     */
+    updateChunkingConfig(config) {
+        this.chunker = new DocumentChunker(config);
+    }
+    /**
+     * 検索設定を更新
+     */
+    updateRetrieverConfig(config) {
+        this.retriever.updateConfig(config);
+    }
+    /**
+     * ドキュメントをチャンキングのみ実行（インデックス追加なし）
+     */
+    chunk(document) {
+        return this.chunker.chunk(document);
+    }
+    /**
+     * 複数ドキュメントをチャンキングのみ実行
+     */
+    chunkBatch(documents) {
+        return this.chunker.chunkBatch(documents);
+    }
+}
+//# sourceMappingURL=RAGEngine.js.map

package/dist/RAGEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RAGEngine.js","sourceRoot":"","sources":["../src/RAGEngine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAY3C;;;GAGG;AACH,MAAM,OAAO,SAAS;IACZ,OAAO,CAAkB;IACzB,SAAS,CAAY;IAE7B,YACE,iBAAoC,EACpC,WAAwB,EACxB,SAA0B,EAAE;QAE5B,IAAI,CAAC,OAAO,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC,iBAAiB,EAAE,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IACnF,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,QAAkB;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACnD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,SAAqB;QACrC,MAAM,SAAS,GAAY,EAAE,CAAC;QAE9B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC5C,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;YAC1B,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACrD,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,KAAa;QACvB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,OAAiB;QACnC,OAAO,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,OAAe;QAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,UAAkB,EAAE,UAAkB;QACzD,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,GAAG,UAAU,UAAU,CAAC,EAAE,CAAC;YAC3C,IAAI,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC9C,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,MAAsB;QACzC,IAAI,CAAC,OAAO,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,qBAAqB,CAAC,MAAgC;QACpD,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAkB;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,SAAqB;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;CACF"}

package/dist/RAGPipeline.d.ts

@@ -0,0 +1,162 @@
+/**
+ * RAG Pipeline - End-to-End RAG処理パイプライン
+ *
+ * 検索→コンテキスト構築→回答生成を統合したパイプライン
+ *
+ * @requirement REQ-RAG-101
+ * @design DES-KATASHIRO-003-RAG §3.6
+ */
+import type { Document, Chunk, SearchResult, RAGEngineConfig, EmbeddingProvider, VectorStore } from './types.js';
+interface LLMProviderLike {
+    generate(request: {
+        messages: Array<{
+            role: string;
+            content: string;
+        }>;
+        temperature?: number;
+        maxTokens?: number;
+    }): Promise<{
+        content: string;
+        usage?: {
+            promptTokens: number;
+            completionTokens: number;
+            totalTokens: number;
+        };
+    }>;
+}
+/**
+ * RAGパイプライン設定
+ */
+export interface RAGPipelineConfig extends RAGEngineConfig {
+    /** システムプロンプト */
+    systemPrompt?: string;
+    /** コンテキストテンプレート */
+    contextTemplate?: string;
+    /** 最大コンテキスト長（文字数） */
+    maxContextLength?: number;
+    /** 回答生成温度パラメータ */
+    temperature?: number;
+    /** 最大回答トークン数 */
+    maxAnswerTokens?: number;
+    /** デフォルトのtopK */
+    defaultTopK?: number;
+    /** 検索結果の最小スコア */
+    minSearchScore?: number;
+    /** ストリーミング有効化 */
+    enableStreaming?: boolean;
+}
+/**
+ * RAGパイプライン結果
+ */
+export interface RAGPipelineResult {
+    /** 生成された回答 */
+    answer: string;
+    /** 使用されたコンテキスト */
+    contexts: string[];
+    /** 検索されたチャンク */
+    retrievedChunks: SearchResult[];
+    /** 使用されたクエリ */
+    query: string;
+    /** トークン使用量 */
+    tokenUsage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    /** 処理時間（ミリ秒） */
+    processingTimeMs: number;
+    /** メタデータ */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * RAGパイプラインオプション（クエリごと）
+ */
+export interface RAGQueryOptions {
+    /** 検索件数 */
+    topK?: number;
+    /** 最小スコア */
+    minScore?: number;
+    /** 温度パラメータ */
+    temperature?: number;
+    /** 追加コンテキスト */
+    additionalContext?: string;
+    /** システムプロンプトオーバーライド */
+    systemPromptOverride?: string;
+    /** 会話履歴 */
+    conversationHistory?: Array<{
+        role: 'user' | 'assistant';
+        content: string;
+    }>;
+}
+/**
+ * デフォルトのシステムプロンプト
+ */
+export declare const DEFAULT_RAG_SYSTEM_PROMPT = "\u3042\u306A\u305F\u306F\u4E0E\u3048\u3089\u308C\u305F\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u60C5\u5831\u306B\u57FA\u3065\u3044\u3066\u8CEA\u554F\u306B\u56DE\u7B54\u3059\u308B\u30A2\u30B7\u30B9\u30BF\u30F3\u30C8\u3067\u3059\u3002\n\u4EE5\u4E0B\u306E\u30EB\u30FC\u30EB\u306B\u5F93\u3063\u3066\u304F\u3060\u3055\u3044:\n1. \u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u306B\u542B\u307E\u308C\u308B\u60C5\u5831\u306E\u307F\u3092\u4F7F\u7528\u3057\u3066\u56DE\u7B54\u3057\u3066\u304F\u3060\u3055\u3044\n2. \u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u306B\u60C5\u5831\u304C\u306A\u3044\u5834\u5408\u306F\u3001\u305D\u306E\u65E8\u3092\u6B63\u76F4\u306B\u4F1D\u3048\u3066\u304F\u3060\u3055\u3044\n3. \u56DE\u7B54\u306F\u7C21\u6F54\u304B\u3064\u6B63\u78BA\u306B\u3057\u3066\u304F\u3060\u3055\u3044\n4. \u63A8\u6E2C\u3084\u4EEE\u5B9A\u3092\u907F\u3051\u3001\u4E8B\u5B9F\u306B\u57FA\u3065\u3044\u305F\u56DE\u7B54\u3092\u3057\u3066\u304F\u3060\u3055\u3044";
+/**
+ * デフォルトのコンテキストテンプレート
+ */
+export declare const DEFAULT_CONTEXT_TEMPLATE = "## \u95A2\u9023\u60C5\u5831\n{{contexts}}\n\n## \u8CEA\u554F\n{{query}}\n\n\u4E0A\u8A18\u306E\u60C5\u5831\u306B\u57FA\u3065\u3044\u3066\u8CEA\u554F\u306B\u56DE\u7B54\u3057\u3066\u304F\u3060\u3055\u3044\u3002";
+/**
+ * RAGパイプライン
+ * 検索→コンテキスト構築→回答生成を統合
+ */
+export declare class RAGPipeline {
+    private ragEngine;
+    private llmProvider;
+    private config;
+    private ragEngineConfig;
+    constructor(embeddingProvider: EmbeddingProvider, vectorStore: VectorStore, llmProvider: LLMProviderLike, config?: RAGPipelineConfig);
+    /**
+     * ドキュメントをインジェスト
+     */
+    ingest(document: Document): Promise<Chunk[]>;
+    /**
+     * 複数ドキュメントをバッチインジェスト
+     */
+    ingestBatch(documents: Document[]): Promise<Chunk[]>;
+    /**
+     * RAGクエリを実行（検索→回答生成）
+     */
+    query(query: string, options?: RAGQueryOptions): Promise<RAGPipelineResult>;
+    /**
+     * 会話形式でクエリ（履歴を自動管理）
+     */
+    chat(query: string, conversationHistory: Array<{
+        role: 'user' | 'assistant';
+        content: string;
+    }>, options?: Omit<RAGQueryOptions, 'conversationHistory'>): Promise<RAGPipelineResult>;
+    /**
+     * 検索のみ実行（回答生成なし）
+     */
+    search(query: string, topK?: number): Promise<SearchResult[]>;
+    /**
+     * コンテキストを構築
+     */
+    private buildContexts;
+    /**
+     * ユーザープロンプトを構築
+     */
+    private buildUserPrompt;
+    /**
+     * コンテキストを最大長に切り詰め
+     */
+    private truncateContext;
+    /**
+     * チャンクを削除
+     */
+    deleteChunk(chunkId: string): Promise<boolean>;
+    /**
+     * ドキュメントを削除
+     */
+    deleteDocument(documentId: string, chunkCount: number): Promise<number>;
+    /**
+     * 設定を更新
+     */
+    updateConfig(config: Partial<RAGPipelineConfig>): void;
+    /**
+     * 現在の設定を取得
+     */
+    getConfig(): Readonly<RAGPipelineConfig>;
+}
+export {};
+//# sourceMappingURL=RAGPipeline.d.ts.map

package/dist/RAGPipeline.d.ts.map

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

package/dist/RAGPipeline.js

@@ -0,0 +1,222 @@
+/**
+ * RAG Pipeline - End-to-End RAG処理パイプライン
+ *
+ * 検索→コンテキスト構築→回答生成を統合したパイプライン
+ *
+ * @requirement REQ-RAG-101
+ * @design DES-KATASHIRO-003-RAG §3.6
+ */
+import { RAGEngine } from './RAGEngine.js';
+/**
+ * デフォルトのシステムプロンプト
+ */
+export const DEFAULT_RAG_SYSTEM_PROMPT = `あなたは与えられたコンテキスト情報に基づいて質問に回答するアシスタントです。
+以下のルールに従ってください:
+1. コンテキストに含まれる情報のみを使用して回答してください
+2. コンテキストに情報がない場合は、その旨を正直に伝えてください
+3. 回答は簡潔かつ正確にしてください
+4. 推測や仮定を避け、事実に基づいた回答をしてください`;
+/**
+ * デフォルトのコンテキストテンプレート
+ */
+export const DEFAULT_CONTEXT_TEMPLATE = `## 関連情報
+{{contexts}}
+
+## 質問
+{{query}}
+
+上記の情報に基づいて質問に回答してください。`;
+/**
+ * RAGパイプライン
+ * 検索→コンテキスト構築→回答生成を統合
+ */
+export class RAGPipeline {
+    ragEngine;
+    llmProvider;
+    config;
+    ragEngineConfig;
+    constructor(embeddingProvider, vectorStore, llmProvider, config = {}) {
+        const { systemPrompt, contextTemplate, maxContextLength, temperature, maxAnswerTokens, defaultTopK, minSearchScore, enableStreaming, ...ragEngineConfig } = config;
+        this.ragEngine = new RAGEngine(embeddingProvider, vectorStore, ragEngineConfig);
+        this.llmProvider = llmProvider;
+        this.ragEngineConfig = ragEngineConfig;
+        this.config = {
+            systemPrompt: systemPrompt ?? DEFAULT_RAG_SYSTEM_PROMPT,
+            contextTemplate: contextTemplate ?? DEFAULT_CONTEXT_TEMPLATE,
+            maxContextLength: maxContextLength ?? 8000,
+            temperature: temperature ?? 0.3,
+            maxAnswerTokens: maxAnswerTokens ?? 2048,
+            defaultTopK: defaultTopK ?? 5,
+            minSearchScore: minSearchScore ?? 0.3,
+            enableStreaming: enableStreaming ?? false,
+        };
+    }
+    /**
+     * ドキュメントをインジェスト
+     */
+    async ingest(document) {
+        return this.ragEngine.ingest(document);
+    }
+    /**
+     * 複数ドキュメントをバッチインジェスト
+     */
+    async ingestBatch(documents) {
+        return this.ragEngine.ingestBatch(documents);
+    }
+    /**
+     * RAGクエリを実行（検索→回答生成）
+     */
+    async query(query, options = {}) {
+        const startTime = Date.now();
+        // 1. 検索
+        const topK = options.topK ?? this.config.defaultTopK;
+        const minScore = options.minScore ?? this.config.minSearchScore;
+        this.ragEngine.updateRetrieverConfig({ topK, minScore });
+        const searchResults = await this.ragEngine.query(query);
+        // 2. コンテキスト構築
+        const contexts = this.buildContexts(searchResults);
+        const contextText = this.truncateContext(contexts.join('\n\n'));
+        // 3. プロンプト構築
+        const systemPrompt = options.systemPromptOverride ?? this.config.systemPrompt;
+        const userPrompt = this.buildUserPrompt(query, contextText, options.additionalContext);
+        // 4. メッセージ配列構築
+        const messages = [
+            { role: 'system', content: systemPrompt },
+        ];
+        // 会話履歴があれば追加
+        if (options.conversationHistory && options.conversationHistory.length > 0) {
+            for (const msg of options.conversationHistory) {
+                messages.push({ role: msg.role, content: msg.content });
+            }
+        }
+        messages.push({ role: 'user', content: userPrompt });
+        // 5. 回答生成
+        const temperature = options.temperature ?? this.config.temperature;
+        const response = await this.llmProvider.generate({
+            messages,
+            temperature,
+            maxTokens: this.config.maxAnswerTokens,
+        });
+        const processingTimeMs = Date.now() - startTime;
+        return {
+            answer: response.content,
+            contexts,
+            retrievedChunks: searchResults,
+            query,
+            tokenUsage: response.usage,
+            processingTimeMs,
+            metadata: {
+                topK,
+                minScore,
+                temperature,
+                searchResultCount: searchResults.length,
+                contextLength: contextText.length,
+            },
+        };
+    }
+    /**
+     * 会話形式でクエリ（履歴を自動管理）
+     */
+    async chat(query, conversationHistory, options = {}) {
+        return this.query(query, { ...options, conversationHistory });
+    }
+    /**
+     * 検索のみ実行（回答生成なし）
+     */
+    async search(query, topK) {
+        if (topK) {
+            this.ragEngine.updateRetrieverConfig({ topK });
+        }
+        return this.ragEngine.query(query);
+    }
+    /**
+     * コンテキストを構築
+     */
+    buildContexts(searchResults) {
+        return searchResults.map((result, index) => {
+            const metadata = result.chunk.metadata;
+            const source = metadata.source ?? metadata.documentId ?? 'unknown';
+            return `[情報源 ${index + 1}] (score: ${result.score.toFixed(2)}, source: ${source})\n${result.chunk.content}`;
+        });
+    }
+    /**
+     * ユーザープロンプトを構築
+     */
+    buildUserPrompt(query, contextText, additionalContext) {
+        let prompt = this.config.contextTemplate
+            .replace('{{contexts}}', contextText)
+            .replace('{{query}}', query);
+        if (additionalContext) {
+            prompt = `## 追加情報\n${additionalContext}\n\n${prompt}`;
+        }
+        return prompt;
+    }
+    /**
+     * コンテキストを最大長に切り詰め
+     */
+    truncateContext(context) {
+        if (context.length <= this.config.maxContextLength) {
+            return context;
+        }
+        // 文境界で切り詰め
+        const truncated = context.slice(0, this.config.maxContextLength);
+        const lastSentenceEnd = Math.max(truncated.lastIndexOf('。'), truncated.lastIndexOf('.'), truncated.lastIndexOf('\n'));
+        if (lastSentenceEnd > this.config.maxContextLength * 0.8) {
+            return truncated.slice(0, lastSentenceEnd + 1) + '\n[...以下省略...]';
+        }
+        return truncated + '...\n[...以下省略...]';
+    }
+    /**
+     * チャンクを削除
+     */
+    async deleteChunk(chunkId) {
+        return this.ragEngine.deleteChunk(chunkId);
+    }
+    /**
+     * ドキュメントを削除
+     */
+    async deleteDocument(documentId, chunkCount) {
+        return this.ragEngine.deleteDocument(documentId, chunkCount);
+    }
+    /**
+     * 設定を更新
+     */
+    updateConfig(config) {
+        if (config.systemPrompt !== undefined) {
+            this.config.systemPrompt = config.systemPrompt;
+        }
+        if (config.contextTemplate !== undefined) {
+            this.config.contextTemplate = config.contextTemplate;
+        }
+        if (config.maxContextLength !== undefined) {
+            this.config.maxContextLength = config.maxContextLength;
+        }
+        if (config.temperature !== undefined) {
+            this.config.temperature = config.temperature;
+        }
+        if (config.maxAnswerTokens !== undefined) {
+            this.config.maxAnswerTokens = config.maxAnswerTokens;
+        }
+        if (config.defaultTopK !== undefined) {
+            this.config.defaultTopK = config.defaultTopK;
+        }
+        if (config.minSearchScore !== undefined) {
+            this.config.minSearchScore = config.minSearchScore;
+        }
+        // RAGEngine設定の更新
+        const { chunking, retriever } = config;
+        if (chunking) {
+            this.ragEngine.updateChunkingConfig(chunking);
+        }
+        if (retriever) {
+            this.ragEngine.updateRetrieverConfig(retriever);
+        }
+    }
+    /**
+     * 現在の設定を取得
+     */
+    getConfig() {
+        return { ...this.config, ...this.ragEngineConfig };
+    }
+}
+//# sourceMappingURL=RAGPipeline.js.map

package/dist/RAGPipeline.js.map

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

package/dist/Retriever.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Retriever - 検索エンジン
+ *
+ * @requirement REQ-RAG-004
+ * @design DES-KATASHIRO-003-RAG §3.4
+ */
+import type { Chunk, Document, EmbeddingProvider, RetrieverConfig, SearchResult, VectorStore } from './types.js';
+/**
+ * 検索エンジン
+ * Embedding生成とVector検索を統合
+ */
+export declare class Retriever {
+    private embeddingManager;
+    private vectorStore;
+    private config;
+    constructor(embeddingProvider: EmbeddingProvider, vectorStore: VectorStore, config?: RetrieverConfig);
+    /**
+     * ドキュメントをインデックスに追加
+     */
+    addDocument(_document: Document, chunks: Chunk[]): Promise<void>;
+    /**
+     * 複数ドキュメントをバッチでインデックスに追加
+     */
+    addDocuments(documents: Array<{
+        document: Document;
+        chunks: Chunk[];
+    }>): Promise<void>;
+    /**
+     * クエリで検索
+     */
+    search(query: string): Promise<SearchResult[]>;
+    /**
+     * 複数クエリで検索（結果をマージ）
+     */
+    searchMultiple(queries: string[]): Promise<SearchResult[]>;
+    /**
+     * チャンクを削除
+     */
+    deleteChunk(chunkId: string): Promise<boolean>;
+    /**
+     * 検索設定を取得
+     */
+    getConfig(): Required<RetrieverConfig>;
+    /**
+     * 検索設定を更新
+     */
+    updateConfig(config: Partial<RetrieverConfig>): void;
+}
+//# sourceMappingURL=Retriever.d.ts.map

package/dist/Retriever.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Retriever.d.ts","sourceRoot":"","sources":["../src/Retriever.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAUjH;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,MAAM,CAA4B;gBAGxC,iBAAiB,EAAE,iBAAiB,EACpC,WAAW,EAAE,WAAW,EACxB,MAAM,GAAE,eAAoB;IAO9B;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWtE;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,MAAM,EAAE,KAAK,EAAE,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5F;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAQpD;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAmBhE;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpD;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,eAAe,CAAC;IAItC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;CAGrD"}