client

Jun 18, 2026

Changes in this version

+ const ClientModeEnvVar

+ var DefaultClientMode = ClientModeLegacyOnly

+ var ErrListPaginationOverrun = errors.New("client: list pagination exceeded max pages")

+ func SetDefaultClientMode(m ClientMode)

type CallContext

+ Headers map[string]string

type Client

+ func (c *Client) Discover() (*DiscoverResult, error)

+ func (c *Client) ReadResourceFull(uri string) (*core.ResourceResult, error)

+ func (c *Client) ServerExtensionCapability(id string) (core.ExtensionCapability, bool)

+ func (c *Client) UsingStatelessWire() bool

+ type ClientMode int

+ const ClientModeAdaptive

+ const ClientModeLegacyOnly

+ const ClientModeStateless

+ func ParseClientMode(s string) (ClientMode, bool)

+ func ResolveClientMode() ClientMode

+ func (m ClientMode) String() string

type ClientOption

+ func WithClientMode(m ClientMode) ClientOption

+ func WithInspectResponse(fn func(*http.Response)) ClientOption

+ func WithMaxListPages(n int) ClientOption

+ func WithTracerProvider(tp core.TracerProvider) ClientOption

+ type DiscoverResult struct

+ Capabilities core.ServerCapabilities

+ ServerInfo core.ServerInfo

+ SupportedVersions []string

+ type UnsupportedDiscoverError struct

+ Source string

+ func (e *UnsupportedDiscoverError) Error() string

May 8, 2026

Changes in this version

type ToolCallResult

+ InputRequired *core.InputRequiredResult

+ func (r *ToolCallResult) IsInputRequired() bool

May 5, 2026

Changes in this version

+ func FileInputsFromTool(tool core.ToolDef) map[string]core.FileInputDescriptor

+ func PrepareFileArg(path string, desc *core.FileInputDescriptor) (string, error)

+ type CallContext struct

+ func NewCallContext(ctx context.Context) *CallContext

+ func (cc *CallContext) WithNotifyHook(hook func(method string, params json.RawMessage)) *CallContext

type Client

+ func (c *Client) CallContext(cc *CallContext, method string, params any) (*CallResult, error)

type ClientOption

+ func WithFileInputs() ClientOption

May 1, 2026

Changes in this version

type Client

+ func (c *Client) ListPromptsPage(cursor string) (*core.PromptsListResult, error)

+ func (c *Client) ListResourceTemplatesPage(cursor string) (*core.ResourceTemplatesListResult, error)

+ func (c *Client) ListResourcesPage(cursor string) (*core.ResourcesListResult, error)

+ func (c *Client) ListToolsPage(cursor string) (*core.ToolsListResult, error)

Apr 30, 2026

Changes in this version

+ var ErrMRTRMaxRounds = errors.New("MRTR max rounds exceeded")

+ func CancelTask(c *Client, taskID string, opts ...TaskOptions) error

+ func CancelTaskV1(c *Client, taskID string) (*core.CancelTaskResultV1, error)

+ func GetTask(c *Client, taskID string, opts ...TaskOptions) (*core.DetailedTask, error)

+ func GetTaskPayloadV1(c *Client, taskID string) (*core.ToolResult, string, error)

+ func GetTaskV1(c *Client, taskID string) (*core.GetTaskResultV1, error)

+ func IsToolTaskV1(tool core.ToolDef) bool

+ func ListTasksV1(c *Client, cursor string) (*core.ListTasksResultV1, error)

+ func ToolCallAsTaskV1(c *Client, name string, args any, opts ...*TaskCallOptionsV1) (*core.CreateTaskResultV1, error)

+ func UpdateTask(c *Client, req core.UpdateTaskRequest) error

+ func WaitForTask(ctx context.Context, c *Client, taskID string, opts ...WaitOptions) (*core.DetailedTask, error)

+ func WaitForTaskV1(ctx context.Context, c *Client, taskID string, pollInterval time.Duration) (*core.GetTaskResultV1, error)

type Client

+ func (c *Client) HandleServerRequestWithContext(ctx context.Context, req *core.Request) *core.Response

type ClientOption

