pocketCuts a length-defined recess from a body by subtracting material from a sketch, with through-wall/body and direction controls to target the intended wall.
Instructions
Subtract a pad of length mm from the body. through_all ignores length.
through ('wall'|'body'): preferred over through_all. 'wall' ray-casts to the
first exit and cuts exactly one wall — right for solids AND shelled bodies;
'body' (legacy ThroughAll) punches every wall of a shell. Implies
direction='into_body'; result carries wall_depth_mm.
direction ('into_body'|'away_from_body', preferred over the legacy raw
reversed, honoured only when neither is set): the tool probes both
Reversed values and picks the one that does / does not remove material.
strict: raise instead of warn on a degenerate pocket.
Returns {handle, name, volume, removed_volume, volume_ratio}, plus warnings
ONLY when the pocket removed the whole body or nothing (strict=True makes
those errors). direction='away_from_body' never warns.
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": {
"sketch": "<sketch>"
},
"name": "pocket"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| length | No | ||
| sketch | Yes | ||
| strict | No | ||
| through | No | ||
| reversed | No | ||
| direction | No | ||
| workspace | No | Run this call in this named workspace | |
| through_all | No |