picoclaw/pkg/agent/agent_tenant_test.go
admin-mf 9a0b281734 forward-port: multi-tenancy hint plumbing on agent processOptions (phase 1)
Re-applies the tenant-isolation extension from the deleted pkg/agent/loop.go
to upstream's split agent_*.go layout. Phase 1 plumbs the protocol; Phase 2
(future PR) wires effective sessions / provider / context per turn.

What's added:
- New file pkg/agent/agent_tenant.go (kept isolated for sync friendliness):
  - extractTenantOverrides reads workspace_override, config_dir,
    allowed_tools, allowed_skills from msg.Context.Raw
  - Validates workspace_override and config_dir resolve within the
    workspace_root boundary set in agents.defaults; rejects path escape
  - Fails closed when any override is present but workspace_root is unset,
    so tenants cannot bypass the security boundary
  - applyTo copies the overrides onto processOptions
  - logIfPresent logs a single line summarising tenant routing per turn
- processOptions in agent.go gains four override fields (WorkspaceOverride,
  ConfigDir, AllowedTools, AllowedSkills)
- agent_message.go processMessage extracts and applies the overrides right
  after building processOptions
- agent_tenant_test.go covers the happy path, escape rejection, missing
  boundary rejection, and CSV parsing

Phase 2 will introduce effSessions, effContextBuilder, effProvider, effModel
on processOptions and thread them through pipeline_llm/turn_state/context_*
so each tenant turn runs against an isolated session store, context builder,
and provider credential set. Phase 2 is deferred because:
- MagicForm doesn't currently send webhook traffic (verified), so phase 1's
  protocol-level plumbing has no live consumer that requires the swap yet.
- Phase 2 needs design discussion (per-tenant credential storage, session
  backend selection) that warrants its own focused PR.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-07 12:20:23 -05:00

135 lines
3.6 KiB
Go

package agent
import (
"reflect"
"testing"
"github.com/sipeed/picoclaw/pkg/bus"
"github.com/sipeed/picoclaw/pkg/config"
)
func newTestLoopWithRoot(t *testing.T, root string) *AgentLoop {
t.Helper()
cfg := config.DefaultConfig()
cfg.Agents.Defaults.WorkspaceRoot = root
return &AgentLoop{cfg: cfg}
}
func TestExtractTenantOverrides_NoRaw(t *testing.T) {
al := newTestLoopWithRoot(t, t.TempDir())
got, err := al.extractTenantOverrides(bus.InboundMessage{})
if err != nil {
t.Fatalf("unexpected error: %v", err)
}
if got.workspace != "" || got.configDir != "" || len(got.allowedTools) > 0 || len(got.allowedSkills) > 0 {
t.Fatalf("expected zero overrides, got %+v", got)
}
}
func TestExtractTenantOverrides_AllFields(t *testing.T) {
root := t.TempDir()
al := newTestLoopWithRoot(t, root)
msg := bus.InboundMessage{
Context: bus.InboundContext{
Raw: map[string]string{
"workspace_override": "tenant-a/workspace",
"config_dir": "tenant-a/config",
"allowed_tools": "read_file, write_file ,exec",
"allowed_skills": "search,plan",
},
},
}
got, err := al.extractTenantOverrides(msg)
if err != nil {
t.Fatalf("unexpected error: %v", err)
}
if got.workspace == "" {
t.Fatalf("expected workspace to be resolved, got empty")
}
if got.configDir == "" {
t.Fatalf("expected configDir to be resolved, got empty")
}
wantTools := []string{"read_file", "write_file", "exec"}
if !reflect.DeepEqual(got.allowedTools, wantTools) {
t.Fatalf("allowedTools = %v, want %v", got.allowedTools, wantTools)
}
wantSkills := []string{"search", "plan"}
if !reflect.DeepEqual(got.allowedSkills, wantSkills) {
t.Fatalf("allowedSkills = %v, want %v", got.allowedSkills, wantSkills)
}
}
func TestExtractTenantOverrides_EscapeRejected(t *testing.T) {
al := newTestLoopWithRoot(t, t.TempDir())
msg := bus.InboundMessage{
Context: bus.InboundContext{
Raw: map[string]string{
"workspace_override": "../../../etc",
},
},
}
if _, err := al.extractTenantOverrides(msg); err == nil {
t.Fatalf("expected error for path escape, got nil")
}
}
func TestExtractTenantOverrides_NoRootBoundary(t *testing.T) {
// workspace_root unset → any override must be rejected.
cfg := config.DefaultConfig()
cfg.Agents.Defaults.WorkspaceRoot = ""
al := &AgentLoop{cfg: cfg}
msg := bus.InboundMessage{
Context: bus.InboundContext{
Raw: map[string]string{"workspace_override": "anything"},
},
}
if _, err := al.extractTenantOverrides(msg); err == nil {
t.Fatalf("expected error when workspace_root is unset, got nil")
}
}
func TestSplitCSV(t *testing.T) {
cases := []struct {
in string
want []string
}{
{"", nil},
{" ", nil},
{",,", nil},
{"a", []string{"a"}},
{"a,b,c", []string{"a", "b", "c"}},
{" a , b , c ", []string{"a", "b", "c"}},
{"a,,b", []string{"a", "b"}},
}
for _, c := range cases {
got := splitCSV(c.in)
if !reflect.DeepEqual(got, c.want) {
t.Errorf("splitCSV(%q) = %v, want %v", c.in, got, c.want)
}
}
}
func TestApplyTo(t *testing.T) {
o := tenantOverrides{
workspace: "/ws",
configDir: "/cfg",
allowedTools: []string{"x"},
allowedSkills: []string{"y"},
}
var opts processOptions
o.applyTo(&opts)
if opts.WorkspaceOverride != "/ws" {
t.Errorf("WorkspaceOverride = %q", opts.WorkspaceOverride)
}
if opts.ConfigDir != "/cfg" {
t.Errorf("ConfigDir = %q", opts.ConfigDir)
}
if !reflect.DeepEqual(opts.AllowedTools, []string{"x"}) {
t.Errorf("AllowedTools = %v", opts.AllowedTools)
}
if !reflect.DeepEqual(opts.AllowedSkills, []string{"y"}) {
t.Errorf("AllowedSkills = %v", opts.AllowedSkills)
}
}