webaccess

Documentation

Overview

Package webaccess applies policy decisions to network access requests.

Index

• type FetchInput
• type FetchOutput
  • func Fetch(ctx context.Context, input FetchInput) (FetchOutput, error)
• type SearchInput
• type SearchOutput
  • func Search(ctx context.Context, input SearchInput) (SearchOutput, error)
  • func (o SearchOutput) MarshalJSON() ([]byte, error)
• type SearchResult

Types

type FetchInput

type FetchInput struct {
	URL       string `json:"url"`
	Prompt    string `json:"prompt,omitempty"`
	TimeoutMS int    `json:"timeout_ms,omitempty"`
	MaxBytes  int64  `json:"max_bytes,omitempty"`
}

FetchInput describes a web fetch request.

type FetchOutput

type FetchOutput struct {
	URL         string `json:"url"`
	FinalURL    string `json:"final_url"`
	StatusCode  int    `json:"status_code"`
	Code        int    `json:"code"`
	CodeText    string `json:"codeText"`
	ContentType string `json:"content_type,omitempty"`
	Title       string `json:"title,omitempty"`
	Bytes       int64  `json:"bytes"`
	Truncated   bool   `json:"truncated"`
	Text        string `json:"text"`
	Summary     string `json:"summary,omitempty"`
	Result      string `json:"result,omitempty"`
	DurationMS  int64  `json:"duration_ms"`
	DurationMs  int64  `json:"durationMs"`
}

FetchOutput reports fetched content, metadata, and extracted text.

func Fetch

func Fetch(ctx context.Context, input FetchInput) (FetchOutput, error)

Fetch retrieves a URL and returns normalized text and summary metadata.

type SearchInput

type SearchInput struct {
	Query          string   `json:"query"`
	MaxResults     int      `json:"max_results,omitempty"`
	AllowedDomains []string `json:"allowed_domains,omitempty"`
	BlockedDomains []string `json:"blocked_domains,omitempty"`
	TimeoutMS      int      `json:"timeout_ms,omitempty"`
}

SearchInput describes a web search request.

type SearchOutput

type SearchOutput struct {
	Query           string         `json:"query"`
	SourceURL       string         `json:"source_url"`
	Results         []SearchResult `json:"results"`
	DurationMS      int64          `json:"duration_ms"`
	DurationSeconds float64        `json:"durationSeconds"`
}

SearchOutput reports search results and the provider/source URL.

func Search

func Search(ctx context.Context, input SearchInput) (SearchOutput, error)

Search queries the configured search endpoint and returns normalized results.

func (SearchOutput) MarshalJSON

func (o SearchOutput) MarshalJSON() ([]byte, error)

MarshalJSON emits both raw hits and Claude-compatible result blocks.

type SearchResult

type SearchResult struct {
	Title   string `json:"title"`
	URL     string `json:"url"`
	Snippet string `json:"snippet,omitempty"`
}

SearchResult is one normalized web search result.