plugin-host

Install

togo install togo-framework/plugin-host

Where a compiled togo plugin is wired at build time, plugin-host adds a runtime layer (the sentra-style plugins table): an admin can enable/disable a hosted plugin, change its config, and reorder navigation — live, persisted through a pluggable store, no restart. Each hosted plugin can contribute capabilities that call other togo plugins or trigger a workflow as step management.

Concepts

• Hosted plugin record — Plugin{Slug, Kind, Enabled, Config, Nav, Sort, LabelEN, LabelAR} stored via the Store interface (in-memory default; back it with a DB plugins table).
• Runtime toggle — Enable/Disable/Configure + Refresh() apply state without recompiling.
• Capabilities — RegisterCapability(slug, fn); RunCapability(ctx, slug, input) runs it, gated by the owning plugin's enabled state.
• Workflow composition — WorkflowCapability(k, "name") returns a capability that triggers a workflow (uses the workflow plugin's steps).

Usage

ph, _ := pluginhost.FromKernel(k)

// Host a plugin (persisted), shown in nav, sorted.
ph.Register(pluginhost.Plugin{Slug: "newsletter", Kind: "capability", Enabled: true, Nav: true, Sort: 10, LabelEN: "Newsletter"})

// Toggle / configure at runtime — no restart.
ph.Disable("newsletter")
ph.Configure("newsletter", map[string]any{"from": "news@acme.io", "double_optin": true})
ph.Enable("newsletter")

// Contribute a capability that composes other plugins…
ph.RegisterCapability("newsletter.send", func(ctx context.Context, in map[string]any) (any, error) {
    // call mail / notifications / billing plugins here
    return nil, nil
})

// …or compose the workflow plugin as step management.
ph.RegisterCapability("onboard", pluginhost.WorkflowCapability(k, "onboarding"))
out, err := ph.RunCapability(ctx, "onboard", map[string]any{"user_id": 42})

nav := ph.Nav() // enabled + nav-visible plugins, in sort order (for a sidebar)

REST API

Configuration

No required env. Storage defaults to a bounded in-memory store; implement the Store interface (Upsert/Get/All/Delete) and call ph.WithStore(db) to host plugins in a database plugins table for true runtime, multi-instance control.