Add current date and page url to agent context

[miguelg719]

why

To improve context

what changed

Added current page and url to the system prompt

test plan

[changeset-bot]

🦋 Changeset detected

Latest commit: f376142

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[greptile-apps]

Greptile Overview

Summary

This PR adds contextual information to the agent system prompt by appending the current date and page URL. The change is made to the `buildSystemPrompt` method in `lib/handlers/stagehandAgentHandler.ts`, where a new line is added to the system prompt: `Today's date is ${new Date().toLocaleDateString()}. You're currently on the website: ${this.stagehand.page.url}.`

This enhancement provides the Stagehand agent with essential environmental context that can improve its decision-making capabilities. The current date enables time-sensitive operations such as scheduling tasks, understanding temporal context on web pages, or making date-based comparisons. The page URL helps the agent understand its current location within a website, which is valuable for navigation decisions and understanding the context of available actions.

This change integrates well with the existing Stagehand architecture, specifically the agent handler system that was introduced in version 2.0.0 as part of the major release that added stagehand.agent functionality for computer use models. The modification is minimal and follows the existing pattern of building comprehensive system prompts that guide the agent's behavior.

Important Files Changed

Changed Files

Filename	Score	Overview
lib/handlers/stagehandAgentHandler.ts	4/5	Added current date and page URL to the agent's system prompt for better context awareness

Confidence score: 4/5

• This PR is safe to merge with minimal risk as it only adds contextual information to a system prompt
• Score reflects the simple nature of the change with clear benefits and no apparent side effects
• No files require special attention as this is a straightforward enhancement to agent context

Sequence Diagram

sequenceDiagram
    participant User
    participant StagehandAgentHandler as "StagehandAgentHandler"
    participant Stagehand as "Stagehand"
    participant LLMClient as "LLMClient"
    participant AgentTools as "AgentTools"

    User->>StagehandAgentHandler: "execute(instruction)"
    StagehandAgentHandler->>StagehandAgentHandler: "buildSystemPrompt(instruction, systemInstructions)"
    Note over StagehandAgentHandler: "Adds current date and page URL to system prompt"
    StagehandAgentHandler->>Stagehand: "page.url"
    Stagehand-->>StagehandAgentHandler: "current page URL"
    StagehandAgentHandler->>StagehandAgentHandler: "createTools()"
    StagehandAgentHandler->>AgentTools: "createAgentTools(stagehand, options)"
    AgentTools-->>StagehandAgentHandler: "default tools"
    StagehandAgentHandler->>LLMClient: "getLanguageModel()"
    LLMClient-->>StagehandAgentHandler: "base language model"
    StagehandAgentHandler->>LLMClient: "generateText(model, systemPrompt, messages, tools)"
    LLMClient-->>StagehandAgentHandler: "agent execution result with actions"
    StagehandAgentHandler-->>User: "AgentResult with success, message, actions"

Loading

_{1 file reviewed, 1 comment}

_{Edit Code Review Agent Settings | Greptile}

[greptile-apps]

style: The date format will vary by system locale - consider using toLocaleDateString('en-US') or toISOString().split('T')[0] for consistency

Prompt To Fix With AI

This is a comment left during a code review.
Path: lib/handlers/stagehandAgentHandler.ts
Line: 241:241

Comment:
style: The date format will vary by system locale - consider using `toLocaleDateString('en-US')` or `toISOString().split('T')[0]` for consistency

How can I resolve this? If you propose a fix, please make it concise.