Agent: sharing tools that ask first, and a hard delete for a misplaced plop #131
+42
-23
@@ -993,26 +993,35 @@ func (a *adapter) listShares(ctx context.Context, args struct {
|
||||
return nil, err
|
||||
}
|
||||
out := make([]shareView, 0, len(shares))
|
||||
for _, sh := range shares {
|
||||
out = append(out, shareView{UserID: sh.UserID, Email: sh.Email, DisplayName: sh.DisplayName, Role: sh.Role})
|
||||
for i := range shares {
|
||||
out = append(out, toShareView(&shares[i]))
|
||||
}
|
||||
link, err := a.svc.GetPublicShareLink(ctx, a.actor, args.GardenID)
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
return map[string]any{"shares": out, "publicLink": a.linkView(link)}, nil
|
||||
return map[string]any{"shares": out, "publicLink": a.linkOf(link)}, nil
|
||||
}
|
||||
|
||||
// linkView is a public link as the tools report it: on/off, and the address
|
||||
// when on. The token itself is only ever shown as part of that address.
|
||||
func (a *adapter) linkView(link *service.PublicShareLink) map[string]any {
|
||||
v := map[string]any{"enabled": link.Enabled}
|
||||
type linkView struct {
|
||||
|
|
||||
Enabled bool `json:"enabled"`
|
||||
URL string `json:"url,omitempty"`
|
||||
}
|
||||
|
||||
func (a *adapter) linkOf(link *service.PublicShareLink) linkView {
|
||||
v := linkView{Enabled: link.Enabled}
|
||||
if link.Enabled {
|
||||
v["url"] = a.svc.PublicShareURL(link.Token)
|
||||
v.URL = a.svc.PublicShareURL(link.Token)
|
||||
}
|
||||
return v
|
||||
}
|
||||
|
||||
func toShareView(sh *domain.ShareWithUser) shareView {
|
||||
return shareView{UserID: sh.UserID, Email: sh.Email, DisplayName: sh.DisplayName, Role: sh.Role}
|
||||
}
|
||||
|
||||
func (a *adapter) shareGarden(ctx context.Context, args struct {
|
||||
GardenID int64 `json:"gardenId" description:"garden to share (the user must own it)"`
|
||||
Email string `json:"email" description:"the other person's pansy account email, exactly as the user gave it"`
|
||||
@@ -1027,7 +1036,7 @@ func (a *adapter) shareGarden(ctx context.Context, args struct {
|
||||
if !args.Confirmed {
|
||||
return nil, errUnconfirmed(fmt.Sprintf("sharing this garden with %s as %s", email, role))
|
||||
}
|
||||
share, err := a.svc.AddShare(ctx, a.actor, args.GardenID, email, role)
|
||||
_, err := a.svc.AddShare(ctx, a.actor, args.GardenID, email, role)
|
||||
switch {
|
||||
case errors.Is(err, domain.ErrShareUserNotFound):
|
||||
|
gitea-actions
commented
🟡 shareView is built inline five times; a toShareView helper would remove the copy-paste maintainability · flagged by 1 model
🪰 Gadfly · advisory 🟡 **shareView is built inline five times; a toShareView helper would remove the copy-paste**
_maintainability · flagged by 1 model_
- **`internal/agent/tools.go:1041` — `shareView` is built inline five times with all four fields.** `listShares` (line 997) constructs it in a loop; `shareGarden` builds it three different ways across its branches (lines 1041, 1048, 1053); `removeShare` builds it once (line 1090). Four of these repeat `UserID/Email/DisplayName/Role` field-by-field from a `domain.ShareWithUser`-shaped source. A tiny helper `toShareView(s domain.ShareWithUser) shareView` would remove the copy-paste and make the `E…
<sub>🪰 Gadfly · advisory</sub>
|
||||
return nil, fmt.Errorf("%w — they need to sign in to pansy once before a garden can be shared with them", err)
|
||||
@@ -1038,19 +1047,22 @@ func (a *adapter) shareGarden(ctx context.Context, args struct {
|
||||
return nil, ferr
|
||||
}
|
||||
if existing.Role == role {
|
||||
return map[string]any{"share": shareView{UserID: existing.UserID, Email: existing.Email, DisplayName: existing.DisplayName, Role: existing.Role},
|
||||
"note": "already shared with them at that role; nothing changed"}, nil
|
||||
return map[string]any{"share": toShareView(existing), "note": "already shared with them at that role; nothing changed"}, nil
|
||||
}
|
||||
updated, uerr := a.svc.UpdateShareRole(ctx, a.actor, args.GardenID, existing.UserID, role)
|
||||
if uerr != nil {
|
||||
return nil, uerr
|
||||
if _, err := a.svc.UpdateShareRole(ctx, a.actor, args.GardenID, existing.UserID, role); err != nil {
|
||||
return nil, err
|
||||
|
gitea-actions
commented
🟡 share_garden new-share success path omits DisplayName, inconsistent with its other return paths and list_shares/remove_share maintainability · flagged by 1 model
🪰 Gadfly · advisory 🟡 **share_garden new-share success path omits DisplayName, inconsistent with its other return paths and list_shares/remove_share**
_maintainability · flagged by 1 model_
- **`internal/agent/tools.go:1053` — `share_garden`'s new-share success path omits `DisplayName` (and reports the input email, not the stored one), while every other return path in the same tool sets it.** The `ErrShareExists` branches (lines 1041, 1048) build `shareView{... DisplayName: existing.DisplayName}`, and `remove_share`/`list_shares` both populate it too. A model that shares a brand-new person back gets a `share` object shaped differently from the one it would get for a re-share or fro…
<sub>🪰 Gadfly · advisory</sub>
|
||||
}
|
||||
return map[string]any{"share": shareView{UserID: updated.UserID, Email: existing.Email, DisplayName: existing.DisplayName, Role: updated.Role},
|
||||
"note": "they already had access; their role is now " + updated.Role}, nil
|
||||
existing.Role = role
|
||||
return map[string]any{"share": toShareView(existing), "note": "they already had access; their role is now " + role}, nil
|
||||
case err != nil:
|
||||
return nil, err
|
||||
}
|
||||
return map[string]any{"share": shareView{UserID: share.UserID, Email: email, Role: share.Role}}, nil
|
||||
// Read the share back so every path reports the same shape, name included.
|
||||
created, err := a.findShare(ctx, args.GardenID, email)
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
return map[string]any{"share": toShareView(created)}, nil
|
||||
}
|
||||
|
||||
// findShare resolves an email to the garden's share for it, case-insensitively
|
||||
@@ -1087,7 +1099,7 @@ func (a *adapter) removeShare(ctx context.Context, args struct {
|
||||
if err := a.svc.RemoveShare(ctx, a.actor, args.GardenID, share.UserID); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
return map[string]any{"removed": shareView{UserID: share.UserID, Email: share.Email, DisplayName: share.DisplayName, Role: share.Role}}, nil
|
||||
return map[string]any{"removed": toShareView(share)}, nil
|
||||
|
gitea-actions
commented
🟠 Unknown publicLink action with confirmed=false produces empty-description errUnconfirmed; clear validation error is unreachable from that path correctness, error-handling, maintainability · flagged by 4 models
🪰 Gadfly · advisory 🟠 **Unknown publicLink action with confirmed=false produces empty-description errUnconfirmed; clear validation error is unreachable from that path**
_correctness, error-handling, maintainability · flagged by 4 models_
- **`internal/agent/tools.go:1102`** — Unknown action + `confirmed=false` produces a garbled error. The map lookup at line 1103 has keys only for `"enable"`, `"rotate"`, and `"disable"`; any other action value (including a misspelled one) causes a missing-key lookup that returns `""`, so `errUnconfirmed("")` yields `"not done — is outward-facing, …"` with an empty action description. The `default` branch at line 1124 that would return the clear `"action must be get, enable, rotate or disable"`…
<sub>🪰 Gadfly · advisory</sub>
|
||||
}
|
||||
|
||||
func (a *adapter) publicLink(ctx context.Context, args struct {
|
||||
@@ -1099,12 +1111,21 @@ func (a *adapter) publicLink(ctx context.Context, args struct {
|
||||
if action == "" {
|
||||
action = "get"
|
||||
}
|
||||
if action != "get" && !args.Confirmed {
|
||||
return nil, errUnconfirmed(map[string]string{
|
||||
// What each outward-facing action does, in the words the model should ask
|
||||
// with. Checked before the confirmation gate, so an unknown action is told
|
||||
// it is unknown rather than asked to confirm nothing in particular.
|
||||
asks := map[string]string{
|
||||
"get": "",
|
||||
"enable": "turning the public link on, so anyone with the link can see this garden",
|
||||
"rotate": "rotating the public link, so the old link stops working",
|
||||
"disable": "turning the public link off, so the link stops working",
|
||||
}[action])
|
||||
}
|
||||
ask, known := asks[action]
|
||||
if !known {
|
||||
return nil, fmt.Errorf("%w: action must be get, enable, rotate or disable", domain.ErrInvalidInput)
|
||||
}
|
||||
if ask != "" && !args.Confirmed {
|
||||
return nil, errUnconfirmed(ask)
|
||||
}
|
||||
var (
|
||||
link *service.PublicShareLink
|
||||
@@ -1117,15 +1138,13 @@ func (a *adapter) publicLink(ctx context.Context, args struct {
|
||||
link, err = a.svc.EnablePublicShareLink(ctx, a.actor, args.GardenID, false)
|
||||
case "rotate":
|
||||
link, err = a.svc.EnablePublicShareLink(ctx, a.actor, args.GardenID, true)
|
||||
case "disable":
|
||||
default: // disable
|
||||
if err = a.svc.DisablePublicShareLink(ctx, a.actor, args.GardenID); err == nil {
|
||||
link = &service.PublicShareLink{Enabled: false}
|
||||
}
|
||||
default:
|
||||
return nil, fmt.Errorf("%w: action must be get, enable, rotate or disable", domain.ErrInvalidInput)
|
||||
}
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
return a.linkView(link), nil
|
||||
return a.linkOf(link), nil
|
||||
}
|
||||
|
||||
@@ -1066,8 +1066,8 @@ func TestSharingToolsAskFirst(t *testing.T) {
|
||||
Note string `json:"note"`
|
||||
}
|
||||
mustCall("share_garden", map[string]any{"gardenId": g.ID, "email": "[email protected]", "role": "editor", "confirmed": true}, &shared)
|
||||
if shared.Share.Role != domain.RoleEditor || shared.Share.Email != "[email protected]" {
|
||||
t.Errorf("share = %+v, want sam as editor", shared)
|
||||
if shared.Share.Role != domain.RoleEditor || shared.Share.Email != "[email protected]" || shared.Share.DisplayName != "Sam" {
|
||||
t.Errorf("share = %+v, want Sam as editor, named", shared)
|
||||
}
|
||||
mustCall("share_garden", map[string]any{"gardenId": g.ID, "email": "[email protected]", "role": "viewer", "confirmed": true}, &shared)
|
||||
if shared.Share.Role != domain.RoleViewer || !strings.Contains(shared.Note, "now viewer") {
|
||||
@@ -1082,10 +1082,10 @@ func TestSharingToolsAskFirst(t *testing.T) {
|
||||
|
||||
var listed struct {
|
||||
Shares []shareView `json:"shares"`
|
||||
PublicLink map[string]any `json:"publicLink"`
|
||||
PublicLink linkView `json:"publicLink"`
|
||||
}
|
||||
mustCall("list_shares", map[string]any{"gardenId": g.ID}, &listed)
|
||||
if len(listed.Shares) != 1 || listed.Shares[0].Email != "[email protected]" || listed.Shares[0].Role != domain.RoleViewer || listed.PublicLink["enabled"] != false {
|
||||
if len(listed.Shares) != 1 || listed.Shares[0].Email != "[email protected]" || listed.Shares[0].Role != domain.RoleViewer || listed.PublicLink.Enabled {
|
||||
t.Errorf("list_shares = %+v", listed)
|
||||
}
|
||||
// Not the owner: Sam can see the garden but can't manage its sharing.
|
||||
@@ -1135,6 +1135,9 @@ func TestSharingToolsAskFirst(t *testing.T) {
|
||||
t.Error("the link is still on after disable")
|
||||
}
|
||||
refused("public_link", map[string]any{"gardenId": g.ID, "action": "share", "confirmed": true}, "get, enable, rotate or disable")
|
||||
// An unknown action is unknown whether or not it was confirmed — not a
|
||||
// request to confirm nothing in particular.
|
||||
refused("public_link", map[string]any{"gardenId": g.ID, "action": "share"}, "get, enable, rotate or disable")
|
||||
|
||||
// --- delete_planting: gone from every view, but in the history — undoable.
|
||||
bed, err := svc.CreateObject(ctx, owner, g.ID, service.ObjectInput{Kind: domain.KindBed, Name: "Bed", XCM: 500, YCM: 500, WidthCM: 200, HeightCM: 200})
|
||||
|
||||
@@ -94,7 +94,9 @@ func (s *Service) EnablePublicShareLink(ctx context.Context, actorID, gardenID i
|
||||
func (s *Service) PublicShareURL(token string) string {
|
||||
path := "/g/" + token
|
||||
if s.cfg != nil && s.cfg.BaseURL != "" {
|
||||
|
gitea-actions
commented
🟡 PublicShareURL does not trim trailing slash from BaseURL before concatenation correctness · flagged by 1 model 🪰 Gadfly · advisory 🟡 **PublicShareURL does not trim trailing slash from BaseURL before concatenation**
_correctness · flagged by 1 model_
<sub>🪰 Gadfly · advisory</sub>
|
||||
return s.cfg.BaseURL + path
|
||||
// config trims the trailing slash already; a Config built by hand
|
||||
// (tests, an embedder) may not have.
|
||||
return strings.TrimRight(s.cfg.BaseURL, "/") + path
|
||||
}
|
||||
return path
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user
🟡 linkView returns untyped map[string]any while shareView is a typed struct — inconsistent representation of sibling view types
maintainability · flagged by 1 model
internal/agent/tools.go:1008—linkViewreturnsmap[string]anywhileshareViewis a typed struct. Both are "the view the tools report," andlistSharesreturns them side by side in the same map (line 1003). The link gets an untyped map (so callers/tests reach in withpublicLink["enabled"], see tools_test.go:1085–1088), the share gets a typed struct. Inconsistent for conceptually sibling output types. A smalllinkViewstruct (Enabled bool/URL string \json:"url,omitempty"\…🪰 Gadfly · advisory