bridge

type Bridge ¶

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

Bridge is a running loopback HTTP MCP server.

func New(tools []ToolDef, logger *slog.Logger, recorder InvocationRecorder) (*Bridge, error)

func (b *Bridge) Close(ctx context.Context) error

func (b *Bridge) Start(_ context.Context) error

func (b *Bridge) Token() string

func (b *Bridge) URL() string

type HandlerFunc ¶

type HandlerFunc func(ctx context.Context, input map[string]any) (*ToolOutput, error)

HandlerFunc is the tool-invocation handler the bridge invokes when opencode calls one of the registered tools. It receives the raw arguments as a map and returns a structured ToolOutput or an error.

The ctx passed to the handler carries a ToolSession under sessionContextKey, accessible via SessionFromContext. Tools that want to send an MCP elicitation (server → client prompt) back to opencode should pull the session from ctx and call Elicit.

type InvocationRecorder ¶

type InvocationRecorder interface {
	RecordMCPBridge(ctx context.Context, tool, status string)
}

InvocationRecorder receives a single observation for each tool call routed through the bridge. status is one of "ok", "error", "app_error" (the tool returned IsError=true). Callers can implement this with observability.Observer.RecordMCPBridge.

type ToolDef ¶

type ToolDef struct {
	Name        string
	Description string
	Schema      map[string]any
	Handler     HandlerFunc
	// Annotations, when non-nil, is attached to the underlying MCP
	// tool's Annotations field so opencode sees the hints on
	// tools/list. See opencodesdk.ToolAnnotations for the public
	// wrapper shape.
	Annotations *mcp.ToolAnnotations
}

ToolDef is the bridge-internal tool definition. opencodesdk maps its public Tool interface to this before passing to New.

type ToolOutput ¶

type ToolOutput struct {
	Text       string
	Structured any
	IsError    bool
}

ToolOutput carries the bridge-friendly form of a tool's result. It decouples the bridge from opencodesdk's public Tool API so the bridge package has no cyclic dependencies.

type ToolSession ¶

type ToolSession interface {
	// Elicit sends an MCP elicitation request to the connected
	// client (opencode). Returns the client's response (or an error
	// if the client does not support elicitation).
	Elicit(ctx context.Context, params *mcp.ElicitParams) (*mcp.ElicitResult, error)
}

ToolSession is the minimal surface a bridge-served tool needs for server-initiated interactions (currently: elicitation). It mirrors a subset of *mcp.ServerSession so the public opencodesdk package can expose a stable API without leaking the MCP-SDK types.

func SessionFromContext(ctx context.Context) ToolSession