git.iko.soy/crush
on 94de6bc help sign in
crush/internal/agent/agentic_fetch_tool.go
231 lines 8.1 kB history raw
1package agent
3import (
4 "context"
5 _ "embed"
6 "errors"
7 "fmt"
8 "net/http"
9 "os"
10 "time"
12 "charm.land/fantasy"
14 "github.com/charmbracelet/crush/internal/agent/prompt"
15 "github.com/charmbracelet/crush/internal/agent/tools"
16 "github.com/charmbracelet/crush/internal/permission"
19//go:embed templates/agentic_fetch.md
20var agenticFetchToolDescription []byte
22// agenticFetchValidationResult holds the validated parameters from the tool call context.
23type agenticFetchValidationResult struct {
24 SessionID string
25 AgentMessageID string
28// validateAgenticFetchParams validates the tool call parameters and extracts required context values.
29func validateAgenticFetchParams(ctx context.Context, params tools.AgenticFetchParams) (agenticFetchValidationResult, error) {
30 if params.Prompt == "" {
31 return agenticFetchValidationResult{}, errors.New("prompt is required")
32 }
34 sessionID := tools.GetSessionFromContext(ctx)
35 if sessionID == "" {
36 return agenticFetchValidationResult{}, errors.New("session id missing from context")
37 }
39 agentMessageID := tools.GetMessageFromContext(ctx)
40 if agentMessageID == "" {
41 return agenticFetchValidationResult{}, errors.New("agent message id missing from context")
42 }
44 return agenticFetchValidationResult{
45 SessionID: sessionID,
46 AgentMessageID: agentMessageID,
47 }, nil
50//go:embed templates/agentic_fetch_prompt.md.tpl
51var agenticFetchPromptTmpl []byte
53func (c *coordinator) agenticFetchTool(_ context.Context, client *http.Client) (fantasy.AgentTool, error) {
54 if client == nil {
55 client = &http.Client{
56 Timeout: 30 * time.Second,
57 Transport: &http.Transport{
58 MaxIdleConns: 100,
59 MaxIdleConnsPerHost: 10,
60 IdleConnTimeout: 90 * time.Second,
61 },
62 }
63 }
65 return fantasy.NewParallelAgentTool(
66 tools.AgenticFetchToolName,
67 string(agenticFetchToolDescription),
68 func(ctx context.Context, params tools.AgenticFetchParams, call fantasy.ToolCall) (fantasy.ToolResponse, error) {
69 validationResult, err := validateAgenticFetchParams(ctx, params)
70 if err != nil {
71 return fantasy.NewTextErrorResponse(err.Error()), nil
72 }
74 // Determine description based on mode.
75 var description string
76 if params.URL != "" {
77 description = fmt.Sprintf("Fetch and analyze content from URL: %s", params.URL)
78 } else {
79 description = "Search the web and analyze results"
80 }
82 p := c.permissions.Request(
83 permission.CreatePermissionRequest{
84 SessionID: validationResult.SessionID,
85 Path: c.cfg.WorkingDir(),
86 ToolCallID: call.ID,
87 ToolName: tools.AgenticFetchToolName,
88 Action: "fetch",
89 Description: description,
90 Params: tools.AgenticFetchPermissionsParams(params),
91 },
92 )
94 if !p {
95 return fantasy.ToolResponse{}, permission.ErrorPermissionDenied
96 }
98 tmpDir, err := os.MkdirTemp(c.cfg.Options.DataDirectory, "crush-fetch-*")
99 if err != nil {
100 return fantasy.NewTextErrorResponse(fmt.Sprintf("Failed to create temporary directory: %s", err)), nil
101 }
102 defer os.RemoveAll(tmpDir)
104 var fullPrompt string
106 if params.URL != "" {
107 // URL mode: fetch the URL content first.
108 content, err := tools.FetchURLAndConvert(ctx, client, params.URL)
109 if err != nil {
110 return fantasy.NewTextErrorResponse(fmt.Sprintf("Failed to fetch URL: %s", err)), nil
111 }
113 hasLargeContent := len(content) > tools.LargeContentThreshold
115 if hasLargeContent {
116 tempFile, err := os.CreateTemp(tmpDir, "page-*.md")
117 if err != nil {
118 return fantasy.NewTextErrorResponse(fmt.Sprintf("Failed to create temporary file: %s", err)), nil
119 }
120 tempFilePath := tempFile.Name()
122 if _, err := tempFile.WriteString(content); err != nil {
123 tempFile.Close()
124 return fantasy.NewTextErrorResponse(fmt.Sprintf("Failed to write content to file: %s", err)), nil
125 }
126 tempFile.Close()
128 fullPrompt = fmt.Sprintf("%s\n\nThe web page from %s has been saved to: %s\n\nUse the view and grep tools to analyze this file and extract the requested information.", params.Prompt, params.URL, tempFilePath)
129 } else {
130 fullPrompt = fmt.Sprintf("%s\n\nWeb page URL: %s\n\n<webpage_content>\n%s\n</webpage_content>", params.Prompt, params.URL, content)
131 }
132 } else {
133 // Search mode: let the sub-agent search and fetch as needed.
134 fullPrompt = fmt.Sprintf("%s\n\nUse the web_search tool to find relevant information. Break down the question into smaller, focused searches if needed. After searching, use web_fetch to get detailed content from the most relevant results.", params.Prompt)
135 }
137 promptOpts := []prompt.Option{
138 prompt.WithWorkingDir(tmpDir),
139 }
141 promptTemplate, err := prompt.NewPrompt("agentic_fetch", string(agenticFetchPromptTmpl), promptOpts...)
142 if err != nil {
143 return fantasy.ToolResponse{}, fmt.Errorf("error creating prompt: %s", err)
144 }
146 _, small, err := c.buildAgentModels(ctx)
147 if err != nil {
148 return fantasy.ToolResponse{}, fmt.Errorf("error building models: %s", err)
149 }
151 systemPrompt, err := promptTemplate.Build(ctx, small.Model.Provider(), small.Model.Model(), *c.cfg)
152 if err != nil {
153 return fantasy.ToolResponse{}, fmt.Errorf("error building system prompt: %s", err)
154 }
156 smallProviderCfg, ok := c.cfg.Providers.Get(small.ModelCfg.Provider)
157 if !ok {
158 return fantasy.ToolResponse{}, errors.New("small model provider not configured")
159 }
161 webFetchTool := tools.NewWebFetchTool(tmpDir, client)
162 webSearchTool := tools.NewWebSearchTool(client)
163 fetchTools := []fantasy.AgentTool{
164 webFetchTool,
165 webSearchTool,
166 tools.NewGlobTool(tmpDir),
167 tools.NewGrepTool(tmpDir),
168 tools.NewSourcegraphTool(client),
169 tools.NewViewTool(c.lspClients, c.permissions, tmpDir),
170 }
172 agent := NewSessionAgent(SessionAgentOptions{
173 LargeModel: small, // Use small model for both (fetch doesn't need large)
174 SmallModel: small,
175 SystemPromptPrefix: smallProviderCfg.SystemPromptPrefix,
176 SystemPrompt: systemPrompt,
177 DisableAutoSummarize: c.cfg.Options.DisableAutoSummarize,
178 IsYolo: c.permissions.SkipRequests(),
179 Sessions: c.sessions,
180 Messages: c.messages,
181 Tools: fetchTools,
182 })
184 agentToolSessionID := c.sessions.CreateAgentToolSessionID(validationResult.AgentMessageID, call.ID)
185 session, err := c.sessions.CreateTaskSession(ctx, agentToolSessionID, validationResult.SessionID, "Fetch Analysis")
186 if err != nil {
187 return fantasy.ToolResponse{}, fmt.Errorf("error creating session: %s", err)
188 }
190 c.permissions.AutoApproveSession(session.ID)
192 // Use small model for web content analysis (faster and cheaper)
193 maxTokens := small.CatwalkCfg.DefaultMaxTokens
194 if small.ModelCfg.MaxTokens != 0 {
195 maxTokens = small.ModelCfg.MaxTokens
196 }
198 result, err := agent.Run(ctx, SessionAgentCall{
199 SessionID: session.ID,
200 Prompt: fullPrompt,
201 MaxOutputTokens: maxTokens,
202 ProviderOptions: getProviderOptions(small, smallProviderCfg),
203 Temperature: small.ModelCfg.Temperature,
204 TopP: small.ModelCfg.TopP,
205 TopK: small.ModelCfg.TopK,
206 FrequencyPenalty: small.ModelCfg.FrequencyPenalty,
207 PresencePenalty: small.ModelCfg.PresencePenalty,
208 })
209 if err != nil {
210 return fantasy.NewTextErrorResponse("error generating response"), nil
211 }
213 updatedSession, err := c.sessions.Get(ctx, session.ID)
214 if err != nil {
215 return fantasy.ToolResponse{}, fmt.Errorf("error getting session: %s", err)
216 }
217 parentSession, err := c.sessions.Get(ctx, validationResult.SessionID)
218 if err != nil {
219 return fantasy.ToolResponse{}, fmt.Errorf("error getting parent session: %s", err)
220 }
222 parentSession.Cost += updatedSession.Cost
224 _, err = c.sessions.Save(ctx, parentSession)
225 if err != nil {
226 return fantasy.ToolResponse{}, fmt.Errorf("error saving parent session: %s", err)
227 }
229 return fantasy.NewTextResponse(result.Response.Content.Text()), nil
230 }), nil