Documentation
¶
Index ¶
- func WithLabel(key, value string) opt.Opt
- func WithLimit(limit *uint) opt.Opt
- func WithName(name string) opt.Opt
- func WithOffset(offset uint) opt.Opt
- func WithProvider(provider string) opt.Opt
- func WithVersion(version uint) opt.Opt
- type AskOpt
- type ChatOpt
- type Client
- func (c *Client) Ask(ctx context.Context, req schema.AskRequest, opts ...AskOpt) (*schema.AskResponse, error)
- func (c *Client) CallTool(ctx context.Context, name string, input json.RawMessage) (*schema.CallToolResponse, error)
- func (c *Client) Chat(ctx context.Context, req schema.ChatRequest, opts ...ChatOpt) (*schema.ChatResponse, error)
- func (c *Client) CreateAgent(ctx context.Context, meta schema.AgentMeta) (*schema.Agent, error)
- func (c *Client) CreateAgentSession(ctx context.Context, agentID string, request schema.CreateAgentSessionRequest) (*schema.CreateAgentSessionResponse, error)
- func (c *Client) CreateConnector(ctx context.Context, url_ string, meta schema.ConnectorMeta) (*schema.Connector, error)
- func (c *Client) CreateSession(ctx context.Context, meta schema.SessionMeta) (*schema.Session, error)
- func (c *Client) DeleteAgent(ctx context.Context, id string) error
- func (c *Client) DeleteConnector(ctx context.Context, url_ string) error
- func (c *Client) DeleteCredential(ctx context.Context, url_ string) error
- func (c *Client) DeleteSession(ctx context.Context, id string) error
- func (c *Client) Embedding(ctx context.Context, req schema.EmbeddingRequest) (*schema.EmbeddingResponse, error)
- func (c *Client) GetAgent(ctx context.Context, id string) (*schema.Agent, error)
- func (c *Client) GetConnector(ctx context.Context, url_ string) (*schema.Connector, error)
- func (c *Client) GetCredential(ctx context.Context, url_ string) (*schema.OAuthCredentials, error)
- func (c *Client) GetModel(ctx context.Context, name string, opts ...opt.Opt) (*schema.Model, error)
- func (c *Client) GetSession(ctx context.Context, id string) (*schema.Session, error)
- func (c *Client) GetTool(ctx context.Context, name string) (*schema.ToolMeta, error)
- func (c *Client) ListAgents(ctx context.Context, opts ...opt.Opt) (*schema.ListAgentResponse, error)
- func (c *Client) ListConnectors(ctx context.Context, req schema.ListConnectorsRequest) (*schema.ListConnectorsResponse, error)
- func (c *Client) ListModels(ctx context.Context, opts ...opt.Opt) (*schema.ListModelsResponse, error)
- func (c *Client) ListSessions(ctx context.Context, opts ...opt.Opt) (*schema.ListSessionResponse, error)
- func (c *Client) ListTools(ctx context.Context, opts ...opt.Opt) (*schema.ListToolResponse, error)
- func (c *Client) SetCredential(ctx context.Context, url_ string, cred schema.OAuthCredentials) error
- func (c *Client) UpdateAgent(ctx context.Context, meta schema.AgentMeta) (*schema.Agent, error)
- func (c *Client) UpdateConnector(ctx context.Context, url_ string, meta schema.ConnectorMeta) (*schema.Connector, error)
- func (c *Client) UpdateSession(ctx context.Context, id string, meta schema.SessionMeta) (*schema.Session, error)
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func WithLabel ¶
WithLabel adds a label filter (key:value) for listing sessions. The key must be a valid identifier. Multiple calls accumulate filters.
func WithLimit ¶
WithLimit sets the maximum number of results to return. If limit is nil, any existing limit is removed.
func WithOffset ¶
WithOffset sets the pagination offset. If offset is 0, any existing offset is removed.
func WithProvider ¶
WithProvider filters results by provider name.
func WithVersion ¶ added in v0.3.0
WithVersion filters results by version number.
Types ¶
type AskOpt ¶
type AskOpt func(*askOptions)
AskOpt is a functional option for the Ask method.
func WithFile ¶
WithFile adds a file attachment to the ask request. WithFile takes ownership of the reader: it will be closed after the request completes. The returned AskOpt is single-use; passing the same option to multiple Ask calls will fail on the second call because the reader will already be consumed and closed.
type ChatOpt ¶
type ChatOpt func(*chatOptions)
ChatOpt is a functional option for the Chat method.
func WithChatFile ¶
WithChatFile adds a file attachment to the chat request. WithChatFile takes ownership of the reader: it will be closed after the request completes. The returned ChatOpt is single-use; passing the same option to multiple Chat calls will fail on the second call because the reader will already be consumed and closed.
func WithChatStream ¶
WithChatStream enables SSE streaming for the chat request. The callback receives streamed text chunks as they arrive (role and text).
func WithChatURL ¶
WithChatURL adds a URL-referenced attachment to the chat request.
type Client ¶
Client is an LLM HTTP client that wraps the base HTTP client and provides typed methods for interacting with the LLM API.
func New ¶
New creates a new LLM HTTP client with the given base URL and options. The url parameter should point to the LLM API endpoint, e.g. "http://localhost:8084/api".
func (*Client) Ask ¶
func (c *Client) Ask(ctx context.Context, req schema.AskRequest, opts ...AskOpt) (*schema.AskResponse, error)
Ask sends a stateless text request with zero or more attachments. Use WithFile to attach file uploads and WithURL to attach URL references. A single file with no other attachments uses streaming multipart/form-data; all other cases use JSON with base64-encoded file data.
func (*Client) CallTool ¶ added in v0.4.2
func (c *Client) CallTool(ctx context.Context, name string, input json.RawMessage) (*schema.CallToolResponse, error)
CallTool calls a tool by name with the given JSON input and returns the result.
func (*Client) Chat ¶
func (c *Client) Chat(ctx context.Context, req schema.ChatRequest, opts ...ChatOpt) (*schema.ChatResponse, error)
Chat sends a message within a session with zero or more attachments. Use WithChatFile to attach file uploads and WithChatURL to attach URL references. A single file with no other attachments uses streaming multipart/form-data; all other cases use JSON with base64-encoded file data.
func (*Client) CreateAgent ¶ added in v0.3.0
CreateAgent creates a new agent with the given metadata (sent as JSON).
func (*Client) CreateAgentSession ¶ added in v0.3.0
func (c *Client) CreateAgentSession(ctx context.Context, agentID string, request schema.CreateAgentSessionRequest) (*schema.CreateAgentSessionResponse, error)
CreateAgentSession creates a new session from an agent definition. The agentID can be an agent ID or name.
func (*Client) CreateConnector ¶ added in v0.4.2
func (c *Client) CreateConnector(ctx context.Context, url_ string, meta schema.ConnectorMeta) (*schema.Connector, error)
CreateConnector registers a new MCP server connector with the given URL and metadata.
func (*Client) CreateSession ¶
func (c *Client) CreateSession(ctx context.Context, meta schema.SessionMeta) (*schema.Session, error)
CreateSession creates a new session with the given metadata.
func (*Client) DeleteAgent ¶ added in v0.3.0
DeleteAgent deletes an agent by ID or name.
func (*Client) DeleteConnector ¶ added in v0.4.2
DeleteConnector removes the connector registered for the given server URL.
func (*Client) DeleteCredential ¶ added in v0.4.0
DeleteCredential removes the credential for the given server URL.
func (*Client) DeleteSession ¶
DeleteSession deletes a session by ID.
func (*Client) Embedding ¶
func (c *Client) Embedding(ctx context.Context, req schema.EmbeddingRequest) (*schema.EmbeddingResponse, error)
Embedding generates embedding vectors for the given text inputs.
func (*Client) GetConnector ¶ added in v0.4.2
GetConnector retrieves the connector registered for the given server URL.
func (*Client) GetCredential ¶ added in v0.4.0
GetCredential retrieves the credential stored for the given server URL.
func (*Client) GetModel ¶
GetModel retrieves a specific model by name, optionally scoped to a provider. If provider is empty, the model is looked up across all providers.
func (*Client) GetSession ¶
GetSession retrieves a session by ID.
func (*Client) ListAgents ¶ added in v0.3.0
func (c *Client) ListAgents(ctx context.Context, opts ...opt.Opt) (*schema.ListAgentResponse, error)
ListAgents returns a list of all agents. Use WithLimit, WithOffset and WithName to filter and paginate results.
func (*Client) ListConnectors ¶ added in v0.4.2
func (c *Client) ListConnectors(ctx context.Context, req schema.ListConnectorsRequest) (*schema.ListConnectorsResponse, error)
ListConnectors returns registered MCP server connectors, with optional filtering by namespace and enabled state, and optional pagination.
func (*Client) ListModels ¶
func (c *Client) ListModels(ctx context.Context, opts ...opt.Opt) (*schema.ListModelsResponse, error)
ListModels returns a list of all available models. Use WithLimit, WithOffset and WithProvider to paginate and filter results.
func (*Client) ListSessions ¶
func (c *Client) ListSessions(ctx context.Context, opts ...opt.Opt) (*schema.ListSessionResponse, error)
ListSessions returns a list of all sessions. Use WithLimit and WithOffset to paginate results.
func (*Client) ListTools ¶
ListTools returns a list of all available tools. Use WithLimit and WithOffset to paginate results.
func (*Client) SetCredential ¶ added in v0.4.0
func (c *Client) SetCredential(ctx context.Context, url_ string, cred schema.OAuthCredentials) error
SetCredential stores (or updates) the credential for the given server URL.
func (*Client) UpdateAgent ¶ added in v0.3.0
UpdateAgent updates an existing agent by name (sent as JSON). The agent name in the metadata is used to look up the existing agent.
Source Files