plugins

type DataKind string

type DataModule struct {
	Name  string
	Kind  DataKind
	Taint Tainter // optional; switches are refused once tainted
	// Store, when set, keeps every version under StoreName; Set adds the
	// version and makes it current.
	Store     *ModuleStore
	StoreName string
	// contains filtered or unexported fields
}

type DataVersion struct {
	Hash    string // sha256 of Content, hex
	Content []byte
	Meta    map[string]any // front-matter fields (prompt, skill)
	Retry   *RetryPolicy   // retry only
}

type HostFunc = extism.HostFunction

type Loaded struct {
	Path     string // the configured path
	Manifest *Manifest
	Err      error
	MCP      *MCPConfig // nil when the plugin was rejected
}

type MCPConfig struct {
	Present bool
	Err     error
	Digest  string // SHA-256 of the file, hex
	Entries []MCPEntry
}

type MCPEntry struct {
	Name    string
	Type    string
	Err     error
	Command string
	Args    []string
	Env     map[string]string
	Cwd     string
}

type Manifest struct {
	Name        string
	Version     string
	Description string
	Root        string // filesystem-resolved plugin root
	Extensions  map[string]json.RawMessage
	Warnings    []string // non-fatal problems (unknown fields, bad extensions)
}

type ModuleStore struct {
	Dir string
	Now func() time.Time // for tests; time.Now when nil
}

type Permissions struct {
	HostFuncs []string          `json:"host_functions,omitempty"`
	Paths     map[string]string `json:"allowed_paths,omitempty"` // host path -> guest path
	Hosts     []string          `json:"allowed_hosts,omitempty"`
	WASI      bool              `json:"wasi,omitempty"`
}

type RetryPolicy struct {
	MaxAttempts int `json:"max_attempts" toml:"max_attempts"`
	BackoffMS   int `json:"backoff_ms" toml:"backoff_ms"`
}

type SessionGrant struct {
	Root      string
	Hosts     []string
	CheckPath func(abs string, write bool) error // nil allows
	Taint     Tainter
}

type Tainter interface{ Tainted() bool }

type VersionMeta struct {
	Hash        string          `json:"hash"`
	Ext         string          `json:"ext"`
	Manifest    json.RawMessage `json:"manifest,omitempty"`
	Permissions Permissions     `json:"permissions"`
	LoadedAt    time.Time       `json:"loaded_at"`
}

type WasmDecl struct {
	Name     string       `json:"name"`
	File     string       `json:"file"`
	Version  string       `json:"version"`
	Exports  []WasmExport `json:"exports"`
	Requires Permissions  `json:"requires"`
	// Source and Lang declare a module built from Go source by TinyAgent
	// (with TinyGo, an external, separately downloaded tool) instead of a
	// prebuilt file: Source is a directory relative to the plugin root and
	// Lang must be "go".
	Source string `json:"source,omitempty"`
	Lang   string `json:"lang,omitempty"`
}

type WasmExport struct {
	Name        string `json:"name"`
	Description string `json:"description"`
}

type WasmHost struct {
	Grant Permissions
	Funcs []HostFunc // host functions the caller can offer, by name
	Taint Tainter    // optional
	// contains filtered or unexported fields
}

type WasmManifest struct {
	Name     string      `json:"name"`
	Version  string      `json:"version"`
	Requires Permissions `json:"requires"`
}

type WasmModule struct {
	// contains filtered or unexported fields
}

type WasmPool struct {
	// Store, when set, keeps every version of each module; activation loads
	// the version its current pointer names (verifying its hash), and a
	// changed plugin file is added as a new version and made current.
	Store *ModuleStore
	// Compile builds Go source files into a module (TinyGo under the OS
	// sandbox). Modules declared with source need it and Store.
	Compile func(ctx context.Context, files map[string][]byte) ([]byte, error)
	// contains filtered or unexported fields
}

type WasmTools struct {
	Specs []model.ToolSpec
	// contains filtered or unexported fields
}