photoshop_select_painting_method
Selects a compatible executable painting method from registered Photoshop capabilities using construction role or visual intent plus impact class, without contacting or changing Photoshop.
Instructions
Choose an executable painting method from registered runtime capabilities without contacting or mutating Photoshop. Use photoshop_get_painting_method_capabilities to inspect the full map; use this tool for a specific construction_role or visual_intent plus required impact_class. construction_role takes precedence and derives the intent when both are supplied. Excludes avoid_method_ids, then uses the ordered intent preferences unless a valid preferred_method_id is supplied; an unavailable, avoided or incompatible preference is rejected rather than silently replaced. With edge_class, returns a separate edge_selection and tries preferred_method_id first for that edge choice; incompatible edge preferences are listed as rejected and may fall back. Returns ok=true, selection (selected method, fallbacks and rejected candidates), execution_contract with registered commands/input schemas and fallback_commands. This is planning guidance, not execution or pixel verification; required preparation and state still apply. Missing role/intent or no compatible method returns isError=true with ok=false, code=no_painting_method_available and message.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"impact_class": "<impact_class>"
},
"name": "photoshop_select_painting_method"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| stage | No | Optional painting-stage context passed to method selection. Does not change the durable Guard stage or authorize painting. | |
| edge_class | No | Optional boundary appearance: hard, soft, lost, firm or broken. Adds an independent edge_selection alongside the main construction/intent selection. | |
| document_id | No | Optional Photoshop document id from photoshop_get_state / photoshop_list_documents. When set, the tool verifies that this document is already active and fails closed if another tab is active. It never switches the active Photoshop document automatically. | |
| impact_class | Yes | Required operation-impact category (for example construct, subtract or tone); filters methods compatible with the chosen intent. | |
| visual_intent | No | Desired visual effect. Required when construction_role is absent; when both are given, the construction role determines the intent. | |
| avoid_method_ids | No | Method ids from the capability map to exclude from main and optional edge selection, including fallback candidates. | |
| construction_role | No | Subject-agnostic construction role. In broad nontrivial construction this classification must precede concrete Photoshop method selection. | |
| preferred_method_id | No | Exact capability-map method id. Without edge_class, requires this method for the main selection and rejects invalid/avoided/incompatible preferences. With edge_class, tries it first only for edge_selection and may fall back, recording the rejection. |