gwtool

Documentation

Overview

Package gwtool is the gateway's tool point (P3 of docs/subsystems/plugin-runtime.md): the tools magpie answers itself for an agent, in place of the vendor. A plugin serves a tool by its name while it is on (Serve). In the process serving the gateway (Gate), a tool no plugin serves is neither offered nor answered; a process not serving the gateway (the CLI, the TUI) has them all, as before the point was there.

WebSearch is plugins/search's: magpie's web search for a model that can't search by itself. Off, a vendor that searches by itself still does; magpie offers no search of its own. PluginTools is plugins/tools': the tools community plugins give, served to every agent over MCP. Off, the server lists none and runs none.

Index

• Constants
• func Gate() (stop func())
• func Serve(name string) (remove func())
• func Served(name string) bool

Constants

const PluginTools = "plugin_tools"

PluginTools are the tools the user's plugins give (their OpenCode tool hook), served over magpie's plugin tools MCP server.

const WebSearch = "web_search"

WebSearch is magpie's web search: the stand-in web_search tool, the search MCP server and Codex's search when ChatGPT can't answer it.

Functions

func Gate

func Gate() (stop func())

Gate makes every tool wait on Serve until stop: the gateway calls it as it starts serving.

func Serve

func Serve(name string) (remove func())

Serve serves the tool name until remove: its plugin calls it while it is on.

func Served

func Served(name string) bool

Served says whether the tool name is offered and answered here now.