Render a message in the chat interface. Args: sender: The sender type (USER, BOT, or TOOL) message: The message conte

Render all messages in conversation history. This method processes a list of messages and renders each one according to its role and

Print message if verbose mode is on.

Run agent synchronously

Best-effort coercion of string values (from env/toml/--set) to the declared field type. Non-string values (e.g. from TOML) pass through.

Returns a new ToolResult with the given fields replaced.

Scale coordinates to a target maximum resolution.

Initialize session state variables.

Run a shell command and return the output, error, and optionally a screenshot.

Take a screenshot of the current screen and return the base64 encoded image.

Get existing event loop or create a new one if needed. This function ensures we have a valid event loop for async operations, reusing existin

Execute a command in the bash shell.

Largest (w, h) preserving aspect ratio with long-edge <= max_edge_px and tile-count <= max_tokens. Returns the input unchanged if already val

Render as a list of tool_result content blocks.

Normalize a model-emitted chord like 'ctrl+shift+a' to Playwright's 'Control+Shift+a'. Unknown segments pass through unchanged.

Returns a new ToolResult with the given fields replaced.

Resize `img` to its target size (no-op if already within budget), encode as JPEG, and return (base64_string, (sent_width, sent_height)).

Format a coordinate for tool output. Echoes the *image-space* values the model sent (not the scaled screen pixels) so the model sees its own

Translate an effort level into messages.stream() kwargs. Raises if the model does not support output_config.effort and effort is not "off".

Load and execute JavaScript from a file.

Return any keys that pyautogui's macOS backend has no keycode for.

Check that the path/command combination is valid.

Convert content to list for uniform processing. This eliminates duplicate code for handling list vs non-list content. Args:

Apply auto-scaling to coordinates using the CoordinateScaler. Claude's vision model interprets images at a different resolution than

Take a visual screenshot of the current page. NOTE: This only returns an image, not text content. Use read_page or get_page_t

Convert input from the user or output from the agent to a streamlit message.

Put cache breakpoints on the last few cacheable blocks (`tool_result` in a user turn, or `compaction` in an assistant turn). Clears any breakpoint

Drop everything before the most recent assistant message that contains a `compaction` block. The server does this drop anyway when it sees the

Handle API responses.

Handle API key authentication.

Release any resources held by tools (e.g. the Playwright browser). Safe to call multiple times; individual tool failures are swallowed so

Build a Config from defaults -> toml -> CU_* env vars -> overrides.

Sampling loop for browser automation. Args: browser_tool: Optional persistent browser tool instance. If not provided, creates a new

Terminate the bash shell.

Return (container, index) for every image block inside tool_result content, in document order, so callers can replace them in place.

Return each tool_result's inner content list, in document order.

Patch cfg to pure dataclass defaults plus the given overrides, ignoring whatever the local .env / CU_* environment may have set.

Prepare parameters for client.messages.create() call. Returns a dict with base parameters from config, with any message_param

Type text into the focused element.

Validate that messages maintain proper structure. Args: messages: The message list to validate Returns:

Implement the insert command, which inserts new_str at the specified line in the file content.

Process an API response into a structured format. Args: response: The API response from Anthropic Returns:

Build a tool result block from a ToolResult. Args: result: The tool execution result tool_use_id: The ID of

Exponential-backoff retry for recoverable API errors.

Remove text extraction markers and return a summary.

Generate output for the CLI based on the content of a file.

Load a system framework and call a zero-arg bool-returning C function. Returns True on any load/call failure so an unknown environment doesn't blo

Drive sampling_loop through a single no-tool-use turn and return the kwargs passed to messages.create.

Add a complete assistant message with all content blocks. Args: messages: The message list to append to cont

Add a message to the history and track token usage.

Add tool results as a user message. Args: messages: The message list to append to tool_results: The tool res

Execute tools and collect results. Args: tool_uses: List of tool use blocks to execute tool_collection: The

Extract command names from a shell command string. Handles pipes, command chaining (&&, ||, ;), and subshells. Returns the base command

Extract text content from a message. Args: message: The message to extract text from Returns: The e

Truncate content and append a notice if content exceeds the specified length.

Print a summary of current progress.

Read the content of a file from a given path; raise a ToolError if an error occurs.

Run a shell command asynchronously with a timeout.

Agentic sampling loop for the assistant/tool interaction of computer use.

Save data to a file in the storage directory.