Class ToolCall

CodenameOne/src/com/codename1/ai/ToolCall.java:36–93

/// from the request's tool list. See the [Tool] class javadoc for
/// the full pattern.
public final class ToolCall {
    private final String id;
    private final String name;
    private final String argumentsJson;

    public ToolCall(String id, String name, String argumentsJson) {
        this.id = id;
        this.name = name;
        this.argumentsJson = argumentsJson == null ? "{}" : argumentsJson;
    }

    public String getId() {
        return id;
    }

    public String getName() {
        return name;
    }

    public String getArgumentsJson() {
        return argumentsJson;
    }

    /// Finds the [Tool] whose name matches this call and invokes its
    /// [ToolHandler] with this call's `argumentsJson`. Returns the
    /// JSON result the handler produced. Apps typically wrap that in
    /// a [ChatMessage#toolResult] and append it to the conversation
    /// before the next chat turn.
    ///
    /// Throws `IllegalArgumentException` when no tool in `tools`
    /// has a matching name, or `IllegalStateException` when the
    /// matching tool has no handler registered.
    public String execute(List<Tool> tools) throws Exception {
        Tool match = findTool(tools);
        if (match == null) {
            throw new IllegalArgumentException(
                    "No tool registered with name '" + name + "'. "
                  + "Add it to the request's tool list, or dispatch by hand "
                  + "via getName() / getArgumentsJson().");
        }
        return match.invoke(argumentsJson);
    }

    /// Looks up the matching [Tool] without invoking it. Useful when
    /// the caller wants to dispatch by hand but still benefit from
    /// the name-matching plumbing.
    public Tool findTool(List<Tool> tools) {
        if (tools == null) {
            return null;
        }
        for (Tool t : tools) {
            if (t.getName().equals(name)) {
                return t;
            }
        }
        return null;
    }
}