Agent seam: bulk ops (FillRegion/ClearObject/DescribeGarden) + DefineTool wrappers (#19)

Co-authored-by: Steve Dudenhoeffer <[email protected]>
2026-07-19 05:16:40 +00:00
parent 245e0cbe71
commit 18e4a299c2
6 changed files with 990 additions and 0 deletions
@@ -0,0 +1,18 @@
+// Package agent adapts pansy's service layer to majordomo tools so an agent can
+// drive a garden in natural language ("fill the NE corner with garlic, the NW
+// with basil, the south half with beans"). Each tool runs as a fixed actor and
+// therefore inherits pansy's ACL checks for free — a viewer's fill_region returns
+// ErrForbidden, exactly as the REST API would.
+//
+// Two deliberate separations keep the core server lean:
+//
+//   - cmd/pansy does NOT import this package, so the server binary carries no
+//     agent/LLM dependencies.
+//   - the tool wiring (tools.go) sits behind the `majordomo` build tag, so the
+//     default `go build ./...` / `go test ./...` compiles without the majordomo
+//     module. Build the agent tools with `-tags majordomo` once majordomo is a
+//     dependency (`go get gitea.stevedudenhoeffer.com/steve/majordomo`).
+//
+// The agent harness itself (model loop, chat surface) lives in the
+// majordomo/executus stack, outside this repo; this package is only the toolbox.
+package agent