+ func WithElicitationCompleteHandler(h ElicitationCompleteHandler) ClientOption

+ func WithElicitationURLSupport() ClientOption

+ func WithTasksExtension() ClientOption

+ type ElicitationCompleteHandler func(context.Context, core.ElicitationCompleteParams)

+ type InputHandler func(ctx context.Context, reqs core.InputRequests) (core.InputResponses, error)

+ func DefaultInputHandler(c *Client) InputHandler

+ type MRTROption func(*mrtrConfig)

+ func WithMaxMRTRRounds(n int) MRTROption

+ type RPCError struct

+ Code int

+ Data any

+ Message string

+ func (e *RPCError) Error() string

+ type TaskCallOptionsV1 struct

+ PollInterval int

+ ProgressToken any

+ TTL int

+ type TaskOptions struct

+ RequestState string

+ type ToolCallResult struct

+ Incomplete *core.IncompleteResult

+ Sync *core.ToolResult

+ Task *core.CreateTaskResult

+ func CallToolWithInputs(ctx context.Context, c *Client, name string, args any, handler InputHandler, ...) (*ToolCallResult, error)

+ func ToolCall(c *Client, name string, args any) (*ToolCallResult, error)

+ func (r *ToolCallResult) IsIncomplete() bool

+ func (r *ToolCallResult) IsTask() bool

+ type WaitOptions struct

+ PollInterval time.Duration

+ RequestState string

Apr 16, 2026

Changes in this version

+ type ClientCallFunc func(ctx context.Context, method string, params any) (*CallResult, error)

+ type ClientMiddleware func(ctx context.Context, method string, params any, next ClientCallFunc) (*CallResult, error)

type ClientOption

+ func WithClientMiddleware(mw ...ClientMiddleware) ClientOption

Apr 16, 2026

Changes in this version

type Client

+ func (c *Client) ListPrompts() ([]core.PromptDef, error)

+ func (c *Client) SetLogLevel(level string) error

Apr 16, 2026

Changes in this version

type Client

+ func (c *Client) Prompts(ctx context.Context) iter.Seq2[core.PromptDef, error]

+ func (c *Client) ResourceTemplates(ctx context.Context) iter.Seq2[core.ResourceTemplate, error]

+ func (c *Client) Resources(ctx context.Context) iter.Seq2[core.ResourceDef, error]

+ func (c *Client) Tools(ctx context.Context) iter.Seq2[core.ToolDef, error]

type ClientOption

+ func WithIOTransport(r io.Reader, w io.Writer) ClientOption

Apr 13, 2026

Changes in this version

type Client

+ func (c *Client) ToolCallFull(name string, args any) (*core.ToolResult, error)

Apr 12, 2026

Changes in this version

type Client

+ func (c *Client) NotifyRootsChanged() error

type ClientOption

+ func WithRootsHandler(h RootsHandler) ClientOption

+ type RootsHandler func(context.Context) ([]core.Root, error)

Apr 10, 2026

Changes in this version

type ClientOption

+ func WithContentChunkHandler(fn func(chunk core.ContentChunk)) ClientOption

Apr 10, 2026

Changes in this version

type ClientOption

+ func WithConnectTimeout(d time.Duration) ClientOption

Apr 10, 2026

Changes in this version

type ClientOption

+ func WithCommandTransport(name string, args []string, opts ...CommandOption) ClientOption

+ func WithModifyRequest(fn func(*http.Request)) ClientOption

+ type CommandOption func(*commandOpts)

+ func WithDir(dir string) CommandOption

+ func WithEnv(env ...string) CommandOption

+ func WithShutdownTimeout(d time.Duration) CommandOption

+ func WithStderr(w io.Writer) CommandOption

+ type CommandTransport struct

+ func NewCommandTransport(name string, args []string, opts ...CommandOption) *CommandTransport

+ func (ct *CommandTransport) Call(ctx context.Context, req *core.Request) (*core.Response, error)

+ func (ct *CommandTransport) Close() error

+ func (ct *CommandTransport) Connect(ctx context.Context) error

+ func (ct *CommandTransport) Notify(ctx context.Context, req *core.Request) error

