Class NaturalActionService

java.lang.Object

com.shaft.mcp.NaturalActionService

@Service
public class NaturalActionService
extends Object

MCP entry point for trust-gated SHAFT natural-language actions.

Constructor Summary

Constructors

Constructor	Description
NaturalActionService()

Method Summary

Modifier and Type	Method	Description
McpNaturalActionResult	act(String intent, List<String> arguments, Integer minimumTrustPercentage, String planner, Boolean aiFallbackEnabled, String allowedActions)	Performs a natural-language browser, element, or touch action through the active SHAFT driver.

Methods inherited from class Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

NaturalActionService

public NaturalActionService()

Method Details

act

@Tool(name="natural_act",
      description="performs a trust-gated natural-language browser, element, or touch action on the active page")
public McpNaturalActionResult act(String intent,
 List<String> arguments,
 Integer minimumTrustPercentage,
 String planner,
 Boolean aiFallbackEnabled,
 String allowedActions)

Performs a natural-language browser, element, or touch action through the active SHAFT driver.

Parameters:

intent - natural-language action intent

arguments - optional sensitive action arguments, such as typed values

minimumTrustPercentage - optional trust threshold from 0 to 100; uses current configuration when null

planner - optional planner id: deterministic, auto, or a ServiceLoader planner id

aiFallbackEnabled - optional provider fallback flag; uses current configuration when null

allowedActions - optional comma-separated targets: browser, element, touch

Returns:

redacted execution metadata