63 lines
1.9 KiB
Go
63 lines
1.9 KiB
Go
package webfetch
|
|
|
|
import (
|
|
"context"
|
|
"fmt"
|
|
"strings"
|
|
|
|
"github.com/samcharles93/archie-core/internal/tools"
|
|
)
|
|
|
|
// ToolName is the registry name of the fetch tool.
|
|
const ToolName = "web_fetch"
|
|
|
|
// Tool builds the registry entry for cfg, or nil when the fetcher is
|
|
// disabled. Returning nil rather than an entry that always refuses keeps a
|
|
// capability the operator turned off out of the model's tool list entirely --
|
|
// an advertised tool that never works costs a round trip to discover.
|
|
func Tool(cfg Config) *tools.ToolEntry {
|
|
if !cfg.Enabled {
|
|
return nil
|
|
}
|
|
|
|
client := New(cfg)
|
|
|
|
return &tools.ToolEntry{
|
|
Name: ToolName,
|
|
Toolset: "web",
|
|
Description: "Fetch a web page or API response over http/https and return its readable text. " +
|
|
"HTML is reduced to text; JSON, XML and plain text are returned as received. " +
|
|
"Use it to read documentation, changelogs, issues or any URL the user provides.",
|
|
// Reading a URL has no side effect on this host, so it is safe to
|
|
// run alongside other reads.
|
|
Classification: tools.ClassIdempotent,
|
|
Schema: tools.JSONSchema{
|
|
"type": "object",
|
|
"properties": map[string]any{
|
|
"url": map[string]any{
|
|
"type": "string",
|
|
"description": "Absolute http:// or https:// URL to fetch.",
|
|
},
|
|
"raw": map[string]any{
|
|
"type": "boolean",
|
|
"description": "Return the response body unchanged instead of extracting readable text from HTML. Defaults to false.",
|
|
},
|
|
},
|
|
"required": []any{"url"},
|
|
},
|
|
Handler: func(ctx context.Context, input map[string]any) (any, error) {
|
|
target, _ := input["url"].(string)
|
|
if strings.TrimSpace(target) == "" {
|
|
return nil, fmt.Errorf("%s: url is required", ToolName)
|
|
}
|
|
raw, _ := input["raw"].(bool)
|
|
|
|
body, err := client.Fetch(ctx, target, raw)
|
|
if err != nil {
|
|
return nil, fmt.Errorf("%s: %w", ToolName, err)
|
|
}
|
|
return body, nil
|
|
},
|
|
}
|
|
}
|