+ func (ct *CommandTransport) SessionID() string

+ func (ct *CommandTransport) Stderr() string

Apr 9, 2026

Changes in this version

+ func ToolCallTyped[T any](c *Client, name string, args any) (T, error)

Apr 9, 2026

Changes in this version

type ClientOption

+ func WithClientKeepalive(interval time.Duration, maxFailures int) ClientOption

Apr 8, 2026

Changes in this version

type HTTPStatusError

+ Body string

+ StatusCode int

+ func (e *HTTPStatusError) Error() string

Apr 9, 2026

Changes in this version

+ func DoWithAuthRetry(ts core.TokenSource, buildReq func() (*http.Request, error), ...) (*http.Response, error)

+ func ExtractMethodFromJSON(data []byte) string

+ func IsTransientError(err error) bool

+ func ResolveEndpointURL(baseSSEURL, endpointRef string) (string, error)

+ type CallResult struct

+ Raw json.RawMessage

+ func (r *CallResult) JSON() string

+ func (r *CallResult) Unmarshal(v any) error

+ type Client struct

+ ServerInfo core.ServerInfo

+ func NewClient(url string, info core.ClientInfo, opts ...ClientOption) *Client

+ func (c *Client) Call(method string, params any) (*CallResult, error)

+ func (c *Client) Close() error

+ func (c *Client) Connect() error

+ func (c *Client) HandleServerRequest(req *core.Request) *core.Response

+ func (c *Client) ListResourceTemplates() ([]core.ResourceTemplate, error)

+ func (c *Client) ListResources() ([]core.ResourceDef, error)

+ func (c *Client) ListTools() ([]core.ToolDef, error)

+ func (c *Client) ListToolsForModel() ([]core.ToolDef, error)

+ func (c *Client) ReadResource(uri string) (string, error)

+ func (c *Client) ServerSupportsExtension(id string) bool

+ func (c *Client) ServerSupportsUI() bool

+ func (c *Client) SessionID() string

+ func (c *Client) SetTransport(t core.Transport)

+ func (c *Client) SetURL(url string)

+ func (c *Client) SubscribeResource(uri string) error

+ func (c *Client) ToolCall(name string, args any) (string, error)

+ func (c *Client) URL() string

+ func (c *Client) UnsubscribeResource(uri string) error

+ type ClientAuthError struct

+ Message string

+ RequiredScopes []string

+ StatusCode int

+ WWWAuthenticate string

+ func (e *ClientAuthError) Error() string

+ type ClientOption func(*Client)

+ func WithClientBearerToken(token string) ClientOption

+ func WithClientLogging(logger *log.Logger) ClientOption

+ func WithElicitationHandler(h ElicitationHandler) ClientOption

+ func WithExtension(id string, cap core.ClientExtensionCap) ClientOption

+ func WithGetSSEStream() ClientOption

+ func WithMaxRetries(n int) ClientOption

+ func WithNotificationCallback(fn func(method string, params any)) ClientOption

+ func WithReconnectBackoff(d time.Duration) ClientOption

+ func WithSSEClient() ClientOption

+ func WithSamplingHandler(h SamplingHandler) ClientOption

+ func WithStdioTransport(r io.Reader, w io.Writer) ClientOption

+ func WithTokenSource(ts core.TokenSource) ClientOption

+ func WithTransport(t core.Transport) ClientOption

+ func WithUIExtension() ClientOption

+ type ElicitationHandler func(context.Context, core.ElicitationRequest) (core.ElicitationResult, error)

+ type HTTPStatusError = ssehttp.HTTPStatusError

+ type SamplingHandler func(context.Context, core.CreateMessageRequest) (core.CreateMessageResult, error)

+ type StdioTransport struct

+ func NewStdioTransport(r io.Reader, w io.Writer) *StdioTransport

+ func (t *StdioTransport) Call(ctx context.Context, req *core.Request) (*core.Response, error)

+ func (t *StdioTransport) Close() error

+ func (t *StdioTransport) Connect(ctx context.Context) error

+ func (t *StdioTransport) Notify(ctx context.Context, req *core.Request) error

+ func (t *StdioTransport) SessionID() string