llm-worker-rs/docs/patch_note/v0.4.0.md

Release Notes - v0.4.0

Release Date: 2025-??-??

v0.4.0 は Worker が Role や YAML 設定を扱わず、システムプロンプト生成を完全に利用者へ委譲する大規模リファクタです。これにより、任意のテンプレートエンジンやデータソースを組み合わせてプロンプトを構築できます。

Breaking Changes

• Role / ConfigParser / ResourceLoader を削除。WorkerBuilder はシステムプロンプト生成関数 (system_prompt(...)) の指定が必須になりました。
• worker/src/config の Role 関連コードとテストを削除。既存の YAML ベース設定は互換層なし。

新機能 / 仕様変更

• PromptComposer は Arc<SystemPromptFn> を受け取り、PromptContext と履歴メッセージからシステムプロンプト文字列を生成するシンプルなラッパーになりました。
• WorkerBuilder は .system_prompt(...) で登録した関数を保持し、メッセージ送信時に毎回システムプロンプトを再生成します。
• README／サンプルコードを刷新し、システムプロンプト関数・マクロベースのツール／フック登録手順のみを掲載。
• 新しい docs/prompt-composer.md を追加し、PromptComposer の利用例をサマリー形式で紹介。

不具合修正

• PromptComposer が内部でファイルアクセスを行う経路を排除し、生成関数の失敗時は直近のキャッシュを利用するようにしました。
• Worker から NIA 固有の設定コードを除去し、環境依存の副作用を縮小。

移行ガイド

1. 旧 Role / ConfigParser を利用していた場合、PromptContext と会話履歴を引数にシステムプロンプト文字列を返す関数を実装し、.system_prompt(...) に渡してください。
2. Worker::load_config やリソースパス解決に依存していたコードは削除してください。必要であればアプリケーション側でファイル読み込みを行い、生成関数内で利用してください。
3. ツール・フックは引き続き #[worker::tool] / #[worker::hook] マクロを推奨しています（API に変更はありません）。

開発者向けメモ

• README を簡潔化し、RustDocs で確認できる内容の重複を削除しました。
• worker/examples/ を更新し、システムプロンプト関数とマクロベースのツール登録のみを扱うよう整理しました。