Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

sandbox

package

Go to main page

Versions in this module

v0

v0.4.1

Aug 29, 2026

v0.4.0

Aug 28, 2026

Changes in this version

+ const DefaultMaxLogBytes

type DefaultPolicy

+ AllowCommands []string

type EventKind

+ const EventBrowser

+ const EventExec

+ const EventExecResult

+ const EventFileRead

+ const EventFileWrite

type Pack

+ SkillType string

type Sandbox

+ func (s *Sandbox) SetMaxLogBytes(n int)

v0.3.0

Aug 26, 2026

Changes in this version

+ func ReservedModuleNames() []string

+ func ValidateModuleCode(name, code string) error

+ func ValidateModuleName(name string) error

+ type DefaultPolicy struct

+ AllowPrivateNetworks bool

+ AllowTools []string

+ URLAllowPrefixes []string

+ func (p DefaultPolicy) Check(_ context.Context, toolName string, args map[string]any) (PolicyCheckResult, error)

+ type Event struct

+ Detail string

+ Kind EventKind

+ Payload map[string]any

+ Result string

+ Summary string

+ type EventKind string

+ const EventAI

+ const EventAnswer

+ const EventAsk

+ const EventAskResult

+ const EventAssetWrite

+ const EventBlock

+ const EventCard

+ const EventCollFind

+ const EventCollInsert

+ const EventCollRemove

+ const EventCollUpdate

+ const EventDocumentSearch

+ const EventEmail

+ const EventError

+ const EventFetch

+ const EventLog

+ const EventMemory

+ const EventPlan

+ const EventScript

+ const EventScriptResult

+ const EventSkillCall

+ const EventWarning

+ const EventWebSearch

+ type HelpEntry struct

+ Description string

+ Name string

+ type InputRequestData struct

+ InputType string

+ Message string

+ Options []string

+ Placeholder string

+ RequestID string

+ type InputRequester interface

+ Request func(req InputRequestData) (any, error)

+ type LogEntry struct

+ Message string

+ Time time.Time

+ type MultiPolicy struct

+ Checkers []PolicyChecker

+ func (m MultiPolicy) Check(ctx context.Context, toolName string, args map[string]any) (PolicyCheckResult, error)

+ type OnEvent func(Event)

+ type Pack struct

+ Description string

+ HelpEntries map[string]string

+ Name string

+ Prompt string

+ Register func(rt *goja.Runtime, s *Sandbox)

+ func AIPack(ctx context.Context, client llm.Client, model string) Pack

+ func FetchPack(ctx context.Context, requester InputRequester) Pack

+ func HelpPack() Pack

+ func HttpModulePack() Pack

+ func MarkdownModulePack() Pack

+ func RequirePack(ctx context.Context) Pack

+ func SkillDiscoveryPack(skills []SkillInfo) Pack

+ func SkillPack(name, code, description string) Pack

+ type PolicyCheckResult struct

+ Allowed bool

+ ConfigJSON json.RawMessage

+ Reason string

+ type PolicyChecker interface

+ Check func(ctx context.Context, toolName string, args map[string]any) (PolicyCheckResult, error)

+ var AllowAll PolicyChecker = allowAllPolicy{}

+ type Sandbox struct

+ func New(packs ...Pack) *Sandbox

+ func (s *Sandbox) AddHelpEntry(name, description string)

+ func (s *Sandbox) AddSkillCode(name, code string)

+ func (s *Sandbox) CheckPolicy(ctx context.Context, toolName string, args map[string]any) (PolicyCheckResult, error)

+ func (s *Sandbox) CheckPolicyOrPanic(rt *goja.Runtime, ctx context.Context, toolName string, args map[string]any) PolicyCheckResult

+ func (s *Sandbox) Emit(evt Event)

+ func (s *Sandbox) Execute(code string) (result string, err error)

+ func (s *Sandbox) ExecuteTurn(code string, argsJSON json.RawMessage) (logs string, ret json.RawMessage, err error)

+ func (s *Sandbox) HelpEntries() []HelpEntry

+ func (s *Sandbox) HelpEntry(name string) (string, bool)

+ func (s *Sandbox) Logs() []LogEntry

+ func (s *Sandbox) Packs() []Pack

+ func (s *Sandbox) RegisterModule(name, code, description string) error

+ func (s *Sandbox) RequireCacheGet(name string) (goja.Value, bool)

+ func (s *Sandbox) RequireCacheSet(name string, v goja.Value)

+ func (s *Sandbox) Runtime() *goja.Runtime

+ func (s *Sandbox) SetExecTimeout(d time.Duration)

+ func (s *Sandbox) SetOnEvent(fn OnEvent)

+ func (s *Sandbox) SetPolicy(p PolicyChecker)

+ func (s *Sandbox) SkillCode(name string) (string, bool)

+ func (s *Sandbox) SystemPrompt() string

+ func (s *Sandbox) TakeAnswer() (value string, ok bool)

+ type SkillInfo struct

+ Description string

+ Name string

+ Type string

+ type URLAllowlistPolicy struct

+ AllowedPrefixes []string

+ func (p URLAllowlistPolicy) Check(_ context.Context, toolName string, args map[string]any) (PolicyCheckResult, error)

v0.2.0

Aug 25, 2026