Skip to content

Latest commit

 

History

History
291 lines (160 loc) · 6.7 KB

namespaces.md

File metadata and controls

291 lines (160 loc) · 6.7 KB

Namespaces

Nerve offers a rich set of predefined tools, organized in namespaces, that the agent can import via the using directive. This page contains the list of namespaces available in Nerve, with the descriptive prompt that will be provided to the model.

🔧 anytool

Let the agent create its own tools in Python.

Show Tools

create_tool

Create a new tool or redefine an existing one by defining it as an annotated Python function.
    Use this tool to implement the missing functionalities you need to perform your task.

Parameters

  • code (<class 'str'>): The Python code to create the tool.

💻 computer

Important

This namespace is not available by default and requires the computer_use optional feature. To enable it, run pip install nerve-adk[computer_use].

Computer use primitives for mouse, keyboard, and screen.

Show Tools

get_cursor_position

Get the current mouse position.

keyboard_press_hotkeys

Press one or more hotkeys on the keyboard.

Parameters

  • keys (<class 'str'>): The hotkey sequence to press (like 'ctrl+shift+cmd+space')

keyboard_type

Type the given text on the keyboard.

Parameters

  • text (<class 'str'>): The text to type

mouse_double_click

Double click the left mouse button at the current mouse position.

mouse_left_click

Click the left mouse button at the current mouse position.

mouse_left_click_drag

Click and drag the left mouse button from the current mouse position to the given coordinates.

Parameters

  • x (<class 'int'>): The x coordinate to move to
  • y (<class 'int'>): The y coordinate to move to

mouse_middle_click

Click the middle mouse button at the current mouse position.

mouse_move

Move the mouse to the given coordinates.

Parameters

  • x (<class 'int'>): The x coordinate to move to
  • y (<class 'int'>): The y coordinate to move to

mouse_right_click

Click the right mouse button at the current mouse position.

mouse_scroll

Scroll the mouse wheel in the given direction.

Parameters

  • x (<class 'int'>): The x coordinate to move to
  • y (<class 'int'>): The y coordinate to move to

screenshot

Take a screenshot of the current screen.

📂 filesystem

Read-only access primitives to the local filesystem.

Jail

The tools in this namespace can be restricted to a specific set of paths by using the jail directive in the agent configuration:

using:
  - filesystem

jail:
    filesystem:
      - "/only/path/to/allow"
      - "{{ target_path }}" # variables can be used too
Show Tools

list_folder_contents

List the contents of a folder on disk.

Parameters

  • path (<class 'str'>): The path to the folder to list

read_file

Read the contents of a file from disk.

Parameters

  • path (<class 'str'>): The path to the file to read

💬 inquire

Let the agent interactively ask questions to the user in a structured way.

Show Tools

ask_for_confirmation

Ask a confirmation question to the user.

Parameters

  • question (<class 'str'>): The question to ask the user.
  • default (<class 'bool'>): The default answer to the question.

ask_for_multiple_choice

Ask a multiple choice question to the user.

Parameters

  • question (<class 'str'>): The question to ask the user.
  • choices (list[str]): The choices to offer the user.

ask_for_single_choice

Ask a single choice question to the user.

Parameters

  • question (<class 'str'>): The question to ask the user.
  • choices (list[str]): The choices to offer the user.

ask_question

Ask a question to the user.

Parameters

  • question (<class 'str'>): The question to ask the user.

🧠 reasoning

Simulates the reasoning process at runtime.

Show Tools

clear_thoughts

If the reasoning process proved wrong, inconsistent or ineffective, clear your thoughts and start again.

think

Adhere strictly to this reasoning framework, ensuring thoroughness, precision, and logical rigor.

    ## Problem Decomposition

    Break the query into discrete, sequential steps.
    Explicitly state assumptions and context.

    ## Stepwise Analysis

    Address each step individually.
    Explain the rationale, principles, or rules applied (e.g., mathematical laws, linguistic conventions).
    Use examples, analogies, or intermediate calculations to illustrate reasoning.

    ## Validation & Error Checking

    Verify logical consistency at each step.
    Flag potential oversights, contradictions, or edge cases.
    Confirm numerical accuracy (e.g., recompute calculations).

    ## Synthesis & Conclusion

    Integrate validated steps into a coherent solution.
    Summarize key insights and ensure the conclusion directly addresses the original query.

Parameters

  • thought (<class 'str'>): A thought to think about

💻 shell

Let the agent execute shell commands.

Show Tools

shell

Execute a shell command on the local computer and return the output. Non interactive shell with a timeout of 30 seconds.

Parameters

  • command (<class 'str'>): The shell command to execute

✅ task

Let the agent autonomously set the task as complete or failed.

Show Tools

task_complete_success

When your objective has been reached use this tool to set the task as complete.

Parameters

  • reason (str | None): Optional reason why the task is complete or report of conclusive information.

task_failed

Use this tool if you determine that the given goal or task is impossible given the information you have.

Parameters

  • reason (<class 'str'>): The reason why the task is impossible

🕒 time

Provides tools for getting the current date and time and waiting for a given number of seconds.

Show Tools

current_time_and_date

Get the current date and time.

wait

Wait for a given number of seconds.

Parameters

  • seconds (<class 'int'>): The number of seconds to wait