tools

type ArtifactWriter interface {
	WriteArtifact(ctx context.Context, artifact agentcore.AgentRunArtifact) error
}

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

type BrowserCommandRunner interface {
	Run(ctx context.Context, env []string, args ...string) ([]byte, error)
}

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

type BrowserToolsConfig struct {
	Enabled               bool
	AppID                 string
	Binary                string
	KernelAPIKey          string
	AllowedDomains        []string
	CommandTimeout        time.Duration
	SessionTimeoutSeconds int
	MaxOutputChars        int
	ArtifactUploadURL     string
	ArtifactUploadToken   string
	HTTPClient            *http.Client
	Runner                BrowserCommandRunner
	Kernel                kernelBrowserProvider
	KernelHeadless        bool
	KernelStealth         bool
	ReplayFramerate       int
	FFmpegBinary          string
	RecordingTrimTimeout  time.Duration
	RecordingTrimThreads  int
	RecordingTrimPrePad   time.Duration
	RecordingTrimPostPad  time.Duration
	RecordingTrimLimiter  chan struct{}
	RecordingTrimmer      browserRecordingTrimmer
	DisableRecordingTrim  bool
}

type CallContext struct {
	AppID            string
	RunID            string
	Agent            *agentcore.Agent
	Run              *agentcore.AgentRun
	Target           agentcore.TargetRef
	StagedSkillRoot  string
	ArtifactWriter   ArtifactWriter
	WorkspaceManager WorkspaceManager
}

type CheckoutRepositoryRequest struct {
	RepositoryID string
	RepoFullName string
	BaseBranch   string
	WorkBranch   string
	Alias        string
	Primary      bool
}

type CheckoutRepositoryResult struct {
	Alias        string                    `json:"alias,omitempty"`
	Primary      bool                      `json:"primary"`
	Lease        *agentcore.WorkspaceLease `json:"lease,omitempty"`
	RepositoryID string                    `json:"repository_id,omitempty"`
	RepoFullName string                    `json:"repo_full_name,omitempty"`
	BaseBranch   string                    `json:"base_branch,omitempty"`
	WorkBranch   string                    `json:"work_branch,omitempty"`
}

type CommandExecutionContext = sdk.CommandExecutionContext

type Definition struct {
	Name                 string      `json:"name"`
	Description          string      `json:"description"`
	Category             string      `json:"category"`
	InputSchema          interface{} `json:"input_schema"`
	Mutating             bool        `json:"mutating"`
	RiskLevel            string      `json:"risk_level,omitempty"`
	SupportedTargetTypes []string    `json:"supported_target_types,omitempty"`
}

type ExaCitation struct {
	URL   string `json:"url,omitempty"`
	Title string `json:"title,omitempty"`
}

type ExaExtrasConfig struct {
	Links      *int `json:"links,omitempty"`
	ImageLinks *int `json:"imageLinks,omitempty"`
}

type ExaGrounding struct {
	Field      string        `json:"field,omitempty"`
	Citations  []ExaCitation `json:"citations,omitempty"`
	Confidence string        `json:"confidence,omitempty"`
}

type ExaHighlightsConfig struct {
	MaxCharacters int    `json:"maxCharacters,omitempty"`
	Query         string `json:"query,omitempty"`
}

type ExaOutput struct {
	Content   any            `json:"content,omitempty"`
	Grounding []ExaGrounding `json:"grounding,omitempty"`
}

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

type ExaSearchContents struct {
	Text          *ExaTextConfig       `json:"text,omitempty"`
	Highlights    *ExaHighlightsConfig `json:"highlights,omitempty"`
	Summary       *ExaSummaryConfig    `json:"summary,omitempty"`
	MaxAgeHours   *int                 `json:"maxAgeHours,omitempty"`
	Subpages      *int                 `json:"subpages,omitempty"`
	SubpageTarget any                  `json:"subpageTarget,omitempty"`
	Extras        *ExaExtrasConfig     `json:"extras,omitempty"`
}

