web

type ContentFormat string

type FetchRequest struct {
	// URL is the page to fetch. Required.
	URL string `json:"url" jsonschema:"minLength=1" jsonschema_description:"Absolute http(s) URL of the page to fetch."`

	// Format selects the response format. "" defaults to markdown.
	Format ContentFormat `` /* 178-byte string literal not displayed */
}

type FetchResponse struct {
	Content string        `json:"content"`
	Format  ContentFormat `json:"format"`
}

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

type Fetcher interface {
	// Fetch retrieves and renders exactly request.URL in the requested format
	// without mutating or retaining request. Implementations must honor ctx,
	// preserve network error causes, and transfer response ownership to the
	// caller.
	Fetch(ctx context.Context, request *FetchRequest) (*FetchResponse, error)
}

type Recency string

type SearchRequest struct {
	// Query is the search string. Required.
	Query string `` /* 155-byte string literal not displayed */

	// MaxResults caps the number of returned results. 0 = use the
	// provider's default (typically 5-10).
	MaxResults int `` /* 188-byte string literal not displayed */

	// AllowedDomains restricts results to any of these domains. Mutually
	// exclusive with BlockedDomains on most providers.
	AllowedDomains []string `` /* 202-byte string literal not displayed */

	// BlockedDomains drops results from these domains.
	BlockedDomains []string `` /* 197-byte string literal not displayed */

	// Recency filters to a coarse time-window. "" = no time filter.
	Recency Recency `` /* 167-byte string literal not displayed */
}

type SearchResponse struct {
	Query   string          `json:"query"`
	Results []*SearchResult `json:"results"`
}

type SearchResult struct {
	Title         string    `json:"title"`
	URL           string    `json:"url"`
	Snippet       string    `json:"snippet"`
	FaviconURL    string    `json:"favicon_url,omitempty"`
	PublishedTime time.Time `json:"published_time,omitzero"`
	Source        string    `json:"source,omitempty"`
}

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

type Searcher interface {
	// Search performs one request without mutating or retaining it and transfers
	// ownership of a normalized response to the caller. Implementations must
	// honor ctx, preserve provider error causes, and reject unsupported explicit
	// fields instead of silently ignoring them.
	Search(ctx context.Context, request *SearchRequest) (*SearchResponse, error)
}