WeKnora/internal/models/runtime/plugin.go

81 lines
2.5 KiB
Go

package runtime
import (
"encoding/json"
"errors"
"fmt"
"io"
"strings"
)
// RegisterPlugin adds a vendor an installed plugin declares. The definition
// uses the deployment overlay format for one provider, with two limits: it
// is taken literally (no ${ENV} expansion, which would hand a plugin the
// server's environment) and it carries no deployment API key, since every
// workspace brings its own. It cannot replace a built-in or operator
// vendor; registering the same plugin vendor again replaces it. baseDir
// resolves the icon path inside the plugin package.
//
// The vendor joins the baseline, so later deployment overlay reloads keep
// it and may patch it like a built-in.
func (rt *Runtime) RegisterPlugin(id string, definition []byte, baseDir string) error {
id = strings.ToLower(strings.TrimSpace(id))
if id == "" {
return errors.New("vendor id is empty")
}
var p OverlayProvider
dec := json.NewDecoder(bytesReader(definition))
dec.DisallowUnknownFields()
if err := dec.Decode(&p); err != nil {
return fmt.Errorf("parse vendor definition: %w", err)
}
if err := dec.Decode(new(any)); err != io.EOF {
return errors.New("parse vendor definition: expected a single JSON document")
}
if p.APIKey != "" {
return errors.New("a plugin vendor cannot set api_key; workspaces supply their own keys")
}
vendor := newOverlayVendor(id)
if err := applyOverlayProvider(vendor, p, baseDir, func(s string) string { return s }); err != nil {
return err
}
normalizeProvider(vendor)
if err := validateDefinition(vendor); err != nil {
return err
}
rt.mu.Lock()
defer rt.mu.Unlock()
if _, taken := rt.providers[id]; taken && !rt.plugins[id] {
return fmt.Errorf("vendor %s already exists", id)
}
if rt.plugins == nil {
rt.plugins = map[string]bool{}
}
rt.plugins[id] = true
rt.providers[id] = vendor
rt.builtins[id] = vendor.clone()
return nil
}
// Unregister removes a vendor RegisterPlugin added. Other vendors stay.
func (rt *Runtime) Unregister(id string) {
id = strings.ToLower(strings.TrimSpace(id))
rt.mu.Lock()
defer rt.mu.Unlock()
if !rt.plugins[id] {
return
}
delete(rt.plugins, id)
delete(rt.providers, id)
delete(rt.builtins, id)
}
// RegisterPlugin adds a plugin vendor to the default runtime.
func RegisterPlugin(id string, definition []byte, baseDir string) error {
return Default().RegisterPlugin(id, definition, baseDir)
}
// Unregister removes a plugin vendor from the default runtime.
func Unregister(id string) { Default().Unregister(id) }