webaccess

package
v0.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 14, 2026 License: MIT Imports: 12 Imported by: 0

Documentation

Overview

Package webaccess applies policy decisions to network access requests.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

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(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.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL