Files
archie/internal/tools/mcp/sampling.go
T

74 lines
3.0 KiB
Go

package mcp
import (
"context"
"encoding/json"
)
// JSON-RPC 2.0 error codes used when answering a server-initiated request.
// These are spec-defined and part of the MCP wire contract: the server
// distinguishes "this client cannot do that" from "the request was
// malformed" from "the handler failed" by the code, not the message.
const (
// ErrCodeMethodNotFound is returned when this client has no idea how
// to answer the requested method, including a sampling request when no
// sampling handler is configured. It is never a silent drop.
ErrCodeMethodNotFound = -32601
// ErrCodeInvalidParams is returned when the request's params cannot be
// decoded into the method's shape.
ErrCodeInvalidParams = -32602
// ErrCodeInternal is returned when the configured handler ran but
// failed. The message carries the handler's own error text.
ErrCodeInternal = -32603
)
// SamplingContent is one content block in a sampling message. The MCP
// sampling method sends text today; the type field is carried so an
// unsupported block is rejected explicitly rather than silently emptied.
type SamplingContent struct {
Type string `json:"type"`
Text string `json:"text,omitempty"`
}
// SamplingMessage is one conversation message supplied by the MCP server.
type SamplingMessage struct {
Role string `json:"role"`
Content SamplingContent `json:"content"`
}
// SamplingRequest is the params of a sampling/createMessage request: the
// server asks this client to run a completion on its behalf.
type SamplingRequest struct {
Messages []SamplingMessage `json:"messages"`
SystemPrompt string `json:"systemPrompt,omitempty"`
MaxTokens int `json:"maxTokens,omitempty"`
Temperature *float64 `json:"temperature,omitempty"`
StopSequences []string `json:"stopSequences,omitempty"`
}
// SamplingResult is the result of a sampling/createMessage request.
type SamplingResult struct {
Model string `json:"model"`
Role string `json:"role"`
Content SamplingContent `json:"content"`
StopReason string `json:"stopReason,omitempty"`
}
// SamplingHandler answers a server's sampling request. Errors become JSON-RPC
// internal errors.
type SamplingHandler func(ctx context.Context, req SamplingRequest) (SamplingResult, error)
// ServerRequestHandler answers one request the MCP server sent to this
// client. A non-nil *ErrorData becomes a JSON-RPC error response;
// otherwise result becomes the success response. The MCP wire contract
// permits both, and a client must never drop a request it cannot answer.
type ServerRequestHandler func(ctx context.Context, method string, params json.RawMessage) (json.RawMessage, *ErrorData)
// serverRequestRouter is implemented by transports that can receive
// server-initiated requests over their server→client channel. The
// stateless HTTP transport cannot (it has no persistent stream) and
// therefore does not implement it.
type serverRequestRouter interface {
SetServerRequestHandler(handler ServerRequestHandler)
}