type ExaSearchRequest struct {
	Query              string             `json:"query"`
	AdditionalQueries  []string           `json:"additionalQueries,omitempty"`
	SystemPrompt       string             `json:"systemPrompt,omitempty"`
	Type               string             `json:"type,omitempty"`
	Category           string             `json:"category,omitempty"`
	UserLocation       string             `json:"userLocation,omitempty"`
	NumResults         int                `json:"numResults,omitempty"`
	IncludeDomains     []string           `json:"includeDomains,omitempty"`
	ExcludeDomains     []string           `json:"excludeDomains,omitempty"`
	StartPublishedDate string             `json:"startPublishedDate,omitempty"`
	EndPublishedDate   string             `json:"endPublishedDate,omitempty"`
	StartCrawlDate     string             `json:"startCrawlDate,omitempty"`
	EndCrawlDate       string             `json:"endCrawlDate,omitempty"`
	Moderation         bool               `json:"moderation,omitempty"`
	Contents           *ExaSearchContents `json:"contents,omitempty"`
	OutputSchema       map[string]any     `json:"outputSchema,omitempty"`
}

type ExaSearchResponse struct {
	RequestID   string            `json:"requestId"`
	SearchType  string            `json:"searchType"`
	Results     []ExaSearchResult `json:"results"`
	Output      *ExaOutput        `json:"output,omitempty"`
	CostDollars map[string]any    `json:"costDollars,omitempty"`
}

type ExaSearchResult struct {
	Title           string            `json:"title"`
	URL             string            `json:"url"`
	ID              string            `json:"id"`
	PublishedDate   *string           `json:"publishedDate,omitempty"`
	Author          *string           `json:"author,omitempty"`
	Image           string            `json:"image,omitempty"`
	Favicon         string            `json:"favicon,omitempty"`
	Text            string            `json:"text,omitempty"`
	Highlights      []string          `json:"highlights,omitempty"`
	HighlightScores []float64         `json:"highlightScores,omitempty"`
	Summary         string            `json:"summary,omitempty"`
	Subpages        []ExaSearchResult `json:"subpages,omitempty"`
	Extras          map[string]any    `json:"extras,omitempty"`
}

type ExaSummaryConfig struct {
	Query  string         `json:"query,omitempty"`
	Schema map[string]any `json:"schema,omitempty"`
}

type ExaTextConfig struct {
	MaxCharacters   int  `json:"maxCharacters,omitempty"`
	IncludeHTMLTags bool `json:"includeHtmlTags,omitempty"`
}

type Handler func(ctx context.Context, callCtx CallContext, input json.RawMessage) (json.RawMessage, error)

type LocalCommandOptions struct {
	// Env is an explicitly selected local environment. Nil preserves server policy.
	Env []string
	// Output receives command chunks; it must be safe for concurrent writes.
	Output io.Writer
}

type ProviderHealth struct {
	AppID       string    `json:"app_id"`
	Provider    string    `json:"provider"`
	Ready       bool      `json:"ready"`
	Degraded    bool      `json:"degraded"`
	Source      string    `json:"source"`
	ToolCount   int       `json:"tool_count"`
	LastSuccess time.Time `json:"last_success,omitempty"`
	LastError   string    `json:"last_error,omitempty"`
}

type ProviderRegistration struct {
	Definition Definition
	Handler    Handler
}

type PublishedPreview struct {
	PanelKey string          `json:"panel_key"`
	Title    string          `json:"title"`
	Format   string          `json:"format"`
	Content  json.RawMessage `json:"content"`
	Replace  bool            `json:"replace"`
}

type PublishedPreviewRequest struct {
	Slot     string          `json:"slot,omitempty"`
	PanelKey string          `json:"panel_key"`
	Title    string          `json:"title"`
	Format   string          `json:"format"`
	Content  json.RawMessage `json:"content"`
	Replace  *bool           `json:"replace,omitempty"`
}

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

