Struct ParamResolver 

pub struct ParamResolver<'a> { /* private fields */ }

Action パラメータ解決ヘルパー

Environment がアクションパラメータを取得する際の共通パターンを提供する。 args[key] と target の優先順位を統一し、空文字列の扱いを正規化する。

Example

fn handle_read_logs(&self, action: &Action) -> WorkResult {
    let resolver = ParamResolver::new(action);

    // 必須パラメータ: なければエラー
    let service = match resolver.require("service") {
        Ok(s) => s,
        Err(e) => return WorkResult::env_failure(e.to_string()),
    };

    // オプショナルパラメータ
    let limit = resolver.get("limit");

    // ...
}

Implementations

impl<'a> ParamResolver<'a>

pub fn new(action: &'a Action) -> Self

新しい ParamResolver を作成

pub fn get(&self, key: &str) -> Option<&str>

パラメータを取得（args[key] を優先、なければ target をフォールバック）

空文字列は None として扱う。

Arguments

• key - パラメータ名（例: “service”, “path”）

Returns

• Some(&str): 値が存在し、空でない場合
• None: 値が存在しないか、空文字列の場合

pub fn require(&self, key: &str) -> Result<&str, ActionValidationError>

必須パラメータを取得（なければエラー）

Arguments

• key - パラメータ名

Returns

• Ok(&str): 値が存在する場合
• Err(ActionValidationError::MissingParam): 値が存在しない場合

pub fn get_target_first(&self, key: &str) -> Option<&str>

target を優先して取得（なければ args[key] をフォールバック）

LLM が target フィールドにパラメータを入れる場合に使用。

Arguments

• key - フォールバック用のパラメータ名

pub fn require_target_first( &self, key: &str, ) -> Result<&str, ActionValidationError>

target を優先して必須パラメータを取得

pub fn target(&self) -> Option<&str>

target のみを取得（args は参照しない）

pub fn arg(&self, key: &str) -> Option<&str>

指定した key の args のみを取得（target は参照しない）

pub fn action_name(&self) -> &str

Action 名を取得

pub fn action(&self) -> &Action

元の Action への参照を取得

Trait Implementations

impl<'a> Debug for ParamResolver<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.