Kandev Agent
c53f699714
- go plugin backends ship as release tarballs (per-platform binaries, checksums) that kandev installs from url/upload or filesystem sideload+sync, then spawns and supervises via hashicorp/go-plugin (unix socket / loopback tcp+automtls) - strict typed grpc contract (kandev.plugin.v1): DeliverEvent/InvokeTool/HandleWebhook plus a capability-gated host service (state, secrets, emit); author sdk in pkg/pluginsdk; packaging cli in cmd/plugin-pack - native frontend bundles: window.registerKandevPlugin + registry/host loader with dynamic routes, nav items, slots and ws handlers; plugins settings page with install dialog, sync button and enable/disable/uninstall - gated behind the plugins feature flag (prod off, dev/e2e on); covered by unit and integration tests plus playwright e2e against a real packaged fixture plugin Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
86 lines
3.1 KiB
Go
86 lines
3.1 KiB
Go
package pluginsdk
|
|
|
|
import (
|
|
"context"
|
|
"sync"
|
|
)
|
|
|
|
// Plugin is the interface a plugin author implements. It is delivered RPCs
|
|
// from kandev over the go-plugin gRPC transport (§3 of
|
|
// docs/plans/plugins/GRPC-CONTRACT.md): DeliverEvent -> OnEvent, InvokeTool
|
|
// -> InvokeTool, HandleWebhook -> HandleWebhook.
|
|
type Plugin interface {
|
|
// OnEvent handles a single bus event delivery. A non-nil error causes
|
|
// kandev's delivery subsystem to retry per §5 (3 retries, 5s/15s/45s).
|
|
OnEvent(ctx context.Context, e *Event) error
|
|
|
|
// InvokeTool handles a tool call routed to this plugin.
|
|
InvokeTool(ctx context.Context, req *ToolRequest) (*ToolResponse, error)
|
|
|
|
// HandleWebhook handles an inbound webhook relayed by kandev's
|
|
// POST /api/plugins/{id}/webhooks/{key} endpoint.
|
|
HandleWebhook(ctx context.Context, req *WebhookRequest) (*WebhookResponse, error)
|
|
}
|
|
|
|
// HostSetter is implemented by Plugin values that want Serve to inject the
|
|
// Host once the broker connection back to kandev is established (see the
|
|
// "Host injection" section of the serve.go file header). UnimplementedPlugin
|
|
// implements this, so embedding it is the easiest way to opt in.
|
|
type HostSetter interface {
|
|
SetHost(Host)
|
|
}
|
|
|
|
// UnimplementedPlugin is an embeddable no-op base for Plugin. Authors that
|
|
// only care about one or two RPCs embed this and override the rest. It also
|
|
// implements HostSetter, storing the injected Host for retrieval via Host().
|
|
//
|
|
// SetHost is called from a background goroutine (see the GRPCPlugin doc
|
|
// comment in serve.go for why), so access to the stored Host is
|
|
// mutex-guarded — Host() may be called concurrently with SetHost from
|
|
// another goroutine.
|
|
type UnimplementedPlugin struct {
|
|
mu sync.RWMutex
|
|
host Host
|
|
}
|
|
|
|
var (
|
|
_ Plugin = (*UnimplementedPlugin)(nil)
|
|
_ HostSetter = (*UnimplementedPlugin)(nil)
|
|
)
|
|
|
|
// OnEvent is a no-op default: it accepts the event without doing anything.
|
|
//
|
|
// Pointer receiver (like every other UnimplementedPlugin method): the type
|
|
// embeds a sync.RWMutex, and a value receiver would trip go vet's copylocks
|
|
// check even though this method never touches it.
|
|
func (*UnimplementedPlugin) OnEvent(context.Context, *Event) error {
|
|
return nil
|
|
}
|
|
|
|
// InvokeTool is a no-op default: it returns an empty successful response.
|
|
func (*UnimplementedPlugin) InvokeTool(context.Context, *ToolRequest) (*ToolResponse, error) {
|
|
return &ToolResponse{}, nil
|
|
}
|
|
|
|
// HandleWebhook is a no-op default: it returns 404, since an unhandled
|
|
// webhook path has nothing sensible to serve.
|
|
func (*UnimplementedPlugin) HandleWebhook(context.Context, *WebhookRequest) (*WebhookResponse, error) {
|
|
return &WebhookResponse{Status: 404}, nil
|
|
}
|
|
|
|
// SetHost stores the Host injected by Serve. Call Host() from your
|
|
// overridden methods to reach kandev.
|
|
func (p *UnimplementedPlugin) SetHost(h Host) {
|
|
p.mu.Lock()
|
|
defer p.mu.Unlock()
|
|
p.host = h
|
|
}
|
|
|
|
// Host returns the Host injected by Serve, or nil if the broker connection
|
|
// hasn't completed yet (or Serve hasn't been called, e.g. in unit tests).
|
|
func (p *UnimplementedPlugin) Host() Host {
|
|
p.mu.RLock()
|
|
defer p.mu.RUnlock()
|
|
return p.host
|
|
}
|