type RunCloser interface {
	CloseRun(ctx context.Context, appID, runID string) error
}

type SecurityFindingGroup struct {
	Kind            string              `json:"kind"`
	Key             string              `json:"key"`
	Category        string              `json:"category,omitempty"`
	Severity        string              `json:"severity,omitempty"`
	RuleID          string              `json:"rule_id,omitempty"`
	PackageName     string              `json:"package_name,omitempty"`
	VulnerabilityID string              `json:"vulnerability_id,omitempty"`
	Path            string              `json:"path,omitempty"`
	Count           int                 `json:"count"`
	Summary         SecurityScanSummary `json:"summary"`
}

type SecurityScanFinding struct {
	Scanner          string                 `json:"scanner"`
	Category         string                 `json:"category"`
	Severity         string                 `json:"severity"`
	RuleID           string                 `json:"rule_id"`
	Title            string                 `json:"title"`
	Message          string                 `json:"message"`
	Path             string                 `json:"path"`
	StartLine        *int                   `json:"start_line,omitempty"`
	EndLine          *int                   `json:"end_line,omitempty"`
	PackageName      *string                `json:"package_name,omitempty"`
	InstalledVersion *string                `json:"installed_version,omitempty"`
	FixedVersion     *string                `json:"fixed_version,omitempty"`
	VulnerabilityID  *string                `json:"vulnerability_id,omitempty"`
	CWEIDs           []string               `json:"cwe_ids,omitempty"`
	CVSSScore        *float64               `json:"cvss_score,omitempty"`
	References       []string               `json:"references,omitempty"`
	Fingerprint      string                 `json:"fingerprint"`
	Raw              map[string]interface{} `json:"raw,omitempty"`
}

type SecurityScanSummary struct {
	Total    int `json:"total"`
	Critical int `json:"critical"`
	High     int `json:"high"`
	Medium   int `json:"medium"`
	Low      int `json:"low"`
	Info     int `json:"info"`
}

type SecurityScannerResult struct {
	Scanner                 string                 `json:"scanner"`
	Summary                 SecurityScanSummary    `json:"summary"`
	SummaryBeforePagination SecurityScanSummary    `json:"summary_before_pagination"`
	TotalFindings           int                    `json:"total_findings"`
	ReturnedFindings        int                    `json:"returned_findings"`
	Page                    int                    `json:"page"`
	PageSize                int                    `json:"page_size"`
	HasMore                 bool                   `json:"has_more"`
	ScanID                  string                 `json:"scan_id,omitempty"`
	CacheHit                bool                   `json:"cache_hit"`
	SummaryOnly             bool                   `json:"summary_only,omitempty"`
	DetailLevel             string                 `json:"detail_level,omitempty"`
	Bounded                 bool                   `json:"bounded,omitempty"`
	Groups                  []SecurityFindingGroup `json:"groups,omitempty"`
	Findings                []SecurityScanFinding  `json:"findings"`
	Warnings                []string               `json:"warnings,omitempty"`
}

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

type TinyFishSearchRequest struct {
	Query          string
	Location       string
	MaxResults     int
	IncludeDomains []string
	ExcludeDomains []string
}

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

type WebSearchClient interface {
	Search(ctx context.Context, query WebSearchQuery) ([]WebSearchResult, error)
}

type WebSearchQuery struct {
	Query           string
	Count           int
	Freshness       string
	DomainAllowlist []string
}

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

type WebToolsConfig struct {
	BraveSearch    *BraveSearchClient
	ExaSearch      *ExaSearchClient
	TinyFishSearch *TinyFishSearchClient
	WebFetch       *WebFetchClient
}

type WorkspaceManager interface {
	CheckoutRepository(ctx context.Context, req CheckoutRepositoryRequest) (*CheckoutRepositoryResult, error)
}