web

type ContentFormat string

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

	Format ContentFormat `` /* 131-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 exactly request.URL in the requested format without
	// mutating or retaining request, and transfers ownership of the response to
	// the caller. Implementations must honor ctx and preserve network error
	// causes.
	Fetch(ctx context.Context, request *FetchRequest) (*FetchResponse, error)
}

type Recency string

type SearchRequest struct {
	Query string `` /* 155-byte string literal not displayed */

	MaxResults int `` /* 173-byte string literal not displayed */

	AllowedDomains []string `` /* 178-byte string literal not displayed */

	BlockedDomains []string `` /* 167-byte string literal not displayed */

	Recency Recency `json:"recency,omitempty" jsonschema_description:"Optional time window: hour, day, week, month, or year."`
}

type SearchResponse struct {
	// Query is the caller's prepared query, never a provider's echo of it:
	// providers may receive rewritten text such as appended site: operators
	// for domain filters.
	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 the response to the caller. Implementations must
	// honor ctx, preserve provider error causes, and reject unsupported
	// explicit fields instead of ignoring them.
	Search(ctx context.Context, request *SearchRequest) (*SearchResponse, error)
}